توثيق الفاتورة الإلكترونية
في دولة الإمارات العربية المتحدة
إنشاء المستندات وإرسالها

فحص طلب JSON أو XML في Test API

قم بإجراء فحص تجريبي قبل إرسال طلب نظام تخطيط موارد المؤسسات (ERP). تستخدم واجهة برمجة التطبيقات التجريبية مفتاحاً خاصاً بها بدلاً من جلسة تسجيل الدخول الخاصة بالبوابة.

للمطورين والمستخدمين التقنيين في القطاع المالي · تم التحديث في 28 أكتوبر 2026

قبل البدء

  • مفتاح واجهة برمجة تطبيقات (API key) صالح ووثائق المطورين المحدثة.
  • بيانات المرسل، وتفاصيل المستلم، والبيئة المستهدفة.

الخطوات

  1. افتح واجهة برمجة التطبيقات التجريبية (Test API) وأدخل مفتاح الواجهة. تأكد من إيقاف خيار "تذكرني محلياً" (Remember locally) عند استخدام أجهزة مشتركة؛ فالتخزين خياري في شاشة المراجعة.
  2. حدد التنسيق (JSON أو XML)، ونوع المستند (فاتورة أو إشعار دائن)، وطبيعة المعاملة (ضريبية أو تجارية)، والبيئة (تجريبية أو فعلية) حسب الحاجة.
  3. اختر مرسلاً نشطاً مسجلاً في حسابك ضمن هذه الشبكة. أدخل عنوان المستلم؛ ويجب أن يتطابق مع المشتري المذكور في المستند.
  4. اختر مثالاً وقم بتحميله، ثم استبدل بيانات العمل الخاصة به. استخدم المثال الحالي الذي تم إنشاؤه بدلاً من قائمة الحقول اليدوية القديمة.
  5. اختر "تحقق". اقرأ كل نتيجة، بما في ذلك رمز القاعدة، والرسالة، وموقع الحقل.
  6. صحح نص الطلب وتحقق منه مرة أخرى. أي تغيير في الطلب يتطلب إجراء تحقق جديد قبل تفعيل خيار الإرسال.
  7. إذا كان الهدف هو إرسال معتمد، فافحص ترويسات الإرسال ومفتاح Idempotency-Key، ثم استخدم "إرسال إلى Peppol". احفظ معرف المعاملة الذي تم إرجاعه وقم بمراقبته.
تحقق من النتيجة

يعيد التحقق قيمة valid=true للطلب الناجح. لا يؤدي التحقق بمفرده إلى إنشاء أي معاملة ولا يرسل أي شيء إلى المستلم أو هيئة الضرائب (FTA). يؤدي الإرسال إلى إنشاء معاملة للمعالجة غير المتزامنة.

واجهة برمجة تطبيقات الاختبار من Azdan مع وضعي JSON وXML، وأنواع الفواتير، واختيار البيئة
التحقق من صحة طلب JSON أو XMLلقطة حديثة للمنتج، 28 أكتوبر 2026. تم اقتصاصها لتشمل عناصر التحكم ذات الصلة؛ تم استبعاد معرفات الحساب وتفاصيل الاتصال. افتح الصورة لعرضها بالحجم الكامل.

ملاحظات واستكشاف الأخطاء وإصلاحها

استخدم العقد الحالي

الموضوعالتوجيهات الحالية
أسطر JSONاستخدم payload.lines من الأمثلة الحالية؛ ولا تعتمد على مسار payload.lineItems الوارد في الدليل
الملف التعريفيPINT-AE؛ تحدد وثائق أكتوبر الإصدار 1.0.4، مع إصدار قواعد TDD بشكل منفصل
TDDيتم إنشاؤه بواسطة النظام وهو للقراءة فقط؛ لا تقم بتقديمه كمستند خاص بالمستأجر
تعدد القوة (Idempotency)استخدم ترويسة Idempotency-Key؛ وأعد استخدامها عند إعادة المحاولة لنفس الطلب
مستند جديديتطلب المستند الجديد كلياً هوية تجارية جديدة بالإضافة إلى مفتاح تقديم جديد

أدلة ذات صلة

وثائق الفاتورة الإلكترونية من Azdan في الإمارات العربية المتحدة · سير عمل محايد لنظام تخطيط موارد المؤسسات (ERP). تأكد من تسميات النشر الحالية، والأذونات، وعقد واجهة برمجة التطبيقات (API) قبل إجراء أي تغييرات.