دليل الربط بين أودو والفاتورة الإلكترونية في مصر

الفاتورة الإلكترونية المصرية

أودو متوافق مع متطلبات مصلحة الضرائب المصرية (ETA).

⚠️ ملاحظة مهمة:

الفاتورة الإلكترونية المصرية متوفرة ابتداءً من إصدار Odoo 15.0. قم بترقية قاعدة بياناتك إذا لزم الأمر.

التثبيت

قم بتثبيت التطبيقات التالية:

الاسم	الاسم التقني	الوصف
Egypt - Accounting	l10n_eg	الحزمة الافتراضية للتوطين المالي المصري
Egyptian E-invoice Integration	l10n_eg_edi_eta	التكامل مع هيئة الضرائب المصرية (ETA) للفوترة الإلكترونية

تسجيل أودو في بوابة مصلحة الضرائب المصرية (ETA Portal)

يجب تسجيل نظام أودو الخاص بك على بوابة مصلحة الضرائب المصرية للحصول على بيانات واجهة البرمجة (API credentials) اللازمة لإعدادات تطبيق المحاسبة في أودو.

1. انتقل إلى ملف شركتك التعريفي على بوابة المصلحة عبر خيار عرض الملف الشحصي لدافع الضرائب (View Taxpayer Profile).

   

2. 
   

   
   

3. بعد الدخول، انتقل إلى قسم المفوضين (Representatives) ثم اضغط على تسجيل ERP (Register ERP).

4. املأ اسم النظام في حقل ERP Name (مثلاً: أودو) واترك باقي الحقول فارغة.

5. 
   

   
   

   

بعد التسجيل بنجاح، ستظهر لك بيانات الدخول (API credentials):

• معرف العميل (Client ID)

  
  

• معرف سري 1 (Client Secret 1)

• معرف سري2 (Client Secret 2) 

  
  

📝 ملاحظات:

• ستمنحك المصلحة اسم مستخدم وكلمة مرور للوصول إلى البوابة الإلكترونية.

• اطلب من المصلحة تزويدك ببيانات الدخول إلى بوابة الاختبار (Preproduction portal) أيضًا.

• هذه البيانات سرّية ويجب حفظها بأمان.

الإعدادات في أودو

لربط قاعدة بيانات أودو بحسابك في بوابة مصلحة الضرائب المصرية:

1. انتقل إلى المحاسبة → الإعدادات → إعدادات الفوترة الإلكترونية (ETA E-Invoicing Settings).

   
   

2. أدخل ETA Client ID و ETA Secret التي حصلت عليها عند تسجيل أودو في البوابة.

   
   

3. يمكنك تحديد حد أدنى للفوترة (Invoicing Threshold) إذا لزم الأمر.

4. 
   

   
   

📌 ملاحظة مهمة:

• قم بالاختبار أولاً في بيئة الاختبار (Preproduction) قبل إصدار أي فواتير فعلية على البوابة الفعلية (Production).

• بيانات الدخول لكل بيئة مختلفة. تأكد من تحديثها عند الانتقال بين البيئتين.

• تأكد من إدخال تفاصيل الشركة (العنوان الكامل، الدولة، الرقم الضريبي).

 

أكواد مصلحة الضرائب المصرية (ETA Codes)

تعتمد الفاتورة الإلكترونية على مجموعة من الأكواد التي تحددها المصلحة. يمكنك الرجوع إلى توثيق ETA لتكويد خصائص عملك.

أودو يعالج معظم هذه الأكواد تلقائيًا طالما تم إعداد الفروع، العملاء، والمنتجات بشكل صحيح.

معلومات الشركة:

• الرقم الضريبي للشركة

  
  

• رمز الفرع (Branch ID) - إذا كان لديك فرع واحد فقط استخدم الرقم 0.

  
  

• رمز نوع النشاط (Activity Type Code)

  
  

معلومات أخرى:

• أكواد المنتجات: يجب مطابقة المنتجات مع أكواد GS1 أو EGS.

  
  

• أكواد الضرائب: تم إعداد معظم أكواد الضرائب مسبقًا في حقل ETA Code (Egypt) في أودو، تحقق من تطابقها مع ضرائب شركتك.

  
  

📚 راجع أيضًا:

 [Egyptian eInvoicing & eReceipt SDK - Code Tables]

الفروع

أنشئ جهة اتصال ودفتراً محاسبيًا (Journal) لكل فرع من فروع شركتك مع إعدادات مصلحة الضرائب الخاصة به.

1. انتقل إلى المحاسبة - الإعدادات - الدفاتر المحاسبية (Journals) واضغط على إنشاء.

   
   

2. قم بتسمية الدفتر باسم الفرع وحدد النوع: مبيعات.

   
   

3. في تبويب الإعدادات المتقدمة (Advanced Settings)، املأ قسم إعدادات مصلحة الضرائب المصرية (Egyptian ETA settings):

   
   

4. • اختر جهة الاتصال الخاصة بالفرع.

     
     

   • أدخل رمز النشاط (Activity Code).

     
     

   • أدخل رمز الفرع (Branch ID) (استخدم 0 إذا كان لديك فرع واحد فقط).

     

     
     

   
   

   ⚠️ ملاحظة:

   يجب أن تكون جهة الاتصال المحددة في حقل "الفرع" من نوع شركة (Company) وليست فرد (Individual)، ويجب تعبئة عنوانها ورقمها الضريبي.

العملاء

تأكد من تعبئة بيانات عملائك بشكل صحيح حتى تكون الفواتير الإلكترونية صالحة:

• نوع جهة الاتصال: فرد أو شركة

  
  

• الدولة

  
  

• الرقم الضريبي (للشركات) أو الرقم القومي (للأفراد)

  
  

  📍 لتعديل بيانات العملاء:

  اذهب إلى تطبيق المحاسبة - قسم العملاء - العملاء 

المنتجات

تأكد من إعداد بيانات المنتجات بشكل صحيح حتى تكون الفواتير الإلكترونية صالحة:

• نوع المنتج: البضائع (Goods)، أو خدمة (Service).

  
  

• وحدة القياس (UoM): إذا كنت تستخدم تطبيق المخزون.

  
  

• الباركود: رمز GS1 أو EGS.

  
  

• رمز الصنف لدى المصلحة (ETA Item Code): تحت تبويب المحاسبة (Accounting) إذا لم يتطابق الباركود مع رمز المصلحة.

  
  

📍 لتحرير المنتجات:

 اذهب إلى المحاسبة - العملاء - المنتجات

التوقيع الإكتروني عبر USB

كل شخص يحتاج إلى توقيع الفواتير إلكترونيًا يجب أن يمتلك USB مخصص للمصادقة والإرسال إلى بوابة المصلحة عبر الـ ERP.

ملحوظة

📞 يمكنك التواصل مع إيجبت تراست للحصول على التوقيع.

تثبيت أودو كـ (Local Proxy)

يعمل Local Proxy كجسر بين جهازك وقاعدة بيانات أودو المستضافة على الإنترنت.

1. قم بتحميل أودو المجتمعي (Odoo Community) من الصفحة:

   🔗 https://www.odoo.com/page/download

2. أثناء التثبيت، اختر نوع التثبيت Odoo IoT فقط.

⚠️ ملحوظة

 هذا التثبيت لا يضيف تطبيقات أودو إلى جهازك، بل يعمل فقط كـ Server.

بعد التثبيت، سيظهر لك رمز وصول (Access Token) خاص بالخادم المحلي. انسخه واحتفظ به بأمان لاستخدامه لاحقًا.

إعدادات USB

بعد تثبيت Local Proxy على جهازك، يمكنك ربطه بقاعدة بيانات أودو:

1. انتقل إلى المحاسبة - الإعدادات - (Thumb Drive) واضغط على إنشاء.

   
   

2. أدخل اسم الشركة، رقم تعريف USB Pin الذي قدمه لك مزود التوقيع، ورمز الوصول (Access Token) الذي حصلت عليه من Local Proxy.

   
   

3. اضغط على حفظ ثم على الحصول على الشهادة (Get Certificate).

   نرحب بمساعدتك فى اى استفسار يخص الفاتورة الإلكترونية     تواصل معنا