Invoice Status & ZATCA Response
Every Sales Invoice submitted to ZATCA gets a response that you can check directly on the invoice in YousrERP. This page explains what each status means and how to read the ZATCA response.
Where to Check Invoice Status
- Open any submitted Sales Invoice.
- Look for the ZATCA Status field in the Additional Fields section (added by KSA Compliance).
- You'll also see:
- ZATCA UUID: The unique identifier assigned by ZATCA
- ZATCA QR Code: Embedded in the invoice print format
- ZATCA XML: The submitted XML (viewable from the invoice)
- Submission Date/Time: When the invoice was sent to ZATCA
ZATCA Statuses
| Status | What It Means | Action Required |
|---|---|---|
| Not Submitted | Invoice hasn't been sent to ZATCA yet. May be in draft or pending submission. | Submit the invoice, or wait for batch processing. |
| Pending | Invoice has been sent but ZATCA hasn't responded yet. | Wait a few minutes and check again. |
| Accepted | ZATCA has accepted and cleared the invoice. | No action needed — invoice is compliant. |
| Accepted with Warnings | ZATCA accepted but had minor issues (e.g., optional fields missing). | Review warnings in the integration log, but no urgent action required. |
| Rejected | ZATCA rejected the invoice due to compliance issues. | Check the rejection reason, fix the issue, and resubmit. See Handling Rejections. |
| Partially Accepted | In a batch submission, some invoices were accepted and others rejected. | Check the integration log for which ones failed. |
| Error | Technical error during submission (e.g., network issue, invalid certificate). | Check Integration Logs for the specific error. |
Understanding the ZATCA UUID
The ZATCA UUID is a globally unique identifier that ZATCA assigns to each accepted invoice. This UUID:
- Appears on the printed invoice alongside the QR code
- Is embedded in the QR code
- Can be used to look up the invoice on ZATCA's portal
- Proves the invoice was cleared by ZATCA
QR Code on Printed Invoices
Every ZATCA-compliant invoice in YousrERP includes a QR code on the printed version. The QR code contains:
- Seller's VAT registration number
- Invoice timestamp
- Invoice total (including VAT)
- VAT amount
- ZATCA UUID (for Phase 2)
- Cryptographic hash
Users can scan the QR code with ZATCA's mobile app to verify the invoice authenticity.
Viewing the XML
To view the XML that was sent to ZATCA:
- Open the Sales Invoice.
- Go to the ZATCA Additional Fields section.
- Click View XML to see the full UBL 2.1 XML.
- You can also Download XML for audit or troubleshooting purposes.
Invoice Print Format
YousrERP includes ZATCA-compliant print formats:
- ZATCA Phase 2 Print Format: Standard format with QR code, UUID, and required fields
- ZATCA Phase 1 Print Format: Legacy format (for Phase 1 compliance)
- Simplified Invoice Format: For B2C transactions
The correct format is automatically selected based on the invoice type.
Checking Status in Batch Mode
If you're using Batch Mode:
- Go to ZATCA > E-Invoicing Sync page.
- This page shows the batch queue status.
- You can see which invoices are queued, submitted, and their results.
- Click Sync Now to manually trigger a batch submission.
Status Alerts
The system provides alerts for:
- Rejected invoices: Visible on the ZATCA Dashboard and on the invoice itself
- Stuck pending: Invoices pending for more than the expected time
- Submission failures: When the system can't reach ZATCA