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

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