Saudi ZATCA Phase 2 · ZATCA-CSID-401
How to Fix ZATCA-CSID-401 (Expired OTP or Unpromoted CCSID)
Either the 6-digit Fatoora Portal OTP expired before onboarding, or you attempted live production clearance using a Compliance CSID without promoting it to a Production CSID.
Exact Fix
Onboard with a fresh 6-digit OTP via POST /v1/onboard/zatca-csid, then promote to production via POST /v1/onboard/zatca-pcsid.
Failing Payload
// Calling production clearance with csidStage: "compliance"Fixed Payload
// Step 2: Promote CCSID -> PCSID
POST /v1/onboard/zatca-pcsid
{ "csidId": "your-csid-uuid" }Verify Fix via Free Preflight API
curl -sS -X POST https://api.invora.dev/v1/onboard/zatca-pcsid -H "Authorization: Bearer tb_live_your_key" -H "Idempotency-Key: pcsid-001" -d '{"csidId":"YOUR_CSID_UUID"}'Does promoting CCSID to PCSID reset ICV and PIH?
Yes. Invora resets last_icv = 0 and last_pih = ZATCA_GENESIS_PIH atomically upon PCSID promotion.