OpenParable
Skip to content
← Back to skills

Szamlazz Invoicing

Apps & Automation
szamlazz-invoicing

Szamlazz Invoicing is an Agent Skill for apps & automation published in the davepoon/buildwithclaude repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/davepoon/buildwithclaude/blob/HEAD/plugins/all-skills/skills/szamlazz-invoicing/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/szamlazz-invoicing, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Szamlazz.hu Hungarian Invoicing

Issue, cancel (storno), download, and manage Hungarian invoices directly from Claude Code via the szamlazz.hu Agent API.

Built by SocialPro — 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 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

/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

FeatureDetails
Invoice typesRegular, proforma (díjbekérő), storno
VAT rates27% / 18% / 5% / 0% / AAM + KATA support
NAV lookupAuto-fetches company name and address from tax number
Partner cacheCustomers remembered by tax ID in local partners.yaml
Cross-platformmacOS, Linux, Windows
RoundingDecimal with ROUND_HALF_UP to 2 decimals
Error handling7 most common szamlazz.hu errors translated with recovery steps
SecurityAPI key in OS credential store, never echoed to stdout

Error Codes

CodeMeaningFix
3Auth failedRegenerate Agent key at szamlazz.hu
54, 55e-Számla certRetry with eszamla=false
57, 259-264Calculation mismatchRecalculate with Decimal rounding
136Unpaid balancePay 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