الدليل 6 من 7

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

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

7 دقائق قراءة آخر مراجعة: أكتوبر ٢٠٢٦

قائمة مراجعة البيانات في EgyTax

أغلب أسباب رفض المستندات بيانات أساسية ناقصة. راجع هذه القائمة مرة واحدة قبل أول إرسال:

بيانات الشركة (الإعدادات ← بيانات الشركة): الاسم كما في البطاقة الضريبية، رقم التسجيل الضريبي، كود النشاط، الهاتف، والعنوان.
الفروع: لكل فرع كود الفرع كما في تبويب «الفروع» في ملف الممول على البوابة (الفرع الرئيسي غالباً 0)، وكود النشاط والعنوان، ورقم ماكينة البيع للإيصالات.
المنتجات والخدمات: كل صنف له نوع كود (EGS/GS1) وكود صنف معتمد ووحدة قياس. راجع دليل الأكواد.
الضرائب: نوع الضريبة وكودها الفرعي صحيحان (مثلاً ضريبة القيمة المضافة T1 بنسبة ١٤٪ بالكود الفرعي المناسب لنشاطك).
العملاء: الشركات برقم تسجيل ضريبي من ٩ أرقام، والأفراد برقم قومي عند الحاجة، والعملاء الأجانب كأجانب.
بيانات الربط: Client ID و Client Secret للفاتورة (الدليل ٢) ولنقطة البيع (الدليل ٣)، واختبار الاتصال ناجح لكل منهما.
جهاز التوقيع متصل للفواتير (الدليل ٥).

التجربة على البيئة التجريبية

الخطوة 1: تأكد أن البيئة «تجريبي»

في EgyTax ← الإعدادات ← الربط مع المنظومة تأكد أن كل بطاقة على تجريبي (Preprod) وأن البيانات المدخلة هي بيانات البوابة التجريبية.

الخطوة 2: أصدر فاتورة تجريبية

من الفواتير الإلكترونية أنشئ فاتورة لعميل تجريبي بصنف أو صنفين، ثم أرسلها. تمر بالحالات: في انتظار التوقيع ← تم الإرسال ← صالحة. إذا ظهرت غير صالحة افتحها لترى سبب الرفض من المنظومة، وصححه ثم أعد المحاولة.

الخطوة 3: أصدر إيصالاً تجريبياً

من الإيصالات أنشئ إيصالاً وأرسله، وتابع حالته حتى يُقبل.

الخطوة 4: تحقق من البوابة

ادخل البوابة التجريبية preprod.invoicing.eta.gov.eg ← «الوثائق الأخيرة» وستجد المستندات المرسلة من EgyTax بنفس الأرقام والقيم.

تحذير الشهادة في البوابة التجريبية

البيئة التجريبية للمصلحة تستخدم شهادات أمان داخلية، فقد يظهر لك تحذير «الاتصال غير آمن» عند فتحها من المتصفح. الحل الرسمي من المصلحة هو الوثوق بشهادة الجذر الخاصة بالبيئة التجريبية على أجهزة الاختبار فقط:

افتح صفحة الأسئلة الشائعة في دليل المطورين sdk.preprod.invoicing.eta.gov.eg/faq وحمّل ملف شهادة الجذر (root CA certificate file).
اضغط على الملف بالزر الأيمن واختر Install Certificate.
اختر Local Machine ثم ضعها في مخزن «Trusted Root Certification Authorities». تحتاج صلاحيات مسؤول على Windows.

تعليمات تثبيت شهادة الجذر للبيئة التجريبية — من أدلة مصلحة الضرائب المصرية الرسمية

الشهادة EEI-RootCA-SIT من أدلة مصلحة الضرائب المصرية الرسمية

الانتقال للبيئة الفعلية

البيئة الفعلية لا تعرف شيئاً عما سجلته على التجريبية. كرر الخطوات التالية على البوابات الفعلية:

الخطوة 1: فعّل حساب البيئة الفعلية

اقبل دعوة البيئة الفعلية invoicing.eta.gov.eg بنفس خطوات تفعيل حساب مدير النظام.

الخطوة 2: سجّل EgyTax ونقاط البيع والأكواد من جديد

سجّل نظام ERP على البوابة الفعلية واحصل على Client ID و Client Secret جديدين (الدليل ٢).
سجّل نقطة البيع على الملف الفعلي profile.eta.gov.eg (الدليل ٣).
سجّل استخدام الأكواد أو أرسل أكواد EGS على البوابة الفعلية وانتظر الموافقة (الدليل ٤).

الخطوة 3: حوّل EgyTax إلى «فعلي»

في الإعدادات ← الربط مع المنظومة اضغط فعلي (Production) في كل بطاقة، والصق بيانات البوابة الفعلية، ولمفتاح API في بطاقة الفاتورة أدخل نفس المفتاح الذي كتبته في «مفتاح التشغيل» عند تسجيل النظام على البوابة الفعلية. احفظ ثم اختبر الاتصال.

أول مستند حقيقي

ابدأ بفاتورة حقيقية صغيرة لعميل تعرفه، وتأكد أنها أصبحت صالحة وظهرت على البوابة الفعلية.
اطبع المستند من EgyTax وتأكد من ظهور رمز الاستجابة السريعة (QR) للإيصالات.
أرسل المستندات في نفس يوم إصدارها؛ المنظومة لا تقبل تاريخ إصدار في المستقبل وتحدد مهلة قصيرة للإرسال بعد الإصدار.
إذا أخطأت في فاتورة مقبولة فلا تعدلها: ألغها من EgyTax خلال المهلة التي تسمح بها المنظومة، أو أصدر إشعاراً دائناً/مديناً.