Update Store Statusstore status

• To Online

Authenticated user User inputs restaurant address on restaurant search in App.Update Store Status to Online (docs)in the store locator in RBI’s platform.

Update store status to online via Update Store Status endpoint.

→ Partners API reports store is offline online through Get Store Status call endpoint.

→ Ordering buttons become eligible for the store.

Image Removed

Note: Select button is available and not grayed out.

Image Added

→ RBI admins have access to the Store Diagnostics and can verify that isRestaurantPosOnline: true

Update Store Statusstore status

• To Offline

Authenticated user User inputs restaurant address on restaurant search in App.Update Store Status to Offline (docs)in the store locator in RBI’s platform.

Update store status to offline via Update Store Status endpoint.

→ Partners API reports store is offline through Get Store Status call endpoint.

→ Ordering buttons become grayed out for the store. Mobile ordering is not available at this store warning appears.

Image Removed

Image Added

→ RBI admins have access to the Store Diagnostics and can verify that isRestaurantPosOnline: false

Image Removed

→ RBI admins have access to the Store Diagnostics and can verify that isRestaurantPosOnline: false

Image Added

Make an item unavailable available for a certain store

Authenticated user User selects ordering for the corresponding store and navigates to the menu section of the item.

Make a request with price and availability : falsetrue for the respective PLU (s) to Partner’s API using the Update Store Menu PLUs endpoint.

→ Partners API GET Store Menu PLUs endpoint returns the PLUs with the corresponding price and availability.

→ Item disappears from App Menu section.

• Consider a cache of up to 1 minute for updates to reflect in FE.

Make a combo available .

→ Item appears in App Menu section with correct price.

Make an item unavailable for a certain store

Authenticated user User selects ordering for the corresponding store and navigates to the menu section of the comboitem.

Make a request with price and availability : truefalse for the respective PLU (s) to Partner’s API using the Update Store Menu PLUs endpoint.

→ Partners API GET Store Menu PLUs endpoint returns the PLUs with the corresponding price and availability.

→ Combo appears in App Menu section with correct price.

• Consider a cache of up to 1 minute for updates to reflect in FE.

Make a combo unavailable available for a certain store

Authenticated user User selects ordering for the corresponding store and navigates to the menu section of the combo.

Make a request with price and availability : falsetrue for the respective PLU(s) to Partner’s API using the Update Store Menu PLUs endpoint.

→ Partners API GET Store Menu PLUs endpoint returns the PLUs with the corresponding price and availability.

→ Combo disappears from appears in App Menu section .

• Consider a cache of up to 1 minute for updates to reflect in FE.

Make a modifier multiplier available with correct price.

Make a combo unavailable for a certain store

Authenticated user User selects ordering for the corresponding store and navigates to the item containing the modifier multipliermenu section of the combo.

Make a request with price and availability : truefalse for the respective PLU(s) to Partner’s API using the Update Store Menu PLUs endpoint.

→ Partners API GET Store Menu PLUs endpoint returns the PLUs with the corresponding price and availability.

→ Modifier Multiplier appears in Combo disappears from App Menu section with correct price.

.

Make a modifier multiplierunavailable available for a certain store

Authenticated user User selects ordering for the corresponding store and navigates to the item containing the modifier multiplier.

Make a request with price and availability : falsetrue for the respective PLU (s) to Partner’s API using the Update Store Menu PLUs endpoint.

→ Partners API GET Store Menu PLUs endpoint returns the PLUs with the corresponding price and availability.

→ Modifier Multiplier disappears from App Menu section.

Multiplier appears in App Menu section with correct price.

Make a Systemwide Offer available modifier multiplier unavailable for a certain store

Authenticated user User selects ordering for the corresponding store and navigates to the offers pageitem containing the modifier multiplier.

Make a request with price and availability : truefalse for the respective PLU (s) to Partner’s API using the Update Store Menu PLUs endpoint.

→ Partners API GET Store Menu PLUs endpoint returns the PLUs with the corresponding price and availability.

→ Offer appears in App Offers page and is available for Mobile redemption with correct price.

• Consider a cache of up to 1 minute for updates to reflect in FE.

Make a Systemwide Offer unavailable available for a certain store

Authenticated user User selects ordering for the corresponding store and navigates to the offers page.

Make a request with price and availability : falsetrue for the respective PLU(s) to Partner’s API using the Update Store Menu PLUs endpoint.

→ Partners API GET Store Menu PLUs endpoint returns the PLUs with the corresponding price and availability.

→ Offer button for Mobile redemption is grayed out.

• Consider a cache of up to 1 minute for updates to reflect in FE.

Make a premium item (within a comboslot) available as part of a combo

Image Removed

Authenticated user selects ordering for the corresponding store and navigates to the combo containing the premium item.

price and availability.

→ Offer appears in App Offers page and is available for Mobile redemption with correct price.

Make a Systemwide Offer unavailable for a certain store

User selects ordering for the corresponding store and navigates to the offers page.

Make a request with price and availability : truefalse for the respective PLU(s) to Partner’s API using the Update Store Menu PLUs endpoint.

Menu PLUs endpoint.

→ Partners API GET Store Menu PLUs endpoint returns the PLUs with the corresponding price and availability.

→ Item appears inside the Combo with the desired premium price.

Offer button for Mobile redemption is grayed out. Offer displays text indicating that it isn't available at the selected location.

Make a premium item (within a comboslot) unavailable as part of a combo

Image Removed

Authenticated user available as part of a combo

Image Added

User selects ordering for the corresponding store and navigates to the combo containing the premium item.

• Internal configurations should be applied to serve Composite PLU for the given POS Vendor / market.

Make a request with price and availability : falsetrue for the respective PLU(s) to Partner’s API using the Update Store Menu PLUs endpoint.

• The PLU for the premium comboslot option should follow the pattern comboPlu-itemPlu. ( E.g. for the whopper meal medium (PLU=123) to have onion rings (PLU=456) as a premium comboslot option, the price would have to be posted using the plu 123-456.

→ Partners API GET Store Menu PLUs endpoint returns the PLUs with the corresponding price and availability.

→ Item disappears from appears inside the Combo with the desired premium price.

• Consider a cache of up to 1 minute for updates to reflect in FE.

Make a Reward available for a certain store

Authenticated user Make a premium item (within a comboslot) unavailable as part of a combo

Image Added

User selects ordering for the corresponding store and navigates to the combo containing the premium item.

• Internal configurations should be applied to

• serve Composite PLU for the given POS Vendor / market.

Make a request with price and availability : truefalse for the respective PLU(s) to Partner’s API using the Update Store Menu PLUs endpointPLU(s) to Partner’s API using the Update Store Menu PLUs endpoint.

• The PLU for the premium comboslot option should follow the pattern comboPlu-itemPlu. E.g. for the whopper meal medium (PLU=123) to have onion rings (PLU=456) as a premium comboslot option, the price would have to be posted using the plu 123-456.

→ Partners API GET Store Menu PLUs endpoint returns the PLUs with the corresponding price and availability.

→ Reward appears in App Rewards page and is available for Mobile redemption with correct price.

• Consider a cache of up to 1 minute for updates to reflect in FE.

Make a Reward unavailable available for a certain store

Authenticated user selects ordering for the corresponding store and navigates to the rewards page.

User must have enough points to redeem applicable reward.

Make a request with price and availability : falsetrue for the respective PLU(s) to Partner’s API using the Update Store Menu PLUs endpoint.

→ Partners API GET Store Menu PLUs endpoint returns the PLUs with the corresponding price and availability.

→ Reward button for Mobile redemption is grayed out.

• Consider a cache of up to 1 minute for updates to reflect in FE.

Reward appears in App Rewards page and is available for Mobile redemption with correct price.

Make a Reward unavailable for a certain store

Authenticated user selects ordering for the corresponding store and navigates to the rewards page.

User must have enough points to redeem applicable reward.

Make a request with price and availability : false for the respective PLU(s) to Partner’s API using the Update Store Menu PLUs endpoint.

→ Partners API GET Store Menu PLUs endpoint returns the PLUs with the corresponding price and availability.

→ Reward button for Mobile redemption is grayed out. Rewards displays text indicating that it isn't available at the selected location.

Change price for an item

User navigates through App Menu.

Make a request with updated price for the respective PLU using the Update Store Menu PLUs endpoint.

→ Partners API GET Store Menu PLUs endpoint returns the PLUs with the corresponding updated price.

→ Item price appears updated in the App Menu section with correct price.

Pricing Order

Authenticated user selects ordering for the corresponding store, builds a cart, adds items to cart and navigates to the checkout and places an order.

All available Cart Structures must be tested in this category:

• Item

• Item w/ with modifiers

• Combo

• Combo with items w/ with modifiers

• Systemwide Offer Item

• Systemwide Offer Combo

• Systemwide Offer Combo w/ modifiers

• Promo Codes - Amount Discount

• Promo Codes - Percentage Discountwith modifiers

• Reward Item

• Reward Combo

• Reward Combo with modifier

Cancel Order

→ Check whether the status has been changed to cancel

→ Check whether the automatic refund has been processed (if applicable)

→ Check whether the cancellation email was triggered

→ Check whether delivery has been cancelled (if applicable)

→ When the order is canceled in the POS the payment should be refunded.

• modifiers

• Promo Codes - Amount Discount

• Promo Codes - Percentage Discount

Partner is subscribed to the Price Order webhook. The payload of the webhook includes the order contents for the selected store ID, service mode, and other details.

Partner must return the price and availability for each item in the order, the total price and any errors using the Price Webhook Callback endpoint.

Error Handling must follow the message and code standards:

• Message: Include a clear and concise error message. Include information that would lead to the fixing and understanding of the error occurred. (e.g.: Offending PLUs, store status, etc.).
  Do not include redundant information like: Error occurred while processing request.

• Code Enum: "MENU" "STORE" "TIMEOUT" "UNKNOWN"

→ /cart page loads total price of the cart, corresponding to the sum of all products within.

→ Loading time does not exceed 3 seconds for p99.

→ Tax, Subtotal, and Total are visible at checkout

→ (OPTIONAL) Fees, such as “Bag Fee”, are visible in the /cart page, separately from total cart amount.

Commit Order

After pricing an order, an authenticated user pays, and continues with the placement the order.

All available Cart Structures must be tested in this category:

• Item

• Item w/ modifiers

• Combo

• Combo with items w/ modifiers

• Systemwide Offer Item

• Systemwide Offer Combo

• Systemwide Offer Combo w/ modifiers

• Promo Codes - Amount Discount

• Promo Codes - Percentage Discount

• Reward Item

• Reward Combo

• Reward Combo with modifier

Partner is subscribed to the Commit Order webhook. The payload of the webhook includes the service mode, order id, total order price and customer details, among other details.

All order information can also be fetched from the GET Order endpoint, at any time.

The POS must respond to the webhook request by using the Commit Webhook callback endpoint.

Error Handling must follow the message and code standards:

• Message: Include a clear and concise error message. Include information that would lead to the fixing and understanding of the error occurred. (e.g.: Offending PLUs, store status, etc.).
  Do not include redundant information like: Error occurred while processing request.

• Code Enum: "MENU" "STORE" "TIMEOUT" "UNKNOWN"

→ Order is registered in the POS.

Cancel Order – Initiated by guests or delivery fulfillment providers

• Initiated by guest: for pick up order, guest selects the Cancel Order option.

Image Added

• Initiated by delivery provider: order is canceled by the delivery provider in their Driver Management Portal.

Partner is subscribed to the Order Event webhook. Upon cancelation, the webhook will return an event with status CANCELED.

The POS must acknowledge the cancelation and mark the order as canceled in the POS.

→ Order status is changed to CANCELED. You can check it using the GET Order endpoint.

→ An automatic refund is processed (if applicable).

→ A cancellation email is triggered.

Cancel Order – Initiated by POS

Restaurant team member cancels order in the POS.

Partner send status CANCELED using the Order Event endpoint.

→ Order status is changed to cancel. You can check it using the GET Order endpoint or in the Order Event webhook.

→ An automatic refund is processed (if applicable).

→ A cancellation email is triggered.

Place a Dine In / Pickup

• Immediate order (Now)

Authenticated user selects ordering for the corresponding store, builds a cart and navigates to checkout.

User selects service mode and order time Now.User inputs the desired table Dine In or Pick Up and order time Now.

Image Added

Partner injects order the POS using the corresponding service Mode and number. Partner collects the

The Partner has received all relevant information to the order previously via the pricing webhook: service mode (serviceMode) from the GET Order endpoint (TABLE_SERVICE) and injects in the POS.Partner collects the order number (number) TAKEOUT) , order number, etc.

All order information can also be fetched from the GET Order endpoint and injects in the POS, at any time.

fireOrderInSeconds: 0 indicates the order should be fired to the kitchen immediately.

→ Order is injected registered in the POS with reference to the table numberthe POS.

→ KDS identifies the service mode.→ KDS identifies the table number.

→ DSS ticket printed according to the service mode.→ DSS ticket printed with the table number.

→ Receipt printed with the table number.

→ Receipt printed with order number from RBI, though at a less relevant place, since table number should take precedence to the order number.

Order Number from RBI.

→ ORB displays Order Number from RBI.

Place a Curbside Drive-Thru order

• Immediate order (Now)

Authenticated user selects ordering for the corresponding store, builds a cart and navigates to checkout.

User selects service mode and order time Now.

User inputs the car plate number.

Partner collects the service mode (serviceMode) from the GET Order endpoint (CURBSIDE) and injects in the POS.

Partner collects the order number (number) from the GET Order endpoint and injects in the POS.

• fireOrderInSeconds: 0 indicates the order should be fired to the kitchen immediately.

→ Order is injected in the POS with reference to the table number.

→ KDS identifies the service mode.

→ KDS identifies the table number.

→ DSS ticket printed according to the service mode.

→ DSS ticket printed with the table number.

→ Receipt printed with the car plate.

→ Receipt printed with order number from RBI, though at a less relevant place, since car plate should take precedence to the order number.

• RBI’s order number is expected to substitute the POS order number.

• RBI’s order number is configurable, allowing numerical interval restriction and / or utilization of an alphanumerical prefix.

Place a Dine In / Pickup / Drive-Thru order

Drive Thru. No time selection appears at checkout.

Partner injects order the POS using the corresponding service Mode and number.

The Partner has received all relevant information to the order previously via the from pricing webhook: service mode (DRIVE_THRU) , order number, etc.

All order information can also be fetched from the GET Order endpoint, at any time.

fireOrderInSeconds: null indicates the order should be held in the POS until the order is released.

→ Order is registered in the POS but not sent to the kitchen.

→ When the guest arrives at the restaurant, a team member manually fires the order to the kitchen from the POS.

At that point,

→ DSS ticket printed.

→ Receipt printed with Order Number from RBI.

→ ORB displays Order Number from RBI.

Place a Table Service order

• Immediate order (Now)

Authenticated user selects ordering for the corresponding store, builds a cart and navigates to checkout.

User selects service mode and order time equivalent to any slot in the future.

Partner collects the service mode (serviceMode) from the GET Order endpoint (EAT_IN TAKEOUT DRIVE_THRU) and injects in the POS.

Partner collects the order number (number) from the GET Order endpoint and injects in the POS.

Table Service and inputs the desired table number.

Image Added

No time selection appears.

Partner injects order the POS using the corresponding service Mode and number.

The Partner has received all relevant information to the order previously via the from pricing webhook: service mode (TABLE_SERVICE) , order number, etc. The table service is provided under the instructions field.

All order information can also be fetched from the GET Order endpoint, at any time.

fireOrderInSeconds: 0 indicates the order should be fired to the kitchen

→ Order is injected in the POSimmediately.

→ Order appears is registered in the KDS X seconds after POS order injectionPOS with reference to the table number.

→ KDS identifies the service mode.

→ KDS identifies the table number.

→ DSS ticket printed according to the service mode.

→ Receipt DSS ticket printed with Order Number from RBIthe table number.

→ ORB displays Order Number from RBI.

Receipt printed with the table number.

→ Receipt printed with order number from RBI, though at a less relevant place, since table number should take precedence to the order number.

Place a Table Service Dine In / Pickup order

• Future order (Scheduled)

Authenticated user selects ordering for the corresponding store, builds a cart and navigates to checkout.

User selects service mode Dine In or Pick Up and order time equivalent to any slot in the future.User inputs the desired table number.

Image Added

Partner collects injects order the POS using the service mode (serviceMode) from the GET Order endpoint (TABLE_SERVICE) and injects in the POS.Partner collects the order number (number) corresponding service Mode and number.

The Partner has received all relevant information to the order previously via the pricing webhook: service mode (TAKEOUT) , order number, etc.

All order information can also be fetched from the GET Order endpoint and injects in the POS, at any time.

fireOrderInSeconds: X indicates the order should be fired to the kitchen X seconds after the order is placed.

→ Order is injected registered in the POS with reference to the table number.

→ Order appears in the KDS X seconds after POS order injection.→ KDS identifies the service mode.

→ KDS identifies the table number.

→ DSS ticket printed according to the service mode.

→ DSS ticket printed with the table numberthe service mode.

→ Receipt DSS ticket printed with the table numberaccording to the service mode.

→ Receipt printed with order number from RBI, though at a less relevant place, since table number should take precedence to the order number.

Order Number from RBI.

→ ORB displays Order Number from RBI.

Place a Curbside order

Authenticated user selects ordering for the corresponding store, builds a cart and navigates to checkout.

User selects service mode and order time equivalent to any slot in the future. No time selection appears.

User inputs the car plate number, places the order and is taken to an order confirmation page with an “I’m here” button.

Partner injects order the POS using the corresponding service Mode and number.

Partner collects the service mode (serviceMode) from the GET Order endpoint (CURBSIDE) and injects in the POS.

Partner collects the order number (number) The Partner has received all relevant information to the order previously via the pricing webhook: service mode (CURBSIDE) , order number, etc.

All order information can also be fetched from the GET Order endpoint and injects in the POS, at any time.

fireOrderInSeconds:

null indicates the order should be

held in the POS until the order is

released.

→ Order is injected in the POS with reference to the table number.→ Order appears in the KDS X seconds after POS order injection.is registered in the POS but not sent to the kitchen.

→ When the guest clicks on I’m here, the order is sent to the kitchen.

At that point:

→ KDS identifies the service mode.

→ KDS identifies the table number.

→ DSS ticket printed according to the service mode.

→ DSS ticket printed with the table number.

→ Receipt printed with the car plate.

→ Receipt printed with order number from RBI , though at a less relevant place, since and car plate should take precedence to the order number.

, which should be more visible than the order number.

Place a Delivery order

Authenticated user inputs address within covered delivery area on restaurant search locator in App, builds a cart and navigates to checkout.

Authenticated user clicks on “Continue” on the checkout page, and confirms selecting any payment method by clicking “Place Secure Order”.

Partner collects the The Partner has received all relevant information to the order previously via the from pricing webhook: service mode (serviceMode) DELIVERY) , order number, etc.

All order information can also be fetched from the GET Order endpoint (DELIVERY) and injects in the POS, at any time.

fireOrderInSeconds: null indicates the order should

Partner collects the order number (number) from the GET Order endpoint and injects be held in the POS until the order is released.

→ Order is injected registered in the POS.

→ Order does not appear in the KDS (not fired into the kitchen).

Fire a Delivery order into the kitchen

Delivery vendor request fulfillment provider requests to move the order to kitchen

based on the driver’s geolocation

or driver’s ETA to the restaurant.

Partner is subscribed to the ORDER_FIRE webhook, which triggers a request to fire an order into the kitchen.

Partner fires the order through a POST call to the Fire Order endpoint.

→ Order appears in the KDS (is fired into the kitchen).

→ KDS identifies the service mode.

→ DSS ticket printed according to the service mode.

→ Receipt printed with Order Number from RBI.

• RBI’s order number is expected to substitute the POS order number.

• RBI’s order number is configurable, allowing numerical interval restriction and / or utilization of an alphanumerical prefix.

Cancel a Delivery order

Delivery cancelation

→ Delivery Order successfully sent and placed in Partner’s POS.

→ If a delivery cancellation is requested:

• The order should be canceled in the POS.