invoiceverify
v1.0.2使用极速数据发票查验 API，根据发票代码、号码、日期和金额等信息查询发票详情，并获取可用的发票类型列表。
Sourced from ClawHub,
Authored by 极速数据
Installation
Please help me install the skill `invoiceverify` from SkillHub official store.
npx skills add jisuapi/invoiceverify
极速数据发票查验（Jisu InvoiceVerify）
基于 发票查验 API 的 OpenClaw 技能， 可以通过发票代码、发票号码、开票日期、合计金额、校验码等信息获取发票详情， 也支持获取平台支持的发票类型列表。
使用技能前需要申请数据，申请地址：https://www.jisuapi.com/api/invoiceverify/
环境变量配置
# Linux / macOS
export JISU_API_KEY="your_appkey_here"
# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"
脚本路径
脚本文件：skills/invoiceverify/invoiceverify.py
使用方式
1. 查验发票信息
通过 /invoiceverify/verify 接口，根据发票号、开票日期及金额等信息查验发票。
python3 skills/invoiceverify/invoiceverify.py verify '{"number":"61124608","date":"2019-06-15","code":"033001800311","extaxtotalfee":"2388.46","checkcode":"62057237940487749830"}'
请求 JSON 示例：
{
"code": "033001800311",
"number": "61124608",
"date": "2019-06-15",
"extaxtotalfee": "2388.46",
"checkcode": "62057237940487749830",
"sellercreditno": ""
}
请求参数（verify）
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | int | 否 | 发票代码 |
| number | int | 是 | 发票号码 |
| date | string | 是 | 开票日期（格式：YYYY-MM-DD） |
| extaxtotalfee | string | 否 | 合计金额（不含税，与 totalfee 二选一） |
| totalfee | string | 否 | 价税合计（与 extaxtotalfee 二选一） |
| checkcode | string | 否 | 校验码（部分场景必填） |
| sellercreditno | int | 否 | 销方税号（区块链发票必填） |
返回结果示例（verify）
脚本会直接输出接口 result 字段内容，结构与官网示例一致，典型示例可参考
官网文档 中的 JSON：
{
"number": "61120000",
"code": "033001800000",
"seller": "杭州XXXXX有限公司",
"sellercreditno": "913301833000000000",
"sellerbank": "交通银行浙江分行富阳支行 300000060010100002000",
"selleraddress": "杭州富阳区xxxxx路xx号x幢x层 0571-60000000",
"buyer": "个人",
"buyercreditno": "",
"buyerbank": "",
"buyeraddress": "",
"totalfee": "2698.95",
"extaxtotalfee": "2388.46",
"date": "2019-06-15",
"totaltax": "310.49",
"type": "10",
"remark": "订单号:97670000000 IMEI:868237000000000",
"district": "浙江",
"machinecode": "661620000000",
"checkcode": "62050000040000000000",
"state": 1,
"itemlist": [
{
"name": "*移动通信设备*荣耀20 麒麟Kirin980全网通版",
"type": "",
"unit": "",
"num": "0.0",
"price": "0.0",
"totalfee": "0.00",
"taxrate": "0.13",
"taxfee": "00000000.00"
},
{
"name": "*移动通信设备*荣耀20 麒麟Kirin980全网通版",
"type": "荣耀20",
"unit": "台",
"num": "1.0",
"price": "2388.49557522",
"totalfee": "2388.50",
"taxrate": "0.13",
"taxfee": "00000310.50"
}
]
}
2. 获取发票类型列表
通过 /invoiceverify/type 接口获取平台支持的发票类型列表。
python3 skills/invoiceverify/invoiceverify.py type
返回结果示例：
[
{
"type": "01",
"name": "增值税专用发票"
},
{
"type": "02",
"name": "货运运输业增值税专用发票"
},
{
"type": "03",
"name": "机动车销售统一发票"
},
{
"type": "04",
"name": "增值税普通发票"
},
{
"type": "10",
"name": "增值税普通发票（电子）"
}
]
常见错误码（业务错误）
来自 极速数据发票查验文档 的业务错误码：
| 代号 | 说明 |
|---|---|
| 201 | 发票信息不一致（扣次数） |
| 202 | 发票查验失败 |
| 203 | 所查发票不存在（扣次数） |
| 204 | 发票代码为空 |
| 205 | 发票号码为空 |
| 206 | 开票日期为空 |
| 207 | 合计金额为空 |
| 208 | 校验码为空 |
| 209 | 校验码小于 6 位 |
| 210 | 未知错误 |
| 211 | 该票在平台核验失败已超 5 次（扣次数） |
| 212 | 校验码小于 5 位（区块链发票 5 位必填） |
| 213 | 销方税号为空（区块链发票必填） |
系统错误码
| 代号 | 说明 |
|---|---|
| 101 | APPKEY 为空或不存在 |
| 102 | APPKEY 已过期 |
| 103 | APPKEY 无请求此数据权限 |
| 104 | 请求超过次数限制 |
| 105 | IP 被禁止 |
| 106 | IP 请求超过限制 |
| 107 | 接口维护中 |
| 108 | 接口已停用 |
在 OpenClaw 中的推荐用法
- 用户提供发票信息（发票代码、号码、开票日期、金额、校验码等）。
- 代理根据需要构造 JSON 请求体，例如：
{"code":"033001800311","number":"61124608","date":"2019-06-15","extaxtotalfee":"2388.46","checkcode":"62057237940487749830"}。 - 调用：
python3 skills/invoiceverify/invoiceverify.py verify '<JSON_BODY>'。 - 从返回结果中读取销售方、购买方、税额、发票状态、明细行等信息，并向用户总结发票是否有效及其关键信息。
- 如需提示发票类型选择，可先调用
python3 skills/invoiceverify/invoiceverify.py type获取支持的发票类型列表，为用户解释不同发票类型的含义。