湖北航信商品智能赋码

作者 admin

2026年11月7日 3 分钟阅读

0 0

下载地址

代码

https://www.zhengdianxue.com/wp-content/uploads/skills/org-wl7ywliy--hbhtxx-tax-code.zip

将提示词发送给你的 AI 安装该 skills

代码

请根据 https://skillhub.cn/install/skillhub.md，安装 @org-wl7ywliy/hbhtxx-tax-code。

根据商品名称自动匹配税收分类编码，依托湖北航信商品智能编码平台，支持智能语义匹配。可一次性完成单商品或批量商品的税收分类编码推荐，提高开票效率。

阅读全文（展开查看完整说明）

概述

商品智能赋码（Hbhtxx Tax Code）

功能概述

支持两种查询模式：

正向查询：商品名称 → 税收分类编码（默认）
反向查询：税收分类编码 → 商品/服务/项目名称

使用场景

开票前为商品清单自动匹配税收分类编码
商品主数据维护时批量赋码
ERP/进销存系统对接，自动获取税收分类编码
税务申报前的商品编码合规性检查
通过税收分类编码反向查询对应的商品/服务名称

核心规则与约束

单用户 5 QPS，超出返回 HTTP 429
30 秒超时
单次批量 ≤ 100 条
语义匹配，非精确匹配；返回置信度最高的编码
按次计费，每次调用扣减 1 次配额（批量模式按 1 次计费）
试用期每个id每天 免费赋码 100 个商品，超出返回 HTTP 429 + "今日免费额度已用完"

核心参数

API Key 凭证获取方法（推荐）

API Key 是静态凭证，无需刷新，适合服务端集成。格式为 sk- 开头 + 32 位十六进制字符，示例：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

访问 湖北航信开发者门户 https://skillhub.hbhtxx.com ** → **凭证管理 页面
使用微信扫码登录（首次登录自动注册）
在 API Key 标签页点击 "生成 API Key" 按钮
输入 Key 名称（便于识别用途，如 "生产环境"、"测试环境"）
系统将生成 API Key，请立即复制保存，关闭后无法再次查看明文

API Key 有效期：在本版本中长期有效，如有变化会在湖北航信开发者门户通知

API Key 配置方法

方式一：环境变量（推荐）

BASH

export YOUR_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

方式二：代码中直接配置

PYTHON

API_KEY = "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

JWT Token 获取方法

访问 湖北航信开发者门户 https://skillhub.hbhtxx.com ** → **凭证管理 页面
使用微信扫码登录（首次登录自动注册）
在 JWT Token 标签页点击 "生成 JWT Token" 按钮
系统将生成 Access Token 和 Refresh Token（长期有效），请妥善保管

JWT Token 配置方法

方式一：环境变量（推荐）

BASH

export YOUR_JWT_TOKEN="eyJhbGciOiJIUzI1NiIs..."

方式二：代码中直接配置

PYTHON

JWT_TOKEN = "eyJhbGciOiJIUzI1NiIs..."

方式三：配置文件

INI

# config.ini
[caishui]
jwt_token = eyJhbGciOiJIUzI1NiIs...

刷新 Token

Access Token 过期后，可使用 Refresh Token 获取新 Token：

BASH

curl -X POST https://skillhub.hbhtxx.com/auth/refresh 
  -H "Content-Type: application/json" 
  -d '{"refresh_token": "YOUR_REFRESH_TOKEN"}'

接口规范

请求方式

POST

请求地址

https://skillhub.hbhtxx.com/v1/tools/call

认证方式

以湖北航信开发者门户 https://skillhub.hbhtxx.com 展现的认证方式为准：

方式一：API Key（推荐）在请求 Header 中携带 API Key：

代码

X-API-Key: YOUR_API_KEY

方式二：JWT Token在请求 Header 中携带 JWT Token：

代码

Authorization: Bearer YOUR_JWT_TOKEN

请求参数说明

参数名	类型	必填	约束	说明
name	string	是	固定值 `tax-code`	技能名称
arguments	object	是	—	技能参数
arguments.mode	string	否	`forward`（默认）或 `reverse`	查询模式
arguments.product_name	string	正向单次必填	2-50 个字符	商品名称，支持模糊匹配
arguments.batch_mode	boolean	否	默认 `false`	是否批量模式
arguments.product_list	array	正向批量必填	1-100 条，每项含 `product_name`	批量商品名称列表
arguments.tax_code	string	反向单次必填	9位短编码或19位长编码	税收分类编码
arguments.code_list	array	反向批量必填	1-100 条，每项含 `tax_code`	批量编码列表

请求报文示例

单次赋码：

JSON

{
 "name": "tax-code",
 "arguments": {
 "product_name": "苹果"
 }
}

批量赋码：

JSON

{
 "name": "tax-code",
 "arguments": {
 "batch_mode": true,
 "product_list": [
 {"product_name": "苹果"},
 {"product_name": "笔记本电脑"},
 {"product_name": "技术服务费"}
 ]
 }
}

反向查询（单次）：

JSON

{
 "name": "tax-code",
 "arguments": {
 "mode": "reverse",
 "tax_code": "109050901"
 }
}

反向查询（批量）：

JSON

{
 "name": "tax-code",
 "arguments": {
 "mode": "reverse",
 "batch_mode": true,
 "code_list": [
 {"tax_code": "109050901"},
 {"tax_code": "101011501"}
 ]
 }
}

响应报文示例

单次成功响应（HBHT API 命中）：

JSON

{
 "success": true,
 "data": {
 "name": "苹果",
 "short_name": "苹果",
 "code": "1010115010100000000",
 "short_code": "101011501",
 "rate": "9%",
 "category": "水果",
 "score": "85%"
 },
 "source": "hbht"
}

单次成功响应（向量语义匹配命中）：

JSON

{
 "success": true,
 "data": {
 "name": "高清智能投影仪",
 "short_name": "投影仪",
 "code": "1090509020000000000",
 "short_code": "109050902",
 "rate": "13%",
 "category": "电子计算机",
 "score": "92%"
 },
 "source": "local"
}

批量成功响应：

JSON

{
 "success": true,
 "data": {
 "success": true,
 "success_count": 2,
 "fail_count": 0,
 "results": [
 {
 "sp_name": "苹果",
 "data": {
 "name": "苹果",
 "code": "1010115010100000000",
 "rate": "9%",
 "category": "水果"
 },
 "source": "hbht"
 },
 {
 "sp_name": "高清智能投影仪",
 "data": {
 "name": "投影仪",
 "code": "1090509020000000000",
 "rate": "13%",
 "category": "电子计算机",
 "score": "92%"
 },
 "source": "local"
 }
 ],
 "errors": []
 }
}

反向查询成功响应：

JSON

{
 "success": true,
 "data": {
 "tax_code": "109050901",
 "match_type": "prefix",
 "matches": [
 {
 "merge_code": "1090509010000000000",
 "goods_name": "电子计算机整机",
 "category_short": "电子计算机",
 "vat_rate": "13%",
 "description": "包括通用电子计算机、专用电子计算机等"
 }
 ],
 "total": 1
 }
}

失败响应：

JSON

{
 "success": false,
 "error": "商品名称不能为空"
}

每日额度耗尽响应：

JSON

{
 "success": false,
 "error": "今日免费额度已用完"
}

HTTP 状态码：429

使用示例

示例 1：单商品赋码

使用 API Key（推荐）：

BASH

curl -X POST https://skillhub.hbhtxx.com/v1/tools/call 
 -H "Content-Type: application/json" 
 -H "X-API-Key: YOUR_API_KEY" 
 -d '{
 "name": "tax-code",
 "arguments": {"product_name": "苹果"}
 }'

使用 JWT Token：

BASH

curl -X POST https://skillhub.hbhtxx.com/v1/tools/call 
 -H "Content-Type: application/json" 
 -H "Authorization: Bearer YOUR_JWT_TOKEN" 
 -d '{
 "name": "tax-code",
 "arguments": {"product_name": "苹果"}
 }'

Python（API Key）：

PYTHON

import requests

resp = requests.post(
    "https://skillhub.hbhtxx.com/v1/tools/call",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={
        "name": "tax-code",
        "arguments": {"product_name": "苹果"}
    }
)
data = resp.json()["data"]
print(f"商品: {data['product_name']}, 编码: {data['tax_code']}, 税率: {data['tax_rate']}")

示例 2：批量赋码（适合导入商品清单）

PYTHON

import requests

products = ["苹果", "笔记本电脑", "技术服务费", "办公桌椅", "快递服务"]

resp = requests.post(
    "https://skillhub.hbhtxx.com/v1/tools/call",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={
        "name": "tax-code",
        "arguments": {
            "batch_mode": True,
            "product_list": [{"product_name": p} for p in products]
        }
    }
)
for item in resp.json()["data"]:
    print(f"{item['product_name']} -> {item['tax_code_name']} ({item['tax_rate']})")

示例 3：反向查询编码对应的商品名称

PYTHON

import requests

resp = requests.post(
    "https://skillhub.hbhtxx.com/v1/tools/call",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={
        "name": "tax-code",
        "arguments": {"mode": "reverse", "tax_code": "109050901"}
    }
)
result = resp.json()
if result["success"]:
    for m in result["data"]["matches"]:
        print(f"编码: {m['merge_code']}, 名称: {m['goods_name']}, 税率: {m['vat_rate']}")

示例 4：集成到开票流程

PYTHON

import requests

def get_tax_code(product_name):
    """在开票前自动获取税收分类编码"""
    resp = requests.post(
        "https://skillhub.hbhtxx.com/v1/tools/call",
        headers={"X-API-Key": "YOUR_API_KEY"},
        json={
            "name": "tax-code",
            "arguments": {"product_name": product_name}
        }
    )
    result = resp.json()
    if result["success"]:
        return result["data"]
    else:
        raise Exception(f"赋码失败: {result['error']}")

code_info = get_tax_code("技术服务费")
print(f"编码: {code_info['tax_code']}, 税率: {code_info['tax_rate']}")

约束项

约束项	说明
并发限制	单用户 5 QPS，超出返回 HTTP 429
超时时间	30 秒
批量上限	单次批量 ≤ 100 个商品名称
每日免费额度	每人每天免费赋码 100 个商品，超出返回 HTTP 429
匹配精度	智能编码 + 语义匹配，非精确匹配；返回置信度最高的编码

返回字段说明

顶层字段：

字段	类型	说明
success	boolean	`true` 成功，`false` 失败
data	object / array	单次模式返回 object，批量模式返回 array
error	string	失败时返回错误描述

data 字段（正向单条赋码结果）：

字段	类型	说明
name	string	输入的商品名称（原样返回）
short_name	string	税收分类编码对应的分类名称
code	string	税收分类编码，19 位长编码
short_code	string	9 位短编码
rate	string	适用税率，如 `13%`、`9%`、`6%`、`0%`、`免税`
category	string	所属大类，如 `农产品`、`电子计算机`
score	string	匹配置信度，HBHT 返回百分比（如 `85%`），本地回退显示 `本地匹配`，向量匹配显示百分比（如 `92%`）

source 字段（顶层的 source 字段，标识数据来源与匹配方式）：

值	匹配方式	说明
`hbht`	HBHT API 精确匹配	数据来自湖北航信智能编码平台，置信度最高
`local`	SQL LIKE 模糊匹配	数据来自税务局税收分类编码表 LIKE 查询命中
`local`	向量语义匹配	通过向量语义匹配命中，score 显示百分比（如 `92%`）

区分方法：score 字段值为百分比（如 85%、92%）时来自 HBHT 或向量匹配；值为 本地匹配 时来自 SQL LIKE 模糊匹配。source: local 结合 score: "92%" 即为向量语义匹配结果。

data 字段（反向查询结果）：

字段	类型	说明
tax_code	string	输入的税收分类编码
match_type	string	匹配方式：`exact`（精确，≥19位）、`prefix`（前缀，≥9位）、`fuzzy`（模糊，<9位）
matches	array	匹配结果列表
matches[].merge_code	string	19 位长编码
matches[].goods_name	string	商品/服务名称
matches[].category_short	string	分类简称
matches[].vat_rate	string	适用税率
matches[].description	string	分类说明
total	integer	匹配总数

常见错误码：

错误信息	原因	解决方法
`商品名称不能为空`	product_name 为空	传入有效的商品名称
`商品名称过短，至少2个字符`	名称太短无法匹配	使用更完整的商品名称
`批量商品数量超过上限(100)`	product_list 超过 100 条	分批调用
`未匹配到税收分类编码`	商品名称无法匹配任何编码	换用更通用的商品名称重试
`今日免费额度已用完`（HTTP 429）	当天免费赋码超过 100 个商品	等待次日重置或联系客服

版本变更说明

版本号	日期	变更内容
v1.0.0	2026-07-12	初始版本：支持单次/批量商品赋码；对接湖北航信税务编码体系；对接财税AI API Gateway体系
v1.1.0	2026-07-17	新增反向查询模式（编码→名称）；新增空编码时本地商编表回退查询；响应新增 source 字段标识数据来源
v1.2.1	2026-09-01	新增向量语义匹配兜底（Qwen3-Embedding，HBHT和SQL LIKE均失败时触发）；新增每日免费 100 个商品限额；响应 score 字段支持向量匹配百分比显示；source 字段扩展说明

特别说明：skill返回的税收分类编码为 AI 语义匹配结果，仅供参考。调用方应结合自身业务场景和专业判断，自行核实编码的适用性与合规性。凡skill返回税收分类编码（即 success: true），均计入当日免费额度。

版权声明

本技能为湖北航天信息技术有限公司（简称"湖北航信"）旗下财税 AI 产品。

版权所有 © 2026 湖北航天信息技术有限公司。保留所有权利。

欢迎访问湖北航信财税AI助理 Skills 市场 https://skillhub.hbhtxx.com/

官网：https://www.hbhtxx.com

官微：湖北航天信息

2026 年 11 月
一	二	三	四	五	六	日
						1
2	3	4	5	6	7	8
9	10	11	12	13	14	15
16	17	18	19	20	21	22
23	24	25	26	27	28	29
30

湖北航信商品智能赋码

下载地址

概述

商品智能赋码（Hbhtxx Tax Code）

功能概述

使用场景

核心规则与约束

核心参数

API Key 凭证获取方法（推荐）

API Key 配置方法

JWT Token 获取方法

JWT Token 配置方法

刷新 Token

接口规范

请求方式

请求地址

认证方式

请求参数说明

请求报文示例

响应报文示例

使用示例

示例 1：单商品赋码

示例 2：批量赋码（适合导入商品清单）

示例 3：反向查询编码对应的商品名称

示例 4：集成到开票流程

约束项

返回字段说明

版本变更说明

版权声明

标签：

其他文章

暂无评论！成为第一个。

发表回复 取消回复

您可能错过了

发表回复取消回复