用途:在 Claude Code 中直接管理匈牙利发票,调用 szamlazz.hu Agent API 完成开票、取消(storno)、下载 PDF 等操作。由 SocialPro 开发。
主要能力:支持普通发票、形式发票(díjbekérő)和 storno 取消;增值税税率覆盖 27%/18%/5%/0%/AAM 及 KATA;按税号自动从 NAV 获取公司名称与地址;本地 partners.yaml 缓存客户;使用 Decimal 精度并按 ROUND_HALF_UP 保留两位小数;跨 macOS、Linux、Windows;内置 7 类常见错误的中文提示与恢复步骤;API 密钥存于操作系统凭据库,不回显到 stdout。
使用方式:需先安装插件 socialpro-szamlazz,Python 3.9+ 与 PyYAML(pip install pyyaml),并在 szamlazz.hu 生成 Agent API 密钥。安装命令: /plugin marketplace add socialproKGCMG/socialpro-plugins /plugin install szamlazz@socialpro-plugins 首次运行会检测缺失配置,询问 API 密钥、卖方税号(NAV 自动查询)和银行账户(自动识别),并写入 seller.yaml。常用命令示例: /szamlazz állíts ki egy számlát Példa Kft.-nek 150 000 Ft-ról webfejlesztésről /szamlazz sztornózd a SOC-2026-0042 számlát /szamlazz díjbekérő Acme Ltd-nek 500 EUR-ról konzultációért /szamlazz töltsd le a SOC-2026-0042 PDF-jét /szamlazz ki ez a cég: 12345678-2-42
适用场景:匈牙利语或英语触发词均可激活;适合需要开具匈牙利发票、形式发票、取消发票、下载 PDF 或查询 NAV 公司信息的用户。
限制:发票为法律文件,开具前技能总会显示确认;合作伙伴缓存仅本地保存,不提交到 git;外币发票需设置 penznem,汇率自动使用 MNB;每会话最多重试 5 次以防死循环。错误码 3 表示认证失败,54/55 为电子发票证书问题(可用 eszamla=false 重试),57 与 259-264 为计算不匹配,136 为 szamlazz.hu 订阅欠费。其余细节暂未提供。