慧穗云智能赋码
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @smarttax/huisuiyun-smart-revenue。
技能介绍
要解决什么问题
开票或商品主数据维护里,税收分类编码(revenueCode)和适用税率往往不能靠人工逐条查表:商品名称写法杂、同一品目多候选、匹配度(prob)接近时也容易选错。慧穗云提供的 smart-revenue 接口,是根据商品名称做智能赋码同步查询;本技能把官方契约和鉴权方式封装成可复用流程,避免在对话里手写 AK/SK 或自行拼请求。
技能如何工作
- 通过随技能附带的脚本调用
GET /api/v2/agent/cdk/invoice/smart-revenue,鉴权走慧穗云 AK/SK(HSY_TYPE=2),访问令牌由MD5(AK + SK)获取,并支持X-Tax-Token/X-Serial-Token。 - 将多个商品名作为独立参数传入,由脚本按规范用英文逗号拼接;不要把规格、型号、数量、单价混入商品名。
- 仅当顶层
code为字符串"200"视为成功:data[i].name对应输入名,data[i].details为候选列表,需展示revenueCode、taxRate、prob、parentName、desc;优先高prob,但歧义时不替用户定稿。 - 操作方税号用环境变量
HSY_TAX_NO或--operator-tax-no配置(ISV 代表操作并扣流量的公司税号,不是商品所属企业税号);密钥应在本地配置,不得在对话中粘贴 SK。
适用边界与注意点
成功响应里 空 data 或空 details 表示未匹配到候选;HTTP 错误、非 JSON 或非 "200" 属于调用失败,须原样报告 message 与 serialNo,不能解释成「未找到编码」。名称含义不清时,应先向用户确认实际商品或服务内容再查询。
使用场景
- 开票前把订单或 ERP 商品名称批量提交慧穗云,核对返回的 revenueCode 与税率候选项
- ISV 代客户开票时,用操作方税号配置环境变量,对多条商品名执行一次智能赋码查询
- 商品名为统称或别名导致 details 多条且 prob 接近时,结合 desc 与用户确认后再选定编码
- 联调慧穗云 CDK 时接口失败,需保留 serialNo 与 message 提交工单而非当作无匹配处理
适合人员
- 对接增值税开票后端、要把商品主数据与税局税收编码对齐的集成工程师
- 维护慧穗云 ISV AK/SK 并以操作方税号消耗流量的 SaaS 开票平台开发者
- 财务共享中心需在系统未自动赋码时,据商品名核对编码与税率的办税/开票专员
- 客户上线前需批量验证商品档案名称能否命中赋码接口的实施顾问