szamlazz-invoicing

Szamlazz.hu 匈牙利发票

通过 szamlazz.hu Agent API，直接在 Claude Code 中开具、作废（storno）、下载和管理匈牙利发票。

由 SocialPro 构建——这是一家匈牙利 AI 自动化与数字营销机构，专注于为中小企业定制 AI 集成方案。

何时使用此技能

• 用户想开具匈牙利发票（számla）
• 用户想创建形式发票 / 付款请求单（díjbekérő）
• 用户想作废（storno）现有发票
• 用户想下载发票 PDF
• 用户想通过税号查询匈牙利公司（NAV）
• 用户在匈牙利相关场景中提到 szamlazz.hu、számlázás 或开票

前提条件

• 插件：socialpro-szamlazz 已安装
• Python 3.9+，并安装 PyYAML（pip install pyyaml）
• szamlazz.hu 账户，并拥有 Agent API 密钥（前往 szamlazz.hu → Beállítások → Számla Agent kulcsok 生成）

安装

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

此技能的功能

1. 首次运行设置——检测缺失的配置，询问 3 个问题（API 密钥、通过 NAV 自动查询的卖方税号、自动检测的银行账户），并写入 seller.yaml
2. 创建发票——解析自然语言，从合作伙伴缓存或 NAV 获取客户信息，使用 Decimal 精度计算净额／增值税／总额，显示必需的确认信息，将 XML 发送至 API，并保存 PDF
3. 作废——按编号取消现有发票
4. 形式发票——创建付款请求单（díjbekérő，即形式发票）
5. 下载 PDF——按编号重新下载发票 PDF
6. NAV 查询——按税号向国家税务局查询公司信息

使用方法

开具发票

/szamlazz állíts ki egy számlát Példa Kft.-nek 150 000 Ft-ról webfejlesztésről

作废（Storno）

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

形式发票 / Díjbekérő

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

下载 PDF

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

NAV 纳税人查询

/szamlazz ki ez a cég: 12345678-2-42

主要功能

功能	详情
发票类型	普通发票、形式发票（díjbekérő）、作废发票（storno）
增值税税率	27% / 18% / 5% / 0% / AAM，并支持 KATA
NAV 查询	根据税号自动获取公司名称和地址
合作伙伴缓存	按税号将客户信息保存在本地 partners.yaml 中
跨平台	macOS、Linux、Windows
舍入	使用 Decimal 和 ROUND_HALF_UP 保留 2 位小数
错误处理	翻译最常见的 7 种 szamlazz.hu 错误，并提供恢复步骤
安全性	API 密钥存储在操作系统凭据库中，绝不输出到 stdout

错误代码

代码	含义	解决方法
3	身份验证失败	在 szamlazz.hu 重新生成 Agent 密钥
54, 55	e-Számla 证书	使用 eszamla=false 重试
57, 259-264	计算不匹配	使用 Decimal 舍入重新计算
136	未付余额	支付 szamlazz.hu 订阅费用

提示

• 插件可由匈牙利语和英语触发词激活
• 发票属于法律文件——此技能在开具前始终会显示确认信息
• 合作伙伴缓存仅保存在本地，绝不会提交到 git
• 对于外币发票，设置 penznem 后会自动使用 MNB 汇率
• 每个会话最多重试 5 次，以防止无限循环

链接

• 插件仓库：github.com/socialproKGCMG/socialpro-szamlazz
• 插件主页：socialpro.hu/claude-code-plugins/szamlazz
• 匈牙利 AI 自动化案例研究：socialpro.hu/esettanulmanyok
• 作者：SocialPro / KG Creative Media Group Kft.