慧穗云—数电发票智能抬头
将以下提示词粘贴到你的 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 与操作税号,避免在聊天里暴露密钥