الهدف من واجهة برمجة التطبيقات Order Entry هو إنشاء طلب في mySE. فهي تمكّن المستخدم من الآتي: الحصول على حالة الطلب خلال جميع خطوات الطلب. ويتم تحقيق ذلك باستخدام طريقة الحالة. والتحقق من صحة محتوى الطلب (العنوان ومحتوى سلة التسوق) والحصول على جميع تفاصيل التسعير. ويتم تحقيق ذلك باستخدام طريقة التحقق من صحة الطلب. وإرسال الطلب إلى mySE. ويتم تحقيق ذلك باستخدام طريقة إرسال الطلب.
تقييم توافر البلد - هذه الواجهة البرمجية متاحة فقط للعملاء الذين يتمركزون في فرنسا.
ميس النظام أبي يدعم 3 عمليات مختلفة على النحو التالي:
- التحقق من صحة إدخال الطلب
- يمكن التحقق من صحة الطلب قبل إرسال طلب إنشاء.
- يتم التحقق من صحة النظر في أنواع البيانات ، المعلمات الإلزامية وقواعد العمل المختلفة اعتمادا على البلد و / أو حساب المشتري.
- بعد التحقق من صحة التفاصيل المطلوبة ، تقوم بإرجاع تفاصيل التسعير للطلب.
- استرداد حالة إدخال الطلب
- إرجاع الوضع الحالي للطلب.
يمكن لفريق واجهة برمجة التطبيقات سرد القيم الرئيسية للحالة إن وجدت.
- إرجاع الوضع الحالي للطلب.
- إرسال إدخال الطلب
- يسمح بتقديم طلب جديد ، عند تقديم الطلب، سيتم تنفيذ جميع عمليات التحقق المذكورة في عمليات إدخال الطلب.
- إذا كان طلب الطلب صالحا ، فسيتم إنشاء الطلب في موسى وتاريخ طلب الطلب ، وسيتم إرجاع رقم الطلب ورقم الطلب ردا على ذلك.
أثناء استخدام أي من واجهة برمجة التطبيقات المذكورة أعلاه ، تأكد من توفير عنوان البريد الإلكتروني الصحيح لضمان المصادقة الناجحة.
عنوان البريد الإلكتروني الصحيح يعني:
- يجب تسجيل البريد الإلكتروني في مايس مقابل حساب المستخدم
- يجب أن يكون البريد الإلكتروني لديه إذن للوصول إلى / إنشاء تفاصيل الطلب
تنسيق البيانات: يتبع تنسيق جميع حقول التاريخ تنسيق التاريخ المحدد في إسو 8601 (ي-م-د).
Getting Started (الشروع في العمل)
سيتطلب الوصول إلى واجهة برمجة التطبيقات مصادقة أووث ، يرجى الرجوع إلى التفاصيل الموجودة على البوابة.
BaseURL: https://api.qa.se.com/v2/customer-order/system/myse-order-entry-fr
| العملية | الطريقة | ResourcePath |
| validateOrderEntry | POST | /orders/validate |
| submitOrderEntry | POST | /orders/submit |
| GET | /orders/{order-id}/status |
