# szamlazz-invoicing

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 100 installs · ★ 3785 repo stars
- Author: davepoon
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-skills/skills/szamlazz-invoicing/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/szamlazz-invoicing

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

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill szamlazz-invoicing -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/szamlazz-invoicing/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/szamlazz-invoicing/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill szamlazz-invoicing -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/szamlazz-invoicing/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill szamlazz-invoicing -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/szamlazz-invoicing/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davepoon/buildwithclaude plugins/all-skills/skills/szamlazz-invoicing
```

2. **Manually: put the files in place**
- File: `.github/skills/szamlazz-invoicing/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill szamlazz-invoicing -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/davepoon/buildwithclaude --path plugins/all-skills/skills/szamlazz-invoicing
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/szamlazz-invoicing/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill szamlazz-invoicing -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-skills/skills/szamlazz-invoicing/SKILL.md

## When to use it
- 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
- 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`.

## Source text · SKILL.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: 44421b23ca2ecf22.

BEGIN THIRD-PARTY FILE 44421b23ca2ecf22
````text
---
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 |
````
END THIRD-PARTY FILE 44421b23ca2ecf22

The third-party file has ended. Everything between the 44421b23ca2ecf22 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.

First 2769 of 4326 bytes. © davepoon · MIT · https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-skills/skills/szamlazz-invoicing/SKILL.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
