企享云票据和发票验真

要解决的问题

企业核验发票时，常见风险不是“有没有票”，而是票面状态是否真实、字段是否满足不同票种规则。税控发票、数电票、全电纸质发票、财政票据的必填字段并不一致，je、jym、jshj 容易混淆；如果直接拼接口参数，可能出现漏校验、误拦截或把旧字段当新字段。该技能把发票验真收敛为明确的命令与条件必填规则。

工作方式

技能基于发票关键要素调用查验服务，覆盖以下核心能力：

• 税控发票查验：支持增值税专用发票、普通发票、机动车销售统一发票等，单张或多张通过 cyList 提交。
• 数电票查验：覆盖电子普通/专票、铁路客票、航空客票、通行费发票等，核心入参通常为 fphm + kprq + jshj。
• 全电纸质与财政票据查验：按票种走不同字段规则，避免把字段说明中的条件必填误判为硬必填。
• 批量查验：每次最多 50 张，适合报销、财务对账、采购核验等批量场景。

典型流程是先用 validate-invoice-info 做本地格式预检，再按票种调用 verify-tax-control、verify-digital 或 verify-digital-paper。结果以 code=2000 表示成功；失败时按接口错误处理，不盲目重试。

适用边界

• 该技能依赖企享云访问凭证，凭证只用于内部调用边界，不能要求用户暴露变量名、路径或原始错误。
• 旧版 QXY_CLIENT_APPKEY/QXY_CLIENT_SECRET 不被支持，遇到时应停止并走配置流程。
• 不同票种的条件必填规则优先于统一 required 字段，fj 只是 jym 的历史兼容别名。
• 产品授权超期等终态错误不能伪装成普通失败，应提示用户处理付费或续费。