Szamlazz Invoicing Skill for Claude
Issue, cancel, and fetch Hungarian invoices via the szamlazz.hu Agent API. Handles VAT calculation, NAV taxpayer lookup, partner caching, and PDF generation. Use when the user mentions számla, számlázás, invoice, sztornó, díjbekérő, proforma, or wants to bill a customer.
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/davepoon/buildwithclaude --skill szamlazz-invoicingThe instruction itself
15 sections, as written by the authorSzamlazz.hu Hungarian Invoicing
Issue, cancel (storno), download, and manage Hungarian invoices directly from Claude Code via the szamlazz.hu Agent API.
Built by SocialPro — a Hungarian AI automation and digital marketing agency specializing in custom AI integrations for SMEs.
When to Use This Skill
- User wants to issue a Hungarian invoice (számla)
- User wants to create a proforma / díjbekérő
- User wants to cancel (storno) an existing invoice
- User wants to download an invoice PDF
- User wants to look up a Hungarian company by tax number (NAV)
- User mentions szamlazz.hu, számlázás, or billing in a Hungarian context
Prerequisites
- Plugin: socialpro-szamlazz installed
- Python 3.9+ with PyYAML (
pip install pyyaml) - szamlazz.hu account with an Agent API key (generate at szamlazz.hu → Beállítások → Számla Agent kulcsok)
Installation
/plugin marketplace add socialproKGCMG/socialpro-plugins
/plugin install szamlazz@socialpro-plugins
What This Skill Does
- First-run setup — detects missing config, asks 3 questions (API key, seller tax number with NAV auto-lookup, bank account with auto-detection), writes
seller.yaml - Invoice creation — parses natural language, resolves customer from partner cache or NAV, calculates net/VAT/gross with Decimal precision, shows mandatory confirmation, fires XML to API, saves PDF
- Storno — cancels an existing invoice by number
- Proforma — creates a díjbekérő (proforma invoice)
- PDF download — re-downloads an invoice PDF by number
- NAV lookup — queries the National Tax Authority for company data by tax number
How to Use
Issue an Invoice
/szamlazz állíts ki egy számlát Példa Kft.-nek 150 000 Ft-ról webfejlesztésről
Cancel (Storno)
/szamlazz sztornózd a SOC-2026-0042 számlát
Proforma / Díjbekérő
/szamlazz díjbekérő Acme Ltd-nek 500 EUR-ról konzultációért
Download PDF
/szamlazz töltsd le a SOC-2026-0042 PDF-jét
NAV Taxpayer Lookup
/szamlazz ki ez a cég: 12345678-2-42
Key Features
| Feature | Details |
|---|---|
| Invoice types | Regular, proforma (díjbekérő), storno |
| VAT rates | 27% / 18% / 5% / 0% / AAM + KATA support |
| NAV lookup | Auto-fetches company name and address from tax number |
| Partner cache | Customers remembered by tax ID in local partners.yaml |
| Cross-platform | macOS, Linux, Windows |
| Rounding | Decimal with ROUND_HALF_UP to 2 decimals |
| Error handling | 7 most common szamlazz.hu errors translated with recovery steps |
| Security | API key in OS credential store, never echoed to stdout |
Error Codes
| Code | Meaning | Fix |
|---:|---|---|
| 3 | Auth failed | Regenerate Agent key at szamlazz.hu |
| 54, 55 | e-Számla cert | Retry with eszamla=false |
| 57, 259-264 | Calculation mismatch | Recalculate with Decimal rounding |
| 136 | Unpaid balance | Pay szamlazz.hu subscription |
Tips
- The plugin activates on both Hungarian and English trigger words
- Invoices are legal documents — the skill always shows a confirmation before issuing
- Partner cache is local-only and never committed to git
- For foreign currency invoices, set
penznemand the MNB exchange rate is used automatically - Maximum 5 retry attempts per session to prevent infinite loops
Links
- Plugin repository: github.com/socialproKGCMG/socialpro-szamlazz
- Plugin homepage: socialpro.hu/claude-code-plugins/szamlazz
- Hungarian AI automation case studies: socialpro.hu/esettanulmanyok
- Author: SocialPro / KG Creative Media Group Kft.
Other skills for the same job
different authors, same section of the catalogue
Generate comprehensive investor-ready business case document with market, solution, financials, and strategy
Generate professional company tear sheets using S&P Capital IQ data via the Kensho LLM-ready API MCP server. Use this skill whenever the user asks for a tear sheet, company one-pager, company profile, fact sheet, company snapshot, or company overview document — especially when they mention a specific company name or ticker. Also trigger when users ask for equity research summaries, M&A company profiles, corporate development target profiles, sales/BD meeting prep documents, or any concise single-company financial summary. This skill supports four audience types: equity research, investment banking/M&A, corporate development, and sales/business development. If the user doesn't specify an audience, ask. Works for both public and private companies.
> PayPal (and Square/Stripe) settlements, flags uncategorized transactions, suspicious duplicates, and missing receipts, then writes a plain-English P&L narrative and exports a close packet (xlsx + one-page PDF). Use when the user says "close the month," "month-end," "reconcile," "what's missing," "P&L," or asks why revenue or margin changed this month.
Use when the user asks to "build the norm card for this platform", "what are the char limits and visible-fold cutoffs here", "is the LinkedIn link-in-first-comment thing documented or folklore", or "which of our platform cards are stale"; maintains the dated, versioned per-platform norm cards in the references/platforms/ pack — char limits, visible-fold cutoffs, hashtag norms, format/aspect specs, link and first-comment placement, disclosure-label mechanics, algorithm emphases (e.g. 小红书 search+saves weighting) — every row labeled platform-documented (official doc, Measured) or Estimated-folklore (named source) with last-verified and review-by dates, and any card past its review date flagged stale rather than trusted. Extends the single pack in place; never forks a second one. Not for picking which channels to run — use channel-portfolio-planner. 平台规范卡/字符限制/折叠线/话题标签/算法侧重/过期标记
Use for due diligence, legal-financial risk review, investment or business transaction checklists, and preliminary screening where facts, documents, assumptions, legal uncertainty, debt/equity, assets/liabilities, contracts, tax, regulatory, compliance, technology/product, and financial-model issues must be separated clearly.
Generating invoices, contracts, forms, receipts, and business documents as professional PDFs
Extract and analyze data from invoices, receipts, bank statements, and financial documents. Categorize expenses, track recurring charges, and generate expense reports. Use when user provides financial PDFs or images.
Generate comprehensive stock analysis report (PDF or markdown) with trend, PMCC, and fundamental analysis
How to use it
Take davepoon/szamlazz-invoicing from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.
The instructions reference pip.
Without those the skill loads but fails at the first command.