دولة الإمارات العربية المتحدة فقط. تُطبّق هذه الوحدة نموذج EIS الإماراتي — وهو شبكة Peppol لامركزية بخمس زوايا (بلا جهة تصديق مركزية مسبقة)، يتولى فيها مزوّد خدمة معتمد (ASP) إلزامي إرسال كل مستند. وهو نموذج مختلف عن نموذج هيئة الزكاة والضريبة والجمارك السعودية (نموذج تصديق وإبلاغ مركزي — راجع صفحة السعودية). ولا يحتفظ ColorsX74 مطلقًا ببيانات اعتماد مزوّدك بنص واضح؛ فكل شركة تسجّل حساب مزوّدها الخاص بها.
كيف تترابط الأجزاء
المسودة ليست مستندًا ضريبيًا. تُنشأ الفاتورة الإلكترونية عند إصدار الفاتورة — لا عند حفظ مسودة. فالمسودة تحمل مرجعًا مؤقتًا بالبادئة DRFT-، ولا تُرحّل شيئًا، ولا تنتج فاتورة إلكترونية ولا تستهلك عدّاد الفواتير ولا تضيف سجلًا إلى سلسلة التجزئة. وبمجرد إصدارها تُنشأ فاتورة إلكترونية واحدة بالضبط تحمل رقم الفاتورة النهائي. وإذا تركت المسودة أو حذفتها فلم يُستهلك شيء قط — ومن ثم يبقى التسلسل المُبلَّغ عنه متصلًا بلا فجوات.
الفوترة الإلكترونية الإماراتية إضافة مُقيَّدة بالتفعيل. عند تفعيلها لشركة ما تظهر تحت الفوترة الإلكترونية (الإمارات) في القائمة الجانبية (/einvoicing-uae)، وتُقدَّم واجهتها البرمجية على /api/v1/einvoicing-uae. وهي تسجّل كل فاتورة مبيعات، وتبنيها في صيغة PINT AE الإلزامية (UBL 2.1 — مع CustomizationID urn:peppol:pint:billing-1@ae-1، ونوعَي المستند 380 للفاتورة و381 لإشعار الدائن، ورقم التسجيل الضريبي TRN بوصفه EndpointID في Peppol تحت المخطط 0235، وبالدرهم الإماراتي AED)، ثم تفحصها مقابل قواعد الأعمال الخاصة بـ PINT AE، وترسلها عبر مزوّدك على شبكة Peppol.
انتقل إلى: نموذج الزوايا الخمس · تفعيل الوحدة · صيغ الإرسال · تسجيل مزوّد الخدمة · دورة حياة المستند وحالة الرسالة · الاختبار بالمزوّد الوهمي المدمج · ملاحظات للمشغّل.
نموذج الزوايا الخمس اللامركزي
خلافًا لدول التصديق المركزي، توجّه الإمارات الفواتير عبر شبكة Peppol: أنت (الزاوية 1) ← مزوّد خدمتك (الزاوية 2) ← الشبكة (الزاوية 3) ← مزوّد خدمة المشتري (الزاوية 4) ← المشتري (الزاوية 5)، مع إبلاغ الهيئة الاتحادية للضرائب عبر الشبكة. ولا يمكنك الاتصال بشبكة Peppol مباشرة — إذ إن التعامل عبر مزوّد خدمة معتمد (ASP) إلزامي. يتولى ColorsX74 بناء المستند والتحقق من صحته؛ ويتولى المزوّد المتعاقد معه توقيعه وختمه وإرساله، ثم يعيد إليك حالة الرسالة (MLS).
تفعيل الوحدة
انتقل إلى الشركة المعنية، وافتح الفوترة الإلكترونية (الإمارات) ← الإعدادات (E-Invoicing (UAE) → Settings)، ثم فعّل خيار تمكين الفوترة الإلكترونية الإماراتية. ومنذ تلك اللحظة تُسجَّل كل فاتورة مبيعات تنشئها كمستند فاتورة إلكترونية إماراتية (النوع 380؛ وإشعارات الدائن النوع 381). ويمكنك اختياريًا تجاوز الاسم النظامي للبائع ورقم تسجيله الضريبي من هنا عندما يختلفان عن سجل الشركة.
صيغ الإرسال — UBL خام أو JSON DTO
تقبل مزوّدات الخدمة المختلفة حمولات مختلفة، ولذلك تنتج الوحدة كلتا الصيغتين من إسقاط واحد، وتختار أنت ما يُرسَل من الإعدادات ← صيغة الإرسال (Settings → Wire format):
- UBL خام بصيغة PINT AE — وهو ملف XML القياسي. ويجتاز كل ملف UBL يُنشأ فحص مطابقة يعمل دون اتصال (قواعد PINT AE الإلزامية عالية الأثر: CustomizationID، وEndpointID بالمخطط
0235مع رقم التسجيل الضريبي، وكتل بيانات الطرف الضريبية والنظامية، والدرهم الإماراتي، وفئة ضريبة القيمة المضافة لكل سطر، وتطابق الإجماليات المالية) قبل أن يصبح قابلًا للإرسال — والمستند الذي يخفق يُحتجز مع بيان القاعدة المخالفة بالتحديد، ولا يُرسَل أبدًا. - JSON DTO للمزوّد — شكل JSON موحّد يحمل بيانات PINT AE ذاتها، لمزوّدات الخدمة التي تستهلك واجهتها البرمجية JSON بدلًا من UBL.
- عند رفض إنشاء الفاتورة الإلكترونية، تُوضّح الرسالة السبب. فالأسباب أربعة — أن تكون الفاتورة لا تزال مسودة، أو أن تكون قد أُلغيت، أو ألّا تكون الفوترة الإلكترونية الإماراتية مفعّلة للمنشأة، أو ألّا تكون الفاتورة موجودة. وكانت تُبلَّغ سابقًا برسالة واحدة لا تذكر سوى السببين الأخيرين، فيُوجَّه المشغّل إلى شاشة الإعدادات بحثًا عن خلل لا وجود له بينما الفاتورة ببساطة لم تُصدَر بعد. أمّا الآن فيُذكر كل سبب على وجه التحديد، على نحو مطابق لسلوك هيئة الزكاة والضريبة والجمارك.
تسجيل مزوّد الخدمة المعتمد لديك
افتح الفوترة الإلكترونية (الإمارات) ← مزوّد الخدمة (ASP) (E-Invoicing (UAE) → Service provider (ASP)) وسجّل المزوّد الذي تعاقدت معه، وعنوان واجهته البرمجية، وصيغة الإرسال التي يستهلكها، ومفتاح واجهتك البرمجية وسرّها. وتُخزَّن بيانات الاعتماد مشفَّرة، ولا تُعرض ولا تُسجَّل ولا تُعيدها الواجهة البرمجية مرة أخرى أبدًا — فالشاشة تبيّن فقط ما إذا كانت بيانات الاعتماد محفوظة. واترك حقلَي المفتاح والسر فارغين عند تعديل إعدادات أخرى لإبقاء القيم المحفوظة كما هي.
وقبل أول إرسال فعلي يجب على مستخدم SuperAdmin أن ينفّذ تفعيل بيئة الإنتاج (Arm production) للشركة — وهي خطوة أمان متعمَّدة تُضاف إلى مفتاح الإرسال الفعلي في المنصّة وإلى بيانات الاعتماد المحفوظة. وإلى أن يُفعَّل مزوّد حقيقي ويُمكَّن، يمكنك تجربة المسار كاملًا بالمزوّد الوهمي المدمج (أدناه).
دورة حياة المستند وحالة الرسالة
يمر كل مستند بالمراحل التالية: Recorded (مُسجَّل من الفاتورة) ← Generated (أُنشئ مستند PINT AE وفُحصت مطابقته) ← SubmittedToAsp ← AspAccepted أو AspRejected ← MlsReceived (استقرت حالة التسليم غير المتزامنة على شبكة Peppol). ويوسَم الإخفاق المؤقت أو المحجوب بـ SubmissionFailed ويكون آمنًا لإعادة المحاولة؛ أما خلل الإنشاء أو المطابقة فيوسَم بـ Failed مع بيان القاعدة المخالفة. استخدم الإجراءات المتاحة لكل صف في جدول المستندات: Generate (إنشاء) وSubmit (إرسال) وRefresh status (تحديث الحالة) وView UBL (عرض ملف UBL)؛ ويبيّن عمودا Provider (المزوّد) وMLS (حالة الرسالة) موضع كل مستند.
الاختبار بالمزوّد الوهمي المدمج
يوجد مزوّد وهمي مدمج يعمل دون اتصال ينفّذ الدورة كاملة ذهابًا وحتى استلام حالة الرسالة بلا بيانات اعتماد وبلا شبكة — وهو مثالي لتجربة الدورة قبل التعاقد مع مزوّد خدمة معتمد. اترك المزوّد غير محدَّد (أو اختر mock)، وفعّل الوحدة، وأنشئ فاتورة، ثم نفّذ إنشاء ← إرسال ← تحديث الحالة (Generate → Submit → Refresh status): سترى المستند ينتقل إلى AspAccepted ثم إلى MlsReceived. أما المحوّلات المرجعية للمزوّدات الحقيقية (Complyance وPagero/ClearTax وCygnet.One) فتُشحن خلف مفتاح الإرسال الفعلي، وتُوصَل بالبيئة التجريبية الخاصة بكل مزوّد أثناء التسجيل.
ملاحظات للمشغّل
- شركة واحدة، حساب مزوّد واحد. تُسجَّل كل شركة على حدة. انتقل إلى الشركة أولًا ثم سجّل المزوّد.
- الأسرار تبقى مشفَّرة. يُخزَّن مفتاح واجهة المزوّد البرمجية وسرّه مشفَّرين، ولا تُعرض ولا تُسجَّل ولا تُعاد أبدًا — ولا يظهر سوى مؤشّر يفيد بأن بيانات الاعتماد محفوظة.
- رقم التسجيل الضريبي مطلوب لكلا الطرفين. تتطلب الفاتورة الإلكترونية الإماراتية رقم التسجيل الضريبي للبائع وللمشتري معًا؛ وسيحتجز فحص المطابقة أي مستند ينقصه أحدهما.
- إشعارات الدائن (ذات الإجماليات السالبة) تُصنَّف وتُنشأ تلقائيًا كمستند إشعار دائن من النوع
381. - جاهزية مسبقة. أُعدّت المنظومة قبل بدء سريان الإلزام في الإمارات، بحيث تستطيع الشركة العمل فعليًا في اللحظة التي تحصل فيها على مزوّد معتمد وبيانات اعتماده.