واجهة API والتكامل مع أنظمة ERP

نعم. صُمِّمت واجهة REST API من DGAssistant بتنسيق JSON للتكامل مع أنظمة ERP والأنظمة اللوجستية. وقد أجرى عملاؤنا التكامل بينها وبين SAP وSAGE X3 وأنظمة أخرى عديدة. ويتولى تنفيذ التكامل نفسه فريق تقنية المعلومات لديكم أو شريك ERP الذي تتعاملون معه، مع دعم مستمر من فريق DGAssistant في مراحل التحليل والتنفيذ وبدء التشغيل.

نعم، واجهة API وحدة ذات ترخيص مستقل تُضاف إلى تراخيصكم القياسية. وتضيفونها إلى اشتراككم عندما تقررون إجراء التكامل.

يُقاس استخدام واجهة API حسب الترخيص: إذ يغطي كل ترخيص 1,500 إرسالية و10,000 استدعاء للخدمة سنوياً، ويتيح لقاعدة البيانات الاحتفاظ بما يصل إلى 5,000 عنصر من غير الإرساليات، مثل المنتجات والأطراف (المرسَل إليهم والموردون والسائقون وغيرهم). وإذا توقعتم حجماً أكبر، فما عليكم إلا إضافة تراخيص أخرى. ويُعرض سعر الوحدة الدقيق لوحدة واجهة API إلى جانب بقية الكتالوج في متجرنا، ويمكن إدراجه في أي عرض سعر مخصص.

يتلقى وضع المعالجة بالدفعات المواصفات الكاملة للإرسالية في استدعاء واحد للخدمة — وهو مثالي عندما يكون نظام ERP على علم مسبق بالبضائع والأطراف والكميات. أما الوضع التفاعلي فيتيح لكم تكوين الإرسالية خطوة بخطوة، مع التحقق من كل بضاعة عند إضافتها؛ وهو أقرب إلى طريقة عمل تطبيق الويب، ومفيد عندما تحتاجون إلى مسارات عمل يقودها المستخدم فوق واجهة API.

الطريقتان مدعومتان كلتاهما. والنهج الموصى به هو «البيانات المعرَّفة مسبقاً»: أنشئوا بضائعكم وأطرافكم مرة واحدة في تطبيق الويب (أو استوردوها)، ثم أشيروا إليها برموزها في استدعاءات واجهة API. أما نهج «البيانات الفورية» فيتيح لكم إرسال كل شيء في كل استدعاء، وهو مناسب عندما يكون نظام ERP لديكم هو المرجع الرئيسي لتلك البيانات ولا ترغبون في تحميلها مسبقاً.

هناك خياران. يمكنكم تلقي المستندات في استجابة واجهة API بوصفها ملفات PDF مرمَّزة بصيغة base64 (مستند النقل وإقرار المرسِل وقائمة التحقق وعلامات الطرود وغيرها)، أو جعل المنصة ترسلها تلقائياً بالبريد الإلكتروني إلى عنوان محدد مسبقاً.

نعم. هناك نمطان يعملان جيداً: (أ) يُنزّل نظام ERP لديكم ملف PDF من واجهة API ويرسله إلى قائمة انتظار الطباعة الخاصة به؛ (ب) يرسل DGAssistant المستندات بالبريد الإلكتروني إلى صندوق بريد مخصص، وتتولى أداة طباعة تلقائية صغيرة لديكم طباعتها على الطابعة المناسبة. ويستخدم كثير من العملاء نمط البريد الإلكتروني لأنه لا يتطلب أي شيفرة إضافية في جانب نظام ERP.

المواصفات الكاملة بتنسيق OpenAPI منشورة في وثائق واجهة API للبضائع الخطرة. كما نوفّر مشروع SoapUI محمَّلاً مسبقاً باستدعاءات اختبار واقعية، كي يتمكن مطوّروكم من استكشاف واجهة API في دقائق.

يجب أن يتضمن كل استدعاء لواجهة API قيمة requestGuid فريدة تُعرّف الطلب في سجلاتنا، وتتيح لفريق الدعم لدينا العثور على المعاملة المعنية بدقة عندما تبلّغون عن مشكلة. وتُقبل أي قيمة أبجدية رقمية فريدة؛ ونوصي بتوليد معرّف UUID/GUID قياسي في جانب العميل.

بيانات اعتماد لا تقبلها الخدمة: إما ترويسة HTTP Basic Authorization مفقودة أو غير صحيحة، وإما، عندما يُصادَق على الاستدعاء باستخدام OAuth2، رمز وصول لم يُطلب قط، أو يخص بيئة أخرى، أو انتهت صلاحيته. ويوجد عنوان URL مخصص للدعم يمكنكم استدعاؤه للتأكد من أن واجهة API تعمل وأن بيانات اعتمادكم صالحة. وإذا تعذّر عليكم المضي قدماً، فأرسلوا إلينا طلب HTTP واستجابته كاملين (بما في ذلك requestGuid) ووصفاً للسلوك المتوقع — فهذا أسرع ما يحل المشكلة.