.svg)
حل مشكلات تسليم إشعارات Webhook
استخدم سجل التسليم للتحقق من محاولات الاتصال بنقطة النهاية الخاصة بك. يمكن تسليم الفاتورة عبر Peppol حتى في حال فشل رد الاتصال (callback) إلى نظام تخطيط موارد المؤسسات (ERP) الخاص بك.
قبل البدء
- نقطة النهاية، أو مرجع الحدث أو المعاملة، والوقت التقريبي.
الخطوات
- افتح إشعارات Webhook (Webhooks) وانتقل إلى سجل التسليم.
- قم بالتصفية حسب إشعار Webhook، وحالة التسليم، ونوع الحدث، ثم اضغط على "تحديث".
- إذا كان إجراء تفاصيل التسليم متاحاً، فافتح المحاولة. راجع رمز الاستجابة، والمدة، وحالة إعادة المحاولة، ومعلومات التشخيص المنقحة.
- طابق الحدث أو المعاملة مع سجلات التطبيق المستلم. حدد ما إذا كان الفشل ناتجاً عن المصادقة، أو أخطاء الخادم، أو تقييد السرعة، أو انتهاء المهلة.
- قم بإصلاح مشكلة المستلم أو بيانات الاعتماد مع مالكها. نسّق أي إجراء إعادة إرسال متاح مع Azdan؛ يجب أن يتعامل المستلمون مع معرفات الأحداث المكررة بأمان.
- إذا كان السجل فارغاً، تحقق مما إذا كانت نقطة النهاية متوقفة مؤقتاً وما إذا كانت هناك أحداث ذات صلة قد وقعت بعد إنشائها. بالنسبة للإشعارات الفائتة، قم بمطابقة حالة المعاملة من خلال واجهة برمجة التطبيقات (API).
تنجح المحاولات الجديدة ويعكس التطبيق المستلم حالة المستند الصحيحة. تحقق من المعالجة التجارية، وليس فقط رمز نجاح HTTP.
ملاحظات واستكشاف الأخطاء وإصلاحها
الاستجابات الشائعة
| العرض | تحقق |
|---|---|
| 401 / 403 | بيانات اعتماد المصادقة الصادرة، والأذونات، وسياسة نقطة النهاية |
| 5xx | سجلات خدمة المستلم وتوافرها |
| انتهت المهلة | الاتصال ووقت الاستجابة؛ تتوقع الوثائق استجابة 2xx في غضون 10 ثوانٍ |
| 429 / تقييد المستلم | سعة المستلم والتعامل مع Retry-After |
| عدم تطابق التوقيع | صحح سر نقطة النهاية، والنص الأساسي الخام، وعقد التوقيع الحالي |
| متوقف مؤقتاً / لا توجد محاولات | لا تستأنف العمل إلا بموافقة مالك المستلم؛ افحص توقيت الاشتراك |
الأسئلة ومتطلبات الحقول
ماذا يحدث بعد فشل جميع محاولات إعادة إرسال إشعار Webhook؟
تظهر الأحداث التي تستنفد محاولات إعادة التسليم كرسائل ميتة (dead letters) ويمكن إعادة وضعها في قائمة الانتظار. قم أولاً بإصلاح مشكلة المستلم أو المصادقة، وتحقق من معرف الحدث والمحاولات السابقة، ثم استخدم إجراء إعادة الإدراج المدعوم. لا تؤدي إعادة إدراج رد اتصال ERP إلى إرسال فاتورة الأعمال عبر Peppol مرة أخرى.
مرجع سير عمل المنتج: مركز مساعدة Azdan، تمت المراجعة في 1 نوفمبر 2026. الأمثلة توضيحية.
أدلة ذات صلة
وثائق الفاتورة الإلكترونية من Azdan في الإمارات العربية المتحدة · سير عمل محايد لنظام تخطيط موارد المؤسسات (ERP). تأكد من تسميات النشر الحالية، والأذونات، وعقد واجهة برمجة التطبيقات (API) قبل إجراء أي تغييرات.