ملف UBL 2.1 XML
الفاتورة مستند XML مُهيكل وفق ملف تعريف UBL 2.1 لدى الهيئة، وليست ملف PDF مكتوبًا عليه بيانات. والـPDF، إن وُجد، هو الوجه المقروء للـXML.
السعودية · زاتكا · منصة فاتورة
تُلزم المرحلة الثانية من زاتكا المنشأة بربط نظام الفوترة لديها بمنصة فاتورة: تُصدَر كل فاتورة بصيغة UBL 2.1 XML، وتحمل معرّفًا فريدًا (UUID) وختمًا تشفيريًا يُنشأ بشهادة تُصدرها الهيئة لوحدة إصدار بعينها، وقيمة تجزئة (hash) للفاتورة السابقة، ورمز QR — مع مقاصّة الفواتير الضريبية القياسية لدى الهيئة قبل تسليمها للمشتري، والإبلاغ عن الفواتير المبسطة بعد إصدارها. ولا يفي أودو ولا ERPNext بهذا جاهزًا في أي إصدار؛ فالتغطية تأتي من وحدة توطين إضافة إلى إعداد واختبار ينفّذهما من يتولى التطبيق.
للفوترة الإلكترونية في السعودية مرحلتان. المرحلة الأولى، مرحلة الإصدار، بدأت في ٤ ديسمبر ٢٠٢١ وتسري على كل مكلف مسجَّل في ضريبة القيمة المضافة: تُصدَر الفواتير عبر نظام إلكتروني متوافق لا بخط اليد، وتتضمن الحقول الإلزامية ومنها رمز QR. والمرحلة الثانية، مرحلة الربط، بدأت في ١ يناير ٢٠٢٣ وتُطبَّق على موجات، وهي التي تضيف الجزء الصعب: الربط التقني بأنظمة الهيئة.
موجتك تتحدد بإيراداتك الخاضعة للضريبة في السنوات التي تسميها الهيئة، وتذكر الهيئة أنها تُبلغ كل موجة قبل ستة أشهر على الأقل من موعد ربطها. فالموعد إذن ليس مفاجأة، لكن ستة أشهر مدة قصيرة لمشروع ERP عليه أيضًا أن يعالج شجرة الحسابات ودليل الأصناف وإعداد الضرائب وقوالب الطباعة.
أما ما يغفله أغلب الموردين فهو أن النظام وحده لا يجعلك ممتثلًا. في أودو توطين سعودي ضمن المنتج، وفي ERPNext تطبيقات زاتكا يصونها المجتمع والموردون. كلاهما يمنحك نقطة انطلاق، ولا يأتي أيٌّ منهما مُعدًّا لمنشأتك وشهاداتك وأنواع فواتيرك وأجهزتك، ولا يعفي أيٌّ منهما من اختبارات التوافق الواجب اجتيازها قبل موعد الربط.
تنفّذ BDC كلًا من أودو وERPNext، وليست شريكًا رسميًا لأيٍّ منهما، ولا تتقاضى عمولة من أيٍّ منهما.
أكثر معلومة على هذه الصفحة عرضةً للتقادم، ومجموعة في مكان واحد ليسهل تدقيقها. كل موجة يحددها حدّ إيرادات؛ ومتى تجاوزت إيراداتك في أيٍّ من السنوات المذكورة ذلك الحدّ دخلت في تلك الموجة وفي كل ما يليها.
| الموجة | من تشملهم | موعد الربط |
|---|---|---|
| الموجة ١ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ٣ مليارات ريال في ٢٠٢١ | من ١ يناير ٢٠٢٣ |
| الموجة ٢ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ٥٠٠ مليون ريال في ٢٠٢١ | من ١ يوليو ٢٠٢٣ |
| الموجة ٣ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ٢٥٠ مليون ريال في ٢٠٢١ أو ٢٠٢٢ | من ١ أكتوبر ٢٠٢٣ |
| الموجة ٤ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ١٥٠ مليون ريال في ٢٠٢١ أو ٢٠٢٢ | من ١ نوفمبر ٢٠٢٣ |
| الموجة ٥ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ١٠٠ مليون ريال في ٢٠٢١ أو ٢٠٢٢ | من ١ ديسمبر ٢٠٢٣ |
| الموجة ٦ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ٧٠ مليون ريال في ٢٠٢١ أو ٢٠٢٢ | من ١ يناير ٢٠٢٤ |
| الموجة ٧ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ٥٠ مليون ريال في ٢٠٢١ أو ٢٠٢٢ | من ١ فبراير ٢٠٢٤ |
| الموجة ٨ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ٤٠ مليون ريال في ٢٠٢١ أو ٢٠٢٢ | من ١ مارس ٢٠٢٤ |
| الموجة ٩ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ٣٠ مليون ريال في ٢٠٢١ أو ٢٠٢٢ | من ١ يونيو ٢٠٢٤ |
| الموجة ١٠ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ٢٥ مليون ريال في ٢٠٢٢ أو ٢٠٢٣ | من ١ أكتوبر ٢٠٢٤ |
| الموجة ١١ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ١٥ مليون ريال في ٢٠٢٢ أو ٢٠٢٣ | من ١ نوفمبر ٢٠٢٤ |
| الموجة ١٢ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ١٠ ملايين ريال في ٢٠٢٢ أو ٢٠٢٣ | من ١ ديسمبر ٢٠٢٤ |
| الموجة ١٣ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ٧ ملايين ريال في ٢٠٢٢ أو ٢٠٢٣ | من ١ يناير ٢٠٢٥ |
| الموجة ١٤ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ٥ ملايين ريال في ٢٠٢٢ أو ٢٠٢٣ | من ١ فبراير ٢٠٢٥ |
| الموجة ١٥ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ٤ ملايين ريال في ٢٠٢٢ أو ٢٠٢٣ | من ١ مارس ٢٠٢٥ |
| الموجة ١٦ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ٣ ملايين ريال في ٢٠٢٢ أو ٢٠٢٣ | من ١ أبريل ٢٠٢٥ |
| الموجة ١٧ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ٢٫٥ مليون ريال في ٢٠٢٢ أو ٢٠٢٣ | بحد أقصى ٣١ يوليو ٢٠٢٥ |
| الموجة ١٨ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز مليوني ريال في ٢٠٢٢ أو ٢٠٢٣ | بحد أقصى ٣١ أغسطس ٢٠٢٥ |
| الموجة ١٩ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ١٫٧٥ مليون ريال في ٢٠٢٢ أو ٢٠٢٣ | بحد أقصى ٣٠ سبتمبر ٢٠٢٥ |
| الموجة ٢٠ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ١٫٥ مليون ريال في ٢٠٢٢ أو ٢٠٢٣ | بحد أقصى ٣١ أكتوبر ٢٠٢٥ |
| الموجة ٢١ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ١٫٢٥ مليون ريال في ٢٠٢٢ أو ٢٠٢٣ أو ٢٠٢٤ | بحد أقصى ٣٠ نوفمبر ٢٠٢٥ |
| الموجة ٢٢ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز مليون ريال في ٢٠٢٢ أو ٢٠٢٣ أو ٢٠٢٤ | بحد أقصى ٣١ ديسمبر ٢٠٢٥ |
| الموجة ٢٣ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ٧٥٠٬٠٠٠ ريال في ٢٠٢٢ أو ٢٠٢٣ أو ٢٠٢٤ | بحد أقصى ٣١ مارس ٢٠٢٦ |
| الموجة ٢٤ | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ٣٧٥٬٠٠٠ ريال في ٢٠٢٢ أو ٢٠٢٣ أو ٢٠٢٤ | بحد أقصى ٣٠ يونيو ٢٠٢٦ |
| الموجة ٢٥ — الحالية | إيرادات خاضعة لضريبة القيمة المضافة تتجاوز ١٨٧٬٥٠٠ ريال في ٢٠٢٢ أو ٢٠٢٣ أو ٢٠٢٤ أو ٢٠٢٥ | بحد أقصى ١ فبراير ٢٠٢٧ |
رُوجعت بتاريخ 2026-08-09. وثمة أمر يستحق الذكر لأن غيرنا لا يذكره: أزالت الهيئة أغلب إعلانات الموجات القديمة من موقعها، فصفحات الموجات ١–٢١ و٢٣ و٢٤ تُرجع الآن صفحة «غير موجود»، ولم تبقَ أرقامها إلا في نسخ محركات البحث عن صفحات الهيئة نفسها. أما إعلانا الموجة ٢٢ والموجة ٢٥ فما زالا متاحين وقُرئا مباشرةً، وكذلك صفحة مراحل التطبيق — غير أن جدول الموجات فيها صورة لا نص. لذا نعدّ الموجات ٢٢ و٢٤ و٢٥ مؤكدة، ونعدّ الصفوف الأقدم والموجة ٢٣ موثوقة لا قابلة للتحقق اليوم. وقد دأبت الهيئة على إعلان موجة جديدة كل بضعة أشهر بحدّ أقل في كل مرة، فإن كنت تقرأ هذا بعد ذلك التاريخ بمدة فابدأ بالتحقق من الصفّين الأخيرين.
هذه هي المتطلبات التي تفصل فاتورة يطبعها برنامج محاسبة عن فاتورة تقبلها الهيئة. وكل واحد منها موضع يمكن أن يسقط فيه التطبيق في اختبار التوافق دون ضجيج.
الفاتورة مستند XML مُهيكل وفق ملف تعريف UBL 2.1 لدى الهيئة، وليست ملف PDF مكتوبًا عليه بيانات. والـPDF، إن وُجد، هو الوجه المقروء للـXML.
يحمل كل مستند معرّفًا فريدًا عالميًا وقيمة عدّاد متسلسلة. والفجوة أو التكرار ليسا مشكلة شكلية، بل يكسران السلسلة.
الفواتير المبسطة يختمها نظامك بمعرّف ختم تشفيري صادر لوحدة إصدار بعينها، لا للمنشأة إجمالًا. أما الفواتير القياسية فتختمها الهيئة نفسها أثناء المقاصّة.
تتضمن كل فاتورة قيمة تجزئة سابقتها، فتتشكل سلسلة مترابطة. واستعادة قاعدة بيانات إلى نقطة أقدم دون إدراك ذلك تكسر السلسلة.
رمز QR بترميز Base64 يحمل تسعة حقول بصيغة Tag-Length-Value. خمسة منها سارية منذ المرحلة الأولى: اسم البائع ورقمه الضريبي والتاريخ والوقت والإجمالي شامل الضريبة وإجمالي الضريبة. وتضيف المرحلة الثانية تجزئة الفاتورة والتوقيع والمفتاح العام، وفي الفواتير المبسطة توقيع الهيئة على ذلك المفتاح.
تخضع الفواتير الضريبية القياسية للمقاصّة لدى الهيئة قبل تسليمها للمشتري. أما الفواتير المبسطة فتُصدَر أولًا ثم يُبلَّغ عنها خلال المهلة التي يحددها القرار.
تُسجَّل كل وحدة إصدار فواتير عبر منصة فاتورة، فتحصل على شهادة توافق أولًا ثم شهادة إنتاج بعد اجتياز فحوص التوافق لدى الهيئة.
أجهزة نقاط البيع وأنظمة الفروع وكل وحدة تُصدر مستندًا تحتاج كل واحدة منها إلى تسجيل خاص بها. وربط ERP واحد لا يغطي أسطولًا من نقاط البيع.
ادعاء يستحق التدقيق
ابحث عن برنامج فوترة إلكترونية في السعودية وستجد أن كل نتيجة تقريبًا تصف نفسها بأنها «معتمدة من هيئة الزكاة والضريبة والجمارك». الهيئة تنشر فعلًا دليلًا لمزودي الحلول، لكنها لا تعتمد أيًّا منهم ولا تصادق عليه ولا تمنحه شهادة — وتقول ذلك صراحةً في صفحة الدليل نفسها.
حقيقة الدليل أنه قائمة استرشادية غير ملزمة تضم مزودين أبدوا استعدادهم لتوفير حلول متوافقة. وتنفي الهيئة صراحةً أن يكون الإدراج اعتمادًا منها، وتُخلي مسؤوليتها عن نشر القائمة أصلًا. وللمكلف أن يستعين بأي مزود، مدرَجًا كان أو غير مدرَج، ما دامت الفواتير مستوفية للمتطلبات — والامتثال يُقاس على المكلف لا على المورد.
ويذهب القرار المنظم للتطبيق أبعد مما يدركه أكثر الناس. فهو ينص على أن الحل يُعدّ متوافقًا بعد التحقق من مطابقته من قِبل الهيئة، أو من طرف ثالث، أو بإقرار ذاتي من المكلف نفسه. فالإقرار الذاتي مسموح به صراحةً، ولا وجود لشهادة منتج إلزامية يحملها أحد، ولهذا لا يحملها أحد.
وللأمر أثر تجاري. تُستخدم عبارة «معتمد من الهيئة» لتبرير فارق سعر ولإغلاق القرار مبكرًا. وهي ادعاء تسويقي لا اعتماد، ولا ينبغي لمورد نزيه أن يستند إليها — ونحن منهم. أما الحقيقي فهو فحص التوافق الذي تُجريه الهيئة أثناء التسجيل على وحدة إصدار بعينها مرتبطة برقمك الضريبي وبشهادة تلك الوحدة: وهو يتحقق من إعدادك أنت لا من منتج، ويجب اجتيازه من جديد لكل وحدة تسجّلها. ويستطيع المورد أن يقول بصدق إنه مُدرَج في دليل الهيئة الاسترشادي، أو إنه سجّل وحدات بنجاح. أما «معتمد» فليست متاحة لتُقال.
«هذه القائمة استرشادية وغير ملزمة على المكلفين… ولا تعتبر هذه القائمة بمثابة اعتماد من الهيئة للحلول التقنية التي يقدمها مزودو الحلول المدرجون في القائمة. كما لا تتحمل الهيئة أية مسؤولية تنشأ عن نشر هذه القائمة سواء بشكل مباشر أو غير مباشر.»
هيئة الزكاة والضريبة والجمارك، دليل مزودي الحلول. قُرئ في ٨ أغسطس ٢٠٢٦.
نقطة انطلاق صادقة لقرار الاختيار. لا أحد من المنتجين متوافق عند التركيب؛ والفرق في مصدر التوطين ومن يتولى صيانته.
| المحور | Odoo | ERPNext |
|---|---|---|
| مصدر التوطين | توطين ضريبي سعودي تصونه Odoo ضمن المنتج، ويُثبَّت كوحدة توطين. | تطبيقات زاتكا يصونها المجتمع وموردون، تُثبَّت فوق ERPNext وعدد منها مفتوح المصدر. |
| التوافق جاهزًا عند التركيب | لا. الوحدة أساس فقط؛ أما الشهادات وأنواع الفواتير والضرائب وقوالب الطباعة فكلها عمل إعداد. | لا. التطبيق أساس بالشروط نفسها، ويضاف إليه سؤال: أي تطبيق تعتمده معيارًا لديك. |
| من يعالج تغيّر متطلبات الهيئة | Odoo وفق دورة إصداراتها، ثم يطبّق منفّذك الترقية على نسختك. | من يصون التطبيق الذي اخترته. راجع سجل التعديلات قبل أن تعتمد عليه — هذا معيار اختيار حقيقي. |
| نقاط البيع والفواتير المبسطة | مغطّاة ضمن التوطين لنقاط بيع Odoo، لكن كل جهاز يظل بحاجة إلى تسجيل واختبار مستقلين. | يتوقف على التطبيق وعلى طريقة بناء دورة التجزئة لديك، والاحتمال أكبر لعمل مخصص. |
| ما يقع دائمًا على المنفّذ | تسجيل كل وحدة، واختبار التوافق، وإعداد الضرائب والأصناف، وقوالب الطباعة، وتدريب الفريق، وخطة للموجة التالية. | القائمة نفسها بلا تغيير. وهذا هو الجزء الذي لا يلغيه أي منتج. |
المنتجان يتغيران. تحقّق من الحالة الحالية للتوطين في الإصدار الذي تنوي تشغيله قبل أن تلتزم — فوحدة غطّت المرحلة الثانية قبل إصدارين ليست دليلًا على الإصدار الذي ستنشره.
لا شيء استثنائي. القيمة في أداء الخطوات غير اللامعة بترتيب يترك وقتًا لتسقط في فحص التوافق مرة وتظل قادرًا على اللحاق بالموعد.
نقارن إيراداتك الخاضعة للضريبة بالحدود الحالية، ونبحث عن إشعار الهيئة إن كان قد وصل. هذه الخطوة تحكم الجدول الزمني كله.
قياسية ومبسطة، وإشعارات دائنة ومدينة، وتصدير، وفروع، وكل جهاز يُصدر مستندًا. هنا يُستهان بالنطاق عادةً.
إعداد الضرائب ودليل الأصناف وأرقام العملاء الضريبية وعناوينهم. أغلب حالات عدم التوافق مشكلات بيانات في ثوب تقني.
نثبّت التوطين ونعدّه، ونسجّل كل وحدة عبر منصة فاتورة، ونجتاز فحوص التوافق في بيئة المحاكاة.
نُصدر مستندات حقيقية على البيئة التجريبية قبل تحويل الإنتاج، حتى يقع أول خطأ في مكان لا يكلفك فاتورة.
تدريب موثّق، مع تذكير في تقويمك بإعلان الموجة التالية، لأن الحدود تواصل الانخفاض وشركات المجموعة تُستهدف لاحقًا.
كل رقم في هذه الصفحة مأخوذ من إحدى صفحات الهيئة التالية. وإن كانت إحداها قد تغيّرت بعد التاريخ أدناه، فالصواب لدى الهيئة والتقادم عندنا.
آخر مراجعة لهذه المصادر بتاريخ 2026-08-09
إجابات مباشرة عمّا تسأل عنه الإدارات المالية السعودية قبل بدء مشروع المرحلة الثانية.
لا، ولا أحدهما. في أودو توطين ضريبي سعودي، وفي ERPNext تطبيقات زاتكا يصونها المجتمع، لكن النظام في الحالتين يظل بحاجة إلى إعداد لأنواع فواتيرك وضرائبك وبيانات أصنافك، وإلى تسجيل كل وحدة على حدة عبر منصة فاتورة، وإلى اجتياز فحوص التوافق لدى الهيئة. المنتج يمنحك أساسًا، والتطبيق هو ما يمنحك الامتثال.
لا. تنشر الهيئة دليلًا لمزودي الحلول، لكنها تذكر في الصفحة نفسها أن القائمة استرشادية وغير ملزمة، وأن الإدراج «لا يُعتبر بمثابة اعتماد من الهيئة للحلول التقنية»، وأنها لا تتحمل أي مسؤولية عن نشرها. فمن يسوّق نفسه بوصفه «معتمدًا من زاتكا» يصف إدراجًا في قائمة لا اعتمادًا. والامتثال يُقاس على المكلف وعلى الفواتير، لا على اسم منتج.
من إيراداتك الخاضعة لضريبة القيمة المضافة في السنوات التي تحددها الهيئة لكل موجة. فمتى تجاوزت إيراداتك في أيٍّ من تلك السنوات حدّ موجة، وقعت ضمنها. كما تذكر الهيئة أنها تُبلغ المكلفين المستهدفين مباشرةً قبل ستة أشهر على الأقل من موعد ربطهم، فالإشعار هو الجواب القاطع — لكن جدول الحدود يتيح لك أن ترى الأمر قادمًا قبل وصول الخطاب.
الفاتورة الضريبية القياسية هي مستند التعامل مع المنشآت والجهات الحكومية، وفي المرحلة الثانية يجب أن تخضع للمقاصّة لدى الهيئة قبل تسليمها للمشتري. أما الفاتورة المبسطة فهي مستند البيع للمستهلك عند نقطة البيع؛ تُسلَّم للعميل فورًا ويُبلَّغ عنها للهيئة بعد ذلك خلال المهلة المقررة. ولكل منهما مسار تقني مختلف، ولهذا يحمل نشاط التجزئة عبء ربط أكبر من تاجر جملة بالحجم نفسه.
ينتقل نظام الإصدار الإلكتروني المتوافق والحقول الإلزامية ورمز QR. ولا ينتقل الربط نفسه: الختم التشفيري، والشهادة الصادرة لكل وحدة إصدار، وسلسلة التجزئة، ونداء المقاصّة أو الإبلاغ إلى منصة فاتورة. عمليًا، رتّبت المرحلة الأولى بياناتك وقوالب طباعتك، والمرحلة الثانية مشروع تقني حقيقي فوق ذلك.
تكفي إذا كان نظام ERP لديك يعمل بالفعل وبياناتك الأساسية نظيفة. ولا تكفي إن كنت ستختار النظام وتنفّذه في المدة نفسها، لأن عمل الامتثال يقع في نهاية مشروع تميل مراحله الأولى إلى التأخر. فإن كنت تتوقع أن تكون ضمن موجة قادمة، فالخطوة المفيدة أن تبدأ قبل الإشعار لا بعده.
نعم. التسجيل يتم لكل وحدة إصدار فواتير، فكل جهاز أو نظام فرع يُصدر مستندات يُسجَّل ويُختبر بذاته. فمنشأة لديها نظام ERP واحد وأربعون نقطة بيع أمامها واحد وأربعون تسجيلًا لا تسجيل واحد. وهذا أكثر سبب منفرد يجعل مشروع زاتكا في التجزئة أطول من التقدير.
تنشر الهيئة دليلًا لتصنيف المخالفات، وبنيته أهم من مبالغه: تبدأ المخالفات العامة بتنبيه ومهلة للمعالجة — ثلاثون يومًا لمخالفات الربط والإصدار، وستون يومًا لأمور مثل خلو الفاتورة من رمز QR أو الحفظ غير المطابق — ولا تتصاعد الغرامات إلا بالتكرار، ويسقط التكرار بمرور اثني عشر شهرًا دون إعادة. فتأخّر أول تعالجه سريعًا وضع مختلف عن تأخّر مستمر. واقرأ الدليل الحالي لا الأرقام المتداولة في المدونات، فعدد منها من إصدار ٢٠٢٢ الملغى.
لا، ولا يستطيع ذلك أحد غيرنا. لا توجد شهادة يصدرها منفّذ. ما نستطيعه هو إعداد النظام وتسجيل وحداتك واجتياز فحوص التوافق لدى الهيئة معك وتوثيق ما جرى. تنفّذ BDC كلًا من أودو وERPNext، وليست شريكًا رسميًا لأيٍّ منهما، ولا تتقاضى عمولة من أيٍّ منهما، لذا فالتوصية بأي نظام تستخدم ليست بيع رخصة متنكرًا.
مراجعة قصيرة لموجتك وأنواع فواتيرك ونظامك الحالي، وجواب صريح عن حجم العمل بينك وبين موعد ربطك.
اطلب مراجعة جاهزية زاتكا