szamlazz — Claude Code command for invoicing and installation
Issue, cancel, and download Hungarian invoices through the szamlazz.hu Agent API. It also looks up taxpayer details and keeps a reusable customer cache.
npx claude-code-templates@latest --command automation/szamlazzWhat szamlazz does
Use the command to create regular invoices or proformas, cancel invoices, and download PDFs. Customer records are resolved from a tax-ID cache first, then through a NAV lookup or manual entry. You can also ask it to look up a company by its Hungarian tax number.
Before sending an invoice, the command presents a summary for confirmation. It then sends XML to the Agent API and saves the PDF locally. Seller details come from seller.yaml; the partner cache is updated after invoicing. First-run setup collects an Agent API key, the seller’s tax number, and a bank account, and stores the key in the OS credential store.
You need a szamlazz.hu account with an Agent API key, Python 3.9+, and PyYAML. Without the API key, the command cannot submit invoices. Amounts use Decimal and are rounded to two decimal places.
What it helps with
- issue a regular invoice or proforma
- cancel an existing invoice
- download an invoice PDF
- look up company details by Hungarian tax number
- reuse customer details from the partner cache
Example prompts for the agent
- Issue an invoice to Példa Kft. for 150 000 Ft of web development.
- Cancel invoice
SOC-2026-0042and download its PDF. - Look up the company with tax number
12345678-2-42. Create a proforma for Acme Ltd for 500 EUR of consulting.
How to install szamlazz
1claude-code-templates
npx claude-code-templates@latest --command automation/szamlazz2Manually: put the files in place
.claude/commands/szamlazz.mdCall it with /szamlazz. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/szamlazz.mdCall it with /prompts:szamlazz. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/szamlazz.prompt.mdManually: put the files in place
.gemini/commands/szamlazz.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about szamlazz
How do I install szamlazz in Claude Code?
Run npx claude-code-templates@latest --command automation/szamlazz, then use the command from .claude/commands/szamlazz.md.
What does szamlazz do?
It issues and cancels Hungarian invoices, downloads PDFs, and retrieves company details from NAV by tax number. Customer details can be reused from its partner cache.
What does szamlazz need to run?
You need Python 3.9+, PyYAML, and a szamlazz.hu account with an Agent API key. First-run setup also collects the seller’s tax number and bank account.
Source text
szamlazz.md · MIT
--- allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion argument-hint: <invoice details or subcommand> description: Issue, cancel, and fetch Hungarian invoices via the szamlazz.hu Agent API — with NAV taxpayer lookup and automatic partner cache --- # /szamlazz — Hungarian Invoicing via szamlazz.hu Issue, cancel (storno), and download Hungarian invoices from Claude Code using the [szamlazz.hu](https://www.szamlazz.hu/) Agent API: $ARGUMENTS Part of the [socialpro-szamlazz](https://github.com/socialproKGCMG/socialpro-szamlazz) plugin by [SocialPro](https://www.socialpro.hu) — a Hungarian AI automation and digital marketing agency. ## Purpose Hungarian invoicing (számlázás) via szamlazz.hu is one of the most common SaaS-driven time sinks for Hungarian SMEs. Their Agent API is XML-only and undocumented in English. This command turns invoicing into a single natural-language prompt: > "állíts ki egy 150 000 Ft-os számlát Példa Kft.-nek webfejlesztésről" ## Features - **Invoice types**: regular, proforma (díjbekérő), and storno (cancellation) - **NAV taxpayer lookup**: type a Hungarian tax number, get company name and address from the National Tax Authority - **Partner cache**: customers remembered by tax ID for instant reuse - **Hungarian VAT**: 27% / 18% / 5% / 0% / AAM, with KATA (kisadózó) support - **Cross-platform**: macOS, Linux, Windows — Python 3.9+ and PyYAML only - **Interactive setup**: first-run configures itself in 30 seconds via 3 questions - **Secure**: API key stored in OS credential store ## Usage ```bash # Install the plugin /plugin marketplace add socialproKGCMG/socialpro-plugins /plugin install szamlazz@socialpro-plugins # Issue an invoice /szamlazz állíts ki egy számlát Példa Kft.-nek 150 000 Ft-ról webfejlesztésről # Cancel an invoice /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 ``` ## Implementation The command activates on Hungarian AND English trigger words (számla, invoice, sztornó, storno, díjbekérő, proforma, etc.). On first run it detects missing config and walks through an interactive setup: 1. **Agent API key** — from szamlazz.hu settings 2. **Seller tax number** — auto-fetches company data from NAV 3. **Bank account** — auto-detects bank name from giro prefix After setup, invoices follow a strict flow: 1. Load seller config from `seller.yaml` 2. Resolve customer (partner cache → NAV lookup → manual input) 3. Collect line items with VAT rate 4. Show confirmation summary (mandatory — invoices are legal documents) 5. Fire XML to szamlazz.hu Agent API 6. Save PDF locally, update partner cache All amounts use `Decimal` with `ROUND_HALF_UP` to 2 decimals — the szamlazz.hu API rejects calculation mismatches. ## Error Handling The 7 most common szamlazz.hu error codes are translated into Hungarian with actionable recovery: | Code | Meaning | Recovery | |---:|---|---| | 3 | Auth failed | Regenerate Agent key | | 54, 55 | e-Számla cert | Retry with eszamla=false | | 57, 259-264 | Calc mismatch | Recalculate with Decimal | | 136 | Unpaid balance | Pay szamlazz.hu subscription | ## Requirements - Python 3.9+ - PyYAML (`pip install pyyaml`) - szamlazz.hu account with Agent API key ## Links - **Plugin repo**: [github.com/socialproKGCMG/socialpro-szamlazz](https://github.com/socialproKGCMG/socialpro-szamlazz) - **Plugin homepage**: [socialpro.hu/claude-code-plugins/szamlazz](https://www.socialpro.hu/claude-code-plugins/szamlazz) - **szamlazz.hu API docs**: [szamlazz.hu](https://www.szamlazz.hu/) - **Author**: [SocialPro — Hungarian AI automation agency](https://www.socialpro.hu)
© davila7 · MIT · davila7/claude-code-templates
