企业财税发票查验
当用户希望查验数电票或传统发票、查询今日查验额度、或询问查验字段时,使用本技能。
本技能已包含调用脚本。不要要求用户自行配置 MCP、填写服务器地址或安装企业软件。
执行方式
使用包内 scripts/invoke_mcp.py 调用企业远程服务。脚本只使用 Python 3.7+ 标准库,通过 HTTPS 访问服务,不需要安装第三方 Python 包。
- 查验发票:
python3 scripts/invoke_mcp.py verify_invoice --fpdm "" --fphm "26317000001632133002" --kprq "20260514" --kpje "1474.61"
- 查询今日额度:
python3 scripts/invoke_mcp.py get_daily_usage
若当前环境将 Python 3 命令命名为 python,可将 python3 替换为 python。
查验流程
- 判断用户查验的是数电票还是传统发票;无法判断时询问,不要猜测。
- 收集
fpdm、fphm、kprq、kpje。字段说明见 @references/invoice-fields.md。 - 数电票的
fpdm可以为空;fphm使用完整 20 位号码。 - 数电票的
kpje为价税合计;传统普通发票通常为校验码后 6 位;传统专票、机动车票和二手车票通常为不含税金额。 - 调用前复述发票号码、开票日期和查验值,请用户确认。不得让用户在对话中提交 API Key。
- 使用脚本调用
verify_invoice。默认通道为new;只有用户明确要求旧通道时才添加--channel old。 - 不要因新通道失败而自动切换旧通道或连续重复查验。
- 读取脚本返回的 JSON,结合系统状态、业务结论和
quota说明结果;不要仅根据外层成功字段判断真伪。 - 用简明中文输出查验结论、票种、金额、购销方和剩余额度,只展示完成当前任务所需的信息。
异常处理
- 参数不完整:只补问缺失字段,暂不执行脚本。
- 服务超时或不可用:说明暂时无法查验,不连续重试。
- 返回结构不完整:不要推断真伪或补造信息。
- 当前运行环境没有 Python:说明该 Agent 环境不支持执行本技能的调用脚本;不得假装已查验。
隐私
发票号码、税号、购销方信息和金额属于敏感业务数据。不要在无关上下文重复展示完整票面信息,不保存或输出 API Key。