سجل التعاملات مع الهيئة
كل مرة يُرسل فيها النظام فاتورة إلى الهيئة ويستلم ردًا، تُسجل العملية كاملة في سجل خاص. هذا السجل هو مرجعك الأول لفهم أي مشكلة تحدث — سواء كانت الفاتورة قُبلت أو رُفضت أو واجهت خطأ تقنيًا.
كيف تصل للسجل؟
من شريط البحث اكتب ZATCA Integration Log وستصل مباشرة. السجل يعرض العمليات مرتبة من الأحدث للأقدم.
كيف تقرأ السجل؟
كل صف في السجل يمثل عملية إرسال واحدة. هذا ما يحتويه:
| المعلومة | أهميتها |
|---|---|
| رقم الفاتورة | أي فاتورة نتكلم عنها |
| نوع العملية | هل هي فاتورة عادية، إشعار دائن، أم إشعار مدين |
| النتيجة | نجحت العملية أم فشلت |
| وقت الإرسال | متى أرسل النظام الفاتورة |
| وقت الرد | متى استلمنا رد الهيئة |
| الرقم المرجعي | UUID — يظهر فقط إذا قُبلت الفاتورة |
| ملف الإرسال | نسخة XML التي ذهبت للهيئة |
| ملف الرد | نسخة XML التي أرسلتها الهيئة |
| رسالة الخطأ | وصف الخطأ — يظهر فقط إذا فشلت العملية |
أمثلة عملية لقراءة السجل
المثال الأول: كل شيء تمام
النتيجة: ✅ نجاح
الرد: "Invoice cleared successfully"
الرقم المرجعي: 4f8a3b2c-...
→ لا تحتاج لأي إجراء. الفاتورة سليمة ومقبولة.
المثال الثاني: خطأ في الرقم الضريبي
النتيجة: ❌ فشل
الخطأ: "رقم تسجيل ضريبة القيمة المضافة غير صحيح"
→ المشكلة في رقم ضريبة القيمة المضافة للعميل أو للمنشأة. راجعه وصححه ثم أعد الإرسال.
المثال الثالث: انتهاء الشهادة
النتيجة: ❌ فشل
الخطأ: "شهادة CSID غير صالحة أو منتهية"
→ شهادتك انتهت صلاحيتها. شغّل معالج التهيئة لتجديدها.
المثال الرابع: مشكلة اتصال
النتيجة: ❌ فشل
الخطأ: "تعذر الاتصال بخادم الهيئة"
→ إما أن الإنترنت عندك مقطوع أو خوادم الهيئة تواجه ضغطًا. انتظر قليلاً ثم حاول مجددًا.
كيف ترشح السجل للوصول لمشكلة معينة؟
- تبحث عن فاتورة محددة؟ — اكتب رقمها في حقل البحث
- تبحث عن كل الفواتير الفاشلة؟ — استخدم فلتر الحالة واختر "Failed"
- تبحث عن مشاكل يوم معين؟ — حدد النطاق الزمني
- تبحث عن كل العمليات من نوع معين؟ — استخدم فلتر "Integration Type"
تصدير السجل
إذا احتجت مشاركة السجل مع فريق الدعم الفني:
- حدد الصفوف المطلوبة
- اضغط Export
- سيصدر ملف Excel يمكنك إرفاقه في طلب الدعم
متى يجب أن تراجع السجل؟
- فاتورة بقيت عالقة لفترة طويلة
- لاحظت أخطاء في لوحة المتابعة
- عميل اشتكى أن رمز QR لا يعمل
- تريد التأكد من تاريخ فاتورة معينة
- بعد تغيير أي إعدادات — للتأكد أن كل شيء يسير بشكل طبيعي