新时代智云·发票查验与企业赋码
将以下提示词粘贴到你的 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 接口