Skip to Content

Saudi Arabia ZATCA Phase 2 E-Invoice (FATOORAH)

by
Odoo

$ 79.07

v 19.0 Third Party
Live Preview
Versions 18.0 19.0
You bought this module and need support? Click here!

الفوترة الإلكترونية السعودية زاتكا المرحلة الثانية لأودو 18 و19

تكامل شامل مع منصة فاتورة: UBL 2.1، توقيعات XAdES B-B، رمز QR بترميز TLV، وواجهة برمجة تطبيقات للتصديق والإبلاغ.

OPL-1 أودو 18 + 19 ثنائي اللغة عربي/إنجليزي بيئة تجريبية وإنتاجية

بانر الفوترة الإلكترونية زاتكا المرحلة الثانية لأودو بعلامة فاتورة

ما هي المرحلة الثانية من زاتكا؟

تُلزم هيئة الزكاة والضريبة والجمارك (زاتكا) بتطبيق المرحلة الثانية ("مرحلة الربط") من الفوترة الإلكترونية منذ يناير 2023. يجب أن تُصدر كل فاتورة داخل المملكة كمستند XML موقّع بصيغة UBL 2.1، مع تجزئة (hash) مرتبطة بتجزئة الفاتورة السابقة، وختم برمز QR مرمّز بصيغة TLV، وأن تُصدَّق آنياً (B2B) أو يُبلَّغ عنها خلال 24 ساعة (B2C) إلى منصة فاتورة التابعة لزاتكا.

يوفّر هذا التطبيق المسار الكامل بشكل أصلي داخل أودو: من توليد زوج مفاتيح EC secp256k1 وطلب CSR، مروراً بالتأهيل عبر رمز OTP إلى /compliance/csid، وتنفيذ جميع سيناريوهات الامتثال الاثني عشر الإلزامية، واستخراج شهادة الإنتاج Production CSID، وصولاً إلى توقيع كل فاتورة عميل وإرسالها دون مغادرة واجهة أودو.

الميزات الرئيسية

مولّد UBL 2.1. جميع عناصر UBL الإلزامية لدى زاتكا: ProfileID وUUID وICV وPIH وAdditionalDocumentReference وAccountingSupplier/Customer وDelivery وPaymentMeans وAllowanceCharge وإجماليات TaxTotal وLegalMonetaryTotal وInvoiceLine.
توقيع XAdES B-B. توقيع <ds:Signature> مضمّن داخل <ext:UBLExtensions>. باستخدام ECDSA secp256k1 + SHA-256، مع SignedProperties التي تتضمن وقت التوقيع وشهادة التوقيع.
مُرمِّز QR بصيغة TLV. حمولة من 5 حقول للفواتير المبسطة B2C، وحمولة كاملة من 9 حقول للفواتير العادية B2B تشمل تجزئة XML والتوقيع والمفتاح العام وبصمة الختم.
أداة بناء CSR. شهادة CSR بصيغة X.509 تتضمن جميع السمات المطلوبة من زاتكا: CommonName وOU وO وC=SA وserialNumber وUID وtitle (النوع الفرعي للفاتورة) وregisteredAddress وbusinessCategory.
معالج التأهيل. تجربة من ست خطوات ترشد المسؤول عبر إنشاء CSR وإرسال OTP وشهادة الامتثال Compliance CSID وسيناريوهات الامتثال الاثني عشر واستبدال شهادة الإنتاج Production CSID.
التصديق والإبلاغ. واجهة متزامنة /invoices/clearance/single للفواتير العادية B2B، وواجهة غير متزامنة /invoices/reporting/single للفواتير المبسطة B2C.
مهمة إعادة المحاولة. إعادة محاولة عمليات الإبلاغ الفاشلة كل 30 دقيقة حتى 10 محاولات.
سلسلة PIH. يُسجَّل تجزئة كل فاتورة كقيمة PIH للفاتورة التالية؛ مما يضمن مقاومة التلاعب.
تقارير ثنائية اللغة. قوالب فاتورة A4 وقوالب حرارية 80 مم مع تسميات عربية وإنجليزية جنباً إلى جنب ورمز QR مضمّن.
تحميلات من بوابة العميل. نقاط نهاية في بوابة العميل لتحميل XML الموقّع وصورة QR وحمولة QR بصيغة Base64.
بيئة تجريبية أو إنتاجية. تبديل لكل جهاز؛ يدعم بيئة زاتكا التجريبية للمطورين وبوابة المحاكاة أيضاً.
تعدد الشركات. جهاز زاتكا واحد لكل شركة مع قواعد سجلات صارمة خاصة بكل شركة.

كيف يعمل التأهيل

  1. افتح المحاسبة -> الإعدادات -> زاتكا -> التأهيل، وأدخل الرقم الضريبي للشركة (15 رقماً، يبدأ بـ 3)، والسجل التجاري CR (10 أرقام)، والاسم الشائع لجهاز EGS.
  2. انقر على "إنشاء CSR" ليتم توليد زوج مفاتيح EC secp256k1 وطلب CSR متوافق مع زاتكا وتخزينهما على الجهاز.
  3. سجّل الدخول إلى بوابة زاتكا على fatoora.zatca.gov.sa، واختر "تسجيل جهاز جديد"، وانسخ رمز التحقق OTP المكوّن من 6 أرقام.
  4. الصق رمز OTP في الخطوة 3 ليقوم التطبيق باستبدال CSR + OTP بشهادة الامتثال Compliance CSID.
  5. تُنفَّذ في الخطوة 4 سيناريوهات الامتثال الإلزامية الاثني عشر تلقائياً.
  6. تستبدل الخطوة 5 شهادة الامتثال Compliance CSID بشهادة الإنتاج Production CSID، ليصبح الجهاز جاهزاً للعمل الفعلي.

سيناريوهات الامتثال المشمولة

#السيناريوالنوع
1فاتورة ضريبية عاديةB2B
2إشعار دائن عاديB2B
3إشعار مدين عاديB2B
4فاتورة ضريبية مبسطةB2C
5إشعار دائن مبسطB2C
6إشعار مدين مبسطB2C
7فاتورة متعددة البنودالكل
8فاتورة بخصمالكل
9فاتورة برسوم إضافيةالكل
10فاتورة بفئات ضريبية متعددةالكل
11فاتورة تصدير (معدل صفري)الكل
12فاتورة معفاةالكل

ما الذي يتضمنه التطبيق

  • مولّد فواتير UBL 2.1 مكتوب بلغة Python بالكامل (باستخدام cryptography وlxml)
  • موقّع رقمي XML من نوع XAdES B-B باستخدام EC secp256k1
  • أداة بناء CSR متوافقة مع زاتكا تتضمن كامل معرّفات OID الإلزامية ومعرّفات OID الخاصة بزاتكا
  • مُرمِّز QR بصيغة TLV / Base64 (5 حقول لـ B2C، 9 حقول لـ B2B)
  • عميل HTTP لواجهات Compliance CSID وProduction CSID والتصديق (Clearance) والإبلاغ (Reporting) وفواتير اختبار الامتثال
  • خطاف ما بعد الترحيل في Account.move: تجزئة، تسلسل، توقيع، QR، إرسال - تلقائياً مع كل فاتورة عميل
  • معالج التأهيل ومعالج فحص الامتثال
  • تقارير QWeb ثنائية اللغة بصيغة A4 و80 مم حرارية مع رمز QR مضمّن
  • نقاط نهاية في بوابة العميل لتحميل XML / QR
  • تسميات ثنائية اللغة عربي/إنجليزي تظهر مباشرة في الواجهة وتقارير الفاتورة QWeb / الحرارية
  • قواعد سجلات متعددة الشركات ومجموعات أمان مخصصة لزاتكا

الأسئلة الشائعة

هل يعمل التطبيق مع أودو 18 وأودو 19؟

نعم، يتم صيانة فرعين منفصلين 18.0 و19.0، ولكل منهما رقم إصدار مناسب في ملف manifest.

هل يتطلب اتصالاً بالإنترنت؟

نعم، لإرسال الفواتير إلى واجهتي التصديق (Clearance) والإبلاغ (Reporting) لدى زاتكا. تُخزَّن المحاولات الفاشلة محلياً ويُعاد إرسالها عبر مهمة مجدولة (cron) كل 30 دقيقة.

هل يدعم تعدد الشركات؟

نعم. لكل شركة في أودو سجل جهاز زاتكا خاص بها يتضمن CSR وCSID وسلسلة PIH مستقلة.

هل رمز QR صالح لتطبيق التحقق الرسمي التابع لزاتكا؟

نعم. يتبع تنسيق TLV بدقة الدليل الفني التفصيلي لزاتكا الإصدار 3: 5 حقول إلزامية للفواتير المبسطة، و9 حقول تشمل تجزئة XML والتوقيع والمفتاح العام وبصمة الختم للفواتير العادية.

ما الترخيص الذي يصدر التطبيق بموجبه؟

OPL-1 (ترخيص أودو الخاص).

المتطلبات

  • أودو 18.0 أو 19.0 - الإصدار المجتمعي / المؤسسي
  • بايثون: lxml وcryptography وqrcode وrequests وPillow
  • شركة سعودية مسجلة بضريبة قيمة مضافة مكوّنة من 15 رقماً

كيف يتصل هذا التطبيق بزاتكا (BYOK)

هذا التطبيق هو أداة لتوليد الصيغة ونقلها. فهو يُنشئ ملف XML بصيغة UBL 2.1 المتوافقة مع زاتكا، ويوقّعه بمفتاحك الخاص من نوع EC secp256k1، ويرسله إلى زاتكا باستخدام بيانات اعتماد Compliance وProduction CSID الخاصة بك، والتي تحصل عليها بنفسك مباشرة من بوابة فاتورة الرسمية أثناء التأهيل (أحضر مفاتيحك الخاصة / أحضر بيانات اعتمادك الخاصة).

  • أنت المكلّف المسجّل. العلاقة القانونية للفوترة الإلكترونية هي بين شركتك وزاتكا. نحن مزوّد برمجيات فقط، ولسنا مزوّد خدمة معتمداً لدى زاتكا أو جهة تكامل أو وكيل تصديق، ولا نتصرف نيابة عنك أمام الهيئة أبداً.
  • مفاتيحك وبيانات اعتمادك تبقى في قاعدة بياناتك. يتم توليد المفتاح الخاص وCSR ورموز CSID والأسرار وتخزينها على مثيل أودو الخاص بك؛ ولا يمر شيء عبر خوادمنا.
  • يتم التأهيل من قبلك باستخدام المعالج داخل التطبيق مع رمز OTP الذي تنسخه من بوابة زاتكا الرسمية.

هذه الأداة تُنشئ فاتورة UBL 2.1 المتوافقة مع هيئة الزكاة والضريبة والجمارك (زاتكا) وتوقّعها بمفتاحك الخاص وترسلها باستخدام بيانات اعتمادك (CSID) التي تحصل عليها بنفسك من منصة فاتورة الرسمية. أنت المكلّف المسجّل، ونحن مزوّد برمجيات فقط ولسنا مزوّد خدمة معتمداً لدى الهيئة.

الدعم وسياسة الاسترداد

يُقدَّم الدعم عبر البريد الإلكتروني على pokutsoft.com. نستجيب لطلبات التثبيت والإعداد وإصلاح الأخطاء للإصدارين المدعومين 18.0 و19.0 من أودو. وبما أن هذا كود مصدري قابل للتحميل، فإن الاسترداد يخضع لسياسة متجر تطبيقات أودو: تواصل معنا أولاً وسنعمل على حل أي عيب حقيقي؛ وإذا تعذّر حل المشكلة المُبلَّغ عنها فسيتم إصدار استرداد وفقاً لتلك السياسة.

الفوترة الإلكترونية السعودية زاتكا المرحلة الثانية لأودو - من Pokutsoft - pokutsoft.com

Update date: 2026-07-09

Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Discuss (mail)
• Invoicing (account)
Lines of code 2950
Technical Name l10n_sa_zatca_einvoice
LicenseOPL-1
Websitehttps://pokutsoft.com 
Odoo Proprietary License v1.0

This software and associated files (the "Software") may only be used (executed,
modified, executed after modifications) if you have purchased a valid license
from the authors, typically via Odoo Apps, or if you have received a written
agreement from the authors of the Software (see the COPYRIGHT file).

You may develop Odoo modules that use the Software as a library (typically
by depending on it, importing it and using its resources), but without copying
any source code or material from the Software. You may distribute those
modules under the license of your choice, provided that this license is
compatible with the terms of the Odoo Proprietary License (For example:
LGPL, MIT, or proprietary licenses similar to this one).

It is forbidden to publish, distribute, sublicense, or sell copies of the Software
or modified copies of the Software.

The above copyright notice and this permission notice must be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.