When ZATCA rejects an invoice, a BR-KSA-coded message explains why; knowing the common ones speeds up the fix and resubmission.
Path: Accounting ← Customers ← Invoices (open the invoice) ← EDI Documents tab
- Open the rejected invoice, go to the EDI Documents tab, and read the error text and code.
- BR-KSA-37 (missing building number): complete the 4-digit Building Number in the customer or company address.
- Invalid VAT: ensure the 15-digit VAT starts and ends with 3, and correct it on the customer record.
- Missing zip/district: complete the 5-digit Zip and District in the national address.
- Tax total mismatch: check each line's 15% rate and rounding, and don't mix exempt with taxable lines.
- After fixing, if still a draft re-Post it; if already posted use Retry / Process Now in the EDI tab.
- If a posted invoice is finally rejected and can't be edited, issue a Credit Note to cancel it, then issue a correct new invoice.
- Watch the Chatter and EDI status until it turns Accepted, and document the cause to avoid repeats.