Compliance alerts are a set of checks Qoyod runs on the invoice before it is sent to the Zakat, Tax and Customs Authority (ZATCA), to warn you of any missing or incorrect data and reduce the risk of rejection. This article explains the types of these alerts and gathers links to their detailed guides.
Alert types
- Mandatory: the invoice cannot be saved or submitted until the required field is completed, a requirement from the authority.
- Warning: a high probability of rejection, shown prominently and not blocking saving, but correcting it before submission is strongly advised.
- Guidance: a non-blocking alert that guides you to correct the data while letting you proceed.
Mandatory alerts
- National ID required for health and education VAT exemption: makes the customer’s national ID mandatory when a health or education exemption is selected.
Warnings
- Future invoice issue date warning: warns you when the invoice date is later than today.
Guidance alerts
- Identifier format validation: checks the format of the national ID, commercial register, and tax number on entry.
- Zero-rate tax reason code: reminds you to choose a reason code for line items at a 0% tax rate.
- VAT exemption reason code: reminds you to choose a reason code for VAT-exempt line items.
- Customer tax address completeness: asks you to complete the customer address fields required under Phase 2.
- 24-hour deadline for simplified invoices: notifies you when a simplified invoice’s issue date has exceeded the 24-hour window.
- Adding the government entity additional identifier: lets you enter the government entity identifier from within the invoice.
- Seller additional identifier (BT-29): notifies you when the seller additional identifier required under Phase 2 is missing.
- Missing customer identifier on government invoices: notifies you when the government customer identifier is missing and its compliance impact.
Notes
- Compliance alerts are enabled automatically, with no setup required, and appear while creating or saving the invoice.
- The alerts aim to reduce the risk of invoice rejection by catching missing or incorrect data early, not to guarantee acceptance.
- Qoyod keeps pace with the authority’s updates and adds new checks automatically, which you can follow on the Qoyod updates page.
