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 a menu item is priced using the Time Specific Price pricing
strategy, its pricingStrategy
value is
TIME_SPECIFIC_PRICE
and its pricingRules
value contains the information you need to calculate the price of the
item at any given time. Inside the pricingRules
value,
you see the timeSpecificPricingRules
value which contains
an array of time-specific prices for the menu item.
In this use case, the pricingRules
value also
contains the sizeSpecificPricingGuid
and
sizeSequencePricingRules
values, however, the
sizeSpecificPricingGuid
is null and the
sizeSequencePricingRules
array is empty because the menu
item uses a time-specific price, not a size price.
Sample JSON for a menu item that uses the Time Specific Price pricing strategy
{ "restaurantGuid": "2071fb81-988b-4d75-b8dc-c5c17cff9706", ... "menus": [ { "name": "Dinner", "guid": "ddd681de-3c12-4d45-b8b1-a5b2ea898210", ... "menuGroups": [ { "name": "Pizza", "guid": "dc868006-919a-4950-a4cc-3a03f9770fd7", ... "menuItems": [ { "name": "Cheese Pizza", "guid": "6f54db28-557b-4070-b3da-58a52fa4a4fb", ... "price": null, "pricingStrategy": "TIME_SPECIFIC_PRICE", "pricingRules": { "timeSpecificPricingRules": [ { "timeSpecificPrice": 8.0,"basePrice": 10.0,
"schedule": [
{ "days": [
"MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY" ], "timeRanges": [
{ "start": "12:00", "end": "14:00" } ] } ] }, { "timeSpecificPrice": 9.0,
"basePrice": 10.0, "schedule": [ { "days": [ "SATURDAY", "SUNDAY" ], "timeRanges": [ { "start": "12:00", "end": "15:00" } ] } ] } ], "sizeSpecificPricingGuid": null, "sizeSequencePricingRules": [] }, ... }, ] } ] } ], "modifierGroupReferences": { ... }, "modifierOptionReferences": { ... } }
The price of the Cheese Pizza menu item during the time
period defined by the |
|
The base price of the Cheese Pizza menu item ($10), used for time periods when a time-specific price has not been defined. |
|
The schedule for this time specific price, which defines the days and times the price applies. |
|
The days this time-specific price applies (Monday through Friday). |
|
The times this time-specific price applies (noon to 2pm), in the restaurant's local time. |
|
The configuration for another time-specific price for Saturday and Sunday. |