davepoon Szamlazz.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.
Source: davepoon/buildwithclaude → plugins/all-skills/skills/szamlazz-invoicing/SKILL.md