.svg)
مصطلحات البوابة ومراجع المطورين
استخدم هذا المرجع عندما تتضمن الشاشة أو الخطأ مصطلحاً غير مألوف. توفر وثائق المطورين ومرجع واجهة برمجة التطبيقات العقود الخاصة بإصدار معين لعمليات التكامل.
قبل البدء
- الوصول إلى مساحة عمل الحساب المخصصة لمؤسستك.
الخطوات
- افتح وثائق المطورين للاطلاع على سير العمل، والأمثلة الحالية، وتفسيرات الأخطاء، وعقود إشعارات Webhook (webhooks).
- افتح مرجع واجهة برمجة التطبيقات (API) للاطلاع على المسارات والمخططات والمصادقة والأذونات المدعومة.
- استخدم وضع الاستكشاف للقراءة فقط للتعرف على المسار. تعامل مع إجراءات التنفيذ/الإرسال في مستكشف واجهة برمجة التطبيقات التفاعلي كطلبات حقيقية لها التأثيرات الموضحة في ذلك المسار.
- طابق الأمثلة مع البيئة ونوع المستند الصحيحين. احتفظ بالقيم السرية في مخزن بيانات الاعتماد المعتمد لديك، وليس في الوثائق المُصدّرة.
يمكنك تحديد العقد ذي الصلة والتمييز بين المستند، وعنوان الشبكة، وإيصال النقل، والتقرير الضريبي، ورد اتصال التكامل.
ملاحظات واستكشاف الأخطاء وإصلاحها
المسرد
| المصطلح | المعنى |
|---|---|
| المستأجر | مساحة العمل المعزولة الخاصة بمؤسستك |
| شركة / شركة تابعة | كيان قانوني تُدار تفاصيل البائع الخاص به وصلاحيات الوصول إليه داخل المستأجر |
| معرف المشارك | عنوان شبكة مسجل بتنسيق scheme:identifier |
| TIN / VAT TRN | معرفات دافع الضرائب وضريبة القيمة المضافة المميزة؛ استخدم الحقل الصحيح |
| Peppol | معايير الشبكة والتبادل المستخدمة بين مزودي الخدمة |
| PINT-AE | التخصيص الإماراتي لنموذج فاتورة Peppol الدولية |
| UBL | تنسيق مستند الأعمال المهيكل بلغة XML |
| AP / AS4 | نقطة الوصول / بروتوكول نقل آمن بين مزودي الخدمة |
| MLS | حالة مستوى الرسالة من مزود الخدمة؛ قد تكون إيجابية أو سلبية |
| TDD | مستند البيانات الضريبية الذي يتم إنشاؤه لإعداد التقارير للهيئة الاتحادية للضرائب |
| FTA / EmaraTax | الهيئة الاتحادية للضرائب / بوابتها المستخدمة في رحلة الربط |
| SBD / SBDH | غلاف مستند الأعمال ورأسه |
| SMP | بيانات تعريف الخدمة المستخدمة للعثور على قدرات المشاركين ومساراتهم |
| مفتاح التكرار (Idempotency key) | مرجع إرسال يُعاد استخدامه عند إعادة المحاولة المتطابقة لتجنب التكرار |
| خطاف الويب (Webhook) | استدعاء رد اتصال (callback) للحدث إلى نظام الاستقبال الخاص بك |
| معرف الارتباط (Correlation ID) | مرجع يُستخدم لربط الأحداث عبر الأنظمة |
| الحجر الصحي | حالة تتطلب التحقيق قبل إعادة المحاولة بشكل آمن |
الأسئلة ومتطلبات الحقول
أين يمكنني التحقق من عقد واجهة برمجة التطبيقات (API) وإشعار Webhook (Webhook) بدقة؟
استخدم وثائق المطورين ومرجع واجهة برمجة التطبيقات (API) المرتبط في البوابة للحصول على مخططات نقاط النهاية، والأذونات، ورؤوس التوقيع، وأسماء الأحداث. يشرح مركز المساعدة سير عمل المستخدم ومتطلبات الحقول. طابق العقد مع نسختك المنشورة قبل تنفيذ أي تكامل.
مرجع سير عمل المنتج: مركز مساعدة Azdan، تمت المراجعة في 1 نوفمبر 2026. الأمثلة توضيحية فقط.
أدلة ذات صلة
وثائق الفاتورة الإلكترونية من Azdan في الإمارات العربية المتحدة · سير عمل محايد لنظام تخطيط موارد المؤسسات (ERP). تأكد من تسميات النشر الحالية، والأذونات، وعقد واجهة برمجة التطبيقات (API) قبل إجراء أي تغييرات.