.svg)
ربط نظام ERP أو منصة التكامل
اربط نظام تخطيط موارد المؤسسات (ERP) الحالي، أو نظام المحاسبة، أو تطبيق الفوترة، أو البرمجيات الوسيطة بـ Azdan من خلال واجهة برمجة التطبيقات (API) وإشعارات Webhook المدعومة. يمكن للمستخدمين الاستمرار في إنشاء الفواتير في نظام المصدر الخاص بهم.
قبل البدء
- مسؤول تكامل قادر على تهيئة استدعاءات API ومطابقة سجلات المصدر الخاصة بك.
- هويات البائعين المعتمدة، ومطابقة حقول المستندات، ومفتاح API مسموح به، ومستقبل أحداث HTTPS.
الخطوات
- اتفق على مكان إنشاء الفواتير وإشعارات الدائن واعتمادها وترقيمها في نظام المصدر الخاص بك. اختر المحفز لإرسال المستند المعتمد.
- قم بمطابقة بيانات المصدر مع عقد JSON الحالي الخاص بـ Azdan، أو قم بإنشاء ملف UBL XML متوافق. تأكد من تضمين تفاصيل الشركة، والمرسل، والمشتري، والتواريخ، والبنود، والضرائب، والدفع بشكل صحيح.
- قم بتهيئة مصادقة API آمنة وحدد البيئة المقصودة بوضوح. استخدم المشاركين النشطين المسجلين لتلك البيئة.
- اتصل بنقطة نهاية التحقق وقم بحل جميع النتائج التي تعيق العملية. يجب أن يعرض نظام المصدر أو البرمجيات الوسيطة لديك القاعدة والحقل والرسالة للشخص القادر على تصحيحها.
- أرسل المستند المعتمد باستخدام مفتاح "Idempotency-Key" ثابت لهذا الإرسال المنطقي. احفظ معرف المعاملة المُعاد بجانب مرجع فاتورة نظام المصدر.
- قم بتهيئة إشعارات Webhook (webhooks) الموقعة لنقطة نهاية HTTPS يمكن لنظام تخطيط موارد المؤسسات (ERP) أو البرمجيات الوسيطة لديك استقبالها. تحقق من التوقيعات، وقم بإزالة معرفات الأحداث المكررة، وعالج عمليات الاستدعاء دون إنشاء سجلات أعمال مكررة.
- اكتب نتائج التسليم، ورد المستلم، وتقارير هيئة الزكاة والضريبة والجمارك (FTA) بشكل منفصل في سجل المصدر. استخدم الاستطلاع/المطابقة للتعامل مع عمليات الاستدعاء المفقودة أو المتأخرة.
- اختبر الفواتير، وإشعارات الدائن، وأخطاء التحقق، والردود المرفوضة، ومعالجة إعادة المحاولة في بيئة الاختبار المعتمدة. تحقق من تدفقات البيانات الصادرة والواردة المطلوبة لتنفيذك.
- أكمل عملية الإطلاق المعتمدة، وأكّد تسجيلات/بيانات اعتماد بيئة الإنتاج، وراقب أولى عمليات التبادل المباشرة.
يمكن تتبع فاتورة نظام المصدر إلى معاملة واحدة في Azdan، وتظهر نتائجها في سجل المصدر، كما أن إعادة إرسال الطلب نفسه لا يؤدي إلى إنشاء معاملة أخرى.
ملاحظات واستكشاف الأخطاء وإصلاحها
اختر نهج اتصال
| النهج | متى تستخدمه |
|---|---|
| واجهة برمجة تطبيقات REST مباشرة | يمكن لنظام تخطيط موارد المؤسسات (ERP) أو تطبيقك إجراء مكالمات HTTPS موثقة والتعامل مع الردود |
| الوسيط / منصة التكامل | طبقة مُدارة تقوم بتعيين الحقول، وإرسال الطلبات، واستقبال ردود الاتصال |
| تصدير UBL XML | يمكن لنظامك المصدري إنشاء المستند المهيكل الذي تقبله Azdan |
| الإدخال عبر وحدة التحكم / استيراد ملفات CSV | التشغيل اليدوي أو المؤقت أثناء تنفيذ الأتمتة |
المستندات الواردة
اتفق على ما إذا كان سيتم تخزين ملفات XML الخاصة بالمورد، أو تعيينها لسجل مشتريات مسودة، أو توجيهها للمراجعة. لا تؤدي عملية الاستلام في Azdan بحد ذاتها إلى إنشاء معاملة دفتر أستاذ مرحّلة في كل أنظمة تخطيط موارد المؤسسات (ERP).
الاسترداد والمطابقة
بعد انتهاء المهلة، ابحث عن المعاملة الحالية أو أعد محاولة إرسال الطلب نفسه باستخدام مفتاح التكرار (Idempotency-Key) ذاته. لا تنشئ رقم فاتورة أو مفتاحاً جديداً لمجرد ضياع رد الاتصال.
أدلة ذات صلة
وثائق الفاتورة الإلكترونية من Azdan في الإمارات العربية المتحدة · سير عمل محايد لنظام تخطيط موارد المؤسسات (ERP). تأكد من تسميات النشر الحالية، والأذونات، وعقد واجهة برمجة التطبيقات (API) قبل إجراء أي تغييرات.