بالنسبة لفريق ERP، الفاتورة الإلكترونية في مصر هي دورة تكامل كاملة وليست Feature لإرسال الفاتورة مرة واحدة. الـSDK الرسمي لـETA يوفر المصادقة وتعريفات المستندات وخدمات الأكواد وإرسال المستندات واسترجاعها ونتائج التحقق، كما تضع أدلة الجاهزية التسجيل والتوقيع الإلكتروني والتكويد ضمن المتطلبات الأساسية.
1. تأكد من موقف الممول الحالي
لا تستنتج موعدًا قانونيًا من مقال قديم. مصلحة الضرائب تنشر قرارات وخدمات مرتبطة بالإلزام. يجب على مسؤول المالية/الضرائب تأكيد موقف الشركة الحالي قبل اعتماد خطة الـGo-Live التقني.
2. سجل بيئة ERP بصورة صحيحة
تكامل النظام يحتاج إعداد هوية وصلاحيات. Production Secrets والشهادات بيانات حساسة يجب تخزينها خارج Source Code وإدارتها بسياسة Rotation واضحة.
3. نظف Master Data قبل اختبار API
كثير من “مشاكل التكامل” هي مشاكل بيانات: رقم ضريبي ناقص، بيانات فرع غير موحدة، أكواد أصناف/خدمات غير صحيحة أو معالجة ضريبية غير منضبطة داخل ERP. لذلك نفذ Validation للبيانات قبل الاختبار.
4. نفذ التوقيع الإلكتروني طبقًا للمواصفة
وثائق ETA توضح Canonicalization للمستند ثم SHA-256 للبيانات المعيارية والتوقيع بـCADES-BES باستخدام eSeal ثم تضمين التوقيع Base64 داخل المستند. لا يجب ابتكار Format خاص في جزء تشفيري حساس.
5. احفظ معرفات الإرسال والمستند
واجهة Document Submission تعيد معرفات للـSubmission والمستندات. يجب حفظها على الفاتورة داخل ERP حتى يستطيع الدعم تتبع دورة المستند بدون بحث يدوي.
6. افصل نجاح الاتصال عن صحة الفاتورة
HTTP Success لا يعني أن المستند Valid. يجب قراءة Validation Results وحفظها وإظهار الأخطاء بشكل واضح للمستخدم المصرح له ثم تنفيذ التصحيح من خلال دورة المستند المناسبة.
7. صمم Monitoring قبل الإنتاج
- تنبيه انتهاء Credentials.
- Retry للـTimeouts.
- Queue واضحة للمستندات المعلقة.
- تصنيف الأخطاء.
- Reconciliation بين ERP وحالة المستند في ETA.
- Audit Logs للمستخدمين والتكامل.
8. اختبر السيناريو التجاري وليس الـAPI فقط
UAT يجب أن يغطي الفاتورة الطبيعية وسيناريوهات الإشعارات المدينة/الدائنة أو المرتجعات التي تنطبق على النشاط، ومعالجات ضريبية مختلفة والفروع. ويجب أن تعتمد المالية تطابق المستند الإلكتروني مع القيد والمعاملة التجارية.
مصادر ETA الرسمية: خدمات الفاتورة الإلكترونية، SDK التكامل وواجهات eInvoicing. الالتزامات القانونية الحالية يجب التأكد منها من ETA مباشرة وليس من مقالات خارجية.