ZATCA Phase 2 (Saudi-Arabien): E-Rechnung in Odoo

Saudi-Arabien hat die verpflichtende E-Rechnung in zwei Phasen über die ZATCA (Zakat, Tax and Customs Authority) eingeführt, unter dem Namen Fatoorah. Phase 1 (seit Dezember 2021) verlangte bereits, strukturierte elektronische Rechnungen zu erstellen und aufzubewahren. Phase 2 geht deutlich weiter: eine direkte technische Anbindung an die Plattform der Behörde.

Was die Phase 2 (Integration Phase) genau ist

Die Phase 2 ist als Integration Phase bekannt. Es genügt nicht mehr, die Rechnung zu erstellen: Ihr Rechnungssystem muss per API mit der Plattform der ZATCA (Fatoora) verbunden sein und ein festgelegtes Format sowie einen festgelegten Validierungszyklus einhalten.

Die ZATCA unterscheidet zwei Dokumentarten mit unterschiedlichen Abläufen:

• Standard Tax Invoice (B2B/B2G): erfordert Clearance. Die Rechnung wird vor der Übergabe an den Kunden an die ZATCA gesendet; diese prüft sie, versieht sie mit einem kryptografischen Siegel und gibt sie freigegeben zurück.
• Simplified Tax Invoice (B2C): erfordert Reporting. Sie wird dem Kunden sofort mit ihrem QR-Code übergeben und innerhalb der folgenden 24 Stunden an die ZATCA gemeldet.

Technische Anforderungen, die Sie nicht umgehen können

• Rechnung im Format XML UBL 2.1 (oder PDF/A-3 mit eingebettetem XML) nach dem Schema der ZATCA.
• Kryptografische Signatur mit einem von der ZATCA ausgestellten Zertifikat nach dem Onboarding des Geräts (CSID).
• Verketteter Hash (PIH, Previous Invoice Hash), der jede Rechnung mit der vorherigen verknüpft und die Integrität der Nummernfolge sicherstellt.
• QR-Code mit TLV-Feldern (Name des Verkäufers, Steuernummer/VAT, Datum, Gesamtbetrag, Mehrwertsteuer und das kryptografische Siegel), lesbar mit der App der ZATCA.
• Eindeutige UUID pro Rechnung und ein fortlaufender Zähler (ICV), den die ZATCA prüft, um Lücken zu erkennen.

So funktioniert es in Odoo 19

Unser Modul bildet diesen gesamten Zyklus im nativen Rechnungsablauf von Odoo ab, ohne externe Back-Offices. Wenn Sie eine Rechnung bestätigen, erzeugt Odoo das UBL-XML, berechnet den verketteten Hash, schickt es zur Signierung mit dem Zertifikat der ZATCA, erstellt den QR-Code und führt je nach Dokumentart den Aufruf für Clearance oder Reporting aus.

Jede Rechnung speichert ihren Status gegenüber der ZATCA (akzeptiert, akzeptiert mit Hinweisen oder abgelehnt), die Meldung der Behörde und das zurückgegebene Siegel. Lehnt die ZATCA ein Dokument ab, wird der Grund in der Rechnung selbst protokolliert, damit Sie es korrigieren und erneut senden können, ohne die Nachvollziehbarkeit zu verlieren.

Worauf Sie vor Ihrer Frist achten sollten

• Bestätigen Sie Ihre Wave und das genaue Datum im Benachrichtigungsschreiben der ZATCA: Das Integrationsfenster öffnet sich Monate im Voraus, hat aber eine feste Frist.
• Saubere Stammdaten: Steuernummer/VAT, Adresse, Postleitzahl und Mehrwertsteuerregelung müssen in Odoo korrekt sein, sonst schlägt die Clearance fehl.
• Testen Sie zuerst in der Sandbox der ZATCA: Das Onboarding des Zertifikats und die ersten Rechnungen müssen in der Testumgebung validiert werden, bevor Sie in die Produktion wechseln.
• Vermischen Sie keine Nummernkreise: Der verkettete Hash (PIH) erfordert eine lückenlose Nummerierung; eine Lücke oder eine doppelte Rechnung unterbricht die Kette.

Die ZATCA Phase 2 ist kein kosmetischer Zusatz: Sie verändert, wie jede einzelne Rechnung ausgestellt wird. Sauber in Odoo umgesetzt, bleibt sie für das Rechnungsteam unsichtbar; halbherzig umgesetzt, führt sie täglich zu abgelehnten Rechnungen und Handarbeit.

Was wir dazu tun