How to handle Store Availability

Introduction

A store's normal business hours are communicated via the "availabilities" array in the menu payload.

Format

Each object in the "availabilities" array will specify a period of store availability as in example below;

"availabilities": [
 {
    "dayOfWeek": 1,
    "startTime": "13:00",
    "endTime": "21:30"
 }

Request Body

FieldUseType
dayOfWeekAn integer value that indicates the day of the week for this availability (starting at 1 for Monday).integer
startTimeA 24-hour HH:MM format notation of the start time of availability expressed in the local time of the location.string
endTimeA 24-hour HH:MM format notation of the end time of availability expressed in the local time of the location.string
Day of weekInteger value
Monday1
Tuesday2
Wednesday3
Thursday4
Friday5
Saturday6
Sunday7

Example - multiple time slots per day

Multiple non-overlapping periods can be specified per day as shown in the example below e.g. Saturday's availability ("dayOfWeek": 6) has two periods in the day where the store will be open;

"availabilities": [
    {
        "dayOfWeek": 1,
        "endTime": "17:00",
        "startTime": "09:00"
    },
    {
        "dayOfWeek": 2,
        "endTime": "17:00",
        "startTime": "09:00"
    },
    {
        "dayOfWeek": 3,
        "endTime": "17:00",
        "startTime": "09:00"
    },
    {
        "dayOfWeek": 4,
        "endTime": "17:00",
        "startTime": "09:00"
    },
    {
        "dayOfWeek": 5,
        "endTime": "17:00",
        "startTime": "09:00"
    },
    {
        "dayOfWeek": 6,
        "endTime": "17:00",
        "startTime": "09:00"
    },
    {
        "dayOfWeek": 6,
        "endTime": "22:00",
        "startTime": "19:00"
    },
    {
        "dayOfWeek": 7,
        "endTime": "17:00",
        "startTime": "09:00"
    }
],

Store Availabilty Messaging
Menu "availabilities" reflect normal operating hours per store. Outside of operating hours, stores can be closed temporarily via Busy Mode. Customers should clearly see whether ordering is unavailable due to being outside opening hours or if a temporary closure applies.


Did this page help you?