قائمة تحقق استكشاف أخطاء تكامل ERP
قائمة تحقق منهجية لتشخيص حالات فشل الفوترة الإلكترونية عند الإرسال من تكامل ERP أو واجهة برمجية وسيطة.
عندما تفشل الفواتير الإلكترونية باستمرار من تكامل ERP، اعمل وفق هذه القائمة قبل رفع تذكرة دعم.
1. المصادقة (E2001 / E2002)
- مفتاح API من بيئة الإنتاج (وليس الصندوق الرملي)
- لم تنته صلاحية مفتاح API (تحقق من البوابة ← الإعدادات ← مفاتيح API)
- رأس
AuthorizationبتنسيقBearer <key>— وليسBasicأوAPI-Key - معرّف المستأجر / معرّف المشارك الصحيح في مسار URL
2. بنية XML (E1005 / E1009)
- مساحة اسم العنصر الجذر تطابق
urn:oasis:names:specification:ubl:schema:xsd:Invoice-2 - جميع بادئات
cac:وcbc:مُعلنة في العنصر الجذر - الملف مُرمَّز بـ UTF-8 (بدون BOM)
- لا تعليقات XML أو تعليمات معالجة فوق العنصر الجذر
3. الحقول الإلزامية (E1006 — تحقق PINT AE)
- رقم التسجيل الضريبي للبائع (IBT-031) مكوّن من 15 رقماً بالضبط، يبدأ بغير الصفر، وينتهي بـ
03 - معرّف Peppol للمشتري (IBT-049) بتنسيق
0235:XXXXXXXXX - تاريخ الفاتورة (IBT-002) بتنسيق
YYYY-MM-DD - رمز وسيلة الدفع (IBT-081) مضبوط (مثلاً
30) - جميع بنود البضاعة لها وصف غير فارغ (IBT-153)
- رموز الوحدات من UN/ECE Rec 20
- رمز نوع المعاملة BTAE-02 مُقدَّم كسلسلة مكوّنة من 8 أحرف
4. حسابات الضريبة
- مبالغ الضريبة على البنود تساوي مجموع إجمالي ضريبة المستند (ضمن تسامح التقريب 0.01 درهم)
- البنود ذات المعدل المعياري تستخدم بالضبط 5.00% (وليس 5 أو 0.05)
- البنود ذات نسبة صفر والمعفاة تتضمن رمز سبب ضريبة القيمة المضافة
- الإجمالي شاملاً ضريبة القيمة المضافة = الإجمالي غير شاملها + إجمالي ضريبة القيمة المضافة