Agent Skills
返回列表
新时代智云·发票查验与企业赋码

新时代智云·发票查验与企业赋码

行业专业 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-c9ln93m8/newtimeai-invoicehelp。

技能介绍

要解决什么问题

在 Agent 或 Workbuddy 里做开票、对账或合规核对时,模型不能凭商品名「猜」税收分类编码,也不能用网页检索代替税务总局口径的验真接口。本技能不经过 zhiyun-agent,而是通过本机或可配置的 智云网关(ZHIYUN_GW_URL,默认 http://localhost:8080)透传调用北京新时代智云开放平台的真实财税 API,把三件事做成可调用的固定能力。

技能如何工作

首次有财税需求时,必须先检查 .env 中的 ZHIYUN_APP_KEY 与 ZHIYUN_APP_SECRET:两者缺一就停下向用户索取或引导至 newtimeai.com 申请租户;凭证经请求头下发,可用 save-cred 写入 .env(600 权限),禁止在回复中回显明文。

核心业务对应三类接口:

  • query_buyer_info:按公司名(nsrmc)或税号查购方开票抬头
  • intelligent_code_assign:商品名称 → 税收分类编码与适用税率(开票 SOP 要求税率取返回 spkysl 数组最大值,参数用小数如 0.13)
  • 发票查验:四要素验真;fpje_type 须按票种选择(专票 tax_excluded、普票 check_code、数电 price_total)

脚本 invoke.sh / invoke.ps1 负责健康检查、读环境与版本头 X-Skill-Version;外层 code=0 为网关成功,data.code 为智云业务码(如 1004 退避重试、1005 税控未就绪勿盲重试)。网关响应若带 skill_upgrade 可提示用户按 download_url 更新技能包,不影响当次 data 返回。

边界与注意点

  • 需自建或可访问的 zhiyun-gateway;网关不代用户签发 Key,流量与配额归属用户租户(兜底凭证仅作例外,技能默认仍倾向独立账号)。
  • 购方查询无结果应追问税号;赋码无结果应追问商品标准品名;查验结果原样转告,不臆测。
  • 金额保留两位小数;业务参数明细与错误码见包内 references/api_reference.md。

使用场景

  • 财务助理在开票前按公司简称查购方税号与正式抬头,避免票面购方信息填错
  • 开票员录入新商品时先对品名调智能赋码,拿到编码再从 spkysl 取最高适用税率组票
  • 收到纸质或邮件发票后,用代码、号码、日期与金额类型做四要素验真核对真伪
  • 集成 Agent 工作流时经本地网关批量查抬头与赋码,统一走租户凭证与同一错误码处理

适合人员

  • 企业财务或开票岗位,需要在对话里先查抬头、再赋码、最后组票且不能靠记忆背税收编码
  • 代理记账公司操作员,日常帮多家客户开票,要按商品名快速落到总局口径的分类与税率
  • 合规或内审人员,收到报销发票后要调用四要素验真并把网关返回结果如实归档
  • 在 Workbuddy 上接财税自动化的工程师,要经 ZHIYUN_GW_URL 透传而非 mock 接口