Zatca FATOORA模拟环境X509IssuerName/X509SerialNumber错误求助

问题背景 #

在FATOORA模拟环境测试Zatca电子发票第二阶段方案时，标准发票验证通过，但简化发票始终触发X509IssuerName和X509SerialNumber错误，当前使用的字段值为：

<ds:X509IssuerName>CN=PEZEINVOICESCA2-CA, DC=extgazt, DC=gov, DC=local</ds:X509IssuerName>
<ds:X509SerialNumber>413713212005634976763820571758723157758585483</ds:X509SerialNumber>

可能原因分析 #

1. 简化发票字段校验规则差异：Zatca对标准发票和简化发票的X.509字段解析逻辑不同，模拟环境中简化发票的校验更严格，比如IssuerName的分隔符、RDN顺序要求，或SerialNumber的格式限制。
2. 证书链不完整：模拟环境的简化发票校验可能要求完整证书链（叶证书+中间CA+根CA），仅提供叶证书的Issuer和Serial会导致校验失败。
3. SDK签名逻辑遗漏配置：Zatca SDK可能针对简化发票需要单独指定签名参数，若未明确发票类型（standard/simplified），会默认使用标准发票规则生成签名块，导致不兼容。
4. 模拟环境证书库未收录当前证书信息：PEZEINVOICESCA2-CA作为模拟环境根CA，其对应的叶证书Issuer或Serial可能未被简化发票校验库收录。

具体解决方案 #

• 调整X509字段格式：
  • 尝试修改IssuerName的分隔符，将逗号改为分号：CN=PEZEINVOICESCA2-CA;DC=extgazt;DC=gov;DC=local，确保RDN顺序与CA证书完全一致。
  • 验证SerialNumber格式：确认证书的SerialNumber为十进制BigInteger字符串，无溢出或格式错误，若长度超出模拟环境限制，可检查证书是否为模拟环境专用测试证书。
• 补充完整证书链：在签署简化发票时，配置SDK加载完整证书链文件（包含叶证书、中间CA、根CA），而非仅叶证书，确保校验时能追溯到根CA。
• 指定发票类型签名配置：查看Zatca SDK文档，确认是否需要在签名时显式指定发票类型为simplified，避免默认使用标准发票的签名逻辑。
• 重新申请模拟环境证书：删除当前PCSID证书，重新通过模拟环境流程申请合规证书，使用新证书签署简化发票后再验证。

关于切换核心API的建议 #

切换到核心生产API不一定能直接解决问题——核心环境与模拟环境的校验规则一致，若模拟环境的问题是逻辑配置错误，核心环境会复现相同问题。但如果排查后确认是模拟环境API的已知bug（如简化发票X509字段校验逻辑异常），可尝试切换核心API测试，但建议优先在模拟环境完成问题排查，降低核心环境测试成本。

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