提交简化版发票至ZATCA时遇「Production CSID不支持简化文档」错误

核心错误原因 #

错误信息Production CSID does not cover Simplified documents明确指向：当前使用的生产环境CSID证书，未被授权处理简易类型发票文档。ZATCA的CSID证书分两种权限维度：

• 仅支持标准发票（Standard Invoice，代码380）
• 支持标准+简易发票（Simplified Invoice，代码388）
  你的CSID证书属于前者，但提交的是简易发票，触发权限校验失败。

修复步骤 #

1. 核对发票文档类型
   检查已签署的发票XML，确认InvoiceTypeCode字段值：

   • 简易发票对应388
   • 标准发票对应380
     若实际应为标准发票但字段值错误，直接修正XML后重新签署上报。

2. 重新生成带简易权限的CSID证书

   • 登录ZATCA Fatoora Portal，在证书申请流程中明确勾选支持简易文档的权限选项
   • 用新生成的CSID证书替换SDK证书目录中的旧证书，重新签署目标发票
   • 同步更新PCSID证书，确保其权限范围与新CSID一致（PCSID用于API认证，需匹配CSID的权限）

3. 校验上报接口参数一致性

   • 确认请求头Clearance-Status值与发票类型匹配：简易发票通常对应1（即时清关），需严格遵循ZATCA V2规范
   • 检查payload中的发票元数据（如文档类型标识），确保与实际发票类型完全一致，避免类型不匹配触发权限校验

4. 证书配置验证

   • 确认SDK证书目录中的CSID/PCSID是新生成的权限版本，无缓存旧证书
   • 检查代码中证书加载逻辑，确保正确引用新证书文件路径

额外排查点 #

• 若提交的是标准发票但仍触发错误，需排查是否因XML结构异常被系统误判为简易发票
• 确认上报接口使用的是生产环境端点，测试环境证书权限规则与生产环境存在差异

内容的提问来源于stack exchange，提问作者hous unus