{
  "markdown": "# socialpro-szamlazz\n\nHungarian invoicing from Claude Code — issue, cancel, and fetch invoices via the szamlazz.hu Agent API. Cross-platform, near-zero-dependency (PyYAML only), with an interactive first-run setup that uses NAV auto-lookup to configure itself in 30 seconds.\n\n> *Magyar olvasóknak: [README magyarul →](./README.hu.md)*\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)\n![Claude Code Plugin](https://img.shields.io/badge/Claude%20Code-Plugin-blueviolet)\n![Cross-platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-informational)\n![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue)\n\nBuilt by [SocialPro](https://www.socialpro.hu) — a Hungarian AI automation and digital marketing agency. This plugin is one of several open-source Claude Code integrations we maintain for Hungarian small businesses.\n\n## What it does\n\nHungarian invoicing (számlázás) via [szamlazz.hu](https://www.szamlazz.hu/) is one of the most common SaaS-driven time sinks for Hungarian SMEs. Their Agent API exists but is XML-only and undocumented in English — so most people issue invoices manually through the web UI, which takes 5-15 minutes per invoice.\n\nThis plugin turns any Hungarian invoicing task into a natural-language prompt in Claude Code:\n\n> \"állíts ki egy 150 000 Ft-os számlát Példa Kft.-nek webfejlesztésről\"\n\nClaude reads your seller config, looks up the customer in the local partner cache, calculates net/VAT/gross amounts with proper 2-decimal rounding, shows you a confirmation block, and fires the invoice to szamlazz.hu — all in one prompt.\n\n## Features\n\n- **Issue invoices**: regular, proforma (díjbekérő), and storno (cancellation)\n- **NAV taxpayer auto-lookup** — type a Hungarian tax number, get the company name and address back\n- **Automatic partner cache** — customers are remembered by tax ID for name-based reuse\n- **Hungarian VAT handling**: 27% / 18% / 5% / 0% / AAM, KATA (kisadózó) support\n- **Cross-platform**: native on macOS, Linux, and Windows — only requires Python 3.9+ and PyYAML\n- **Bilingual auto-invoke**: the plugin activates on Hungarian AND English trigger words\n- **Interactive setup**: the first-run flow asks 3 questions and configures itself in 30 seconds\n- **Secure by default**: API key stored in your OS credential store via Claude Code's `userConfig`\n\n## Installation\n\n```bash\n# Once, per machine: install PyYAML (the only runtime dependency)\npip install pyyaml\n\n# In Claude Code:\n/plugin marketplace add socialproKGCMG/socialpro-plugins\n/plugin install szamlazz@socialpro-plugins\n```\n\nDuring install, Claude Code will prompt you for your szamlazz.hu Agent API key. You can skip this and the first-run flow will ask for it interactively.\n\n## First-run experience\n\nNo YAML editing required. On your first invoicing prompt, the plugin asks 3 questions:\n\n```\n1. \"Szamlazz.hu Agent API kulcsod?\"\n       ↓ (paste the key from szamlazz.hu → Beállítások → Számla Agent kulcsok)\n\n2. \"A saját céged adószáma?\"  (e.g. 12345678-2-42)\n       ↓ (plugin calls NAV and auto-fills name, postal code, city, street)\n\n3. \"Bankszámlaszámod?\"  (e.g. 12345678-12345678-12345678)\n       ↓ (plugin auto-detects the bank name from the giro prefix — e.g. \"UniCredit Bank\")\n\n✓ Beállítás kész. Most folytatom az eredeti kéréseddel...\n```\n\n## Usage examples\n\nType these in Claude Code and the plugin handles the rest:\n\n```\nállíts ki egy számlát Példa Kft.-nek 150 000 Ft-ról webfejlesztésről\nsztornózd a SOC-2026-0042 számlát\ndíjbekérő Acme Ltd-nek 500 EUR-ról konzultációért\ntöltsd le a SOC-2026-0042 PDF-jét\nki ez a cég: 12345678-2-42\n```\n\n## Configuration\n\nThe plugin looks for config files in this priority order:\n\n| Priority | macOS | Linux | Windows |\n|---:|---|---|---|\n| 1 | `$SZAMLAZZ_CONFIG_DIR` (env var) | (same) | `%SZAMLAZZ_CONFIG_DIR%` |\n| 2 | `./.szamlazz/` in current dir | (same) | `.\\.szamlazz\\` |\n| 3 | `~/Library/Application Support/szamlazz/` | `$XDG_CONFIG_HOME/szamlazz/` | `%APPDATA%\\szamlazz\\` |\n| 4 | `~/.claude/szamlazz/` (legacy) | (same) | `%USERPROFILE%\\.claude\\szamlazz\\` |\n\nThis is deliberately flexible — a solo developer uses the global dir; an accountant with multiple clients uses `./.szamlazz/` per project. For more Hungarian-market AI automation patterns, see the [SocialPro blog for detailed AI and SEO case studies](https://www.socialpro.hu/blog).\n\n### Config files in each directory\n\n- `seller.yaml` — your company info (name, tax number, address, bank)\n- `partners.yaml` — customer cache (managed automatically, never edit)\n- `.env` — `SZAMLAZZ_AGENT_KEY=...` (or use Claude Code's `userConfig` instead)\n\n## Troubleshooting\n\nThe szamlazz.hu Agent API returns numeric error codes. The plugin translates the 7 most common ones into Hungarian with actionable recovery steps:\n\n| Code | Meaning | Fix |\n|---:|---|---|\n| 3 | Auth failed | Wrong or revoked Agent key — regenerate at szamlazz.hu |\n| 54, 55 | e-Számla certificate issue | Retry with `eszamla=false` (plain PDF) |\n| 57 | Calculation mismatch | Re-run with Decimal rounding |\n| 259-264 | Same, line-specific | Same fix as 57 |\n| 136 | Unpaid szamlazz.hu balance | Pay your subscription on the szamlazz.hu website |\n\n## How it compares\n\n|  | socialpro-szamlazz (this plugin) | szamlazz.hu web UI | szamlazz.hu Agent API directly |\n|---|---|---|---|\n| Setup time | ~30 seconds (interactive) | ~0 (browser only) | ~1-2 hours (XML, curl, debugging) |\n| Per-invoice time | ~10 seconds (one prompt) | 5-15 minutes | Depends |\n| NAV taxpayer lookup | Automatic | Manual (separate page) | Manual (separate endpoint) |\n| Hungarian VAT handling | Automatic | Automatic | Manual |\n| Partner memory | Local cache | Paid tier only | None |\n| Best for | Frequent issuers, developers, automation | Occasional manual invoices | Custom integrations |\n\n## About the author\n\nThis plugin is built and maintained by [SocialPro / KG Creative Media Group Kft.](https://www.socialpro.hu/rolunk) — a Hungarian digital marketing and AI automation agency specializing in custom AI integrations for SMEs. Our broader work includes SEO, Meta advertising, and Hungarian-market case studies which you can browse in [our case studies archive](https://www.socialpro.hu/esettanulmanyok).\n\n## Support\n\n- **Bug reports / feature requests**: [GitHub Issues](https://github.com/socialproKGCMG/socialpro-szamlazz/issues)\n- **Custom automation or enterprise setup**: for bespoke [Hungarian accounting and billing automation](https://www.socialpro.hu/kapcsolat) contact SocialPro directly.\n\n## License\n\nMIT License — see [LICENSE](./LICENSE) for details.\n\nCopyright © 2026 KG Creative Media Group Kft. (SocialPro)\n",
  "bytes": 6663,
  "sha": "9e5ff7f10e986034db5d9ec399274ad8920babaaa31363006567b5b3c725a4d8",
  "repo_slug": "socialprokgcmg/socialpro-szamlazz",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_socialprokgcmg_socialpro_szamlazz_social_1013d17d/readme"
}