In Progress
هذا المستند لا يزال قيد الإعداد ولم يكتمل بعد
الربط مع الفاتورة الإلكترونية في الإمارات عبر Orchida osTax
نظرة عامة (Overview)
يدعم NamaERP إرسال الفواتير الإلكترونية إلى الهيئة الاتحادية للضرائب في الإمارات (FTA) عبر مزوّد الخدمة Orchida osTax. تعمل Orchida بصفتها مزوّد خدمة معتمدًا (ASP) ضمن نموذج الفوترة الإلكترونية ذي الخمسة أطراف المبني على شبكة Peppol في الإمارات.
يُرسل النظام الفواتير بصيغة JSON إلى Orchida التي تتحقق منها وتُبلّغ بيانات الضريبة إلى الهيئة الاتحادية للضرائب وتوجّهها إلى المشتري عبر شبكة Peppol.
المتطلبات الأساسية (Prerequisites)
قبل البدء في الإعداد، تحتاج إلى:
- حساب على منصة Orchida osTax (https://app.orchidatax.com)
- مفتاح API (Bearer Token) من لوحة تحكم Orchida
- معرّف الشركة (Company ID) من لوحة تحكم Orchida
الحصول على بيانات الاعتماد من Orchida
- سجّل الدخول إلى لوحة تحكم Orchida
- أدخل رمز OTP المُرسَل إلى بريدك الإلكتروني
- اختر المستأجر والشركة المناسبَين
- اذهب إلى Security > Generate Key
- أنشئ مفتاحًا جديدًا (حدد تاريخ انتهاء الصلاحية والاسم)
- انسخ مفتاح API ومعرّف الشركة
إعداد النظام (System Setup)
الخطوة الأولى: إعدادات الفاتورة الإلكترونية العامة (Step 1: Global E-Invoice Settings)
من الإعدادات العامة > الصفحة الثانية:
- اضبط
e-Invoice Page To ShowعلىUAE Page - بعد تغيير القيمة قم بعمل Regen UI
الخطوة الثانية: إعداد مصلحة الضرائب (Step 2: Tax Payer Configuration)
أنشئ إعداد مصلحة ضرائب جديدًا أو عدّل إعدادًا قائمًا.
المعلومات الأساسية (Basic Information)
| الحقل | القيمة |
|---|---|
| taxPayerType | UAE - Electronic Invoice Staging (للاختبار) أو UAE - Electronic Invoice (للإنتاج) |
| TaxRegNo | رقم التسجيل الضريبي للمنشأة |
إعدادات التكامل (Integration Settings)
| الحقل | الوصف |
|---|---|
| APIURL | يُملأ تلقائيًا عند اختيار نوع مصلحة الضرائب |
| password | مفتاح API من Orchida (Bearer Token) |
| orchidaCompanyID | معرّف الشركة من لوحة تحكم Orchida |
إعداد أكواد الضريبة (Tax Code Configuration)
تتبع أكواد الضريبة في الإمارات معيار UN/EDIFACT 5305 (أكواد فئة الضريبة المنسَّقة).
نوع الضريبة (Tax Type):
| الكود | الوصف |
|---|---|
| VAT | ضريبة القيمة المضافة |
نوع الضريبة الفرعي (Tax SubType):
| الكود | الوصف |
|---|---|
| S | النسبة القياسية (5%) |
| Z | خاضع للضريبة بنسبة صفر |
| E | معفي من الضريبة |
| O | خارج النطاق |
| AE | الاحتساب العكسي |
WARNING
عند استخدام الكود S (النسبة القياسية)، يجب أن تكون نسبة ضريبة القيمة المضافة بالضبط 5.00
الخطوة الثالثة: إعداد العميل (Step 3: Customer Setup)
لكل عميل سيستقبل فواتير إلكترونية، أكمل الحقول التالية:
البيانات الضريبية (Tax Information)
| الحقل | الوصف |
|---|---|
| taxRegNo | رقم التسجيل الضريبي (TRN) للعميل |
| specialNumber | معرّف نقطة نهاية Peppol للعميل |
| description4 | معرّف الجهة (مثلًا TL) |
| description5 | اسم الجهة (مثلًا اسم الشركة) |
العنوان (Address)
| الحقل | الوصف |
|---|---|
| country | كود الدولة (مثلًا AE) |
| city | اسم المدينة |
| street | عنوان الشارع |
| governorate | كود الإمارة |
أكواد الإمارات
| الكود | الإمارة |
|---|---|
| AUH | أبوظبي |
| DXB | دبي |
| SHJ | الشارقة |
| AJM | عجمان |
| UAQ | أم القيوين |
| RAK | رأس الخيمة |
| FUJ | الفجيرة |
الخطوة الرابعة: إعداد وحدات القياس (Step 4: Unit of Measure Setup)
يجب أن تمتلك كل وحدة قياس مستخدمة في الفواتير كودًا صالحًا لدى مصلحة الضرائب وفق معيار UN/ECE Rec 20:
| الكود | الوصف |
|---|---|
| EA | وحدة |
| KGM | كيلوغرام |
| MTR | متر |
| LTR | لتر |
| XBX | صندوق |
| PCE | قطعة |
الخطوة الخامسة: إعداد العملة (Step 5: Currency Setup)
تأكد من وجود عملة بكود مصلحة الضرائب AED وأنها مضبوطة كعملة افتراضية.
إرسال الفواتير (Sending Invoices)
إنشاء وثيقة إرسال لمصلحة الضرائب (Creating a Tax Authority Submission Document)
- اذهب إلى وثيقة إرسال مصلحة الضرائب
- انقر على "تجميع الوثائق" لإضافة الفواتير المراد إرسالها
- انقر على "إرسال" لتقديم الفواتير إلى Orchida
حالات الإرسال (Submission Statuses)
بعد الإرسال تُضبط حالة الوثيقة إلى:
- Sent: قبلت Orchida الفاتورة للمعالجة
- NotValidSent: رُفضت الفاتورة — راجع حقل الأخطاء للاطلاع على التفاصيل
التحقق من حالة الفاتورة في Orchida
بعد الإرسال يمكنك التحقق من الحالة النهائية للفاتورة لدى مصلحة الضرائب:
- من وثيقة إرسال مصلحة الضرائب انقر على "التحقق من حالة الوثائق"
- يتصل النظام بـ Orchida ويستعرض الحالة الحالية
- تُحدَّث الحقول التالية تلقائيًا:
- Status In Tax Authority:
validأوinvalidأوpending - Tax Auth Entity Status Type: يُحدَّث بناءً على استجابة Orchida
- Status In Tax Authority:
WARNING
قد تحتاج Orchida إلى بعض الوقت لمعالجة الفاتورة. إذا كانت الحالة pending، انتظر ثم تحقق مجددًا لاحقًا.
أنواع الوثائق المدعومة (Supported Document Types)
| النوع | مدعوم |
|---|---|
| فاتورة | نعم |
| إشعار دائن | نعم |
| إشعار مدين | لا |
الحد الأقصى لأيام الإرسال (Maximum Days to Send)
العدد الافتراضي للأيام المسموح بها لإرسال الفاتورة بعد تاريخ قيمتها هو 14 يومًا. يمكن تغيير هذا الإعداد في إعداد مصلحة الضرائب ضمن حقل "Max Days To Send Invoice".