慧穗云—智能赋码(smart-revenue)
下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/smarttax--huisuiyun-smart-revenue.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @smarttax/huisuiyun-smart-revenue。使用慧穗云 CDK 智能赋码 API,根据一个或多个商品、服务名称查询候选税收分类编码、税率、匹配度、简码和说明。用于用户提到智能赋码、商品赋码、税编查询、税收分类编码、开票税率匹配,或需要为商品选择候选税编时。
阅读全文 (展开查看完整说明)
概述
慧穗云智能赋码
调用慧穗云同步接口 GET /api/v2/agent/cdk/invoice/smart-revenue。使用随 skill 提供的脚本,不要自行拼接鉴权请求。先将本 SKILL.md 所在目录解析为 <skill-dir>,从任何工作目录都通过该绝对路径执行脚本。
配置
要求 Python 3、requests,以及以下环境变量:
HSY_AK=慧穗云或 ISV 的 AK
HSY_SK=对应的 SK
HSY_TYPE=2
HSY_API_URL=https://huisuiyun.comHSY_TYPE 取 2 表示慧穗云 AK/SK。ISV AK/SK 必须改为以下配置:
HSY_TYPE=1
HSY_TAX_NO=被操作公司的税号也可用 --operator-tax-no 代替 HSY_TAX_NO。这里填写当前 ISV 代表其操作并扣减流量的公司税号,不是商品所属企业税号。不得要求用户在对话中粘贴 SK;引导其在本机配置环境变量。秘钥管理地址:https://huisuiyun.com/account/conf/secretkey。
查询
将多个商品名作为独立参数传入,脚本会按官方要求用英文逗号连接:
python "<skill-dir>/scripts/smart_revenue.py" query "小麦" "大米"可选参数:
python "<skill-dir>/scripts/smart_revenue.py" query "技术服务" --operator-tax-no 913... --serial-no order-1001不要把商品规格、型号、数量和单价混入商品名。名称含义不清时,先向用户确认实际商品或服务内容。
解读结果
仅当顶层 code 为字符串 "200" 时按成功处理。data[i].name 对应一个输入商品名,data[i].details 是该商品的候选数组。对每个候选列出 revenueCode、taxRate、prob、parentName(简码)和 desc。优先展示高匹配度候选,但匹配度相同或描述有歧义时不要擅自替用户确定税编。
成功响应中的空 data 或空 details 表示未匹配到候选。非 200、HTTP 错误或非 JSON 响应属于调用失败,必须保留并报告 message 和 serialNo,不得解释为“未匹配”。
依据
接口契约来自当前慧穗云 CDK 文档 辅助功能接口/smart-revenue.md。Token 有效期为 30 天;脚本使用 MD5(AK + SK) 获取访问令牌,并支持 X-Tax-Token 与 X-Serial-Token。