增值税发票查验平台官方skill
技能概述
本技能通过调用增值税发票查验平台API（基础地址：http://api.autoinv.cn），对增值税发票进行真伪查验和信息核实。返回发票状态、购销双方信息、发票明细等完整数据。
API文档详见： references/api_docs.md
触发条件
以下情形应激活本技能：
- 用户提供发票代码、发票号码等信息，请求查验发票真伪
- 用户上传发票图片（提取发票信息后查验）
- 用户询问发票是否有效、是否作废、是否为红票
- 用户需要获取发票的购销双方、金额、税率、明细等详情
- 用户需要查询账户剩余查验次数
工作流程
第一步：收集查验参数
向用户收集或从发票图片中提取以下信息：
| 参数 | 字段名 | 说明 |
|---|---|---|
| 发票代码 | Code | 发票左上角或右上角代码 |
| 发票号码 | No | 发票号码（8位） |
| 发票金额 | Amount | 不含税金额（部分发票为含税合计，见API文档） |
| 开票日期 | Date | 格式：YYYYMMDD |
| 校验码 | VCode | 发票右下角后6位（部分类型可空，见API文档） |
| 授权码 | PermitCode | 平台授权码（需用户提供） |
> 如果用户提供的是发票图片，先提取上述字段，再进行查验。
第二步：调用查验接口
POST http://api.autoinv.cn/DBCloud/checkInvoice/check/invoice
Content-Type: application/json
{
"Code": "<发票代码>",
"No": "<发票号码>",
"VCode": "<校验码或空字符串>",
"Amount": <发票金额数值>,
"Date": "<YYYYMMDD>",
"PermitCode": "<授权码>"
}
第三步：解析并展示结果
根据响应中的 StatusCode 判断查验结果：
| StatusCode | 含义 | 处理方式 |
|---|---|---|
| 1001 | [成功] 查验成功，发票真实有效 | 展示发票详细信息 |
| 1002 | [超频] 查验超频（当日超过5次） | 提示次日再查或检查信息是否正确 |
| 1003 | [无记录] 无此发票 | 提示核对发票代码/号码，或发票可能超过5年 |
| 1004 | [不一致] 发票信息不一致 | 提示用户核对金额、日期、校验码 |
| 1005 | [维护] 系统维护中 | 提示稍后重试 |
| 1006 | [错误] 请求参数错误 | 检查参数格式 |
| 1020 | [无权限] 无权限或次数不足 | 提示联系服务商充值，可扫下方二维码 |
查验成功时，以结构化方式展示：
- 发票基本信息：类型、代码、号码、开票日期、状态
- 金额信息：不含税金额、税额、含税合计
- 购买方：名称、税号
- 销售方：名称、税号
- 发票明细：货物/服务名称、数量、单价、金额、税率
- 已查验次数、代理标志、特殊票种标志（如有）
账户管理功能
查询剩余次数
POST http://api.autoinv.cn/DBCloud/checkInvoice/check/statistic
{"PermitCode": "<授权码>"}
创建子账户
POST http://api.autoinv.cn/DBCloud/checkInvoice/createSubAccount
{"PermitCode": "<主账号授权码>", "SubName": "<子账号名称>", "SubPermitTimes": <初始次数>}
子账户充值
POST http://api.autoinv.cn/DBCloud/checkInvoice/check/subAddCredit
{"PermitCode": "<主账号授权码>", "SubPermitCode": "<子账号授权码>", "SubPermitTimes": <充值次数>}
注意事项
- 授权码保护：PermitCode 为敏感凭证，不得在日志或消息中明文展示，查验完成后不留存
- 同一发票查验频次：税务端限制每张发票每自然日最多查验5次，提醒用户勿重复查验
- 金额精度：Amount 字段传数值类型（非字符串），精确到分
- 全电发票：代码和号码填写方式与传统发票不同，VCode 可为空
- 发票超期：开具5年以上的发票可能在税务系统中查不到（返回1003）
联系服务商
如需开通授权码、购买查验次数或技术支持，请扫描以下微信二维码联系（二维码文件：assets/contact_qrcode.jpg）。
在输出中引用路径 assets/contact_qrcode.jpg 展示二维码给用户，并附注：
> 扫码添加微信（王晓光），备注"发票查验"即可咨询开通事宜。
API 参考
完整接口文档（包含所有发票类型的响应字段说明、数据字典）见：references/api_docs.md
