ZATCA Fase 2 (Aràbia Saudita): facturació electrònica a Odoo

Aràbia Saudita ha desplegat la facturació electrònica obligatòria en dues fases a través de ZATCA (Zakat, Tax and Customs Authority), amb el nom de Fatoorah. La Fase 1 (des del desembre de 2021) ja exigia generar i conservar factures electròniques estructurades. La Fase 2 va molt més enllà: integració tècnica directa amb la plataforma de l'autoritat.

Què és exactament la Fase 2 (Integration Phase)

La Fase 2 es coneix com la Integration Phase. Ja no n'hi ha prou amb generar la factura: el teu sistema de facturació s'ha de connectar per API amb la plataforma de ZATCA (Fatoora) i seguir un format i un cicle de validació concrets.

ZATCA distingeix dos tipus de document amb fluxos diferents:

• Standard Tax Invoice (B2B/B2G): requereix clearance. La factura s'envia a ZATCA abans de lliurar-la al client; ZATCA la valida, la segella criptogràficament i la torna autoritzada.
• Simplified Tax Invoice (B2C): requereix reporting. Es lliura al client a l'instant amb el seu QR i s'informa a ZATCA dins de les 24 hores següents.

Requisits tècnics que no et pots saltar

• Factura en format XML UBL 2.1 (o PDF/A-3 amb XML incrustat) segons l'esquema de ZATCA.
• Signatura criptogràfica amb un certificat emès per ZATCA després de l'onboarding del dispositiu (CSID).
• Hash encadenat (PIH, Previous Invoice Hash) que enllaça cada factura amb l'anterior i garanteix la integritat de la sèrie.
• Codi QR amb camps TLV (nom del venedor, NIF/VAT, data, total, IVA i el segell criptogràfic) llegible per l'app de ZATCA.
• UUID únic per factura i un comptador seqüencial (ICV) que ZATCA verifica per detectar buits.

Com funciona a Odoo 19

El nostre mòdul integra tot aquest cicle dins del flux de facturació natiu d'Odoo, sense back-offices externs. Quan confirmes una factura, Odoo genera l'XML UBL, calcula el hash encadenat, l'envia a signar amb el certificat de ZATCA, construeix el QR i fa la crida de clearance o reporting segons el tipus de document.

Cada factura guarda el seu estat davant de ZATCA (acceptada, acceptada amb avisos o rebutjada), el missatge de l'autoritat i el segell retornat. Si ZATCA rebutja un document, el motiu queda registrat a la mateixa factura per poder-lo corregir i reenviar, sense perdre la traçabilitat.

Què vigilar abans de la teva data límit

• Confirma la teva wave i la data exacta a la carta de notificació de ZATCA: la finestra d'integració s'obre amb mesos d'antelació però té un termini en ferm.
• Dades mestres netes: el NIF/VAT, l'adreça, el codi postal i el règim d'IVA han de ser correctes a Odoo o el clearance fallarà.
• Prova primer al sandbox de ZATCA: l'onboarding del certificat i les primeres factures s'han de validar a l'entorn de proves abans de passar a producció.
• No barregis sèries: el hash encadenat (PIH) exigeix una numeració contínua; un salt o una factura duplicada trenca la cadena.

ZATCA Fase 2 no és un afegit cosmètic: és un canvi en com s'emet cada factura. Ben fet dins d'Odoo, és transparent per a l'equip de facturació; fet a mitges, es converteix en factures rebutjades i feina manual cada dia.

Què fem sobre això