Agent Skills
返回列表
慧穗云智能赋码

慧穗云智能赋码

行业专业 更新于 2026.08.29

将以下提示词粘贴到你的 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 开票平台开发者
  • 财务共享中心需在系统未自动赋码时,据商品名核对编码与税率的办税/开票专员
  • 客户上线前需批量验证商品档案名称能否命中赋码接口的实施顾问