发票查验(invoice-verify) - 慧穗云

发票查验-慧穗云（Invoice Verify）

基于慧穗云官方 API 的发票查验技能，支持通过发票代码、号码、开票日期、金额等信息查验发票真伪。

环境变量配置

# Linux / macOS
export HSY_API_URL="https://huisuiyun.com"
export HSY_AK="your_ak_here"
export HSY_SK="your_sk_here"
export HSY_TYPE="2"  # 1: ISV等级AKSK, 2: 慧穗云等级AKSK

# Windows PowerShell
$env:HSY_API_URL="https://huisuiyun.com"
$env:HSY_AK="your_ak_here"
$env:HSY_SK="your_sk_here"
$env:HSY_TYPE="2"

获取 AK/SK：

• 慧穗云秘钥管理：https://huisuiyun.com/account/conf/secretkey

注意： 如果未配置环境变量，脚本会返回包含配置链接的错误信息，方便用户快速获取秘钥。

脚本路径

脚本文件：skills/invoice-verify-hsy/invoice-verify-hsy.py

使用方式

1. 查验发票信息

通过 /api/v2/agent/cdk/invoice/check 接口查验增值税发票接口文档

python3 skills/invoice-verify-hsy/invoice-verify-hsy.py verify '{"storeFlag":0,"invoiceList":[{"invoiceCode":"3300201130","invoiceNo":"00517731","amount":7559.41,"drewDate":"2021-06-22","invoiceType":"01"}]}'

请求 JSON 示例：

{
  "storeFlag": 0,
  "invoiceList": [
    {
      "invoiceCode": "3300201130",
      "invoiceNo": "00517731",
      "amount": 7559.41,
      "drewDate": "2021-06-22",
      "invoiceType": "01"
    }
  ]
}

请求参数（verify）

invoiceList 数组中每个对象的字段：

返回结果示例（verify）

{
  "code": "200",
  "message": "OK",
  "serialNo": "637680840671330304",
  "data": [
    {
      "checkFlag": true,
      "invoiceCodeNo": "3300201130-00517731",
      "exceptionInfo": null,
      "invoiceVO": {
        "invoiceType": "01",
        "invoiceCode": "3300201130",
        "invoiceNo": "00517731",
        "drewDate": "2021-06-22",
        "checkCode": "56660956691714098653",
        "amount": 7559.41,
        "amountWithTax": 7635,
        "taxAmount": 75.59,
        "sellerName": "杭州江湖有旅人********公司",
        "sellerTaxNo": "91330100MA2H3LL62A",
        "purchaserName": "慧穗数字科技（上海）********司",
        "purchaserTaxNo": "91330108********U",
        "invoiceStatus": 0,
        "detailList": [
          {
            "goodsName": "*设计服务*活动策划",
            "amount": 7559.41,
            "taxRate": 1,
            "taxAmount": 75.59
          }
        ]
      }
    }
  ]
}

返回参数说明

常见错误码

注意事项

1. 本接口支持多发票查验，一次查验张数应不大于20张
2. 同一张票每天最多可以查验5次
3. Token 有效期为30天，超出有效期后需重新获取
4. 全电发票查验时发票类型必填
5. 专票传入不含税金额，数电发票传入价税合计
6. 普票必须传入校验码后六位

在 OpenClaw 中的推荐用法

1. 用户提供发票信息（发票代码、号码、开票日期、金额等）
2. 代理构造 JSON 请求体，根据发票类型填写相应的必填字段
3. 调用：python3 skills/invoice-verify-hsy/invoice-verify-hsy.py verify '\x3CJSON_BODY>'
4. 从返回结果中读取查验状态和发票详细信息，并向用户总结发票是否有效及关键信息

如需了解更多欢迎扫码联系