Common Errors

Created by Reachware Support, Modified on Tue, 17 Mar at 4:46 AM by Reachware Support

What This Section Covers

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