This article shows how to follow, in the Qoyod POS app on Android, the status of each invoice and credit note with ZATCA, how to read the reason for a failure, and how to retry the sync or fix the payment mean.
What is this, and when do you use it?
The Qoyod POS app on Android shows each document’s ZATCA status right after the sale. You need this in these cases:
- You want to confirm that ZATCA received the invoice or credit note you just issued.
- You see the ZATCA Sync Failed status and want to know why and fix it.
- ZATCA rejected a document because of its payment mean and you want to correct it.
See the release announcement for what was added.
Before you start
- The feature is available in the Qoyod POS Android app only, not in the Web POS.
- It works for organizations on ZATCA Phase 2 (the integration phase) of e-invoicing.
- It needs no setting or permission, and turns on automatically for organizations active on Phase 2.
The path in Qoyod
Invoices list › The failed document › Retry Sync
Steps
Follow a document’s status
- Complete the sale. The Waiting for ZATCA approval.. screen shows until ZATCA answers, then the result appears.
- Open the invoices list or the credit notes list. Each card shows its document’s ZATCA status.
- Open the document to see the status on the details screen.
Handle a document that failed to sync
- Open the document whose status is ZATCA Sync Failed.
- Read the reason for the failure. The app explains it in plain language, not technical codes.
- Tap Retry Sync.
If the cause is the payment mean, open Edit Payment Mean from the failed document and correct it, and the document is resent automatically.
Fields
The statuses shown on a document:
- Awaiting ZATCA Sync: the document has not been sent yet.
- Syncing with ZATCA: the submission is in progress.
- Synced with ZATCA: ZATCA received the document.
- Synced with ZATCA (with warnings): the sync completed and came with warnings.
- ZATCA Sync Failed: the sync did not complete, and the reason is shown.
- ZATCA Unauthorized: the organization’s ZATCA authorization is invalid or revoked.
Special cases
What does Retry Sync do?
If the document never reached Qoyod, it is sent again. If it reached Qoyod but ZATCA rejected it, the latest status is fetched.
Outcomes of the waiting screen at checkout
- Submission failed: the reason is given.
- The invoice is saved as a draft because stock was unavailable: a new reference is made for the next attempt.
- The document was already received: do not create it again.
- The customer was no longer found on the device: select the customer again.
The ZATCA Unauthorized status
It means the organization’s ZATCA authorization is invalid or revoked. The cashier cannot fix it from the app, and the message says to contact support.
Notes
- In Phase 2 the app fixes the working mode to Online only.
- Only ZATCA-compliant customers can be selected.
- Invoices and credit notes cannot be deleted.
- Registering the organization with ZATCA (onboarding) is not done in the POS.
- Not every rejection can be fixed from the app.
Frequently asked questions
Is the ZATCA status available in the Web POS?
No. The feature is available in the Qoyod POS Android app only.
Do I need to turn on a setting for the status to appear on invoices?
No. The feature turns on automatically for organizations on ZATCA Phase 2, and needs no setting or permission.
What should I do if the status is ZATCA Unauthorized?
It means the organization’s ZATCA authorization is invalid or revoked. The cashier cannot fix it from the app, so contact support as the message says.
Do I register my organization with ZATCA from the POS?
No. Registering the organization with ZATCA (onboarding) is not done in the POS.
Can I delete an invoice that failed to sync?
No. Invoices and credit notes cannot be deleted. Open the document, read the reason, then tap Retry Sync.
