دليل الربط مع مصلحة الضرائب

من الصفر حتى أول فاتورة وإيصال مقبول من المصلحة

كل ما تحتاجه لربط شركتك بمنظومة الفاتورة الإلكترونية والإيصال الإلكتروني، مشروحاً خطوة بخطوة بصور من بوابات مصلحة الضرائب نفسها، ثم من EgyTax.

قبل أن تبدأ: جهّز هذه الأشياء

  • رقم التسجيل الضريبي للشركة (٩ أرقام) وبطاقتها الضريبية سارية.
  • شهادة الختم الإلكتروني (E-Seal) على توكن USB من جهة معتمدة مثل Egypt Trust أو MCDR، مع الرقم السري (PIN) الخاص بها. مطلوبة للتسجيل الذاتي ولتوقيع كل فاتورة. التفاصيل في دليل التوقيع الإلكتروني.
  • جهاز كمبيوتر بنظام Windows 10 أو 11 يوصَّل به التوكن (للتسجيل الذاتي ولبرنامج التوقيع).
  • بيانات المسؤول عن المنظومة (مدير النظام): الرقم القومي، بريد إلكتروني يستقبل الرسائل، ورقم موبايل مصري يستقبل الرسائل القصيرة (OTP).
  • كود النشاط الخاص بالشركة وعنوان كل فرع كما هو مسجل في المصلحة (تجدهما في ملف الممول على البوابة بعد التسجيل).
  • قائمة بأصنافك وخدماتك بأسمائها بالعربية والإنجليزية، لتكويدها بنظام EGS أو GS1.
  • حساب على EgyTax، والتجربة المجانية تكفي لإتمام الربط واختباره على البيئة التجريبية.

خطوات الربط بالترتيب

اتبع الأدلة بهذا الترتيب. كل دليل يبدأ مما انتهى إليه الدليل السابق، وفي نهاية كل دليل رابط للتالي.

الدليل 1 · 12 دقائق

التسجيل على منظومة الفاتورة الإلكترونية

إنشاء الملف الرقمي للشركة وحساب مدير النظام وإضافة المفوضين.

الدليل 2 · 8 دقائق

الحصول على Client ID و Client Secret للفاتورة الإلكترونية

تسجيل EgyTax كنظام ERP على بوابة المصلحة ونسخ بيانات الربط.

الدليل 3 · 12 دقائق

تسجيل نقطة البيع وبيانات الإيصال الإلكتروني

تفعيل الإيصالات وتسجيل جهاز نقطة البيع والحصول على بيانات الربط الخاصة به.

الدليل 4 · 10 دقائق

تسجيل أكواد الأصناف EGS و GS1

تكويد السلع والخدمات وطلب موافقة المصلحة قبل استخدامها في المستندات.

الدليل 5 · 8 دقائق

شهادة التوقيع الإلكتروني وتشغيل برنامج ETA Signer

استخراج الختم الإلكتروني (التوكن) وربطه بـ EgyTax لتوقيع الفواتير.

الدليل 6 · 7 دقائق

إدخال البيانات في EgyTax والانتقال للبيئة الفعلية

اختبار الاتصال وإصدار أول مستند ثم التحويل من التجريبي إلى الفعلي.

الدليل 7 · 6 دقائق

حل المشكلات الشائعة

أشهر رسائل الخطأ من المنظومة وسببها وطريقة حلها.

أي الأدلة تحتاج؟

ما تريد إصدارهالأدلة المطلوبة
فواتير إلكترونية فقط (B2B)١ التسجيل، ٢ Client ID للفاتورة، ٤ تكويد الأصناف، ٥ التوقيع الإلكتروني، ٦ الانتقال للفعلي.
إيصالات إلكترونية فقط (B2C)١ التسجيل، ٣ تسجيل نقطة البيع، ٤ تكويد الأصناف، ٦ الانتقال للفعلي. الإيصال لا يُوقَّع بالتوكن.
الاثنان معاًكل الأدلة. بيانات الفاتورة وبيانات نقطة البيع منفصلتان تماماً ولكل منهما Client ID خاص.

البيئة التجريبية والبيئة الفعلية

لمنظومة المصلحة بيئتان منفصلتان تماماً، ولكل واحدة حسابات وبيانات ربط مختلفة:

  • البيئة التجريبية (Preprod): لتجربة الإصدار والإرسال. المستندات فيها ليس لها أي أثر ضريبي.
  • البيئة الفعلية (Production): كل مستند يُرسل منها مستند ضريبي حقيقي له أثر قانوني.
الخدمةالبيئة التجريبيةالبيئة الفعلية
بوابة التسجيل وملف الممولprofile.preprod.eta.gov.egprofile.eta.gov.eg
بوابة الفاتورة والإيصالpreprod.invoicing.eta.gov.eginvoicing.eta.gov.eg
خدمات الهوية (Token)id.preprod.eta.gov.egid.eta.gov.eg
واجهات البرمجة (API)api.preprod.invoicing.eta.gov.egapi.invoicing.eta.gov.eg
بوابة نقاط البيعpos.eta.gov.eg (للأجهزة من موردين غير معتمدين فقط)
دليل المطورين (SDK)sdk.preprod.invoicing.eta.gov.egsdk.invoicing.eta.gov.eg

مصطلحات ستقابلها

المصطلحمعناه
رقم التسجيل (RIN)رقم التسجيل الضريبي للشركة، ٩ أرقام.
مدير النظام / المفوضالشخص الذي يدير حساب الشركة على البوابة ويستطيع دعوة مفوضين آخرين وتسجيل أنظمة ERP ونقاط البيع.
نظام ERPالبرنامج المحاسبي الذي يرسل الفواتير للمنظومة. في حالتك هو EgyTax.
Client ID«معرّف العميل»: اسم المستخدم الخاص بالنظام عند الاتصال بالمنظومة.
Client Secret«مفتاح سري ١» و«مفتاح سري ٢»: كلمة المرور الخاصة بالنظام. تظهر مرة واحدة فقط عند التسجيل.
نقطة البيع (POS)الجهاز أو البرنامج الذي يصدر الإيصالات الإلكترونية، وله رقم تسلسلي وبيانات ربط خاصة.
الختم الإلكتروني (E-Seal)شهادة رقمية على توكن USB تُوقَّع بها الفواتير الإلكترونية نيابة عن الشركة.
EGSالتكويد المصري للسلع والخدمات بالشكل EG-رقم التسجيل-الكود الداخلي، مجاني ويحتاج موافقة المصلحة.
GS1التكويد العالمي (باركود من ١٣ رقماً)، مقابل اشتراك من وكيل GS1 في مصر.
GPCالتصنيف العالمي للسلع والخدمات. يُربط كل كود EGS بكود GPC من المستوى الرابع (Brick) من ٨ أرقام.
كود النشاطكود نشاط الشركة المسجل في المصلحة، ويُرسل مع كل مستند.
Callbackرابط في EgyTax تستدعيه المنظومة لتبلغه فوراً بحالة المستندات.

الدعم الرسمي من مصلحة الضرائب