Agent Skills
返回列表
慧穗云—数电发票智能抬头

慧穗云—数电发票智能抬头

行业专业 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @smarttax/huisuiyun-smart-header。

技能介绍

要解决什么问题

开具数电发票前,你需要准确的企业抬头:全称、纳税人识别号,以及地址、电话、开户行与账号。人工在税务系统或工商库里逐条核对既慢,也容易把简称当成正式名称。本技能面向 慧穗云 CDK 的「智能抬头」能力,在对话里按公司名称或已有线索发起查询,并把接口返回的结构化字段整理成可读结果。

技能如何工作

技能通过随包提供的脚本调用同步接口 GET /api/v2/agent/cdk/addressee/query,不要自行拼接鉴权;应从 SKILL.md 所在目录解析出的绝对路径执行脚本,以保证 Token 与流水号逻辑一致。鉴权侧要求 Python 3、requests,以及环境变量:

  • HSY_TYPE=2 表示使用慧穗云 AK/SK(ISV 场景需按文档改配)
  • HSY_TAX_NO 或 --operator-tax-no:填写 ISV 操作主体税号(扣减流量的公司),不是被查询企业的税号

查询时可附带操作税号与 业务流水号 serialNo。成功判定只看顶层 code 是否为字符串 "200"。若有多条候选,应先列出公司全称与税号供你确认,再按需展开 companyAddress、companyTel、companyBankName、companyBankNo;address、bankName 为拼接字段时,优先展示拆分后的细项。

适用边界与注意点

  • 公司名称 少于 4 个字 时,接口仅查系统内部数据;需要完整抬头时,请使用不少于 4 个字的正式名称,不要凭简称臆测全称。
  • data 为空表示 未查到抬头,不等于接口失败;调用失败(非 200、HTTP 异常、非 JSON)须原样保留 message 与 serialNo,不得说成「企业不存在」。
  • SK 不应在对话中粘贴;应在本地配置环境变量,密钥管理见慧穗云控制台。
  • Token 有效期 30 天;脚本以 MD5(AK+SK) 取访问令牌,并支持 X-Tax-Token 与 X-Serial-Token。历史上上游凭证失效、内部 MQ 异常时,错误码与流水号对排障很重要。

使用场景

  • 财务在 ERP 录入购方信息前,用公司全称向慧穗云查询纳税人识别号与开户行账号是否匹配
  • 开票员面对多家同名候选抬头,需要列出全称与税号让客户确认后再回填开票表单
  • ISV 集成方在联调 CDK 时,用操作税号与流水号复现一次智能抬头查询并核对 serialNo
  • 用户只提供三个字简称时,先说明四字以下只能查内部库,再请对方补充正式全称后重查

适合人员

  • 代客户开具数电发票的财税服务商,需要在对话中快速核对购方抬头与税号一致性
  • 企业财务共享中心开票员,批量录入前要用接口拉取地址电话和开户信息减少手工错填
  • 对接慧穗云 CDK 的后端工程师,希望 AI 按契约调用 query 接口并保留 message 与 serialNo 便于排障
  • ISV 运营人员,需在本机配置 AK/SK 与操作税号,避免在聊天里暴露密钥