Skip to main content
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

Scenarios

Scenarios attach notes and extensions to a document when its filters match. Read more about scenarios.

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.
Pattern: ^0[12][01]{5}$

Validation Rules

Validation rules check each struct against a set of assertions and report any failures with a unique code and message. Read more about validation.