Skip to main content
skill CX Codex

szamlazz-invoicing — Claude Code skill: invoices and setup

The szamlazz-invoicing Claude Code skill handles Hungarian invoices through the szamlazz.hu Agent API. It activates for requests to issue, cancel, or download an invoice, or create a proforma.

MIT 100 installs ★ 3,785 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add davepoon/buildwithclaude --skill szamlazz-invoicing -a claude-code
Open on GitHub

What szamlazz-invoicing does

The skill issues and cancels Hungarian invoices, creates proforma invoices, and downloads PDFs by invoice number. When preparing an invoice, it finds customer details in a local cache or through a NAV tax-number lookup, calculates VAT, then asks for confirmation before sending the request. Seller settings go in seller.yaml; partner records are kept in partners.yaml.

It requires the socialpro-szamlazz plugin, Python 3.9+ with PyYAML, and a szamlazz.hu account with an Agent API key. On first run, it collects the key, seller tax number, and bank account details. The key is stored in the operating system’s credential store. Amounts use Decimal rounding to two places, and the skill allows up to 5 retries per session.

What it helps with

  • issue an invoice for a Hungarian customer
  • create a proforma invoice
  • cancel an invoice using its number
  • download an invoice PDF
  • look up a company by its tax number

Example prompts for the agent

  • Create an invoice for Példa Kft. for web development, amount 150 000 Ft.
  • Cancel invoice SOC-2026-0042.
  • Download the PDF for invoice SOC-2026-0042.

How to install szamlazz-invoicing

1Skills CLI (Vercel)

npx skills add davepoon/buildwithclaude --skill szamlazz-invoicing -a claude-code

2Manually: put the files in place

~/.claude/skills/szamlazz-invoicing/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/szamlazz-invoicing/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about szamlazz-invoicing

How do I install szamlazz-invoicing in Claude Code?

Run npx skills add davepoon/buildwithclaude --skill szamlazz-invoicing -a claude-code. The skill file is placed at ~/.claude/skills/szamlazz-invoicing/SKILL.md.

What does szamlazz-invoicing do?

It issues and cancels invoices through szamlazz.hu, creates proformas, retrieves invoice PDFs, and looks up Hungarian company details by tax number. It asks for confirmation before issuing an invoice.

What does szamlazz-invoicing require?

It needs the socialpro-szamlazz plugin, Python 3.9+ with PyYAML, and a szamlazz.hu account with an Agent API key.

Source text

SKILL.md · MIT
---
name: szamlazz-invoicing
description: "Issue, cancel, and fetch Hungarian invoices via the szamlazz.hu Agent API. Handles VAT calculation, NAV taxpayer lookup, partner caching, and PDF generation. Use when the user mentions számla, számlázás, invoice, sztornó, díjbekérő, proforma, or wants to bill a customer."
category: finance
---

# Szamlazz.hu Hungarian Invoicing

Issue, cancel (storno), download, and manage Hungarian invoices directly from Claude Code via the [szamlazz.hu](https://www.szamlazz.hu/) Agent API.

Built by [SocialPro](https://www.socialpro.hu) — 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](https://github.com/socialproKGCMG/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

```bash
/plugin marketplace add socialproKGCMG/socialpro-plugins
/plugin install szamlazz@socialpro-plugins
```

## What 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ő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 `penznem` and 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](https://github.com/socialproKGCMG/socialpro-szamlazz)
- **Plugin homepage**: [socialpro.hu/claude-code-plugins/szamlazz](https://www.socialpro.hu/claude-code-plugins/szamlazz)
- **Hungarian AI automation case studies**: [socialpro.hu/esettanulmanyok](https://www.socialpro.hu/esettanulmanyok)
- **Author**: [SocialPro / KG Creative Media Group Kft.](https://www.socialpro.hu/rolunk)

© davepoon · MIT · davepoon/buildwithclaude

Similar skills

All skills for Finance and business →

From the same set235

The whole set →
recap The recap skill for Claude Code and Cursor generates a narrative financial review for any time period using MCP tools. CX Codex +1 105installs immich-photo-manager The immich-photo-manager Claude Code skill manages a self-hosted Immich photo library through natural-language requests. It searches images and text in photos, and helps organize albums, duplicates, and metadata. CX Codex +1 105installs tidy This Claude Code skill groups uncategorized transactions and suggests categories. It starts when asked to tidy transactions or sort uncategorized activity. CX Codex +1 104installs google-drive-upload google-drive-upload is a Claude Code skill that sends files to Google Drive through a deployed Google Apps Script web app. It reacts to requests to store or upload a file. CX Codex +1 101installs optimize-database-performance optimize-database-performance — a slash command that works through slow queries, index strategy and schema layout for PostgreSQL and MySQL, then hands back SQL you can apply. Useful once page loads start dragging. CX Codex +1 ★ 3,785repo stars optimize-bundle-size optimize-bundle-size reads your bundle, finds the dependencies that bloat it and rewrites the build config: chunk splitting, lazy routes, tree shaking. Useful when the JS payload slows the page down. CX Codex +1 ★ 3,785repo stars implement-caching-strategy implement-caching-strategy is a Claude Code command that plans and adds caching across browser, application, and database layers. Run it to define TTL and invalidation rules for a project. CX Codex +1 ★ 3,785repo stars add-performance-monitoring add-performance-monitoring generates performance monitoring configs for Node.js backends and browser apps using New Relic, Datadog or Web Vitals. CX Codex +1 ★ 3,785repo stars

Project sponsors

Companies that keep this analytics open