Common Errors
High-frequency issues users encounter during:
- Invoice submission
- Compliance processing
- Integration flows
Typical Error Categories
1. Device Validation Failed
Meaning: The device linked to the branch is not validated or is misconfigured.
Possible Causes:
- Device not registered correctly
- Certificate mismatch
- Expired credentials
Action:
- Check device status under Devices
- Revalidate device
- Confirm branch assignment
2. ZATCA Status Error
Meaning: ZATCA rejected the document.
Possible Causes:
- Missing mandatory fields
- Invalid invoice calculation
- Incorrect document type
Action:
- Review error code details
- Compare payload with ZATCA requirements
- Correct data and resubmit
3. Missing Required Field
Meaning: Required data was not included in the transaction.
Action:
- Review invoice structure
- Ensure all mandatory fields are populated
Best Practice
Professional Hint
Always check:
- Device status
- Invoice validation result
- Error message details
Before escalating to support.
Related Topics