增值税发票查验平台官方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