موفينجرُوجعت على المنتج في
اربط أنظمتك بموفينج POS بمفاتيح الوصول ووجهات الإرسال
أنشئ مفتاح وصول يقرأ طلبات مطعمك وفروعه وقائمته بالصلاحيات التي تختارها، وأضف وجهة إرسال تصلها أحداث المطعم موقّعة، وتابع كل إرسال وأعد المحاولة.
في هذه الصفحة
قبل أن تبدأ
- فعّل فريق موفينج لحسابك الوصول عبر الواجهة البرمجية.
- لديك صلاحية إدارة مفاتيح الواجهة البرمجية وإشعارات الأحداث، وهي لدور مدير النظام افتراضيًا.
تجمع شاشة التكاملات في لوحة الإدارة مفاتيح الوصول للأنظمة الخارجية، ووجهات إرسال أحداث المطعم، وسجل عمليات الإرسال. لا يمكن للمفتاح أن يتجاوز صلاحيات من أصدره. وفي الشاشة نفسها تبويب المتجر الإلكتروني لربط موفينج ستورز، وتفاصيله في اربط متجر مطعمك بموفينج POS.
أنشئ مفتاح وصول
الخطوة 1: من القائمة الجانبية افتح النظام › التكاملات.
يفتح تبويب مفاتيح الوصول.
صورة الشاشة قيد التحديثتظهر هنا لقطة من موفينج POS بهوية موفينج الجديدة فور اكتمالها.شكل 1 —يعرض الجدول بصمة كل مفتاح فقط، لا المفتاح نفسه. الخطوة 2: اضغط مفتاح جديد واكتب الاسم.
اكتب لمن هذا المفتاح. يظهر الاسم في القائمة وفي سجل النشاط.
الخطوة 3: حدّد الصلاحيات.
حدّد صلاحية واحدة على الأقل. تظهر هنا الصلاحيات التي تملكها أنت فقط.
الخطوة 4: قيّد المفتاح بفرع، وحدّد انتهاءه، إن شئت.
اختر فرعًا في تقييد بفرع واحد أو اترك كل الفروع المتاحة لصاحب المفتاح. والمفتاح يتوقف في نهاية يوم ينتهي في، والحقل الفارغ يعني بلا تاريخ انتهاء.
الخطوة 5: انسخ المفتاح من انسخ المفتاح الآن.
اضغط نسخ ثم حفظته. هذه المرة الوحيدة التي يظهر فيها، ولا يستطيع أحد استرجاعه، ولا الدعم الفني.
حالة المفتاح فعّال أو منتهٍ أو مسحوب، ومعه آخر استخدام. سحب مع السبب (اختياري) يوقف المفتاح من أول طلب تالٍ. ويُفحص المفتاح مع كل طلب مقابل صلاحيات صاحبه الحالية، فسحب صلاحية منه يضيّق المفتاح فورًا.
ما يقرؤه المفتاح
| البيانات | الصلاحية المطلوبة |
|---|---|
| الطلبات وتفاصيل كل طلب، بتصفية حسب الفترة والفرع والحالة | عرض التقارير |
| الفروع | عرض التقارير |
| القائمة والكتالوج | إدارة المنيو والكتالوج |
- أرسل المفتاح في الترويسة
Authorization: Bearer. الحد 600 طلب في الدقيقة لكل مفتاح. - إنشاء الطلبات وإلغاؤها متاحان لمتجر موفينج ستورز المربوط وحده، فلا يستطيع نظام آخر إرسال طلبات إلى الكاشير.
- لا توجد صفحة توثيق منشورة للواجهة البرمجية. راسلنا للتفاصيل التقنية.
أضف وجهة إرسال
الخطوة 1: افتح تبويب وجهات الإرسال واضغط وجهة جديدة.
الخطوة 2: اكتب الاسم والرابط، وحدّد الأحداث.
الرابط هو الذي تُرسَل إليه الأحداث، ويبدأ بـ
https://أوhttp://. حدّد حدثًا واحدًا على الأقل، واترك مفعّل محددًا، ثم احفظ.الخطوة 3: انسخ مفتاح التوقيع من انسخ مفتاح التوقيع الآن.
يظهر مرة واحدة، ويتحقق به نظامك من أن كل إرسال صادر من مطعمك.
| الحدث | متى يُرسَل |
|---|---|
إنشاء طلب order.created | طلب جديد من الكاشير أو موقع الطلبات، دون بيانات العميل. |
اكتمال طلب order.completed | حين يُقدَّم الطلب أو يُسلَّم. |
تغيّر حالة طلب عبر الإنترنت order.status_changed | لطلبات الإنترنت فقط، مرة لكل حالة. |
إقفال اليوم المحاسبي day.closed | عند إقفال يوم العمل، بإجماليات تقرير الإقفال. |
انخفاض مخزون مكوّن stock.low | مرة واحدة كلما نزل المكوّن تحت حدّه. |
لا تحمل الأحداث أسماء ولا بيانات تواصل العملاء، وتعتمد على المعرّفات والكميات. ويُوقَّع كل إرسال بـ HMAC-SHA256 على نص الرسالة بمفتاح التوقيع، ومعه معرّف للحدث ثابت في كل المحاولات ليتجاهل نظامك التكرار. مفتاح توقيع جديد يستبدل المفتاح، فيرفض نظامك كل إرسال حتى تعطيه الجديد. وحذف الوجهة يحذف سجل إرسالها، فعطّلها بدل حذفها إن أردت الاحتفاظ به.
تابع عمليات الإرسال
- تبويب عمليات الإرسال يعرض الحدث والوجهة والمحاولات وآخر نتيجة والمحاولة التالية، والحالة في الانتظار أو تم الإرسال أو توقّف.
- يُعاد الإرسال الفاشل تلقائيًا حتى 6 محاولات: بعد 30 ثانية، ثم دقيقة، ثم 2 و4 و8 دقائق، ومهلة كل محاولة 10 ثوانٍ. يُعاد عند خطأ الشبكة وانتهاء المهلة والردود
5xxو408و429، وأي رد4xxآخر يوقفه من أول محاولة. - ما توقّف نهائيًا لن يُعاد تلقائيًا. اختر عرض ما توقّف نهائيًا فقط، وأصلح المستقبِل، ثم اضغط إعادة المحاولة.
هل أستطيع إرسال طلبات إلى الكاشير من نظامي؟
لا. المفاتيح هنا للقراءة والأحداث، وإنشاء الطلبات متاح لمتجر موفينج ستورز المربوط وحده.
أضعت المفتاح، فهل أعرضه مرة أخرى؟
لا. أنشئ مفتاحًا جديدًا واسحب القديم.
هل هذه هي مفاتيح موفينج ستورز نفسها؟
لا. لموفينج ستورز مفاتيحه ووجهاته الخاصة، وتفاصيلها في اربط أنظمتك بمفاتيح الواجهة البرمجية والويب هوك.