Back to Details

szamlazz-invoicing

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Szamlazz.hu Hungarian Invoicing

Szamlazz.hu 匈牙利发票管理

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.
通过szamlazz.hu Agent API直接在Claude Code中开具、取消（storno）、下载和管理匈牙利发票。
由SocialPro开发——这是一家匈牙利AI自动化与数字营销机构，专注为中小企业提供定制AI集成方案。

When to Use This Skill

何时使用该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
  • 用户想要开具匈牙利发票（számla）
  • 用户想要创建形式发票（díjbekérő/proforma）
  • 用户想要取消（storno）现有发票
  • 用户想要下载发票PDF
  • 用户想要通过税号查询匈牙利公司信息（NAV）
  • 用户提及szamlazz.hu、számlázás，或是在匈牙利语境下提到账单相关内容

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)
  • 插件：已安装socialpro-szamlazz
  • Python 3.9+ 并安装PyYAML（
    pip install pyyaml
    ）
  • szamlazz.hu账户，需拥有Agent API密钥（在szamlazz.hu → Beállítások → Számla Agent kulcsok生成）

Installation

安装步骤

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

What This Skill Does

该Skill的功能

  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
  1. 首次运行设置——检测缺失的配置，询问3个问题（API密钥、带NAV自动查询的销售方税号、自动检测的银行账户），生成
    seller.yaml
    配置文件
  2. 发票创建——解析自然语言，从合作伙伴缓存或NAV中获取客户信息，使用Decimal精度计算净价/增值税/总价，显示强制确认，向API发送XML，保存PDF
  3. 发票取消（Storno）——通过发票号码取消现有发票
  4. 形式发票生成——创建díjbekérő（形式发票）
  5. PDF下载——通过发票号码重新下载发票PDF
  6. NAV纳税人查询——通过税号向国家税务总局查询公司数据

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
/szamlazz állíts ki egy számlát Példa Kft.-nek 150 000 Ft-ról webfejlesztésről

Cancel (Storno)

取消发票（Storno）

/szamlazz sztornózd a SOC-2026-0042 számlát
/szamlazz sztornózd a SOC-2026-0042 számlát

Proforma / Díjbekérő

形式发票（Díjbekérő）

/szamlazz díjbekérő Acme Ltd-nek 500 EUR-ról konzultációért
/szamlazz díjbekérő Acme Ltd-nek 500 EUR-ról konzultációért

Download PDF

下载PDF

/szamlazz töltsd le a SOC-2026-0042 PDF-jét
/szamlazz töltsd le a SOC-2026-0042 PDF-jét

NAV Taxpayer Lookup

NAV纳税人查询

/szamlazz ki ez a cég: 12345678-2-42
/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
Rounding
Decimal
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
功能详情
发票类型常规发票、形式发票（díjbekérő）、取消发票（storno）
增值税税率27% / 18% / 5% / 0% / 支持AAM + KATA
NAV查询通过税号自动获取公司名称和地址
合作伙伴缓存通过本地
partners.yaml
文件中的税ID记录客户信息
跨平台支持macOS、Linux、Windows
精度处理使用
Decimal
类型并采用
ROUND_HALF_UP
方式保留2位小数
错误处理翻译szamlazz.hu最常见的7种错误并提供解决步骤
安全性API密钥存储在操作系统凭据库中，绝不会输出到标准输出

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
代码含义解决方法
3认证失败在szamlazz.hu重新生成Agent密钥
54, 55电子发票证书问题添加
eszamla=false
参数后重试
57, 259-264计算不匹配使用Decimal精度重新计算
136账户余额不足支付szamlazz.hu订阅费用

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
  • 插件支持匈牙利语和英语触发词
  • 发票是法律文件——该Skill在开具前总会显示确认信息
  • 合作伙伴缓存仅存储在本地，绝不会提交到git
  • 对于外币发票，设置
    penznem
    参数后将自动使用MNB汇率
  • 每个会话最多重试5次，防止无限循环

Links

链接