أكثر ما يستهلك الوقت ثلاثة أمور: قواعد Schematron التي يطبقها المزود بعد التحقق من المخطط، وصيغ المعرّفات TRN و TIN، وحقيقة أن HTTP 200 من المزود لا يعني قبول المستند.
حقائق أساسية في لمحة
- PINT AE ملف UBL 2.1، وتحدد الإرشادات 51 حقلاً إلزامياً.
- معرّف المواصفات يبدأ بـ
urn:peppol:pint:billing-1@ae-1. - التحقق: XSD ثم قواعد PINT المشتركة ثم قواعد الإمارات.
- المعرّف الضريبي 15 رقماً يبدأ بـ 1 وينتهي بـ 03 (
IBR-132-AE)، ومعرّف تسجيل البائع TIN من 10 أرقام (IBR-148-AE). - النسبة الأساسية 5.00 بالضبط (
IBR-190-AE).
البنية
تعتمد الدولة نموذج الأركان الخمسة. يتكامل نظامك مع الركن 2 (مزودك) فقط، ولا توجد واجهة برمجية لإرسال المستندات من نظام الخاضع للضريبة إلى الهيئة مباشرة.
طبقات التحقق
| الطبقة | ما تفحصه |
|---|---|
| UBL 2.1 XSD | البنية فقط |
| قواعد PINT المشتركة | الحسابات والتفصيلات الضريبية |
| قواعد الإمارات | المعرّفات والنسب والرموز والحالات الخاصة |
القواعد الأكثر إرهاقاً
| القاعدة | المضمون |
|---|---|
IBR-132-AE | المعرّف الضريبي 15 رقماً يبدأ بـ 1 وينتهي بـ 03 |
IBR-148-AE | معرّف تسجيل البائع TIN من 10 أرقام |
IBR-190-AE | النسبة الأساسية 5.00 |
IBR-147-AE | صافي البند = الكمية × (السعر ÷ الكمية الأساسية) + الرسوم - الخصومات |
ALIGNED-IBRP-S-09 | الضريبة = المبلغ الخاضع × النسبة |
IBR-002-AE | سعر الصرف بست خانات عشرية |
IBR-128-AE | رموز الإمارات من قائمة AE |
IBR-055-AE / IBR-158-AE | الإشعار الدائن يحتاج مرجعاً ورمز سبب |
أنماط واجهة المزود
- HTTP 200 ليس قبولاً: اقرأ نتيجة كل مستند في جسم الاستجابة.
- منع التكرار إلزامي: مفتاح ثابت مشتق من هوية المستند.
- المعالجة غير متزامنة: حالات واضحة من المسودة حتى القبول أو الرفض.
- الإشعارات الواردة: تحقق من التوقيع ثم أعد الاستعلام من الواجهة.
العائق الذي لا يذكره أحد
قبل أن يرسل المزود عن بائع، يجب أن يكون البائع مشاركاً مسجلاً قد عيّن المزود عبر إمارات تاكس. اطلب معرّف بائع تجريبياً مرتبطاً كتابياً قبل الاختبار.
السجلات
منذ القرار الوزاري رقم 197 لسنة 2026 لم يعد الحفظ داخل الدولة إلزامياً، لكن احتفظ بملف XML والطلب والاستجابة وملف PDF لكل نسخة مستند طوال المدة المحددة، وبإمكانية تقديمها عند الطلب.
للنص الكامل مع أمثلة الشيفرة، اطّلع على النسخة الإنجليزية من هذا الدليل، ومكتبتنا مفتوحة المصدر pint-ae.
الأسئلة الشائعة
هل يمكن لنظامي الإرسال إلى الهيئة مباشرة؟
لا. يرسل إلى مزود خدمة معتمد يتولى الإرسال والإبلاغ.
لماذا يجتاز ملفي XSD ثم يُرفض؟
لأن XSD يفحص البنية فقط، والرفض يأتي غالباً من قواعد PINT المشتركة وقواعد الإمارات.
ما الفرق بين TRN و TIN في PINT AE؟
TRN معرّف ضريبي من 15 رقماً يبدأ بـ 1 وينتهي بـ 03، و TIN معرّف من 10 أرقام لتسجيل البائع، وليسا قابلين للتبديل.
هل تعني HTTP 200 القبول؟
لا. نتيجة كل مستند داخل جسم الاستجابة.
