Saudi Arabia ZATCA

Key: sa-zatca-v1 Module: github.com/invopop/gobl.sa.zatca Support for the Saudi Arabia ZATCA (Zakat, Tax and Customs Authority) e-invoicing requirements based on UBL 2.1 with EN 16931 as an intermediate layer and KSA-specific extensions (BR-KSA-* rules). ZATCA e-invoicing covers both standard tax invoices (B2B/B2G) sent for clearance and simplified tax invoices (B2C) sent for reporting through the FATOORA platform. This addon extends EN 16931 with Saudi-specific fields and validations including invoice type transactions, address requirements, and supply date handling.

​

Sources

• ZATCA E-Invoicing Developer Portal

​

Scenarios

​

bill/invoice

standard

Filters:

• Types: standard

Output:

• Extensions: untdid-document-type:388

​

Extensions

​

ZATCA Invoice Transaction Type

Code used to describe the ZATCA invoice transaction type and flags (KSA-2). The code is a 7-character string where positions 1-2 indicate the main type (01 = Standard Tax Invoice, 02 = Simplified Tax Invoice) and positions 3-7 are binary flags for third-party, nominal, export, summary, and self-billed transactions respectively.

sa-zatca-invoice-type

Pattern: ^0[12][01]{5}$

Code	Name
0100000	Standard Tax Invoice
0100001	Standard Tax Invoice — Self-billed
0100010	Standard Tax Invoice — Summary
0100011	Standard Tax Invoice — Summary, Self-billed
0100100	Standard Tax Invoice — Export
0100110	Standard Tax Invoice — Export, Summary
0101000	Standard Tax Invoice — Nominal
0101001	Standard Tax Invoice — Nominal, Self-billed
0101010	Standard Tax Invoice — Nominal, Summary
0101011	Standard Tax Invoice — Nominal, Summary, Self-billed
0101100	Standard Tax Invoice — Nominal, Export
0101110	Standard Tax Invoice — Nominal, Export, Summary
0110000	Standard Tax Invoice — Third-party
0110001	Standard Tax Invoice — Third-party, Self-billed
0110010	Standard Tax Invoice — Third-party, Summary
0110011	Standard Tax Invoice — Third-party, Summary, Self-billed
0110100	Standard Tax Invoice — Third-party, Export
0110110	Standard Tax Invoice — Third-party, Export, Summary
0111000	Standard Tax Invoice — Third-party, Nominal
0111001	Standard Tax Invoice — Third-party, Nominal, Self-billed
0111010	Standard Tax Invoice — Third-party, Nominal, Summary
0111011	Standard Tax Invoice — Third-party, Nominal, Summary, Self-billed
0111100	Standard Tax Invoice — Third-party, Nominal, Export
0111110	Standard Tax Invoice — Third-party, Nominal, Export, Summary
0200000	Simplified Tax Invoice
0200010	Simplified Tax Invoice — Summary
0201000	Simplified Tax Invoice — Nominal
0201010	Simplified Tax Invoice — Nominal, Summary
0210000	Simplified Tax Invoice — Third-party
0210010	Simplified Tax Invoice — Third-party, Summary
0211000	Simplified Tax Invoice — Third-party, Nominal
0211010	Simplified Tax Invoice — Third-party, Nominal, Summary

​

Validation Rules