Agent Skills
返回列表
⚖️

国票信息发票查验

行业专业 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-mp876t4v/guopiao-fpcy-skill。

技能介绍

发票真伪核验与数据一致性校验是财务自动化流程中的高频痛点。在对接报销、入账或税务合规场景时,人工比对纸质或电子发票字段不仅耗时,且极易因录入错误或篡改导致合规风险。

核心能力与工作原理

本技能封装了发票通平台的 MCP 服务接口,通过标准化的 fpcy 工具提供自动化发票查验能力。其工作流程分为凭证配置与参数解析两个阶段:

  • 凭证读取:优先从 Skill 根目录的 .env 文件获取 fpt_client_id 与 fpt_client_secret,若缺失则回退至 workbuddy 环境变量,并允许在对话中交互式获取。
  • 参数映射:支持用户以自然语言描述发票信息,AI 自动将其解析为查验所需的核心字段。
  • 金额与校验码处理:根据发票代码智能适配不同票种的填单规则。例如,数电发票需传入价税合计,而机动车或二手车发票则需传入不含税金额或车价合计;对于普通发票,严格校验校验码后 6 位。
  • 结果判定:调用远端接口后,通过返回码 code=1000 判定查验成功,并输出结构化结果。

适用边界与集成注意

在实际接入时,需注意不同票种对必填参数的硬性约束。非数电发票必须提供发票代码(--fpdm),而特定类型的普通发票若缺失 --jym 校验码将直接导致查验失败。此外,凭证的安全性至关重要,建议通过环境变量注入敏感信息,避免将 client_secret 硬编码在代码或配置文件中。开发者需确保网络环境能够正常访问 http://mcp.fapiao.com:8000/mcp。

使用场景

  • 报销审批高峰期需要快速验证多张员工提交的电子发票是否符合税务规范。
  • 财务收到大额增值税专用发票后需在入账前核对发票代码、金额与校验码。
  • 数电发票越来越多,需要快速核验价税合计是否与交易金额匹配。
  • 通行费电子发票报销时,需确认开票日期和校验码后六位的有效性。

适合人员

  • 财务主管:需要确保报销发票真实有效以避免税务合规风险
  • 企业内部审计人员:季度审计时需批量抽查可疑发票的真实性
  • 报销平台开发者:需要在系统中集成发票自动查验功能
  • 税务专员:需要根据不同发票类型填写正确金额进行批量核验