الحصول على Client ID و Client Secret للفاتورة الإلكترونية
تسجيل EgyTax كنظام ERP على بوابة المصلحة ونسخ بيانات الربط.
أولاً: جهّز بيانات الاتصال من EgyTax
نموذج تسجيل نظام ERP على البوابة يطلب «رابط الاتصال» و«مفتاح التشغيل». هذان يأتيان من EgyTax، فجهّزهما قبل فتح البوابة.
الخطوة 1: افتح إعدادات الربط في EgyTax
ادخل EgyTax بحساب مالك الشركة أو مستخدم له صلاحية الإعدادات، ثم من القائمة الجانبية الإعدادات ← تبويب الربط مع المنظومة. ستجد بطاقة الفاتورة الإلكترونية (نظام ERP).
الخطوة 2: اختر البيئة وأنشئ مفتاح API
- اختر تجريبي (Preprod) أو فعلي (Production) حسب البوابة التي ستسجل عليها الآن.
- في خانة مفتاح API (لاتصال المنظومة) اضغط أيقونة التحديث لتوليد مفتاح عشوائي قوي، ثم احفظ الإعدادات.
- انسخ مفتاح API بأيقونة النسخ واحتفظ به مؤقتاً.
- انسخ رابط الاستدعاء (Callback)، وهو بالشكل
https://موقعك/api/eta/callback/كود-خاص-بشركتك.
ثانياً: سجّل EgyTax كنظام ERP على بوابة المصلحة
الخطوة 3: ادخل البوابة كمدير النظام وافتح ملف الممول
ادخل بوابة المصلحة للبيئة المطلوبة بحساب مدير النظام (الذي أنشأته في دليل التسجيل). من القائمة اختر إدارة ملف التعريف ← ملف الممول (المظلل بالأحمر).
الخطوة 4: افتح تبويب ERP واضغط «تسجيل ERP»
انزل لأسفل الصفحة حتى قسم المفوضين، اختر تبويب ERP، ثم اضغط + تسجيل ERP (المظلل بالأحمر).
الخطوة 5: املأ نموذج «إضافة ERP»
يفتح نموذج «إضافة ERP». املأ الحقول هكذا:
| الحقل في البوابة | ماذا تكتب |
|---|---|
| اسم النظام | اسم يميّز النظام عندك، مثلاً EgyTax
(أو EgyTax - الفرع الرئيسي إن كان لديك أكثر من نظام). |
| مدة الصلاحية | المدة التي يبقى فيها النظام مصرحاً له بالإرسال: سنة أو سنتان أو ٣ سنوات. بعد انتهائها تحتاج لتجديد المفاتيح. |
| رابط الاتصال | الصق رابط الاستدعاء (Callback) الذي نسخته من EgyTax. تكتب الجزء بعد https:// لأن البادئة مكتوبة في الحقل. |
| مفتاح التشغيل | الصق مفتاح API الذي ولّدته في EgyTax. يجب أن يكون نفس المفتاح حرفياً. |
| نظام ERP الأساسي | ضع علامة ✓ إذا كان EgyTax هو النظام الرئيسي الذي تصدر منه الفواتير. |
اضغط تسجيل (أو حفظ).
الخطوة 6: انسخ Client ID والمفاتيح السرية فوراً
تظهر نافذة بها ثلاث قيم مع زر نسخ بجانب كل منها، ورسالة: «يرجى نسخ هذه المعلومات وحفظها في مكان آمن، لأسباب أمنية لا يمكننا عرضها لك مرة أخرى».
- معرّف العميل =
Client ID - مفتاح سري ١ =
Client Secretالذي ستستخدمه - مفتاح سري ٢ = مفتاح احتياطي يعمل بنفس الطريقة
انسخ القيم الثلاث في ملف نصي أو مدير كلمات مرور، ثم ضع علامة على أؤكد أنني قمت بنسخ وحفظ أسرار العميل واضغط تم.
ثالثاً: ضع Client ID و Client Secret في EgyTax
الخطوة 7: الصق القيم واحفظ
ارجع إلى EgyTax ← الإعدادات ← الربط مع المنظومة ← بطاقة الفاتورة الإلكترونية (نظام ERP):
- تأكد أن البيئة المختارة (تجريبي / فعلي) هي نفس البوابة التي سجلت عليها.
- الصق معرّف العميل في خانة
Client ID. - الصق مفتاح سري ١ في خانة
Client Secret. - اضغط حفظ أسفل الصفحة.
الخطوة 8: اختبر الاتصال
بعد الحفظ اضغط اختبار الاتصال في نفس البطاقة. EgyTax يطلب رمز دخول (Token) من خدمات الهوية بالمنظومة بهذه البيانات:
- نجح الاتصال: الربط سليم، وتستطيع إرسال الفواتير بعد تجهيز أكواد الأصناف والتوقيع الإلكتروني.
- رسالة خطأ مثل
invalid_client: راجع حل المشكلات. السبب الأشهر أن البيانات من البيئة التجريبية بينما EgyTax مضبوط على الفعلية أو العكس.
نسيت أو فقدت المفتاح السري؟
لا يمكن استرجاع مفتاح سري قديم، لكن يمكنك إنشاء مفاتيح جديدة لنفس النظام بدون حذفه:
- من ملف الممول ← المفوضين ← تبويب ERP اختر النظام من القائمة.
- اختر إعادة إنشاء الأسرار (Regenerate Secrets).
- في الخانة الأولى حدد متى تتوقف المفاتيح القديمة: فوراً، أو بعد فترة تتيح لك تحديث EgyTax أولاً بدون توقف.
- في الخانة الثانية حدد مدة صلاحية المفاتيح الجديدة.
- انسخ المفاتيح الجديدة قبل إغلاق النافذة، وضع مفتاح سري ١ الجديد في EgyTax واحفظ واختبر الاتصال.
Client ID نفسه لا يتغير عند إعادة إنشاء المفاتيح.
ملاحظات مهمة
- كل بيئة لها بيانات خاصة: كرر هذا الدليل كاملاً على البوابة الفعلية عند الانتقال للإنتاج، وستحصل على Client ID ومفاتيح مختلفة. لا تعمل بيانات التجريبي على الفعلي أبداً.
- الفاتورة والإيصال منفصلان: Client ID الخاص بنظام ERP للفواتير فقط. الإيصالات الإلكترونية لها بيانات خاصة بنقطة البيع من دليل نقطة البيع.
- المفوض المسؤول: يجب أن يكون لمن يسجل النظام صلاحية «إدارة أنظمة الممول» (وظيفة إداري أو مخصص بهذه الصلاحية).
- تجديد قبل انتهاء الصلاحية: سجّل تاريخ انتهاء «مدة الصلاحية» في التقويم، وأعد إنشاء المفاتيح قبلها بأيام.
- يمكن للشركة تسجيل أكثر من نظام ERP، ولكل نظام بياناته المستقلة.