محتاج اعمل ربط مع الفاتورة لالكترونية مصر

[مومن الشيمى]

هل من تجربه او مساعده في الربط مع الفاتورة لالكترونيه حتي لو نبتدي المشروع ونجرب مع بعض

[محب العقيدة]

انا شبكت مع الاردني

ابعث الدوكيومنت تبع الربط المصري

خلينا نشوفوا

ملفpdf

[محمدالشيمى]

ده صفحة التعليمات

https://sdk.preprod.invoicing.eta.gov.eg/

[محب العقيدة]

بحثت عن الجانب التقني للربط لكنني لم اجد
لكن بصورة مبدئية اجد ان  الربط سهل الا التوقيع الالكتروني لاني لم اتعامل معه من قبل
سالت الذكاء الصناعي

هل تستطيع ان تبحث لي عن  الشرح الفني المفصل لإجراءات التكامل كملف pdf
 

 

 

 

 

أهلاً بك. بما أن الوثائق الفنية التفصيلية (كـ دليل المطورين أو مواصفات الـ API) هي معلومات حساسة وموجهة للمطورين بشكل أساسي، فإنها لا تُنشر عادةً كملفات PDF متاحة بسهولة للعامة على الإنترنت من خلال بحث عام، بل يتم توفيرها بشكل خاص للممولين المسجلين في المنظومة.

ومع ذلك، يمكنني أن أقدم لك النقاط التقنية الأساسية المفصلة التي يتمحور حولها أي دليل فني (SDK/API) للربط مع منظومة الفاتورة الإلكترونية المصرية، والتي ستساعدك في توجيه المطورين أو شركات التكامل:

---

 

 (المتطلبات الأساسية)

 

تتم عملية التكامل والربط الفني بين نظام تخطيط موارد المؤسسات (ERP System) الخاص بشركتك ومنظومة الفاتورة الإلكترونية عبر واجهات برمجة التطبيقات (APIs) في عدة مراحل، أهمها:

 

1. الإعداد الأولي والمصادقة (Authentication)

 

المتطلب التقني	الشرح الفني
التسجيل والحصول على بيانات الوصول	يجب على الممول أولاً تعيين نظام تخطيط موارد (ERP) على البيئة الاختبارية ثم البيئة الفعلية. يتم ذلك عبر بوابة المصلحة للحصول على:<ul><li>Client ID</li><li>Client Secret</li></ul>وهما مفتاحا الوصول لنظامك.
الحصول على رمز الوصول (Token)	يتم استخدام Client ID و Client Secret لإرسال طلب إلى الـ API للحصول على Access Token (رمز وصول). هذا الرمز ضروري لمصادقة كل فاتورة يتم إرسالها ويتم تحديثه بشكل دوري.
نظام التكويد الموحد	يجب على النظام الخاص بك أن يقوم بربط (Mapping) أكواد السلع والخدمات الداخلية الخاصة بالشركة بأحد أنظمة التكويد المعتمدة (مثل GS1 أو نظام EGS الذي تعتمده مصلحة الضرائب).

 

---

 

2. تجهيز الفاتورة للتوقيع والإرسال

 

هذه هي أهم خطوة تتطلب تدخلاً برمجياً عميقاً:

 

أ. تهيئة ملف الفاتورة (Document Schema)

 

يجب أن يقوم نظام ERP بإنشاء ملف بيانات الفاتورة بتنسيق JSON أو XML، يحتوي على كافة حقول البيانات المطلوبة في نظام المصلحة (مثل رقم التسجيل الضريبي، بيانات الأصناف، الضرائب، التواريخ، إلخ).

 

ب. التوقيع الإلكتروني (Digital Signing)

 

لتأكيد صحة مصدر الفاتورة وعدم التلاعب بها، يجب أن يقوم النظام الخاص بك بما يلي:

1. استخدام شهادة الختم الإلكتروني: يتم تخزين هذه الشهادة في جهاز التوكين (Token).

2. التشفير والتوقيع: يقوم النظام باستخدام الشهادة لتوقيع ملف بيانات الفاتورة المشفرة.

3. دمج التوقيع: يتم دمج التوقيع الإلكتروني داخل ملف الفاتورة ليصبح جاهزاً للإرسال.

 

ج. الإرسال عبر API

 

يتم إرسال ملف الفاتورة الموقع إلكترونياً إلى نقطة نهاية (API Endpoint) محددة في منظومة الضرائب عبر اتصال آمن (HTTPS).

---

 

3. عمليات ما بعد الإرسال (Post-Submission APIs)

 

يجب أن يكون نظامك قادراً على التعامل مع واجهات API أخرى:

• API الاستعلام عن حالة الفاتورة (Get Status): للاستعلام عن قبول الفاتورة (صحيحة)، رفضها، أو تعليقها من قِبل المنظومة.

• API إلغاء الفاتورة (Cancel Document): لإرسال طلب لإلغاء فاتورة تم إرسالها (يتطلب موافقة الطرف الآخر خلال فترة محددة).

• API إرسال الإشعارات (Credit/Debit Notes): لإرسال إشعارات الإضافة أو الخصم.

---

 

💡 نصيحة للحصول على الوثائق الفنية

 

إذا كنت تحتاج إلى الملفات التقنية بصيغة PDF تحديداً، فالطريقة الأكثر فاعلية هي:

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

2. بوابة المطورين: غالباً ما توجد الوثائق (SDK and API Specification) داخل حسابك على بوابة مصلحة الضرائب ضمن قسم مخصص لـ "التكامل الفني" أو "المطورين".

3.