企业进销项发票归集下载

要解决的问题

企业财务与 Agent 工作流经常需要查询进销项发票，但真实调用依赖税局或企享云会话、企业账号、nsrsbh、accountId 和短期 Agent Grant。直接拼 HTTP、保存登录态或让用户回传内部标识，都可能造成并发串单、凭证泄露和会话冲突。

技能如何工作

该技能将四个发票工具收敛到 scripts/invoice_collection_workflow.py collect：query_input_output_invoice_info_auto、query_invoice_basic_info_auto、query_invoice_detail_aggregation_auto、query_taxable_voucher_input_tax_transfer_out_auto。首次调用不直接请求业务 MCP，而是创建一次性登录会话；Agent 只向用户展示 login_url，内部执行 waitArgv 等待 qxy.agent_login.completed，再从私有 flow 恢复 nsrsbh、accountId 和有效 Grant，放入 X-QXY-Agent-Grant 请求头后续跑。多租户场景应传入稳定私有 --login-context-id；切换账号时增加 --switch-account，避免旧 Grant 残留。

适用边界与注意点

• 必须使用完整 QXY_API_KEY，不得跨环境变量或 .env 来源拼接，也不得输出原文。
• 禁止 curl、手写 HTTP、网页自动化或让用户提供 Grant；mcp_client.py 更适合查看服务与 schema。
• 登录链接默认有效 1 小时，Grant 默认有效 24 小时；税局会话可能提前失效。
• 遇到 code=505069 且命中授权到期文案时，属于不可重试终态，不应重新登录、重试或保存为成功调用。