حل المشكلات الشائعة
أشهر رسائل الخطأ من المنظومة وسببها وطريقة حلها.
أخطاء الاتصال وبيانات الربط
invalid_client عند اختبار الاتصال
المنظومة لم تتعرف على Client ID أو Client Secret. الأسباب بالترتيب الأكثر شيوعاً:
- البيئة مختلفة: البيانات من البوابة التجريبية و EgyTax على «فعلي» أو العكس. اضبط البيئة في البطاقة ثم احفظ.
- نسخ غير كامل: مسافة زائدة في البداية أو النهاية، أو حرف ناقص. انسخ القيمة من جديد بزر النسخ.
- المفتاح المستخدم ليس الأحدث: إذا أعدت إنشاء الأسرار، تتوقف المفاتيح القديمة في الموعد الذي اخترته.
- انتهت مدة صلاحية النظام أو المفوض الذي سجله محظور. راجع تبويب ERP أو نقاط البيع في ملف الممول.
- بيانات الفاتورة في بطاقة الإيصال أو العكس. لكل منهما Client ID مختلف.
إشعارات المنظومة لا تصل لـ EgyTax (الحالة تتأخر)
- تأكد أن رابط الاتصال في تسجيل ERP هو نفس رابط الاستدعاء في EgyTax، وأن الموقع يعمل من الإنترنت عبر
https://. - تأكد أن مفتاح التشغيل على البوابة هو نفس مفتاح API في EgyTax حرفياً. إذا ولّدت مفتاحاً جديداً في EgyTax يجب تحديثه في تسجيل ERP على البوابة.
- حتى لو تعطلت الإشعارات، EgyTax يستعلم عن حالة المستندات المرسلة دورياً، فتتحدث الحالة بعد دقائق.
أخطاء نقطة البيع
| الخطأ | السبب والحل |
|---|---|
invalid_posserial | الرقم التسلسلي في EgyTax لا يطابق نقطة البيع المسجلة بهذه البيانات. انسخه من تبويب «نقاط البيع» في ملف الممول كما هو حرفاً بحرف. |
invalid_presharedkey | المفتاح المشترك غير صحيح. اتركه فارغاً في EgyTax ما لم تعطك المصلحة أو مورد الجهاز قيمة محددة. |
invalid_pososversion / invalid_posmodelframework | بيانات نظام تشغيل الجهاز أو موديله لا تطابق التسجيل. تواصل مع الدعم مع ذكر الموديل المسجل. |
| الشركة غير مسموح لها بإصدار إيصالات | أضف «الإيصالات» إلى «المستندات المطلوب إرسالها» في ملف الممول (الخطوة صفر)، أو تواصل مع المصلحة لإضافة علامة B2C للشركة. |
| جهاز «مرسل للاعتماد» أو «غير مفعل» | الجهاز من مورد غير معتمد ولم يُعتمد بعد. تابع طلب الزيارة على pos.eta.gov.eg. |
| رفض كل الإيصالات من جهاز معين | الجهاز متوقف أو مسحوب (Retired) أو انتهى «نشط إلى». سجّل جهازاً بديلاً. |
رفض المستندات (حالة «غير صالحة»)
افتح المستند في EgyTax لترى أسباب الرفض كما أرسلتها المنظومة. أشهرها:
| السبب | الحل |
|---|---|
| كود الصنف غير صحيح أو غير مسجل | الكود غير معتمد لشركتك أو غير نشط في تاريخ المستند. سجّل استخدامه أو انتظر الموافقة (دليل الأكواد)، وتأكد من كتابته كاملاً EG-رقم التسجيل-الكود. |
| كود النشاط غير صحيح | اكتب كود النشاط المسجل للشركة؛ تجده في ملف الممول ← الفروع. الكود يحدد أنواع المستندات المسموح لك بإصدارها. |
| بيانات الفرع أو العنوان | كود الفرع في EgyTax يجب أن يطابق رقم الفرع في ملف الممول (الرئيسي غالباً 0). |
| بيانات المشتري ناقصة | الشركات: رقم تسجيل ضريبي من ٩ أرقام. الأفراد: الرقم القومي مطلوب عندما تتجاوز قيمة المستند الحد الذي تحدده المنظومة. |
| الضريبة أو الحسابات | نوع الضريبة أو كودها الفرعي لا يناسب الصنف، أو نسبة خطأ. راجع الضرائب في EgyTax. |
| تاريخ الإصدار | لا يجوز أن يكون في المستقبل، والمنظومة تقبل الإرسال خلال مهلة قصيرة فقط بعد تاريخ الإصدار. تأكد من ضبط التاريخ والوقت على جهازك. |
| مستند مكرر | تم إرسال نفس المستند (نفس الرقم الداخلي أو نفس البيانات) من قبل. ابحث عنه في EgyTax أو على البوابة قبل إعادة الإرسال. |
التوقيع والتوكن
- الفواتير «في انتظار التوقيع» لفترة طويلة: برنامج ETA Signer متوقف أو الجهاز مغلق. راجع مشكلات التوقيع.
- «No token detected»: التوكن غير موصّل أو تعريفه غير مثبت.
- التوكن مقفول بعد رقم سري خاطئ: يفتحه مُصدِر الشهادة.
- الشهادة منتهية: جددها من الجهة المُصدِرة؛ تاريخ الانتهاء ظاهر في EgyTax ← أجهزة التوقيع.
مشاكل البوابة والحساب
- لم تصلني رسالة الدعوة: راجع Spam، وتأكد من البريد المكتوب في «دعوة المسؤول». راسل einvoice-support@efinance.com.eg.
- لم يصلني كود OTP: انتظر انتهاء العداد واطلب الإرسال مرة أخرى، وتأكد أن رقم الموبايل مكتوب مسبوقاً بـ
+2. - فقدت المفتاح السري: لا يمكن استرجاعه، أعد إنشاء الأسرار من تبويب ERP (الطريقة).
- تحذير الأمان في البوابة التجريبية: ثبّت شهادة الجذر التجريبية على جهاز الاختبار (الطريقة).
- زر «ابدأ التسجيل» لا يعمل: التسجيل الذاتي متوفر على Windows فقط ويحتاج التوكن موصلاً؛ أو استخدم التسجيل عن طريق المأمورية.
- مفوض لا يرى زر تسجيل ERP أو نقطة البيع: صلاحياته لا تشمل «إدارة أنظمة الممول»؛ عدّل وظيفته من حساب مدير النظام.
متى تتواصل مع المصلحة؟
إذا كانت المشكلة في التسجيل أو الصلاحيات أو اعتماد الأكواد والأجهزة فهي من جانب المصلحة:
- الخط الساخن: 16395
- الفاتورة: eInvoice@eta.gov.eg · الإيصال: eReceipt.hd@eta.gov.eg
- اكتب في الرسالة: عنوان الموضوع، الاسم التجاري، رقم التسجيل، رقم تليفون للتواصل، شرحاً مختصراً، وصورة الشاشة أو نص الخطأ.
وإذا كانت المشكلة في EgyTax نفسه (شاشة لا تعمل أو حالة لا تتحدث) تواصل مع دعم EgyTax ، أو اسأل المساعد الذكي داخل حسابك.