ضبط الحد الأدنى لوقت الحجز المُسبَق

تحديد الحد الأدنى للوقت المُسبَق للحجز

هناك العديد من الحالات التي يريد فيها التاجر حجز خدمات أو خانات محدّدة قبل وقت قصير. ويمكن ضبط هذه الإعدادات على مستوى الخدمة و/أو على مستوى مدى التوفّر. وفي حال ضبطه على كلا المستويَين، سيتم استخدام الإعداد على مستوى مدى التوفّر.

تعريف مستوى الخدمة

في مستوى الخدمة، يُسمى الحقل rules.min_advance_booking. يجب ضبط هذا الحقل على عدد الثواني قبل بدء الحجز التي يجب إجراء الحجز خلالها. على سبيل المثال، إذا كان يجب إجراء الحجز دائمًا قبل ساعة واحدة من وقت البدء، سيتم ضبط هذا الحقل على 3600 (لذا يمكن حجز موعد في الساعة 3 مساءً حتى الساعة 2 مساءً). وينطبق ذلك على جميع الفتحات لهذه الخدمة (ما لم يتم إلغاؤه من خلال تعريف مستوى الفتحة).

JSON

"service": [
  {
    "rules": {
      "min_advance_booking": 3600
    }
  }
]

التعريف على مستوى الخانة

على مستوى موضع التوفّر، يُعرف الحقل باسم scheduling_rule_overrides.last_bookable_sec. هذا الحقل هو آخر مرة (الطابع الزمني لبدء الحقبة) يمكن فيها حجز خانة محدّدة. وينطبق ذلك على كل خانة فردية تم تحديد ذلك فيها.

JSON

"service_availability": [
  {
    "availability": {
      "scheduling_rule_overrides": {
        "last_bookable_sec": 1468081800
        }
    }
  }
]

تحذير: لا يمنع تطبيق الحدّ الأقصى للحجز المُسبَق في الخلاصات من التحقّق مما إذا كان الحجز ضمن فترة الحجز المسموح بها والتعامل معه BookingFailure SLOT_UNAVAILABLE. قد تكون هناك حالات استثنائية (مثل علامة تبويب متوقّفة في المتصفّح) قد يتم فيها إرسال CreateBooking خارج نافذة الحجز. عند تلقّي CreateBooking، يجب أن يؤكّد نظامك أنّ الحجز يقع ضمن فترة الحجز المسموح بها، وإذا لم يكن كذلك، يجب الردّ باستخدام CreateBookingResponse.booking_failure = SLOT_UNAVAILABLE.