企享云数电发票开票
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_bbae3f97/qixiangyun-invoice-issuance-skill。
技能介绍
问题
数电发票开票流程中,Agent 常面临税局登录态、企业账号上下文、商品税收编码、购方抬头、开票确认与异步结果查询分散的问题。直接把工具参数丢给用户,或让模型记忆默认商品编码,都会引入误开、串企业和敏感信息泄露风险。
工作方式
该技能围绕 scripts/invoice_issuance_workflow.py 建立可恢复的发票草稿链路:
- 一次性登录:通过企享云
agent_loginMCP 创建网页登录会话,用户选择企业账号后,脚本校验nsrsbh、accountId、aggOrgId,并签发短期Agent Grant。 - 草稿与确认:解析自然语言需求,调用云抬头补齐购方,使用
invoice_classification查询商品税收编码,生成confirmation_summary,只有用户明确确认才进入真实开票。 - 结果与红冲:支持查询发票明细、PDF/OFD/XML 下载地址、扫脸二维码状态,以及蓝票核验后的红冲申请与状态对账。
边界
技能依赖企享云访问凭证和税局登录态;多租户环境需要平台侧注入密钥并隔离状态目录。真实开票、红冲和登录创建等写操作不自动重放;未拿到发票号码或版式文件前,不应表述为开票成功。
使用场景
- 财务接到“开 1000 元普通发票”的需求,需要生成草稿、补购方抬头、确认税收编码并待确认后开票。
- 开票返回人脸认证提示时,需要展示税务 APP 二维码、查询扫脸状态并续跑同一草稿。
- 用户要查某张已开发票的明细或 PDF 下载时,需要按草稿上下文查询并渲染下载区。
- 需要冲销一张销方全额蓝票时,需要核验原票、申请红字确认并查询红冲状态。
适合人员
- 对接企享云开放平台的财务自动化工程师,需要把自然语言开票请求变成受控草稿和真实开票调用。
- 维护 OpenClaw 或自研 Agent 的后端开发者,需要处理一次性登录、后台等待和发票结果续跑。
- 负责发票查询与红冲的企业运营,需要按草稿上下文查看发票明细、版式下载和红冲状态。
- 多租户 SaaS 平台工程师,需要为不同租户隔离凭证、登录态和发票草稿状态。