
Szamlazz Invoicing
- 79 installs
- 3.2k repo stars
- Updated August 2, 2026
- davepoon/buildwithclaude
Issues, cancels, and downloads Hungarian invoices via the szamlazz.hu Agent API, with VAT calculation, NAV taxpayer lookup, and PDF generation.
About
Creates, cancels (storno), and fetches Hungarian invoices and proformas through the szamlazz.hu Agent API, resolving customers via partner cache or NAV and computing net/VAT/gross with decimal precision. A developer uses it to bill Hungarian customers directly from Claude Code.
- NAV taxpayer lookup and partner caching
- Mandatory confirmation before firing invoice XML
Szamlazz Invoicing by the numbers
- 79 all-time installs (skills.sh)
- Ranked #548 of 1,106 Finance & Trading skills by installs in the Skillselion catalog
- Data as of Aug 3, 2026 (Skillselion catalog sync)
npx skills add https://github.com/davepoon/buildwithclaude --skill szamlazz-invoicingAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 79 |
|---|---|
| repo stars | ★ 3.2k |
| Last updated | August 2, 2026 |
| Repository | davepoon/buildwithclaude ↗ |
What it does
Issues, cancels, and downloads Hungarian invoices via the szamlazz.hu Agent API, with VAT calculation, NAV taxpayer lookup, and PDF generation.
Files
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-pluginsWhat This Skill Does
1. 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 2. 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 3. Storno — cancels an existing invoice by number 4. Proforma — creates a díjbekérő (proforma invoice) 5. PDF download — re-downloads an invoice PDF by number 6. 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őlCancel (Storno)
/szamlazz sztornózd a SOC-2026-0042 számlátProforma / Díjbekérő
/szamlazz díjbekérő Acme Ltd-nek 500 EUR-ról konzultációértDownload PDF
/szamlazz töltsd le a SOC-2026-0042 PDF-jétNAV Taxpayer Lookup
/szamlazz ki ez a cég: 12345678-2-42Key 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.