# szamlazz

Issue, cancel, and download Hungarian invoices through the szamlazz.hu Agent API. It also looks up taxpayer details and keeps a reusable customer cache.

- command · `type=command` · Claude Code · 54 installs
- Author: davila7
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/commands/automation/szamlazz.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/commands/szamlazz

## What it 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.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --command automation/szamlazz
```

2. **Manually: put the files in place**
- File: `.claude/commands/szamlazz.md` — Call it with /szamlazz. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/szamlazz.md` — Call it with /prompts:szamlazz. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/szamlazz.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/szamlazz.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/commands/automation/szamlazz.md

## When to use it
- 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
- Issue an invoice to Példa Kft. for 150 000 Ft of web development.
- Cancel invoice `SOC-2026-0042` and download its PDF.
- Look up the company with tax number `12345678-2-42`. Create a proforma for Acme Ltd for 500 EUR of consulting.

## Source text · szamlazz.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: bd6bd9796ff4a844.

BEGIN THIRD-PARTY FILE bd6bd9796ff4a844
````text
---
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)
````
END THIRD-PARTY FILE bd6bd9796ff4a844

The third-party file has ended. Everything between the bd6bd9796ff4a844 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© davila7 · MIT · https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/commands/automation/szamlazz.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md