توثيق الفوترة الإلكترونية في الإمارات (PINT AE) لأودو 19 Community
دليل الفوترة الإلكترونية في الإمارات (PINT AE): المعرّفات وفئات الضريبة، وقائمة فحص الجاهزية وفحص الدفعة، والتحقق من الملفات وقواعد Schematron الرسمية، وصندوق الصادر، والحالات التي يعطيها مزوّد الخدمة، وتصدير XML وZIP، وما لم يُنفَّذ أو لم يُتحقق منه.
يشرح الإصدار 1.0.0حُدّث في 29 أكتوبر 2026
ابدأ هنا
لمن هي: الشركات في دولة الإمارات العربية المتحدة التي تدير فوترتها في أودو 19 وعليها إعداد الفواتير الإلكترونية لمزوّد خدمتها، والمحاسبون والشركاء الذين يجهّزونها لهم.
الأمثلة: تعرض الصور شركة تجريبية هي Al Noor General Trading LLC في دبي، بالدرهم. أسماؤها وأرقام تسجيلها الضريبي ورخصها وهمية وصيغتها صحيحة فقط. لديها إحدى عشرة فاتورة عميل وإشعار دائن واحد من 14 سبتمبر إلى 29 أكتوبر 2026، أُعدّت ملفاتها في 30 أكتوبر 2026 بواسطة Amira Saleh (المدير). ويظهر مزوّد الخدمة باسم Your appointed ASP وكُتبت ردوده يدويًا: لم يُرسل شيء إلى أي جهة. والأرقام في النص هي أرقام الصور.
ما الذي تحصل عليه
| الميزة | ما تفعله |
|---|---|
| ملف PINT AE بصيغة XML | فواتير العملاء (النوع 380) والإشعارات الدائنة (381) والمستندات الخارجة كليًا عن النطاق (480 / 81) بصيغة PINT AE Billing 1.0.4 (UBL 2.1). |
| المعرّفات | رقم التعريف الضريبي (TIN) ورقم التسجيل الضريبي (TRN) وعنوان الفوترة الإلكترونية والتسجيل القانوني (رخصة تجارية، هوية إماراتية، جواز سفر، قرار مجلس الوزراء) للشركة والعملاء؛ ورموز الإمارات من العنوان. |
| فئات الضريبة | S وZ وE وO وAE على ضرائب المبيعات، مع سبب الإعفاء ونوع السلع الخاضعة للاحتساب العكسي؛ مضبوطة مسبقًا على ضرائب أودو الإماراتية. |
| قائمة فحص الجاهزية | نحو 45 فحصًا لكل فاتورة قبل إنشاء أي ملف: المستند، والإشعار الدائن، والبائع، والمشتري، والتصدير، والدفع، والبنود والضرائب، وتقدير مهلة 14 يوم عمل. |
| فحص دفعة | الفحوص نفسها لفترة أو لمجموعة فواتير، مع قائمة المشكلات وزر لإنشاء الجاهزة منها. |
| تحقق محلي | يُفحص كل ملف بمخطط OASIS UBL 2.1 XSD الرسمي (مرفق بالوحدة)، وبقواعد Schematron الرسمية لـ PINT AE عند تثبيتها. |
| أربع نتائج | صالحة، صالحة مع تحذيرات، غير صالحة، لم يكتمل التحقق. ولا تدّعي أكثر مما شُغّل فعلًا. |
| صندوق الصادر | سجل لكل فاتورة بحالته (مسودة، جاهزة، أُرسلت، مقبولة، مرفوضة، خطأ) ومرجع مزوّد الخدمة والتواريخ وبصمة SHA-256 للملف وسجل التحقق وسجل لا يعدّله أحد. |
| الحالات يدويًا | يسجّل المدير ردّ مزوّد الخدمة؛ بالانتقالات المسموحة فقط، مع فحص صيغة المرجع، وسبب للرفض أو الخطأ. |
| التنزيل | ملف XML لمستند واحد، أو ملف ZIP لعدة مستندات مع manifest.json؛ وفحص سلامة الملف المحفوظ. |
| نقطة ربط للموصل | مكان موثّق لموصل مزوّد خدمة مستقبلي. لا يتضمن أي موصل لمزوّد خدمة. |
| العربية | الوحدة مترجمة، والشاشات تعمل من اليمين إلى اليسار. |
المتطلبات
| البند | التفاصيل |
|---|---|
| أودو | 19.0 (Community أو Enterprise) |
| التطبيقات المطلوبة | الفوترة / المحاسبة (account)، واستيراد وتصدير الفواتير الإلكترونية بصيغة UBL/CII (account_edi_ubl_cii)، والإمارات العربية المتحدة - المحاسبة (l10n_ae). وتُثبَّت مع الوحدة إن لم تكن مثبتة. |
| الرخصة | OPL-1 (رخصة أودو الخاصة v1.0) |
| البند | ما يحتاجه |
|---|---|
| الشركة | شركة في الإمارات العربية المتحدة بدليل الحسابات والضرائب الإماراتية (l10n_ae)، ورقم تسجيل ضريبي في حقل الرقم الضريبي، وإمارة في عنوانها. |
| العملاء | رقم تسجيل ضريبي أو رقم تعريف ضريبي، وعنوان فيه الإمارة (أو الولاية / المنطقة في الخارج)، وعنوان الفوترة الإلكترونية إن لم يكن التلقائي. |
| قواعد Schematron الرسمية (اختيارية) | ملفات التحقق لـ PINT AE من OpenPeppol، ينزّلها المدير أو يرفعها من الوحدة. وهي غير مرفقة بالحزمة. |
| saxonche (اختيارية) | حزمة Python saxonche (SaxonC-HE، معالج XSLT 2.0) على خادم أودو لتشغيل القواعد: pip install saxonche في بيئة Python الخاصة بأودو. ودونها تُفحص الملفات بمخطط XSD فقط وتظهر بحالة لم يكتمل التحقق. |
| مزوّد خدمة | عقد مع مزوّد خدمة معتمد. تُعدّ الوحدة الملفات له ولا تحلّ محلّه. |
التثبيت
- فُكّ ضغط الحزمة. بداخلها
taqnix_uae_einvoicing.zip؛ فُكّه لتحصل على المجلدtaqnix_uae_einvoicing. - انسخ المجلد إلى أحد مجلدات
addons_pathفي خادم أودو وأعد تشغيل أودو. - سجّل الدخول كمدير وفعّل وضع المطوّر ثم افتح التطبيقات واضغط تحديث قائمة التطبيقات.
- أزل مرشح «التطبيقات» وابحث عن UAE E-Invoicing واضغط تثبيت.
# or from the command line ./odoo-bin -c odoo.conf -d YOUR_DATABASE -i taqnix_uae_einvoicing --stop-after-init
بعد التثبيت:
- افتح المحاسبة ← المحاسبة ← الفوترة الإلكترونية (الإمارات) ← الإعدادات وفعّل استخدام الفوترة الإلكترونية الإماراتية لهذه الشركة، وأدخل التسجيل القانوني واسم مزوّد خدمتك واضغط حفظ.
- اضغط فئات الضريبة وتحقق من فئة كل ضريبة مبيعات (انظر فئات الضريبة).
- اختياري: اضغط قواعد Schematron لـ PINT AE وثبّت القواعد الرسمية (انظر تثبيت قواعد Schematron الرسمية).
- أكمل معرّفات عملائك (انظر معرّفات الشركة والعملاء).
كيف تعمل مع مزوّد خدمتك
| الخطوة | من يقوم بها | أين في أودو |
|---|---|---|
| 1. رحّل فاتورة العميل أو الإشعار الدائن | أنت | الفاتورة كالمعتاد |
| 2. افحصها | أودو (هذه الوحدة) | تبويب الفوترة الإلكترونية في الإمارات في الفاتورة، أو الفوترة الإلكترونية (الإمارات) ← الجاهزية |
| 3. أنشئ ملف PINT AE وتحقق منه | أودو (هذه الوحدة) | إنشاء الفاتورة الإلكترونية في الفاتورة، أو إنشاء الجاهزة منها |
| 4. سلّم الملف لمزوّد الخدمة | أنت (الموصل اليدوي) | تنزيل XML، أو ملف ZIP من صندوق الصادر |
| 5. إرساله إلى المشتري والإبلاغ عنه للهيئة | مزوّد خدمتك | خارج أودو |
| 6. سجّل ردّ مزوّد الخدمة | المدير | تعيين الحالة في المستند: أُرسلت، مقبولة، مرفوضة أو خطأ |
ينتقل المستند بين الحالات مسودة (أُنشئ لكنه غير صالح، أو أُعيدت الفاتورة إلى مسودة)، وجاهزة (أُنشئ وليس غير صالح)، وأُرسلت إلى مزوّد الخدمة، ثم مقبولة أو مرفوضة أو خطأ. وبعد إرسال المستند لا يمكن إعادة فاتورته إلى مسودة ولا حذفها: صحّحها بإشعار دائن.
معرّفات الشركة والعملاء
في العميل افتح تبويب الفوترة الإلكترونية في الإمارات:
| الحقل | معناه |
|---|---|
| صيغة رقم التسجيل الضريبي | رقم التسجيل الضريبي هو حقل الرقم الضريبي لجهة الاتصال. وتبيّن الشارة صحة صيغته (15 رقمًا يبدأ بـ 1 وينتهي بـ 03). أما وجود الرقم فعلًا فلا تعرفه إلا الهيئة الاتحادية للضرائب ومزوّد خدمتك. |
| رقم التعريف الضريبي (TIN) | رقم التعريف الضريبي ذو الأرقام العشرة. اتركه فارغًا لاستخدام أول 10 أرقام من رقم التسجيل الضريبي (إعداد مصدر رقم التعريف الضريبي). |
| رقم التعريف الضريبي المستخدم في الفواتير الإلكترونية | الرقم الذي سيحمله الملف. |
| عنوان الفوترة الإلكترونية | تلقائي (الإمارات: رقم التعريف الضريبي؛ الخارج: معرّف Peppol وإلا عنوان التصدير)، أو رقم التعريف الضريبي الإماراتي (المخطط 0235)، أو غير خاضع للفوترة الإلكترونية الإماراتية (0235:9900000098)، أو تصدير، المشتري غير مسجّل في Peppol (0235:9900000099)، أو معرّف المشارك في Peppol (حقول Peppol في أودو). |
| معرّف المشتري | لمشترٍ بعنوان محدد مسبقًا وبلا رقم تسجيل ضريبي: معرّف آخر يُكتب في الملف. |
| التسجيل القانوني | الرقم والنوع (TL رخصة تجارية، EID الهوية الإماراتية، PAS جواز السفر، CD قرار مجلس الوزراء) وجهة الإصدار (للرخصة التجارية) أو بلد جواز السفر. |
تُقرأ الإمارة من ولاية العنوان (دبي، أبوظبي، الشارقة، عجمان، أم القيوين، رأس الخيمة، الفجيرة) وتُكتب برمزها في PINT AE (مثل DXB). ويحتاج العميل الأجنبي إلى ولاية / منطقة في عنوانه.
فئات الضريبة
| الفئة | الاستخدام | حقل إضافي |
|---|---|---|
| S - خاضع للنسبة الأساسية (5%) | التوريدات المحلية بنسبة 5% | — |
| Z - خاضع لنسبة الصفر | التوريدات الخاضعة لنسبة الصفر والصادرات (المولّد العام في أودو يكتب E لضريبة محلية 0%، أما الوحدة فتكتب Z) | — |
| E - معفى من ضريبة القيمة المضافة | التوريدات المعفاة | سبب الإعفاء (DL8.46.1 إلى DL8.46.4)، إلزامي |
| O - خارج نطاق ضريبة القيمة المضافة | التوريدات خارج النطاق؛ والمستند الذي كل بنوده O يصبح مستند 480 / 81 | — |
| AE - الاحتساب العكسي | الاحتساب العكسي المحلي على السلع المعنية | نوع السلع الخاضعة للاحتساب العكسي (DL8.48.x)، إلزامي |
افتح الإعدادات ← فئات الضريبة لترى كل ضرائب المبيعات في قائمة واحدة قابلة للتعديل. ويملأ الضبط المسبق للضرائب الإماراتية فئة الضرائب الإماراتية التي لا فئة لها؛ والفئة التي اخترتها لا تُستبدل أبدًا. والضريبة بلا فئة تمنع إنشاء الملف.
قائمة فحص الجاهزية في الفاتورة
في فاتورة عميل أو إشعار دائن مرحَّل لشركة تستخدم الفوترة الإلكترونية الإماراتية، افتح تبويب الفوترة الإلكترونية في الإمارات. ترى نوع المعاملة (BTAE-02)، وعلامة التصدير، وسبب الإشعار الدائن للإشعار الدائن، والمعرّف الفريد بعد إنشاء الملف، وحالة الفاتورة الإلكترونية، وقائمة فحص الجاهزية. وعندما تنجح كل الفحوص اضغط إنشاء الفاتورة الإلكترونية في الترويسة.
| المجموعة | أمثلة على الفحوص |
|---|---|
| المستند | فاتورة عميل أو إشعار دائن، مرحَّل، تاريخ الفاتورة، العملة، ليس سالبًا، نوع معاملة مدعوم، بند واحد على الأقل |
| الإشعار الدائن | سبب الإشعار الدائن (BTAE-03)، والفاتورة الأصلية (إلا لخصم الكمية) |
| البائع | بلد الإمارات، صيغة رقم التسجيل الضريبي، رقم التعريف الضريبي، التسجيل القانوني وجهة إصداره، العنوان، الإمارة |
| المشتري | الاسم، البلد، العنوان، الإمارة أو المنطقة، صيغة رقم التسجيل الضريبي، عنوان الفوترة الإلكترونية، المعرّف |
| التصدير | عنوان التصدير مع علامة التصدير فقط، وعنوان التسليم في الخارج |
| البنود والضرائب | فئة PINT AE واحدة لكل بند، وسبب الإعفاء، والاحتساب العكسي مع رقم تسجيل المشتري، والكمية، والخصم، ورمز GTIN، ورموز الوحدات؛ وضريبة 5% من الإجمالي ضمن الهامش الرسمي |
| التوقيت | خلال 14 يوم عمل (تقدير): تحذير فقط |
تظهر العلامات منطقة تجارة حرة، وتوريد اعتباري، ونظام هامش الربح، وفاتورة ملخّصة، وتوريد مستمر، وفوترة وكيل مُفصَح عنه، وتوريد عبر التجارة الإلكترونية تحت غير مدعوم في هذا الإصدار: وهي للقراءة فقط، والمستند الذي يحتاج إليها يُمنع.
فحص دفعة
- افتح المحاسبة ← المحاسبة ← الفوترة الإلكترونية (الإمارات) ← الجاهزية، أو حدّد فواتير في قائمة فواتير العملاء واختر فحص جاهزية الفوترة الإلكترونية من قائمة الإجراءات.
- اختر التواريخ (أو اتركها فارغة) وأبقِ المستندات غير المُرسلة بعد فقط مفعّلًا.
- اضغط تشغيل الفحوص: تظهر الأعداد تم فحصها وجاهزة وبها أخطاء وأُنشئت مع قائمة المشكلات (المستند، العميل، المستوى، الرسالة).
- اضغط إنشاء الجاهزة منها لإنشاء ملفات الفواتير الخالية من الأخطاء والتحقق منها.
تأخذ الدفعة 2,000 مستند على الأكثر؛ وما زاد فاختر فترة أقصر. ويفعل إجراء إنشاء فواتير PINT AE الإلكترونية في قائمة الفواتير الشيء نفسه دون النافذة.
نتائج التحقق
| النتيجة | متى |
|---|---|
| صالحة | اجتاز مخطط UBL 2.1 XSD وشُغّلت قواعد Schematron الرسمية لـ PINT AE ولم تجد خطأ ولا تحذيرًا. |
| صالحة مع تحذيرات | شُغّل الفحصان دون خطأ، لكن القواعد أو فحوص الجاهزية أعطت تحذيرات. |
| غير صالحة | وجد مخطط XSD أو القواعد خطأ. يبقى المستند مسودة ولا يمكن إرساله عبر موصل. |
| لم يكتمل التحقق | لم يُشغَّل أحد الفحوص: القواعد غير مثبتة، أو حزمة saxonche غير موجودة، أو أحد الفحوص معطّل في الإعدادات، أو تعطّل المعالج (والسبب في السجل). |
يعرض تبويب سجل التحقق في المستند كل فحص وكل قاعدة فشلت بمعرّفها. وبعد تثبيت القواعد أو تصحيح عميل اضغط إعادة التحقق (أو إعادة الإنشاء بعد تغيير الفاتورة). والمستند المُرسل يحتفظ بالتحقق الذي كان له.
تثبيت قواعد Schematron الرسمية
- ثبّت حزمة Python
saxoncheعلى خادم أودو وأعد تشغيله. وتُظهر النافذة حزمة saxonche مثبّتة عند العثور عليها. - افتح الفوترة الإلكترونية (الإمارات) ← الإعدادات ← قواعد Schematron لـ PINT AE.
- إما أن تنزّل الملف بنفسك من العنوان الرسمي المعروض (docs.peppol.eu/poac/ae/pint-ae/resources.zip) وترفعه (ارفع ملفك ثم تثبيت ملف ZIP المرفوع)، وإما أن تفعّل السماح بتنزيل Schematron من docs.peppol.eu في الإعدادات وتضغط التنزيل من docs.peppol.eu (فينزّله الخادم).
- تُقارن بصمة SHA-256 لملف ZIP بالبصمة المتوقعة لـ PINT AE Billing 1.0.4. ولا يُحتفظ إلا بملفات القواعد المترجمة الأربعة وقائمة رموز الوحدات، وتُفحص بصمة كل منها قبل كل استخدام.
- اضغط إعادة التحقق في المستندات المُعدّة من قبل، أو حدّدها في صندوق الصادر واستخدم إجراء إعادة التحقق.
يوقف إيقاف استخدام القواعد المثبّتة التحقق بالقواعد. وتبقى الملفات على الخادم في مجلد بيانات أودو (taqnix_uae_einvoicing/<database>/).
صندوق الصادر
افتح المحاسبة ← المحاسبة ← الفوترة الإلكترونية (الإمارات) ← صندوق الصادر. تعرض القائمة المستند وتاريخ الفاتورة والعميل والنوع والإجمالي وشارتي التحقق والحالة ومرجع مزوّد الخدمة وتاريخ الإنشاء. وتظهر المستندات المرفوضة وذات الخطأ وغير الصالحة بالأحمر، والمقبولة بالرمادي.
| المرشح | يعرض |
|---|---|
| للتسليم إلى مزوّد الخدمة | المستندات الجاهزة |
| مُرسلة | المستندات المُرسلة التي تنتظر الرد |
| المشكلات | المستندات المرفوضة أو ذات الخطأ أو غير الصالحة |
| لم يكتمل التحقق | الملفات التي لم تُشغَّل عليها القواعد أو مخطط XSD |
| الفواتير / الإشعارات الدائنة | النوعان 380 و480 / 381 و81 |
جمّع حسب الحالة أو التحقق أو العميل، وابحث بالاسم أو العميل أو مرجع مزوّد الخدمة أو المعرّف الفريد. وتنشئ الوحدة وحدها المستندات: فلا زر جديد ولا حذف.
مستند الفاتورة الإلكترونية
| القسم | الحقول |
|---|---|
| المستند | الفاتورة / الإشعار الدائن، العميل، النوع، تاريخ الفاتورة، الإجمالي، الاتجاه، الشركة |
| التحقق | التحقق، اجتاز مخطط UBL 2.1 XSD، شُغّلت Schematron وإصدارها، المعرّف الفريد UUID (BTAE-07)، اسم الملف، بصمة SHA-256 |
| مزوّد الخدمة المعتمد | مزوّد الخدمة، مرجع مزوّد الخدمة، تاريخ الإرسال، تاريخ الرد، آخر رسالة |
| أُنشئت | تاريخ الإنشاء، أنشأها |
| الزر | ما يفعله |
|---|---|
| تنزيل XML | ينزّل الملف بعد فحص بصمته SHA-256، ويُسجَّل التنزيل. |
| إعادة الإنشاء | ينشئ الملف من الفاتورة مجددًا (لا بعد الإرسال). |
| إعادة التحقق | يتحقق من الملف المحفوظ مجددًا (لا بعد الإرسال). |
| تعيين الحالة | يسجّل ردّ مزوّد الخدمة (للمديرين). |
| فحص سلامة الملف | يؤكد أن الملف المحفوظ ما زال يحمل بصمته SHA-256 المسجّلة. |
| إرسال إلى مزوّد الخدمة / فحص الحالة | لا يظهران إلا عند تثبيت موصل لمزوّد خدمة واختياره في الإعدادات. |
يُنشأ المعرّف الفريد مرة واحدة من قاعدة البيانات والفاتورة ولا يتغير أبدًا، ولو أُعيد إنشاء الملف. ويحمل تبويبا السجل وملاحظة السجلَّ وملاحظة حرة (للمديرين).
سجّل ردّ مزوّد خدمتك
- سلّم الملف لمزوّد خدمتك (عبر بوابته أو البريد أو القناة التي يحددها).
- في المستند اضغط تعيين الحالة، واختر أُرسلت إلى مزوّد الخدمة واكتب المرجع الذي أعطاك إياه، ثم اضغط تطبيق.
- عندما يرد مزوّد الخدمة اضغط تعيين الحالة مجددًا واختر مقبولة أو مرفوضة أو خطأ مع رسالته.
| من | الانتقالات المسموحة |
|---|---|
| جاهزة | أُرسلت إلى مزوّد الخدمة |
| أُرسلت إلى مزوّد الخدمة | مقبولة، مرفوضة، خطأ |
| خطأ | جاهزة، أُرسلت إلى مزوّد الخدمة |
| مرفوضة | مسودة (للتصحيح وإعادة الإنشاء) |
| مسودة، مقبولة | لا شيء |
يحتاج الرفض أو الخطأ إلى رسالة مزوّد الخدمة. ويُفحص المرجع مقابل صيغة مرجع مزوّد الخدمة في الإعدادات (# رقم، A حرف، * حرف أو رقم). ولا يستطيع أحد تغيير السجل أو حذفه.
التنزيل والتصدير
في صندوق الصادر حدّد مستندات واختر تنزيل ملفات XML (ZIP) من قائمة الإجراءات (1,000 مستند على الأكثر في كل مرة). يحوي ملف ZIP ملف XML لكل مستند وmanifest.json فيه لكل ملف: المستند والنوع والمعرّف الفريد وبصمة SHA-256 والحالة والتحقق والشركة، مع ملاحظة أن الملفات أُعدّت لمزوّد الخدمة ولم تُرسل ولم تُعتمد. ويعيد إعادة التحقق في القائمة نفسها التحقق من المستندات المحددة.
الملف نفسه فاتورة أو إشعار دائن UBL بصيغة PINT AE Billing 1.0.4: CustomizationID urn:peppol:pint:billing-1@ae-1، وProfileID urn:peppol:bis:billing، وعلامات نوع المعاملة، والمعرّف الفريد، والبائع بنقطة نهاية المخطط 0235 ورقم تعريفه الضريبي، ورقم التسجيل الضريبي، والكيان القانوني، والمشتري، ومجاميع الضريبة، والبنود. والمستند بغير الدرهم يحمل أيضًا عملة الضريبة AED وسعر الصرف ومجموع ضريبة ثانيًا بالدرهم والإجمالي بالدرهم.
الإعدادات
افتح المحاسبة ← المحاسبة ← الفوترة الإلكترونية (الإمارات) ← الإعدادات:
| الإعداد | معناه |
|---|---|
| استخدام الفوترة الإلكترونية الإماراتية لهذه الشركة | يُظهر التبويب والأزرار في فواتير هذه الشركة. |
| رقم التسجيل الضريبي للشركة، مصدر رقم التعريف الضريبي، رقم التعريف الضريبي للشركة | يأتي رقم التسجيل من الرقم الضريبي للشركة. من رقم التسجيل الضريبي (أول 10 أرقام) ما لم يُكتب يدويًا، أو مكتوب يدويًا على جهة الاتصال فقط. ويعرض رقم التعريف الضريبي المستخدم في الفواتير الإلكترونية النتيجة. |
| التسجيل القانوني | رقم الشركة ونوعه وجهة إصداره (أو بلد جواز السفر). |
| مزوّد الخدمة المعتمد (ASP) | اسم مزوّد خدمتك، ويظهر في صندوق الصادر؛ ولا تتصل به الوحدة أبدًا. |
| صيغة مرجع مزوّد الخدمة | قناع اختياري يُفحص عند كتابة المرجع، مثل ASP-########. |
| الموصل | يدوي (نزّل ملف XML لمزوّد الخدمة). ولا تظهر خيارات أخرى إلا عند تثبيت وحدة موصل لمزوّد خدمة. |
| وسيلة الدفع الافتراضية | الرمز المكتوب في الفواتير التي بلا حساب بنكي (ومع حساب بنكي: 30، تحويل دائن). |
| التحقق | التحقق بمخطط UBL 2.1 XSD، والتحقق بقواعد Schematron لـ PINT AE، والسماح بتنزيل Schematron من docs.peppol.eu، وحالة القواعد المثبّتة. |
| 14 يوم عمل (تقدير) | أيام عطلة نهاية الأسبوع والعطلات الرسمية (تاريخ في كل سطر) المستخدمة في تحذير المهلة. |
تفتح أزرار التذييل فئات الضريبة والضبط المسبق للضرائب الإماراتية ونافذة قواعد Schematron لـ PINT AE.
من يستطيع ماذا
| المجموعة | تُمنح مع | تستطيع |
|---|---|---|
| مُطّلع | صلاحية المحاسبة للقراءة فقط | فتح صندوق الصادر، وتنزيل XML وملف ZIP، وفحص سلامة الملف |
| مستخدم | صلاحية الفوترة | وأيضًا تشغيل فحوص الجاهزية، وإنشاء الملفات وإعادة إنشائها والتحقق منها |
| مدير | مدير المحاسبة | وأيضًا تغيير الإعدادات، وتسجيل الحالات التي يعطيها مزوّد الخدمة، والإرسال عبر موصل، وتثبيت القواعد، وكتابة الملاحظة |
لا يرى كل مستخدم إلا مستندات الشركات المسموح له بها. ولا يمكن إنشاء سجلات صندوق الصادر أو تعديلها أو حذفها يدويًا، ولا يمكن تغيير السجل ولا حذفه.
كيف يُبنى الملف
| العنصر | كيف تملؤه الوحدة |
|---|---|
| نوع المستند | 380 للفاتورة، و381 للإشعار الدائن؛ و480 / 81 عندما تكون كل البنود خارج النطاق (O)، كما في المثال الرسمي للمستند خارج النطاق. |
| نوع المعاملة (BTAE-02) | ثماني علامات؛ لا تُدعم إلا العلامة 8، الصادرات. والسبع الأخرى تمنع الملف. |
| المعرّف الفريد (BTAE-07) | معرّف UUID من الإصدار 5 يُبنى من معرّف قاعدة البيانات والفاتورة، ويُحفظ عند الإنشاء الأول ولا يتغير أبدًا. |
| البائع | نقطة نهاية 0235 برقم التعريف الضريبي ذي الأرقام العشرة؛ ورقم التسجيل الضريبي في المخطط الضريبي VAT؛ والبائع بلا رقم تسجيل لا يصدر إلا مستندات 480 / 81 (برقم تعريفه الضريبي). |
| المشتري | رقم التعريف الضريبي، أو 0235:9900000098 (غير خاضع)، أو 0235:9900000099 (تصدير، غير مسجّل في Peppol)، أو معرّف Peppol الخاص به. |
| البنود | السعر الصافي بكمية أساس 1 والسعر الإجمالي كخصم على السعر؛ والمبلغان بالدرهم BTAE-08 وBTAE-10 في كل بند (دون BTAE-08 للفئة E)، بالدرهم كما تطلب المواصفة أيًّا كانت عملة الفاتورة. |
| عملة أخرى | عملة الضريبة AED، وسعر الصرف بست خانات عشرية، ومجموع ضريبة ثانٍ بالدرهم، والإجمالي بالدرهم BTAE-20. |
| وسيلة الدفع | 30 عندما يكون للفاتورة حساب بنكي، وإلا فالقيمة الافتراضية في الإعدادات. والرمز ZZZ في أودو ليس في قائمة PINT AE. |
| المبالغ المستحقة | إجمالي المستند (مع التقريب النقدي). ولا تُذكر في الملف الدفعات اللاحقة. ولا يُضمَّن ملف PDF. |
| النصوص | تُحذف الأحرف الممنوعة في XML، ولا عنصر فارغ، ويُهرَّب الباقي. |
يجب أن تساوي ضريبة 5% من مجموع النسبة الأساسية القيمة ضمن الهامش الرسمي (القاعدة aligned-ibrp-s-09). ومع الإعداد الإماراتي الافتراضي في أودو، التقريب لكل بند، قد تنحرف الفاتورة كثيرة البنود: فتمنعها الوحدة وتطلب ضبط تقريب الضريبة على التقريب الإجمالي (Round Globally).
ما فُحص: سبعة مستندات مرجعية أنشأتها الوحدة (فاتورة قياسية، وإشعار دائن، ونسبة الصفر، ومعفاة مختلطة، وخارج النطاق 480، وتصدير بالدولار، واحتساب عكسي) تجتاز مخطط OASIS UBL 2.1 XSD وقواعد Schematron الرسمية لـ PINT AE 1.0.4 (بطبقتيها) دون أي قاعدة فاشلة؛ والملف المعطوب يُبلَّغ عنه غير صالح. وللوحدة 163 اختبارًا آليًا ناجحًا على قاعدة بيانات جديدة.
ما لم يُنفَّذ وما لم يُتحقق منه
ما ليست عليه الوحدة
| النقطة | التفصيل |
|---|---|
| لا إرسال | لا ترسل شيئًا. يرسل مزوّد خدمتك الفاتورة الإلكترونية إلى المشتري ويبلّغ عنها الهيئة الاتحادية للضرائب. |
| لا صفة رسمية | ليست مزوّد خدمة معتمدًا ولا نقطة وصول Peppol، وليست معتمدة ولا موافقًا عليها من وزارة المالية أو الهيئة. |
| لا مزوّد خدمة متصل | يعني يدوي أنك تنزّل الملفات وتسجّل ردود مزوّد الخدمة. ويحتاج موصل مزوّد خدمة حقيقي إلى وثائق واجهته البرمجية وصلاحية اختبار؛ ولا يتضمن أي موصل. |
| لا شيء للهيئة | لا مستند بيانات ضريبية، ولا اتصال بإمارات تاكس، ولا رمز QR ولا توقيع رقمي (لا يوجد في النموذج الإماراتي). |
| لا Peppol أودو | لا يمكن استخدام خدمة Peppol في أودو (IAP) للإمارات. |
المستندات والحالات غير المشمولة
| غير مشمول | ما يحدث |
|---|---|
| الفوترة الذاتية (389 / 261)، ونظام هامش الربح والفئة N، والمنطقة الحرة، والفواتير الملخّصة، والتوريد المستمر، وفوترة الوكيل المُفصَح عنه، والتجارة الإلكترونية، والتوريد الاعتباري | العلامة للقراءة فقط ويُمنع الملف |
| مبيعات B2C وإيصالات نقاط البيع | لا تُعدّ (مبيعات B2C مستثناة من الفوترة الإلكترونية الإماراتية حاليًا) |
| خصومات الدفع المبكر، والضرائب بمبلغ ثابت | تُمنع الفاتورة |
| فاتورة كل بنودها معفاة (وخارج النطاق) | تُمنع: المستند الصحيح لها غير مؤكد، فاسأل مزوّد خدمتك |
| فواتير الموردين | لا تُستورد من الفواتير الإلكترونية |
الفحوص والتحقق
| النقطة | التفصيل |
|---|---|
| الصيغة فقط | تُفحص صيغة أرقام التسجيل والتعريف الضريبي، لا وجودها لدى الهيئة. |
| رقم تحقق GLN | لا تفحص الوحدة رقم التحقق لمعرّف Peppol بالمخطط 0088: ولا تكشفه إلا قواعد Schematron الرسمية (انظر مثال غير صالحة). |
| العملاء الأجانب | يحتاجون إلى ولاية / منطقة (القاعدة ibr-144-ae). ولبلد بلا ولايات في أودو أنشئ ولاية له أولًا من إعدادات جهات الاتصال. |
| التقريب | قد ينحرف التقريب لكل بند أكثر من 0.02 في الفواتير الطويلة: وتُمنع هذه الملفات حتى تختار التقريب الإجمالي. |
| القواعد غير مرفقة | ينزّلها المدير أو يرفعها. ودونها ودون saxonche تكون الملفات لم يكتمل التحقق وليست صالحة أبدًا. |
| رخصة saxonche | غير مذكورة في PyPI ولم يُتحقق منها؛ وsaxonche غير مرفقة بالحزمة. |
| قاعدة الإمارة | في قواعد 1.0.4 لا تعمل قاعدة رمز الإمارة على عنواني البائع والمشتري؛ أما فحص الوحدة فيعمل. |
| نتيجة محلية | حالة صالحة فحص محلي فقط، ومزوّد خدمتك يتحقق مجددًا. |
نقاط لم يؤكدها مصدر رسمي (اسأل مزوّد خدمتك)
| النقطة | ما تفعله الوحدة |
|---|---|
| المعرّف الفريد | تنشئ معرّفًا ثابتًا لكل فاتورة، بينما تقول إرشادات وزارة المالية إن مزوّد الخدمة ينشئه: وقد يستبدله مزوّد خدمتك. |
| مصدر رقم التعريف الضريبي | أول 10 أرقام من رقم التسجيل الضريبي للقيمة المضافة ما لم يُكتب يدويًا؛ واسأل أي رقم تسجيل تستخدم إذا اختلف رقما ضريبة القيمة المضافة وضريبة الشركات (ويظهر تحذير عند عدم تطابق الرقمين). |
| نص الإجمالي بالدرهم (BTAE-20) | يُكتب «AED 1234.56»، منقولًا من المثال الرسمي الوحيد. |
| نسبة الاحتساب العكسي | يحمل الملف نسبة ضريبة أودو (غالبًا 0%)، بينما يعرض المثال الرسمي 5%. وتقبل القواعد الرسمية الاثنتين. |
| أسعار التصدير بالدرهم | يكتب المثال الرسمي للصادرات BTAE-08 / BTAE-10 بالدولار، ونص المواصفة يقول بالدرهم؛ والوحدة تكتبها بالدرهم (وتقبل القواعد الاثنين). |
| 14 يوم عمل | تقدير من أيام العطلة والعطلات التي تُدخلها؛ تحذير فقط. |
| وقت الإصدار IssueTime | لم يتأكد هل هو إلزامي؛ ولا يُكتب. |
| واجهات مزوّدي الخدمة | لم تُختبر أي واجهة لمزوّد خدمة ولا إرسال فعلي ولا تأكيد من الهيئة. |
مواعيد يجب التحقق منها
بحسب قرارات وزارة المالية المذكورة في ملاحظات الوحدة (القرار الوزاري رقم 244 لسنة 2025 بصيغته المعدّلة بالقرار الوزاري رقم 66 لسنة 2026)، كما قُرئت في 29 أكتوبر 2026: كان على الأعمال التي تبلغ إيراداتها 50 مليون درهم أو أكثر تعيين مزوّد خدمة بحلول 30 أكتوبر 2026 وتطبيق الفوترة الإلكترونية اعتبارًا من 1 يناير 2027؛ وتعيّن الأعمال الأخرى مزوّد خدمة بحلول 31 مارس 2027 وتطبّق اعتبارًا من 1 يوليو 2027 (والجهات الحكومية اعتبارًا من 1 أكتوبر 2027). وقد تغيّرت هذه المواعيد مرة من قبل: راجع النص الحالي على موقع وزارة المالية ومع مزوّد خدمتك.
حل المشكلات
| المشكلة | ما العمل |
|---|---|
| لا يظهر تبويب الفوترة الإلكترونية في الإمارات في الفاتورة | فعّل استخدام الفوترة الإلكترونية الإماراتية لهذه الشركة في الإعدادات؛ فيظهر التبويب في فواتير عملائها وإشعاراتها الدائنة (ويُنشأ الملف بعد ترحيلها). ويحتاج مستخدمك إلى مجموعة مُطّلع على الأقل. |
| لا تظهر قائمة الفوترة الإلكترونية (الإمارات) | تقع القائمة تحت المحاسبة ← المحاسبة، ويعرضها أودو لمن لديهم صلاحيات محاسبية. |
| خطأ إمارة العميل | اجعل ولاية عنوان العميل إحدى الإمارات السبع. |
| خطأ منطقة العميل (في الخارج) | أضف ولاية / منطقة إلى العنوان، وأنشئها للبلد إن لم تكن في أودو. |
| ضريبة بلا فئة PINT AE | الإعدادات ← فئات الضريبة، أو الضبط المسبق للضرائب الإماراتية. |
| ضريبة النسبة الأساسية لا تساوي 5% من المبلغ الخاضع | اضبط تقريب الضريبة في الشركة على التقريب الإجمالي وأعد الفاتورة إلى مسودة ثم رحّلها مجددًا. |
| لم يكتمل التحقق | ثبّت saxonche على الخادم وقواعد Schematron الرسمية ثم إعادة التحقق. ويذكر السجل الفحص الذي لم يُشغَّل. |
| غير صالحة | اقرأ القاعدة الفاشلة في سجل التحقق، وصحّح الفاتورة أو العميل، ثم إعادة الإنشاء. |
| عدم تطابق بصمة SHA-256 | تغيّر الملف المحفوظ بعد إنشائه: اضغط إعادة الإنشاء. |
| رُفض مرجع مزوّد الخدمة | لا يطابق صيغة مرجع مزوّد الخدمة في الإعدادات: صحّح المرجع أو الصيغة. |
| لا يمكن إعادة الفاتورة إلى مسودة | أُرسلت فاتورتها الإلكترونية: أصدر إشعارًا دائنًا بدلًا من ذلك. |
التحديث والإزالة
استبدل المجلد بالإصدار الجديد وأعد تشغيل أودو ونفّذ -u taqnix_uae_einvoicing. يُحتفظ بصندوق الصادر وسجله، والمعرّفات في جهات الاتصال، وفئات الضريبة.
عند إلغاء تثبيت الوحدة تبقى ملفات XML المُعدّة مرفقات بفواتيرها، ويُحذف صندوق الصادر وسجله. وتبقى ملفات Schematron المنزّلة في مجلد بيانات أودو (taqnix_uae_einvoicing/<database>/): احذفها يدويًا إن أردت.
الدعم
المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر مع تحديثات مدى الحياة. تواصل معنا عبر صفحة السوق التي اشتريت منها الوحدة أو راسل support@taqnix.com مع إصدار أودو ولقطة شاشة.