الاتصال بمزود الخدمة المعتمد (Taxilla): أوضاع الاختبار وUAT والتشغيل الفعلي
اختر كيفية إرسال الفواتير، وأدخل بيانات اعتماد Taxilla، واختبر الاتصال، وافهم الأوضاع الثلاثة.
تبلّغ عليا بوكس الفواتير الضريبية إلى الهيئة الاتحادية للضرائب من خلال مزود خدمة معتمد (ASP)، وهو Taxilla. وللاتصال ثلاثة أوضاع، بحيث يمكنك التدرب بأمان قبل الإرسالات الفعلية.
الأوضاع
| الوضع | ما يحدث |
|---|---|
| Test (محاكاة) | لا يغادر شيء التطبيق. تتبع الإرسالات سيناريو تختاره وتُوسم بـ TEST. |
| Taxilla UAT | بيئة اختبار Taxilla (uat.entransact.taxilla.com). تحتاج إلى Client ID وSecret لبيئة UAT من Taxilla. |
| Taxilla Live | إرسالات فعلية إلى شبكة Peppol الإماراتية والهيئة الاتحادية للضرائب. استخدمه فقط بعد اجتياز UAT. |
الخطوات
- انتقل إلى Settings → E-invoicing (الإعدادات → الفوترة الإلكترونية). يمكن للمالكين والمسؤولين تغييره.
- تحت Connection mode (وضع الاتصال)، اختر وضعاً.
- للوضع Test، اختر Test scenario (سيناريو الاختبار): Always accept أو Slow processing أو Rejected by Taxilla أو Rejected by buyer أو Rejected by FTA. ينطبق على الإرسالات الجديدة.
- لوضع UAT أو Live، املأ Taxilla credentials (بيانات اعتماد Taxilla): Client ID وClient Secret كما أصدرتها Taxilla أثناء تسجيلك لديها. يبقى Base URL فارغاً: لكل وضع مضيفه (
https://uat.entransact.taxilla.com/accesspoint/v1وhttps://live.entransact.taxilla.com/accesspoint/v1)، ولا تملأه إلا إذا سمّت Taxilla مضيفاً آخر. اترك الحقل فارغاً لاحقاً للاحتفاظ بالقيمة المحفوظة. ويجب أن يكون Peppol ID ضمن Settings → Company profile هو الذي أصدرته Taxilla مع هذه البيانات. - انقر على Save connection (حفظ الاتصال)، ثم Test connection (اختبار الاتصال). تعرض بطاقة Connection status (حالة الاتصال) الوضع النشط ونتيجة آخر اختبار ووقته.
معلومات مفيدة
-
في علامة التبويب نفسها، ضمن Validation strictness، يوجد المفتاح Treat warnings as errors (اعتبار التحذيرات أخطاء). عند تشغيله لا يمكن إصدار فاتورة عليها تحذير حتى يُعالج. الملاحظات التي تشرح فقط ما سترسله عليا بوكس، مثل مشترٍ بلا رقم TRN، تبقى تحذيرات. الأخطاء تمنع الإصدار دائماً سواء كان المفتاح مشغلاً أم لا.
-
في Settings → Company profile، يحدد Legal registration type (نوع التسجيل القانوني) ماهية الرقم في Trade License Number: رخصة تجارية (مع جهة الترخيص) أو هوية إماراتية أو جواز سفر (مع رمز بلد الإصدار المكوّن من حرفين) أو قرار مجلس الوزراء.
-
تُخزن بيانات الاعتماد على الخادم فقط ولا تُعاد أبداً إلى المتصفح. ويمسحها Remove saved credentials (إزالة بيانات الاعتماد المحفوظة).
-
يرسل وضع Live مستندات ضريبية فعلية. لا يمكن حذف المستندات الصادرة أو إعادة تعيينها، بل تصحيحها فقط بإشعارات دائنة أو مدينة.
-
يمكنك العودة إلى وضع Test في أي وقت؛ وتحتفظ المستندات المرسلة بالفعل بحالة UAT أو Live الخاصة بها.
-
تستهلك الإرسالات في UAT وLive رصيد الإرسال من خطتك.
-
الجدول الزمني: التجربة من 1 يوليو 2026؛ يجب على الشركات التي تبلغ إيراداتها 50 مليون درهم أو أكثر تعيين مزود خدمة معتمد بحلول 30 أكتوبر 2026 والانتقال إلى التشغيل الفعلي في 1 يناير 2027؛ وجميع الشركات الأخرى في 1 يوليو 2027؛ والجهات الحكومية في 1 أكتوبر 2027.
-
في وضع Test، يوفر Incoming Invoices → Simulate received invoice (محاكاة فاتورة مستلمة) فواتير موردين مولّدة للسيناريو الذي تختاره (صالحة وأخرى تفشل في التحقق) لتجربة الاستلام والمراجعة والدفع دون Taxilla. انظر محاكاة الفواتير المستلمة.