Store Integration
¶ Overview
The Store API provides developers with the ability to manage stores and retrieve store information. Use the store endpoints to enable/disable POS integration and set date-specific store override hours.
¶ Components
- Retrieve Store Data
Developers can retrieve store information such as store address and name on an individual location basis viaGET /store/{store_id}
. - Retrieve Stores
To see all stores provisioned to your developer account, use theGET /stores
endpoint. - Set & Retrieve Restaurant Status
Developers can set stores as online or offline (‘paused’) via thePOST /status
endpoint. When set to online, stores will be searchable and available to customers on the Uber Eats platform during store hours. When set to offline, stores will show as “currently unavailable”. - Set & Retrieve Date-Specific Hours
Set and retrieve holiday hours via thePOST /holiday_hours
andGET /holiday_hours
endpoints.
¶ Syncing Store Availability
Support of the POST /status
endpoint is strongly recommended. To ensure a great Eater experience, stores should be set offline using this endpoint when they are unable to fulfill orders during store hours (e.g. while experiencing connectivity issues or undergoing maintenance).
¶ Setting Holiday Hours
Regular store hours are determined by menu hours set through the Menu API. However, date-specific exceptions to the normal operating hours of a restaurant should be set through the Holiday Hours endpoint. Holiday hours override store hours on the specified date(s) and can be set far in advance.
¶ Testing with Uber Eats Orders
In an incognito Chrome browser, navigate to Uber Eats Orders. Log in as a store using your test store credentials.
Call the POST /status
endpoint to pause the store (set it offline). Refresh the Uber Eats Orders page. You should see the display message change to “New orders paused”. Now click on the top button with the three lines (“Menu” on hover) in the left-hand navigation bar. Click “Resume new orders” on the bottom of the sidebar and click “Confirm” in the following prompt. Now use GET /status
to retrieve the store’s status. The status should now read as “ONLINE”.
You can also use Uber Eats Orders to test holiday hours. Set holiday hours via the POST /holiday_hours
endpoint. Refresh your Uber Eats Orders window. Click again on “Menu” in the left-hand navigation bar. In the Menu sidebar, click “Hours” and then “Holiday Hours”. You should see your newly-set holiday hours reflected.
¶ Next Steps
See the Menu Integration guide for steps to construct your menu.