国票信息-发票查验
下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-mp876t4v--guopiao-fpcy-skill.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-mp876t4v/guopiao-fpcy-skill。国信电票平台发票查验(fpcy)- 通过发票四要素验真,返回全票面数据。
阅读全文 (展开查看完整说明)
概述
发票查验 Skill(fpcy)
前置条件:凭证配置
本 skill 依赖发票通凭证:
fpt_client_idfpt_client_secret
凭证读取优先级:
- Skill 根目录的
.env - workbuddy 环境变量
fpt_client_id/fpt_client_secret
首次使用时,如果凭证不存在:
- 询问用户的
fpt_client_id和fpt_client_secret - 如果用户没有凭证,提示:
appKey和appSecret请注册发票通平台申请 https://www.fapiao.com
- 后续调用自动读取,无需再次询问
调用发票通 MCP 服务(http://mcp.fapiao.com:8000/mcp)的 fpcy 工具进行发票查验。
命令
python scripts/fpcy.py --client-id <id> --client-secret <secret> --fphm <号码> --kprq <日期> [--fpdm <代码>] [--je <金额>] [--jym <校验码>]参数:
| 参数 | 说明 | 必填 |
|---|---|---|
--client-id | 发票通 clientID,也可设环境变量 fpt_client_id | 二选一 |
--client-secret | 发票通 clientSecret,也可设环境变量 fpt_client_secret | 二选一 |
--fphm | 发票号码 | 是 |
--kprq | 开票日期 YYYY-MM-DD | 是 |
--fpdm | 发票代码 | 非数电发票必填 |
--je | 发票金额,按发票类型填写对应金额(见下方说明) | 视发票类型 |
--jym | 校验码后6位 | 普票/电子票等必填 |
--je 金额填写说明(按发票类型):
| 发票类型 | --je 填写内容 |
|---|---|
| 增值税专用发票、增值税电子专用发票、机动车销售统一发票、数电纸质专用发票(类型代码 01、03、20、85、87) | 发票不含税金额 |
| 二手车销售统一发票、数电二手车销售发票(类型代码 15、84、88) | 发票车价合计 |
| 数电发票(全电发票)(类型代码 09、90、51、61、83、72) | 发票价税合计 |
以上类型此项不可为空。
--jym 校验码说明:
发票校验码后6位,发票类型为增值税普通发票、增值税电子普通发票、增值税普通发票(卷票)、通行费电子发票、数电通行费发票(类型代码 04、10、11、14、86)时此项不可为空。
示例:
增值税专用发票:
python scripts/fpcy.py --client-id xxx --client-secret xxx --fpdm 3200222130 --fphm 12345678 --kprq 2024-01-15 --je 100.00增值税普通发票(需校验码):
python scripts/fpcy.py --client-id xxx --client-secret xxx --fpdm 3200222130 --fphm 12345678 --kprq 2024-01-15 --jym 123456数电发票:
python scripts/fpcy.py --client-id xxx --client-secret xxx --fphm 12345678 --kprq 2024-01-15 --je 330.00结果中 code=1000 表示成功。
参数说明(用户可直接在对话中使用)
用户在对话中只需提供发票信息,AI 会自动解析并调用工具。以下是用户常见表达方式与参数的对应关系:
| 用户自然语言示例 | 实际调用参数 |
|---|---|
| 帮我查一张发票,fpdm=3200222130,fphm=12345678,kprq=2024-01-15,je=100.00 | --fpdm 3200222130 --fphm 12345678 --kprq 2024-01-15 --je 100.00 |
| 查验这张普票,号码12345678,日期2024-01-15,校验码后六位是123456 | --fphm 12345678 --kprq 2024-01-15 --jym 123456 |
| 数电票查验,号码12345678,开票日期2024-01-15,价税合计330元 | --fphm 12345678 --kprq 2024-01-15 --je 330.00 |
| 查一下这张专票,代码3200222130,号码12345678,日期2024-01-15,不含税金额100 | --fpdm 3200222130 --fphm 12345678 --kprq 2024-01-15 --je 100.00 |