← 返回 Skills 市场
443
总下载
9
收藏
0
当前安装
5
版本数
在 OpenClaw 中安装
/install invoiceverify
功能描述
按发票代码、号码、日期、金额等查验发票真伪与详情。当用户说：帮我验一下这张增值税发票、这张票能不能报销查验？或类似发票查验时，使用本技能。
使用说明 (SKILL.md)
\r \r
极速数据发票查验（Jisu InvoiceVerify）\r
\r
数据由 极速数据（JisuAPI） 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。\r 可以通过发票代码、发票号码、开票日期、合计金额、校验码等信息获取发票详情，\r 也支持获取平台支持的发票类型列表。\r \r
前置配置：获取 API Key\r
\r
# Linux / macOS\r
export JISU_API_KEY="your_appkey_here"\r
\r
# Windows PowerShell\r
$env:JISU_API_KEY="your_appkey_here"\r
```\r
\r
## 脚本路径\r
\r
脚本文件：`skills/invoiceverify/invoiceverify.py`\r
\r
## 使用方式\r
\r
### 1. 查验发票信息\r
\r
通过 `/invoiceverify/verify` 接口，根据发票号、开票日期及金额等信息查验发票。\r
\r
```bash\r
python3 skills/invoiceverify/invoiceverify.py verify '{"number":"61124608","date":"2019-06-15","code":"033001800311","extaxtotalfee":"2388.46","checkcode":"62057237940487749830"}'\r
```\r
\r
请求 JSON 示例：\r
\r
```json\r
{\r
"code": "033001800311",\r
"number": "61124608",\r
"date": "2019-06-15",\r
"extaxtotalfee": "2388.46",\r
"checkcode": "62057237940487749830",\r
"sellercreditno": ""\r
}\r
```\r
\r
### 请求参数（verify）\r
\r
| 字段名 | 类型 | 必填 | 说明 |\r
|----------------|--------|------|----------------------------------------|\r
| code | int | 否 | 发票代码 |\r
| number | int | 是 | 发票号码 |\r
| date | string | 是 | 开票日期（格式：YYYY-MM-DD） |\r
| extaxtotalfee | string | 否 | 合计金额（不含税，与 totalfee 二选一）|\r
| totalfee | string | 否 | 价税合计（与 extaxtotalfee 二选一） |\r
| checkcode | string | 否 | 校验码（部分场景必填） |\r
| sellercreditno | int | 否 | 销方税号（区块链发票必填） |\r
\r
### 返回结果示例（verify）\r
\r
脚本会直接输出接口 `result` 字段内容，结构与官网示例一致，典型示例可参考\r
[官网文档](https://www.jisuapi.com/api/invoiceverify/) 中的 JSON：\r
\r
```json\r
{\r
"number": "61120000",\r
"code": "033001800000",\r
"seller": "杭州XXXXX有限公司",\r
"sellercreditno": "913301833000000000",\r
"sellerbank": "交通银行浙江分行富阳支行 300000060010100002000",\r
"selleraddress": "杭州富阳区xxxxx路xx号x幢x层 0571-60000000",\r
"buyer": "个人",\r
"buyercreditno": "",\r
"buyerbank": "",\r
"buyeraddress": "",\r
"totalfee": "2698.95",\r
"extaxtotalfee": "2388.46",\r
"date": "2019-06-15",\r
"totaltax": "310.49",\r
"type": "10",\r
"remark": "订单号:97670000000 IMEI:868237000000000",\r
"district": "浙江",\r
"machinecode": "661620000000",\r
"checkcode": "62050000040000000000",\r
"state": 1,\r
"itemlist": [\r
{\r
"name": "*移动通信设备*荣耀20 麒麟Kirin980全网通版",\r
"type": "",\r
"unit": "",\r
"num": "0.0",\r
"price": "0.0",\r
"totalfee": "0.00",\r
"taxrate": "0.13",\r
"taxfee": "00000000.00"\r
},\r
{\r
"name": "*移动通信设备*荣耀20 麒麟Kirin980全网通版",\r
"type": "荣耀20",\r
"unit": "台",\r
"num": "1.0",\r
"price": "2388.49557522",\r
"totalfee": "2388.50",\r
"taxrate": "0.13",\r
"taxfee": "00000310.50"\r
}\r
]\r
}\r
```\r
\r
### 2. 获取发票类型列表\r
\r
通过 `/invoiceverify/type` 接口获取平台支持的发票类型列表。\r
\r
```bash\r
python3 skills/invoiceverify/invoiceverify.py type\r
```\r
\r
返回结果示例：\r
\r
```json\r
[\r
{\r
"type": "01",\r
"name": "增值税专用发票"\r
},\r
{\r
"type": "02",\r
"name": "货运运输业增值税专用发票"\r
},\r
{\r
"type": "03",\r
"name": "机动车销售统一发票"\r
},\r
{\r
"type": "04",\r
"name": "增值税普通发票"\r
},\r
{\r
"type": "10",\r
"name": "增值税普通发票（电子）"\r
}\r
]\r
```\r
\r
### 常见错误码（业务错误）\r
\r
来自 [极速数据发票查验文档](https://www.jisuapi.com/api/invoiceverify/) 的业务错误码：\r
\r
| 代号 | 说明 |\r
|------|-------------------------------------|\r
| 201 | 发票信息不一致（扣次数） |\r
| 202 | 发票查验失败 |\r
| 203 | 所查发票不存在（扣次数） |\r
| 204 | 发票代码为空 |\r
| 205 | 发票号码为空 |\r
| 206 | 开票日期为空 |\r
| 207 | 合计金额为空 |\r
| 208 | 校验码为空 |\r
| 209 | 校验码小于 6 位 |\r
| 210 | 未知错误 |\r
| 211 | 该票在平台核验失败已超 5 次（扣次数）|\r
| 212 | 校验码小于 5 位（区块链发票 5 位必填）|\r
| 213 | 销方税号为空（区块链发票必填） |\r
\r
### 系统错误码\r
\r
| 代号 | 说明 |\r
|------|--------------------------|\r
| 101 | APPKEY 为空或不存在 |\r
| 102 | APPKEY 已过期 |\r
| 103 | APPKEY 无请求此数据权限 |\r
| 104 | 请求超过次数限制 |\r
| 105 | IP 被禁止 |\r
| 106 | IP 请求超过限制 |\r
| 107 | 接口维护中 |\r
| 108 | 接口已停用 |\r
\r
## 推荐用法\r
\r
1. 用户提供发票信息（发票代码、号码、开票日期、金额、校验码等）。 \r
2. 代理根据需要构造 JSON 请求体，例如： \r
`{"code":"033001800311","number":"61124608","date":"2019-06-15","extaxtotalfee":"2388.46","checkcode":"62057237940487749830"}`。 \r
3. 调用：`python3 skills/invoiceverify/invoiceverify.py verify '\x3CJSON_BODY>'`。 \r
4. 从返回结果中读取销售方、购买方、税额、发票状态、明细行等信息，并向用户总结发票是否有效及其关键信息。 \r
5. 如需提示发票类型选择，可先调用 `python3 skills/invoiceverify/invoiceverify.py type` 获取支持的发票类型列表，为用户解释不同发票类型的含义。\r
\r
## 关于极速数据\r
\r
**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下API：\r
\r
- **生活常用**：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息 \r
- **工具万能**：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测 \r
- **交通出行**：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询 \r
- **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别 \r
- **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令 \r
- **位置服务**：基站查询，经纬度地址转换，坐标系转换 \r
\r
在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在API详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。\r
\r
安全使用建议
This skill appears to do what it claims: it calls JisuAPI to verify invoice details and only needs the JISU_API_KEY. Before installing, ensure you: 1) provide a valid JISU_API_KEY and do not share it publicly (the key grants queries to your JisuAPI account); 2) allow outbound HTTPS to api.jisuapi.com because the script makes network calls; 3) install the Python 'requests' package in the runtime (the script requires it but the skill metadata does not declare it); 4) review JisuAPI pricing/rate limits and data-retention policies (requests consume your quota and may include sensitive invoice data); and 5) if you have strict security policies, consider running the script in an isolated environment since it transmits invoice data to a third-party API. Overall the skill is internally coherent and not suspicious, aside from the undeclared dependency.
功能分析
Type: OpenClaw Skill
Name: invoiceverify
Version: 1.0.4
The skill is a legitimate wrapper for the JisuAPI invoice verification service. The Python script (invoiceverify.py) correctly handles authentication via environment variables and uses the standard requests library to communicate with the official API endpoint (api.jisuapi.com). No evidence of data exfiltration, malicious execution, or prompt injection was found.
能力评估
Purpose & Capability
Name/description, SKILL.md, and the Python script all implement invoice verification via JisuAPI. The required env var JISU_API_KEY and the external endpoints (api.jisuapi.com) align with the stated purpose; required binary python3 is reasonable.
Instruction Scope
Runtime instructions tell the agent to call the included script with a JSON payload and to set JISU_API_KEY. The script only reads the provided JSON and JISU_API_KEY and issues HTTPS requests to api.jisuapi.com; it does not read unrelated files, system credentials, or forward data to unexpected endpoints.
Install Mechanism
There is no install spec (instruction-only), which is low risk. However, the included Python script depends on the third‑party 'requests' package which is not declared in the metadata or install instructions — a functional/dependency mismatch (operational, not obviously malicious). Ensure the runtime has requests available or add an install step (pip install requests).
Credentials
Only a single API credential (JISU_API_KEY) is required and is the stated primary credential. No other secrets, config paths, or unrelated environment variables are requested.
Persistence & Privilege
The skill is not always-enabled and does not request system-wide persistence. It does not modify other skills or system config. Autonomous invocation is allowed (platform default) but is not combined with other red flags.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install invoiceverify - 安装完成后，直接呼叫该 Skill 的名称或使用
/invoiceverify触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.4
- Skill name updated to "Invoice Verification - 发票查验" with a clearer, user-focused description.
- Invocation prompt refined for more natural language triggers, e.g., "帮我验一下这张增值税发票".
- No code or file changes; documentation and metadata updates only.
- Main usage, API details, and examples are unchanged.
v1.0.3
- 补充了“关于极速数据”介绍，详细说明了数据来源及其 API 产品线
- 强化了前置配置说明，新增引导用户注册、获取 AppKey 的具体步骤
- 优化了描述和排版，使文档更易读、更适合新用户快速上手
- 去除了冗余和重复的说明，推荐用法部分更简明
- 文件内容更新，未检测到脚本代码变动
v1.0.2
Version 1.0.2 of invoiceverify
- No functional or documentation changes were detected in this release.
- The version was updated with no modifications to files.
v1.0.1
- No user-facing changes in this version.
- Documentation and functionality remain unchanged from the previous release.
v1.0.0
Initial release of jisu-invoiceverify:
- Provides invoice verification and details retrieval using 极速数据发票查验 API via Python script.
- Supports querying invoice details using invoice code, number, date, amount, and check code.
- Allows fetching the supported invoice type list.
- Requires JISU_API_KEY environment variable for API access.
- Returns detailed invoice information and error codes based on API responses.
- Includes usage instructions and sample commands for easy integration.
元数据
常见问题
Invoice Verification - 发票查验 是什么？
按发票代码、号码、日期、金额等查验发票真伪与详情。当用户说：帮我验一下这张增值税发票、这张票能不能报销查验？或类似发票查验时，使用本技能。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 443 次。
如何安装 Invoice Verification - 发票查验？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install invoiceverify」即可一键安装，无需额外配置。
Invoice Verification - 发票查验 是免费的吗？
是的，Invoice Verification - 发票查验 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Invoice Verification - 发票查验 支持哪些平台？
Invoice Verification - 发票查验 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Invoice Verification - 发票查验？
由 极速数据（@jisuapi）开发并维护，当前版本 v1.0.4。
推荐 Skills