SuperAPI AI 工具集

pp-pop

编程与开发

查看项目

更新于 10-16 01:32

技能介绍

用途:该技能驱动 pop-pp-cli 命令行工具,面向欧洲电子发票工作流,提供发票生成与 PEPPOL、SdI 文档管理能力。

主要能力:

  • create-pdf:生成品牌 PDF 发票,可按账户设置与载荷可选发送邮件。
  • create-ubl:生成 PEPPOL BIS / UBL 发票,可选通过 POP 的 PEPPOL 集成提交至网络。
  • create-xml:生成意大利 FatturaPA XML 发票,可选提交至 SdI。
  • peppol get-document:按 UUID 和可选 zone 从 POP 获取 PEPPOL 文档。
  • sdi 子命令:查询发票状态、按 UUID 获取已存 SdI 文档、归档已接受的 SdI 文档至长期存储、校验 Base64 编码的 SdI XML。
  • which:用自然语言查询匹配命令,退出码 0 表示有匹配,2 表示无匹配。

使用方式:

  1. 安装 CLI:npx -y @mvanhorn/printing-press-library install pop --cli-only;若失败可用 Go 1.26.6+ 执行 go install github.com/mvanhorn/printing-press-library/library/payments/pop/cmd/pop-pp-cli@latest。验证:pop-pp-cli --version,确保安装目录在 PATH 中。
  2. 配置认证:pop-pp-cli auth setup 获取密钥地址,设置 export POP_API_KEY="<your-key>" 或写入 ~/.config/pop-pp-cli/config.toml,之后运行 pop-pp-cli doctor 验证。
  3. 调用命令:pop-pp-cli <command> [subcommand] [args] --agent。--agent 展开为 --json --compact --no-input --no-color --yes;支持 --select 字段筛选、--dry-run 预览、--deliver <sink> 输出至 stdout/file/webhook。
  4. MCP:go install .../cmd/pop-pp-mcp@latest,然后 claude mcp add pop-pp-mcp -- pop-pp-mcp。

适用场景:需要通过 CLI 或 MCP 自动化处理欧洲电子发票生成与提交、PEPPOL/SdI 文档获取与归档、面向智能体的非交互式工作流。

限制:POP 返回形式(直接文件、URL 等)取决于账户设置与载荷;必须先安装并验证 CLI,未通过验证不应继续执行技能命令;--idempotent 仅在已存在的创建应视为成功时使用;webhook 失败返回非零并在 stderr 记录 URL 与 HTTP 状态;反馈默认仅本地存储。部分命令细节与 POP 载荷要求以 --help 为准。