Szamlazz

Commands automation 58 Scanned by NVIDIA SkillSpector

Issue, cancel, and fetch Hungarian invoices via the szamlazz.hu Agent API — with NAV taxpayer lookup and automatic partner cache

Install Command

npx claude-code-templates@latest --command automation/szamlazz

View on GitHub

claude-code — szamlazz

Scanned by NVIDIA SkillSpector

Automated static analysis (no LLM) · v2.12.0 · 2026-10-17

Partial analysis: some checks could not run on this component.

0 observations

scanner score 0/100

SkillSpector looks for patterns such as shell commands, credential access, network calls or unpinned dependencies. An observation is something worth reading in the files before you install, not a confirmed vulnerability. Components that run code locally, like hooks, MCP servers and security tooling, naturally show more of them.

No observations.

Learn more about NVIDIA SkillSpector.

Content

/szamlazz — Hungarian Invoicing via szamlazz.hu

Issue, cancel (storno), and download Hungarian invoices from Claude Code using the szamlazz.hu Agent API: $ARGUMENTS

Part of the socialpro-szamlazz plugin by SocialPro — 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:

Agent API key — from szamlazz.hu settings
Seller tax number — auto-fetches company data from NAV
Bank account — auto-detects bank name from giro prefix

After setup, invoices follow a strict flow:

Load seller config from seller.yaml
Resolve customer (partner cache → NAV lookup → manual input)
Collect line items with VAT rate
Show confirmation summary (mandatory — invoices are legal documents)
Fire XML to szamlazz.hu Agent API
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