К основному содержанию
скилл CX Codex

szamlazz-invoicing — скилл для Claude Code: счета и установка

Скилл szamlazz-invoicing для Claude Code оформляет венгерские счета через Agent API сервиса szamlazz.hu. Запускается по запросу выставить счёт, создать proforma, отменить или скачать счёт.

MIT 100 установок ★ 3 785 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add davepoon/buildwithclaude --skill szamlazz-invoicing -a claude-code
Открыть на GitHub

Что делает szamlazz-invoicing

Скилл создаёт и отменяет венгерские счета, готовит proforma и скачивает PDF по номеру. При выставлении он ищет данные клиента в локальном кэше или по налоговому номеру через NAV, рассчитывает суммы с НДС и показывает подтверждение до отправки запроса. Данные продавца сохраняются в seller.yaml, партнёров — в partners.yaml.

Для работы нужны плагин socialpro-szamlazz, Python 3.9+ с PyYAML и аккаунт szamlazz.hu с ключом Agent API. При первом запуске скилл запрашивает ключ, налоговый номер продавца и банковский счёт. Ключ хранится в системном хранилище учётных данных. Расчёты округляются через Decimal до двух знаков; лимит — 5 повторных попыток за сессию.

Какие задачи решает

  • выставить венгерский счёт клиенту
  • создать díjbekérő для оплаты
  • отменить существующий счёт по номеру
  • скачать PDF счёта
  • найти данные компании по налоговому номеру

Примеры запросов агенту

  • Выставь счёт клиенту Példa Kft. на 150 000 Ft за веб-разработку.
  • Отмени счёт SOC-2026-0042.
  • Скачай PDF счёта SOC-2026-0042.

Как установить szamlazz-invoicing

1Через Skills CLI (Vercel)

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

2Вручную: положить файлы

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

Папка скилла целиком; для одного проекта — .claude/skills/szamlazz-invoicing/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о szamlazz-invoicing

Как установить szamlazz-invoicing в Claude Code?

Выполни npx skills add davepoon/buildwithclaude --skill szamlazz-invoicing -a claude-code. Файл скилла появится по пути ~/.claude/skills/szamlazz-invoicing/SKILL.md.

Что делает szamlazz-invoicing?

Скилл создаёт и отменяет счета в szamlazz.hu, оформляет proforma, скачивает PDF и ищет данные венгерской компании по налоговому номеру. Перед отправкой нового счёта он запрашивает подтверждение.

Что нужно для работы szamlazz-invoicing?

Нужны плагин socialpro-szamlazz, Python 3.9+ с PyYAML и аккаунт szamlazz.hu с ключом Agent API.

Исходный текст

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

Похожие скиллы

Все скиллы по теме «Финансы и бизнес» →
szamlazz davila7 Выставляет, отменяет и скачивает венгерские счета через API szamlazz.hu. Оформляет счета с венгерским НДС и проверяет налоговые номера компаний. CX Codex +1 54установок Kash — POS, Invoicing, CRM & Webshop paracetamol951 Kash — POS, Invoicing, CRM & Webshop — MCP-сервер для Claude Code, который подключает магазин к ИИ-ассистенту для работы с заказами, клиентами и отчётами по продажам в диалоге. CX Codex +1 2 880установок FacturLint - Factur-X 1.09.2 & BR-FR-CTC E-Invoicing facturlint FacturLint - Factur-X 1.09.2 & BR-FR-CTC E-Invoicing — MCP-сервер для Claude Code, который проверяет счета по Factur-X, EN 16931 и BR-FR-CTC. Исправляет дефекты PDF/A-3b. CX Codex +1 affiliate-payout-audit Maya-Beth Finotti Скилл affiliate-payout-audit для Claude Code проверяет расчёт комиссий партнёрам перед выплатой. Он сверяет суммы и правила начислений и выдаёт отчёт с уровнями серьёзности и рекомендациями по удержанию выплат. CX Codex +1 17 700установок data-analysis claude-office-skills Скилл data-analysis для Claude Code анализирует таблицы Excel и CSV, находит закономерности и строит визуализации. Запускается по запросу об исследовании данных или подготовке отчёта. CX Codex +1 8 300установок cournot Cournot-AI Скилл для запросов к Cournot: вероятности событий, ранжирование расхождений в ценах, баланс и ключи. Вызывается только по /cournot или явной просьбе. CX Codex +1 8 300установок

Из того же набора235

Весь набор →
recap Скилл recap для Claude Code и Cursor собирает финансовые итоги за выбранный период и строит текстовый обзор расходов и доходов. CX Codex +1 105установок immich-photo-manager Скилл immich-photo-manager для Claude Code управляет фототекой Immich через запросы на обычном языке. Он ищет фото и текст на снимках, помогает разбирать альбомы, дубликаты и метаданные. CX Codex +1 105установок tidy Скилл tidy для Claude Code группирует некатегоризированные транзакции и предлагает для них категории. Запускается по просьбе привести расходы в порядок или распределить операции по категориям. CX Codex +1 104установок google-drive-upload Скилл google-drive-upload для Claude Code отправляет файлы в Google Drive через веб-приложение Google Apps Script. Срабатывает по просьбе сохранить или загрузить файл. CX Codex +1 101установок optimize-database-performance Слэш-команда optimize-database-performance для Claude Code разбирает медленные запросы и индексы в PostgreSQL и MySQL: планы выполнения, неиспользуемые индексы, партиции, пул соединений. CX Codex +1 ★ 3 785звёзд репо optimize-bundle-size Команда optimize-bundle-size для Claude Code и Cursor: разбирает бандл, находит тяжёлые зависимости, переписывает конфиг сборки — чанки, ленивая загрузка, tree shaking. Убирает лишний JS из страницы. CX Codex +1 ★ 3 785звёзд репо implement-caching-strategy Команда implement-caching-strategy помогает спроектировать и внедрить кэширование на клиенте, в приложении и при работе с базой данных. Запустите её, когда нужно выбрать стратегию и добавить кэш в проект. CX Codex +1 ★ 3 785звёзд репо add-performance-monitoring Команда add-performance-monitoring настраивает мониторинг производительности приложения: генерирует конфигурации для APM-агентов бэкенда и внедряет сбор метрик Web Vitals в браузере. CX Codex +1 ★ 3 785звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой