# Jisu Invoiceverify

> 使用极速数据发票查验 API，根据发票代码、号码、日期和金额等信息查询发票详情，并获取可用的发票类型列表。

- Skill: `dvcrn/jisu-invoiceverify` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add dvcrn/jisu-invoiceverify`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/jisu-invoiceverify/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/jisu-invoiceverify

---


## 极速数据发票查验（Jisu InvoiceVerify）

基于 [发票查验 API](https://www.jisuapi.com/api/invoiceverify/) 的 OpenClaw 技能，
可以通过发票代码、发票号码、开票日期、合计金额、校验码等信息获取发票详情，
也支持获取平台支持的发票类型列表。

使用技能前需要申请数据，申请地址：https://www.jisuapi.com/api/invoiceverify/

## 环境变量配置

```bash
# 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` 接口，根据发票号、开票日期及金额等信息查验发票。

```bash
python3 skills/invoiceverify/invoiceverify.py verify '{"number":"61124608","date":"2019-06-15","code":"033001800311","extaxtotalfee":"2388.46","checkcode":"62057237940487749830"}'
```

请求 JSON 示例：

```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` 字段内容，结构与官网示例一致，典型示例可参考
[官网文档](https://www.jisuapi.com/api/invoiceverify/) 中的 JSON：

```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` 接口获取平台支持的发票类型列表。

```bash
python3 skills/invoiceverify/invoiceverify.py type
```

返回结果示例：

```json
[
  {
    "type": "01",
    "name": "增值税专用发票"
  },
  {
    "type": "02",
    "name": "货运运输业增值税专用发票"
  },
  {
    "type": "03",
    "name": "机动车销售统一发票"
  },
  {
    "type": "04",
    "name": "增值税普通发票"
  },
  {
    "type": "10",
    "name": "增值税普通发票（电子）"
  }
]
```

### 常见错误码（业务错误）

来自 [极速数据发票查验文档](https://www.jisuapi.com/api/invoiceverify/) 的业务错误码：

| 代号 | 说明                                |
|------|-------------------------------------|
| 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 中的推荐用法

1. 用户提供发票信息（发票代码、号码、开票日期、金额、校验码等）。  
2. 代理根据需要构造 JSON 请求体，例如：  
   `{"code":"033001800311","number":"61124608","date":"2019-06-15","extaxtotalfee":"2388.46","checkcode":"62057237940487749830"}`。  
3. 调用：`python3 skills/invoiceverify/invoiceverify.py verify '<JSON_BODY>'`。  
4. 从返回结果中读取销售方、购买方、税额、发票状态、明细行等信息，并向用户总结发票是否有效及其关键信息。  
5. 如需提示发票类型选择，可先调用 `python3 skills/invoiceverify/invoiceverify.py type` 获取支持的发票类型列表，为用户解释不同发票类型的含义。