.svg)
إعداد إشعارات Webhook الموقّعة
يرسل إشعار Webhook (webhook) أحداث المستندات إلى نظام تخطيط موارد المؤسسات (ERP) الخاص بك أو أي تطبيق استقبال آخر. يعتمد نجاحه على عملية منفصلة عن تسليم فاتورة Peppol.
قبل البدء
- نقطة نهاية HTTPS معتمدة وتطبيق جاهز للتحقق من التوقيعات.
- الأحداث المطلوبة وطريقة المصادقة، بالإضافة إلى سعة الخطة المتاحة.
الخطوات
- افتح إشعارات Webhook (Webhooks) واختر إضافة خطاف ويب. قد تظهر الإصدارات القديمة نموذج إنشاء مباشرة على الصفحة.
- أدخل عنوان URL المستلم وحدد الأحداث المطلوبة. استخدم أسماء الأحداث التي يوفرها الإصدار الحالي أو وثائق المطورين الخاصة به.
- اختر طريقة المصادقة التي يدعمها تطبيقك المستلم وهذا الإصدار. تأكد من بيانات الاعتماد والأذونات مع مالك نظام تخطيط موارد المؤسسات (ERP) أو الوسيط (middleware).
- أكمل عملية الإنشاء واحفظ مفتاح التوقيع بشكل آمن عند ظهوره.
- قم بتنفيذ التحقق من التوقيع باستخدام تنسيق الترويسة الحالي ونص الطلب الخام. قم بتهيئة مصادقة الصادر لنقطة النهاية بشكل منفصل عن التحقق من التوقيع.
- استخدم حدثاً تجريبياً مصرحاً به إذا كان الإجراء متاحاً، ثم راجع سجل التسليم وسجلات النظام المستلم لديك.
- تأكد من أن نقطة النهاية نشطة. قم بالتنسيق مع مالك النظام المستلم بشأن الإيقاف المؤقت، أو الاستئناف، أو التعديل، أو تدوير مفتاح الأمان.
تم تكوين نقطة النهاية، والتحقق من توقيعها من قبل المستلم، وهناك محاولة تسليم ناجحة لحدث تجريبي مصرح به أو حدث فعلي لاحق.
ملاحظات واستكشاف الأخطاء وإصلاحها
أمثلة على الأحداث الحالية
تتضمن وثائق أكتوبر الأحداث التالية: transaction.submitted و ap.outbound.delivered و ap.outbound.failed و ap.inbound.received و ap.mls.updated و transaction.tdd_generated. تأكد من أسماء الاشتراكات المدعومة في إصدارك؛ فقد تختلف الأسماء المستعارة اليدوية القديمة.
الأسئلة ومتطلبات الحقول
ما هو عنوان URL لنقطة النهاية المقبول؟
عنوان HTTPS يصل طوله إلى 2048 حرفاً، يمكن الوصول إليه من الإنترنت، ولا يحتوي على اسم مستخدم أو كلمة مرور. تُرفض الأسماء التي تشير إلى عناوين خاصة أو محلية أو عناوين ربط محلية، وكذلك المنافذ خارج النطاق من 1 إلى 65535. تقوم Azdan بتوقيع كل عملية تسليم؛ وبعد تدوير مفتاح الأمان، يتم استخدام كل من المفتاح الجديد والمفتاح السابق لتوقيع الطلبات لمدة 24 ساعة.
ما هي الأحداث التي يمكن لإشعار Webhook (webhook) استقبالها، وما هي حمولة البيانات (payload)؟
حدد الأحداث التي تريدها (تسليم المستند، أو التحقق منه أو رفضه، وكل تغيير في الحالة، وحكم MLS الخاص بالمستلم، ورد هيئة الضرائب الاتحادية على مستند البيانات الضريبية، والمزيد) أو حددها جميعاً. ترسل إشعارات Webhook الجديدة حمولة الإصدار 2: ملف JSON واحد يحتوي على رقم المستند، والنوع، والمبالغ، والطرف المقابل، والشركة، ومعرفات Peppol، والنتيجة، وروابط التنزيل. تظهر الأحداث التي لا يمكن تسليمها بعد كل محاولة إعادة إرسال كرسائل غير قابلة للتسليم (dead letters) ويمكن إعادة إدراجها في قائمة الانتظار.
مرجع حقل النموذج
| الحقل | المتطلبات | ما يجب إدخاله |
|---|---|---|
| الاسم | اختياري | اسم لنقطة النهاية هذه، يظهر في قائمة خطافات الويب وسجل التسليم. اختياري، بحد أقصى 80 حرفاً. مثال مزامنة حالة نظام تخطيط موارد المؤسسات (ERP) |
| عنوان URL لنقطة النهاية | مطلوب | العنوان الذي ترسل إليه Azdan الأحداث. مطلوب. يجب أن يكون HTTPS فقط، بحد أقصى 2048 حرفاً، وبدون اسم مستخدم أو كلمة مرور؛ يجب أن يكون المضيف اسماً عاماً على الإنترنت. يتم رفض العناوين الخاصة أو المحلية. مثال https://erp.yourcompany.ae/peppol-hook |
| الأحداث | مطلوب | الأحداث التي تستقبلها نقطة النهاية هذه: تغييرات حالة المستند، ونتائج MLS، وتقارير هيئة الضرائب الاتحادية (FTA)، وما إلى ذلك. حدد حدثاً واحداً على الأقل، أو حددها جميعاً. |
| الشركة | اختياري | يحدد نقطة النهاية بمستندات إحدى شركاتك (الشركات التابعة). اختياري. اتركه فارغاً ليشمل جميع الشركات. |
| إصدار الحمولة (Payload) | اختياري | شكل ملف JSON الذي يتم تسليمه. الإصدار 2 عبارة عن ملف JSON واحد يحتوي على رقم المستند، والنوع، والمبالغ، والطرف المقابل، والشركة، ومعرفات Peppol، والنتيجة، وروابط التنزيل. 1 أو 2؛ تستخدم خطافات الويب (webhooks) الجديدة الإصدار 2. مثال 2 |
مرجع سير عمل المنتج: مركز مساعدة Azdan، تمت المراجعة في 1 نوفمبر 2026. الأمثلة توضيحية.
أدلة ذات صلة
وثائق الفاتورة الإلكترونية من Azdan في الإمارات العربية المتحدة · سير عمل محايد لنظام تخطيط موارد المؤسسات (ERP). تأكد من تسميات النشر الحالية، والأذونات، وعقد واجهة برمجة التطبيقات (API) قبل إجراء أي تغييرات.