This guide will be removed on April 29, 2022. Please use our new, easier-to-use Toast technical documentation site. All updated content is on the new site.
When the Toast platform applies a combo discount, it adds a
comboItems
object to the AppliedDiscounts
object. The comboItems
object identifies the menu item
selections that are part of the discount.
For example, the following order contains a single menu item selection for three cups of soup. The applied combo discount offers two cups of soup for a reduced price.
{ "entityType":"Order", [contents omitted] }, "checks":[ { "entityType":"Check", "selections":[ { "entityType": "MenuItemSelection", "itemGroup": { "guid": "e0da05d4-db71-44ed-805b-95284d22df73", "entityType": "MenuGroup" }, "item": { "entityType": "MenuItem", "guid": "a8b4439d-185d-41df-8ad3-2ff4f7dfa6ec"}, "quantity": 3,
"modifiers": [] } ], "appliedDiscounts": [ { "discount": { "guid": "7e345df5-9b3c-4e5a-9fbe-6183c56d2f88"
} } ] } ] }
The GUID of the menu item selection for the check. The specific menu items must match the configuration of the combo discount to trigger the orders API to apply that discount. |
|
The number of menu items in the check. The number of menu items must match the configuration of the combo discount to trigger the orders API to apply that discount. |
|
The GUID for a combo discount that is configured for your
restaurant. You apply combo discounts in the
|
In the returned order information, there are two
MenuItemSelection
objects.
-
One
MenuItemSelection
object is for two cups of soup. These are the two cups of soup that have the combo discount applied. -
The other
MenuItemSelection
object is for the third cup of soup, which is not discounted.
In the AppliedDiscounts
object for the check, the
comboItems
object points to the
MenuItemSelection
object for the two cups of soup.
{ "entityType": "Order", [contents omitted] "checks": [ { "entityType": "Check", [contents omitted] "appliedDiscounts": [{ "guid": "3b97af77-bb9f-4f83-87e1-471a1dd984cd", "entityType": "MultiItemAppliedDiscount", "approver": null, "processingState": null, "loyaltyDetails": null, "name": "Eat more soup.", "comboItems": [ { "guid": "b059bf10-2d4b-4aba-808a-46d0ecfa1b71",
"entityType": "MenuItemSelection" } ], "discountAmount": 2.98, "discount": { "guid": "b1fba60e-f119-45ce-81ed-1e030c8e8705",
"entityType": "Discount" }, "triggers": [ { "selection": { "guid": "13c704da-d8bd-4a72-8df3-d340efb1e0d3",
"entityType": "MenuItemSelection" }, "quantity": 2
} ], "appliedPromoCode": null } ], "totalAmount": 25.67, "selections": [ { "guid": "13c704da-d8bd-4a72-8df3-d340efb1e0d3",
"entityType": "MenuItemSelection", "itemGroup": { "guid": "46c963b8-a4c8-4cd0-9b7e-e1c431ed0b53", "entityType": "MenuGroup" }, "item": { "guid": "a8b4439d-185d-41df-8ad3-2ff4f7dfa6ec",
"entityType": "MenuItem" }, "quantity": 1,
"preDiscountPrice": 8.99, "appliedDiscounts": [],
[contents omitted] "price": 8.99 }, { "guid": "b059bf10-2d4b-4aba-808a-46d0ecfa1b71", "entityType": "MenuItemSelection", "itemGroup": { "guid": "46c963b8-a4c8-4cd0-9b7e-e1c431ed0b53", "entityType": "MenuGroup", "externalId": null }, "item": { "guid": "a8b4439d-185d-41df-8ad3-2ff4f7dfa6ec",
"entityType": "MenuItem", "externalId": null }, "quantity": 2,
"preDiscountPrice": 17.98,
"appliedDiscounts": [],
[contents omitted] "price": 15
} ] [contents omitted] } ] [contents omitted] }
You apply a combo discount in the |
|
The GUID of the |
|
The GUID of the combo discount. |
|
The GUID of the |
|
The number of menu items that qualify for the combo discount. For example, the combo discount in this example applies to two cups of soup. |
|
The GUID that the Toast platform assigned to a menu item
selection in a check. You can use this GUID to determine which
|
|
The GUID of the specific menu item for this selection. |
|
The quantity of the menu items in this
The number of items in the input data for this order was three.
This example response data splits the original
|
|
The orders API reports combo discount information in the
|
|
The GUID of the specific menu item for this selection. This matches the menu item configured in the combo discount. In this example, the specific menu item is a cup of soup. |
|
The quantity of the menu items in this
The number of items in the input data for this order was three.
This example response data splits the original
|
|
The price of the two menu items before the combo discount is applied. |
|
The orders API reports combo discount information in the
|
|
The price of the two menu items after the combo discount is applied. |