Place order for Dine-in (FS)
The Dine-in (FS) orders are only available for ASAP ordering for the customers that are already in the restaurant.
This guide will show you how to develop a flow that enables your customers to place an order for Dine-in (FS) (see Order Types for more information).
| Menu Screen with Table Selected | Order Summary with Cross-Selling | Dine-in FS Order created Screen |
|---|---|---|
 |
 |
 |
Before proceeding, you should have implemented:
Get Singular Point
Singular Points are physical or virtual destinations, connected to Areas, that orders are placed to. For Table service orders the service area and Singular points are associated with physical tables.
In Dine-In (FS) case the Area type is Full-Service and the singular_point_input_type property is returned as manual, as the customer will be able to input the desired table number.
We can make a call to /venues/{venue_uuid} in order to get all details of the Venue, including its Areas:
The venues call is made with additional URL parameter, to retrieve the singular points and areas:
api/venues/{venue_uuid}?view=withNestedEntities
Request
{
"method": "get",
"url": "https://api-public-playground.menu.app/api/venues/{venue_uuid}?view=withNestedEntities",
"headers": {
"X-Request-ID": "69da3547-204b-4093-a225-54e084c24215",
"Application": "f3a90488ffee32c3acb6fcd0ca417cf6",
"Api-Version": 4.38.0
}
}
Response
{
"status":"OK",
"code":200,
"data":{
"venue":{
"id":314,
"uuid":"6b76962a-7a42-4cf2-999c-1aa78c2547f4",
"name":"Kauwela Poke Austin Table",
"code":"314",
"parent_type":"Company",
"parent_id":4,
"company_id":4,
"chain_id":3,
"country_id":14,
"currency_id":5,
"language_id":1,
"store_group_id":318,
"integration_store_group_id":390,
"external_dlc_id":"400825",
"brand_id":4,
"timezone":{
"name":"America\/Chicago",
"offset":"-05:00"
},
"description":"Welcome to Kauwela Dallas!",
"kiosk_receipt_footer":"",
"imprint":"\"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.\"",
"welcome_message":"",
"translations":{
"description":"Welcome to Kauwela Dallas!",
"kiosk_receipt_footer":null,
"welcome_message":null
},
"address":"1645 East 6th Street",
"state":1,
"city":"Austin",
"zip":"78702",
"latitude":30.2621564,
"longitude":-97.7249517,
"tax_number":"",
"phone":"555 55 55 55",
"price_configuration":{
"order_types":[
{
"type_id":1,
"price_configuration":null
},
{
"type_id":4,
"price_configuration":null
},
{
"type_id":6,
"price_configuration":null
},
{
"type_id":7,
"price_configuration":2
},
{
"type_id":8,
"price_configuration":null
},
{
"type_id":9,
"price_configuration":null
}
],
"external_channels":[
{
"type_id":2,
"order_type_id":7,
"price_configuration":3
},
{
"type_id":2,
"order_type_id":6,
"price_configuration":3
},
{
"type_id":7,
"order_type_id":7,
"price_configuration":4
},
{
"type_id":7,
"order_type_id":6,
"price_configuration":5
},
{
"type_id":10,
"order_type_id":7,
"price_configuration":6
},
{
"type_id":10,
"order_type_id":6,
"price_configuration":7
},
{
"type_id":8,
"order_type_id":7,
"price_configuration":3
},
{
"type_id":8,
"order_type_id":6,
"price_configuration":3
},
{
"type_id":36,
"order_type_id":7,
"price_configuration":null
},
{
"type_id":36,
"order_type_id":6,
"price_configuration":null
},
{
"type_id":17,
"order_type_id":7,
"price_configuration":null
},
{
"type_id":17,
"order_type_id":6,
"price_configuration":null
}
]
},
"used_price_configurations":{
"0":2,
"1":3,
"3":4,
"4":5,
"5":6,
"6":7
},
"cuisine":"",
"store_url":"",
"is_shown_in_directory":true,
"allow_item_comments":true,
"tip_default":10,
"tip_max":100,
"service_charge":0,
"pickup_time":50,
"is_pickup_on_open_allowed":false,
"calculation_method":"exclusive",
"image":null,
"available_payment_methods":[
{
"id":1736,
"payment_method_id":1,
"payment_method_type_id":1,
"payment_method_brand":"Visa",
"payment_processor_type_id":2,
"payment_processor_id":3,
"properties":null,
"fraud_detection_processor_id":0,
"visibility_scopes":null
},
{
"id":1737,
"payment_method_id":2,
"payment_method_type_id":1,
"payment_method_brand":"MasterCard",
"payment_processor_type_id":2,
"payment_processor_id":3,
"properties":null,
"fraud_detection_processor_id":0,
"visibility_scopes":null
},
{
"id":1738,
"payment_method_id":3,
"payment_method_type_id":1,
"payment_method_brand":"Amex",
"payment_processor_type_id":2,
"payment_processor_id":3,
"properties":null,
"fraud_detection_processor_id":0,
"visibility_scopes":null
},
{
"id":1739,
"payment_method_id":7,
"payment_method_type_id":1,
"payment_method_brand":"Maestro",
"payment_processor_type_id":2,
"payment_processor_id":3,
"properties":null,
"fraud_detection_processor_id":0,
"visibility_scopes":null
},
{
"id":1740,
"payment_method_id":14,
"payment_method_type_id":4,
"payment_method_brand":"PayPal",
"payment_processor_type_id":8,
"payment_processor_id":12,
"properties":null,
"fraud_detection_processor_id":0,
"visibility_scopes":null
},
{
"id":1741,
"payment_method_id":15,
"payment_method_type_id":5,
"payment_method_brand":"MercadoPago",
"payment_processor_type_id":9,
"payment_processor_id":25,
"properties":null,
"fraud_detection_processor_id":0,
"visibility_scopes":null
},
{
"id":1742,
"payment_method_id":19,
"payment_method_type_id":7,
"payment_method_brand":"Cash",
"payment_processor_type_id":19,
"payment_processor_id":null,
"properties":{
"pos_wait_until_paid":false
},
"fraud_detection_processor_id":0,
"visibility_scopes":[
{
"scope_type":"application-type",
"scope_id":5
},
{
"scope_type":"application-type",
"scope_id":6
},
{
"scope_type":"application-type",
"scope_id":7
},
{
"scope_type":"order-type",
"scope_id":4
},
{
"scope_type":"order-type",
"scope_id":6
},
{
"scope_type":"order-type",
"scope_id":7
}
]
},
{
"id":1763,
"payment_method_id":27,
"payment_method_type_id":10,
"payment_method_brand":"ApplePay",
"payment_processor_type_id":2,
"payment_processor_id":3,
"properties":null,
"fraud_detection_processor_id":0,
"visibility_scopes":null
}
],
"country":{
"id":14,
"currency_id":5,
"name":"United States",
"code":"US",
"code_alpha3":"USA",
"code_numeric":"840",
"calling_code":"+1",
"distance_unit":"mile",
"is_address_number_first":false,
"currency_settings":{
"currency_space":true,
"decimal_separator":".",
"thousands_separator":",",
"symbol_position":"left"
},
"supported_travel_modes":[
"driving",
"bicycling"
],
"available_payment_methods":[
]
},
"currency":{
"id":5,
"code":"USD",
"code_numeric":"840",
"symbol":"$",
"rounding_unit":0.01,
"rounding_unit_tip":0.01
},
"order_types":[
{
"id":2818,
"type_id":1,
"reference_type":"OrderTypeDineIn",
"state":1,
"is_table_supported":true,
"external_channel_only":false,
"tip_default":10,
"tip_max":100
},
{
"id":2823,
"type_id":6,
"reference_type":"OrderTypeTakeOut",
"state":1,
"is_table_supported":false,
"external_channel_only":false,
"tip_default":10,
"tip_max":100
},
{
"id":2824,
"type_id":7,
"reference_type":"OrderTypeDelivery",
"state":1,
"is_table_supported":false,
"external_channel_only":false,
"tip_default":10,
"tip_max":100
}
],
"temporary_updated_entities":[
],
"serving_times":[
{
"id":1958,
"type_id":2,
"reference_type":"WeekDays",
"time_from":null,
"time_to":null,
"delivery_at":null,
"days":[
1,
2,
3,
4,
5,
6,
0
]
}
],
"is_open":true,
"will_open":true,
"has_discounts":true,
"has_loyalty":true,
"has_promotions":true,
"has_delivery_integration":true,
"delivery_integration_properties":{
"restaurant_id":"314"
},
"delivery_travel_type":"driving",
"is_calculated_delivery_buffer_used":false,
"is_monitoring_enabled":false,
"is_threeds_enabled":false,
"is_fraud_detection_enabled":false,
"is_smart_orders_enabled":false,
"use_pos_order_number":false,
"has_uc_capacity_management":false,
"kiosk_face_count":null,
"is_order_regret_enabled":false,
"is_billable":true,
"default_delivery_buffer":0,
"integration":{
"id":2221,
"type_id":29,
"reference_type":"Brink",
"is_windows_pos":false,
"pos_modifier_group_type":1,
"support_combo_meals":true,
"max_comment_limit":200
},
"created_at":"2022-03-21 11:34:48",
"updated_at":"2023-07-28 08:13:25",
"areas":[
{
"id":938,
"type_id":3,
"reference_type":"AreaQuickService",
"venue_id":314,
"menu_id":433,
"singular_point_id":1293,
"pos_id":"4001281",
"name":"Dine-In",
"use_tablet":true,
"state":1,
"is_table_supported":0,
"properties":{
"location_type":"table"
},
"order_types":[
{
"id":2821,
"type_id":4,
"reference_type":"OrderTypePreorder",
"state":2,
"is_table_supported":null,
"external_channel_only":false,
"tip_default":10,
"tip_max":100
}
],
"table_pos_id":"4007950",
"tablet":{
"id":250,
"venue_id":314,
"name":"Kauwela Dallas Tablet",
"use_notifications":1,
"show_kiosk_orders":true,
"kiosk_notification_type":3,
"middleware_endpoint":null,
"pls_name":null,
"state":3,
"is_online":false,
"last_request_at":"2023-07-28 22:05:56",
"failure_reported":false,
"is_critical":false,
"area_ids":[
938,
939,
1284
],
"allow_disable_product":false
},
"singular_point":{
"id":1293,
"parent_id":938,
"parent_type":"AreaQuickService",
"input_type":"ManualInput",
"input_id":0,
"input":{
"id":0
}
}
},
{
"id":939,
"type_id":4,
"reference_type":"AreaTakeOut",
"venue_id":314,
"menu_id":433,
"singular_point_id":1294,
"pos_id":"4001281",
"name":"TO",
"use_tablet":true,
"state":1,
"is_table_supported":0,
"properties":{
"location_type":"table"
},
"order_types":[
{
"id":2823,
"type_id":6,
"reference_type":"OrderTypeTakeOut",
"state":1,
"is_table_supported":null,
"external_channel_only":false,
"tip_default":10,
"tip_max":100
}
],
"table_pos_id":"4007950",
"tablet":{
"id":250,
"venue_id":314,
"name":"Kauwela Dallas Tablet",
"use_notifications":1,
"show_kiosk_orders":true,
"kiosk_notification_type":3,
"middleware_endpoint":null,
"pls_name":null,
"state":3,
"is_online":false,
"last_request_at":"2023-07-28 22:05:56",
"failure_reported":false,
"is_critical":false,
"area_ids":[
938,
939,
1284
],
"allow_disable_product":false
},
"singular_point":{
"id":1294,
"parent_id":939,
"parent_type":"AreaTakeOut",
"input_type":"ManualInput",
"input_id":0,
"input":{
"id":0
}
}
},
{
"id":1284,
"type_id":5,
"reference_type":"AreaDelivery",
"venue_id":314,
"menu_id":433,
"singular_point_id":2150,
"pos_id":null,
"name":"Delivery",
"use_tablet":true,
"state":1,
"is_table_supported":0,
"properties":null,
"order_types":[
{
"id":2824,
"type_id":7,
"reference_type":"OrderTypeDelivery",
"state":1,
"is_table_supported":null,
"external_channel_only":false,
"tip_default":10,
"tip_max":100
}
],
"delivery_area_maps":[
{
"id":497,
"area_id":1284,
"delivery_fee_id":509,
"minimal_order_amount":1000,
"name":"USA",
"coordinate_polygon":[
[
[
-86.1612613022793,
42.81599391866354
],
[
-86.00810960830358,
42.81531081572834
],
[
-86.00330308974698,
42.765992740033624
],
[
-86.16250788678668,
42.7644068087219
],
[
-86.1638608830065,
42.76367838105372
],
[
-86.1612613022793,
42.81599391866354
]
]
],
"radius":null,
"state":1,
"created_at":"2023-03-31 10:12:48",
"updated_at":"2023-04-06 09:42:50"
},
{
"id":498,
"area_id":1284,
"delivery_fee_id":509,
"minimal_order_amount":1000,
"name":"zone1",
"coordinate_polygon":[
[
[
-97.91056850718202,
30.35952816739685
],
[
-97.679336609737,
30.423869330488813
],
[
-97.469416407911,
30.205857598269542
],
[
-97.60581125985316,
30.063475298310976
],
[
-98.01712698526616,
30.071313965589496
],
[
-98.05122569825438,
30.265698100978113
],
[
-97.91056850718202,
30.35952816739685
]
]
],
"radius":null,
"state":1,
"created_at":"2023-04-06 09:40:50",
"updated_at":"2023-04-06 09:40:50"
}
],
"delivery_times":[
{
"id":2039,
"type_id":2,
"reference_type":"WeekDays",
"time_from":"00:00",
"time_to":"00:00",
"delivery_at":null,
"days":[
1,
2,
3,
4,
5,
6,
0
]
}
],
"tablet":{
"id":250,
"venue_id":314,
"name":"Kauwela Dallas Tablet",
"use_notifications":1,
"show_kiosk_orders":true,
"kiosk_notification_type":3,
"middleware_endpoint":null,
"pls_name":null,
"state":3,
"is_online":false,
"last_request_at":"2023-07-28 22:05:56",
"failure_reported":false,
"is_critical":false,
"area_ids":[
938,
939,
1284
],
"allow_disable_product":false
},
"singular_point":{
"id":2150,
"parent_id":1284,
"parent_type":"AreaDelivery",
"input_type":"ManualInput",
"input_id":0,
"input":{
"id":0
}
}
},
{
"id":1537,
"type_id":1,
"reference_type":"AreaFullService",
"venue_id":314,
"menu_id":433,
"singular_point_id":2591,
"pos_id":"4001281",
"name":"FS",
"use_tablet":false,
"state":1,
"is_table_supported":1,
"properties":{
"location_type":"table"
},
"order_types":[
{
"id":2818,
"type_id":1,
"reference_type":"OrderTypeDineIn",
"state":1,
"is_table_supported":null,
"external_channel_only":false,
"tip_default":10,
"tip_max":100
}
],
"singular_point_input_type":"ManualInput",
"singular_point":{
"id":2591,
"parent_id":1537,
"parent_type":"AreaFullService",
"input_type":"ManualInput",
"input_id":0,
"input":{
"id":0
}
},
"tables":[
{
"id":1055,
"area_id":1537,
"singular_point_id":2592,
"pos_id":"4007950",
"number":"1",
"state":1,
"singular_point":{
"id":2592,
"parent_id":1055,
"parent_type":"Table",
"input_type":"ManualInput",
"input_id":1122,
"input":{
"id":1122,
"singular_point_id":"2592",
"name":"1"
}
}
},
{
"id":1068,
"area_id":1537,
"singular_point_id":2641,
"pos_id":"4007950",
"number":"2",
"state":1,
"singular_point":{
"id":2641,
"parent_id":1068,
"parent_type":"Table",
"input_type":"ManualInput",
"input_id":1135,
"input":{
"id":1135,
"singular_point_id":"2641",
"name":"2"
}
}
},
{
"id":1070,
"area_id":1537,
"singular_point_id":2643,
"pos_id":"4007950",
"number":"3",
"state":1,
"singular_point":{
"id":2643,
"parent_id":1070,
"parent_type":"Table",
"input_type":"ManualInput",
"input_id":1137,
"input":{
"id":1137,
"singular_point_id":"2643",
"name":"3"
}
}
}
]
}
],
"menu_id":433,
"days_in_advance":0,
"payment_processors":[
{
"id":518,
"venue_id":314,
"payment_method_type_id":1,
"payment_processor_id":3,
"properties":null
},
{
"id":519,
"venue_id":314,
"payment_method_type_id":4,
"payment_processor_id":12,
"properties":null
},
{
"id":520,
"venue_id":314,
"payment_method_type_id":5,
"payment_processor_id":25,
"properties":null
},
{
"id":529,
"venue_id":314,
"payment_method_type_id":10,
"payment_processor_id":3,
"properties":null
}
],
"company":{
"id":4,
"name":"Kauwela Pok\u00e9",
"address":"Baslerstrasse 60",
"postal_code":"8048",
"city":"Z\u00fcrich",
"imprint":"\"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.\"",
"country":{
"id":14,
"currency_id":5,
"name":"United States",
"code":"US",
"code_alpha3":"USA",
"code_numeric":"840",
"calling_code":"+1",
"distance_unit":"mile",
"is_address_number_first":false,
"currency_settings":{
"currency_space":true,
"decimal_separator":".",
"thousands_separator":",",
"symbol_position":"left"
},
"supported_travel_modes":[
"driving",
"bicycling"
],
"available_payment_methods":[
]
},
"invoice_id":"INVOICING ID",
"billing_report_url":"BILLING REPORT URL",
"fiscal_id":"FISCAL ID"
},
"chain":{
"id":3,
"name":"Kauwela Poke",
"country_id":14,
"language_id":1,
"currency_id":5,
"brand_id":4,
"currency":{
"id":5,
"code":"USD",
"code_numeric":"840",
"symbol":"$",
"rounding_unit":0.01,
"rounding_unit_tip":0.01
},
"allow_item_comments":true,
"calculation_method":"inclusive",
"state":1,
"is_ready_for_venue":false,
"has_discounts":true,
"has_loyalty":true,
"has_promotions":true,
"integration":null,
"price_configuration":{
"order_types":[
{
"type_id":7,
"price_configuration":2
},
{
"type_id":4,
"price_configuration":null
},
{
"type_id":9,
"price_configuration":null
}
],
"external_channels":[
{
"type_id":2,
"order_type_id":0,
"price_configuration":3
},
{
"type_id":5,
"order_type_id":0,
"price_configuration":3
},
{
"type_id":6,
"order_type_id":0,
"price_configuration":4
},
{
"type_id":7,
"order_type_id":0,
"price_configuration":4
},
{
"type_id":8,
"order_type_id":0,
"price_configuration":4
},
{
"type_id":10,
"order_type_id":0,
"price_configuration":4
}
]
},
"used_price_configurations":{
"0":2,
"1":3,
"3":4
},
"created_at":"2020-02-13 12:46:29",
"updated_at":"2023-07-12 09:06:26"
},
"menu_languages":[
{
"id":84,
"parent_type":"Brand",
"parent_id":4,
"brand_id":4,
"name":"English",
"code":"en",
"is_default":true,
"state":1
},
{
"id":150,
"parent_type":"Brand",
"parent_id":4,
"brand_id":4,
"name":"Arabic",
"code":"ar",
"is_default":false,
"state":2
},
{
"id":154,
"parent_type":"Brand",
"parent_id":4,
"brand_id":4,
"name":"Portugu\u00eas (Brasil)",
"code":"pt",
"is_default":false,
"state":2
},
{
"id":196,
"parent_type":"Brand",
"parent_id":4,
"brand_id":4,
"name":"Spanish",
"code":"es",
"is_default":false,
"state":1
},
{
"id":490,
"parent_type":"Brand",
"parent_id":4,
"brand_id":4,
"name":"German",
"code":"de",
"is_default":false,
"state":1
}
],
"taxes":[
{
"id":518,
"name":"VAT",
"inside_rate":0,
"outside_rate":0,
"applies_to_delivery_fee":false
},
{
"id":762,
"name":"MwSt. (NOT USED)",
"inside_rate":0,
"outside_rate":0,
"applies_to_delivery_fee":false
},
{
"id":784,
"name":"MwSt. Alkohol (NOT USED)",
"inside_rate":0,
"outside_rate":0,
"applies_to_delivery_fee":false
},
{
"id":806,
"name":"V.A.T free",
"inside_rate":0,
"outside_rate":0,
"applies_to_delivery_fee":false
},
{
"id":827,
"name":"V.A.T (NOT USED)",
"inside_rate":0,
"outside_rate":0,
"applies_to_delivery_fee":false
},
{
"id":1567,
"name":"Tax",
"inside_rate":0,
"outside_rate":0,
"applies_to_delivery_fee":true
},
{
"id":1618,
"name":"Brink",
"inside_rate":0,
"outside_rate":0,
"applies_to_delivery_fee":false
}
]
}
}
}
| Attribute | Type | Example Value | Description |
|---|---|---|---|
venue |
Venue resource | Venue resource - see Select a Store for Dine-in or Takeout for more details | |
venues.[i].venue.areas |
array[Area] | See Areas reference | |
venues.[i].venue.areas.type_id |
int | 4 |
Type ID of Area - see Areas reference |
venues.[i].venue.areas.singular_point_id |
int | db2f3288-63f4-4939-81f6-d0351bce9c70 |
Singular Point ID, which will be used for placing the order |
venues.[i].venue.areas.state |
int | 1 |
Current status of Area - refer to States reference |
venues.[i].venue.areas.order_types |
array[OrderType] | Array of OrderTypes that are configured for that Area | |
venues.[i].venue.areas.order_types.[i].type_id |
int | 4 |
Type of Order Types - see Order Types reference |
venues.[i].venue.timezone.name |
string | "America/Los_Angeles" |
Name of timezone for pickup time conversions - see Timezone resource for more details |
venues.[i].venue.areas.order_types.tables |
array[Table] | Array of Table entities, each entity represents a singular point | |
venues.[i].venue.areas[j].order_types.tables[k].singular_point.id |
string | "26b40c8d-2dcb-42d0-9f20-a5f2ee49ffe1 " |
Singular point id associated with the table. This number is later sent to the order create to identify the table for the full service |
venues.[i].venue.areas[j].order_types.tables[k].singular_point.input.name |
string | "1" |
Table number that can be input or selected by the customer |
The venues.[i].venue.areas[j].order_types.tables is a collection of objects, representing the tables being served. For each table there is an input.name and a singular_point.id uuid identifying the table. The customers select their table by name and the correcpondent uuid should later be sent in order create request.
Calculate
With every modification to the cart (e.g as the customer is adding, modifying or deleting products) a call to /orders/calculate should be made, in order to calculate the order totals for presentation to the customer:
Request
| Attribute | Type | Example Value | Description |
|---|---|---|---|
singular_point_id |
string | "db2f3288-63f4-4939-81f6-d0351bce9c7"0 |
Singular Point ID from /venues/{venue_uuid} call |
order_type.id |
id | 1 |
Type ID of order type for which order should be placed - see Order Types reference |
menu_items |
array[MenuItem] | Array of Menu Items that are included in the cart | |
menu_items.id |
string | "833c2e35-5066-4b1c-a813-fe5cb349a6aa"", |
Menu Item UUID |
menu_items.quantity |
int | 1 |
Number of the same Menu Items with same price level and modifiers that are in cart |
menu_items.price_level_id |
string | "76efaa5d-b849-4549-9468-72b8131b904a"", |
UUID of Price Level of Menu Item that customer chose |
calculate_accurate_tax |
bool | false |
Defines whether external tax engine (such as POS system) should be used to calculate accurate taxes, or whether a prediction should be returned - should be set to true when proceeding to checkout and be false while the customer is still composing their cart. |
{
"method": "post",
"url": "https://api-public-playground.menu.app/api/orders/calculate",
"headers": {
"X-Request-ID": "69da3547-204b-4093-a225-54e084c24215",
"Application": "f3a90488ffee32c3acb6fcd0ca417cf6",
"Api-Version": 4.38.0,
"Content-Type": "application/json"
},
"body": {
"singular_point_id": "db2f3288-63f4-4939-81f6-d0351bce9c70",
"order_type": {
"id": 1
},
"menu_items": [
{
"id": "833c2e35-5066-4b1c-a813-fe5cb349a6aa",
"quantity": 1,
"price_level_id": "76efaa5d-b849-4549-9468-72b8131b904a"
}
],
"calculate_accurate_tax": false
}
}
Response
{
"status": "OK",
"code": 200,
"data": {
"calculations": {
"calculation_method": "exclusive",
"subtotal": 1200,
"discount": 0,
"subsidy": 0,
"service_charge": 0,
"service_charge_rate": 0,
"service_charge_tax_rate": 0,
"delivery_fee": 0,
"delivery_fee_tax": 0,
"delivery_fee_tax_rate": 0,
"minimum_surcharge": 0,
"minimum_surcharge_tax": 0,
"tip": 0,
"tip_rate": 0,
"total": 1260,
"amount_for_payment": 1260,
"tax": 60,
"tax_exemption": 0,
"tax_rates": {
"5": 60
},
"items": [
{
"id": "833c2e35-5066-4b1c-a813-fe5cb349a6aa",
"type_id": 1,
"price": 1200,
"quantity": 1,
"subtotal": 1200,
"discount": 0,
"total": 1260,
"tax": 60,
"tax_exemption": 0,
"tax_rate": 5,
"tax_rates": {
"5": 60
},
"modifiers": []
}
],
"customer_account_id": null
}
}
}
| Attribute | Type | Example Value | Description |
|---|---|---|---|
calculations.calculation_method |
string | "exclusive" |
Whether the tax is included in the product prices ("inclusive") or taxes are not included in product prices and need to be calculated on top ("exclusive") |
calculations.subtotal |
int | 1200 |
Order subtotal (lowest unit), excluding discounts, taxes and fees |
calculations.total |
int | 1260 |
All-in payable total (lowest unit) of the order, including discounts, taxes and fees |
calculations.tax |
int | 60 |
Total tax amount (lowest unit) of the order - depending on calculation_method is included in subtotal or not |
calculations.tax_rates |
object | {"5": 60} |
Tax amount (lowest unit) by tax percentage - depending on your region / country, a tax breakdown may be required to be shown to your customer |
calculations.items.[i].price |
int | 1200 |
Price (lowest unit) of single unit of Menu Item (excl. modifiers) |
calculations.items.[i].subtotal |
int | 1200 |
Price (lowest unit) of Menu Item based on provided quantity (excl. modifiers) |
calculations.items.[i].total |
int | 2520 |
All-in total (lowest unit) of Menu Item, including discounts, taxes and modifiers |
Calculating Accurate Tax
Prior to proceeding to checkout, you should make another call to /orders/calculate with the calculate_accurate_tax flag set to true. This will ensure you have the most accurate taxes calculated (by tax engine, such as from POS) before payment.
Only request accurate taxes when the customer proceeds to checkout, since API fees may apply (depending on tax engine). Implementations with excessive requests for accurate taxes will not be certified and cannot be promoted to production.
Cross-Selling
Cross-selling enables you to show your customer other items they may be interested in, based on the current cart that they have already configured.
Cross-selling is based on pre-configured cross-sell items and applies an algorithm that automatically excludes cross-sell items of subcategories of which items are already in cart, as well as optimizes for the highest possible variety in cross-sell items. A maximum of 5 cross-sell items are returned.
See here to learn more about how to configure cross-sell items in the Management Center.
Using the /venues/{venue_uuid}/menus/{menu_uuid}/cross-sellings API endpoint you can post the menu items that you already have in cart and receive cross-sell item suggestions:
Request
| Attribute | Type | Example Value | Description |
|---|---|---|---|
order_type.id |
int | 1 |
Type ID of Order Type for which order is being placed - only items that are available for the specified order type will be returned. See Order Types reference for more information |
order_type.pickup_asap |
bool | true |
Whether order is being placed for ASAP or not |
menu_item_ids |
array[string] | ["833c2e35-5066-4b1c-a813-fe5cb349a6aa"] |
Array of Menu Item UUIDs that are already included in the customer's cart |
{
"method": "post",
"url": "https://api-public-playground.menu.app/api/venues/a9d6d0c8-1689-4114-b1ec-6da9c33f0384/menus/899129db-5b88-4c95-8fe2-972e6faec523/cross-sellings",
"headers": {
"X-Request-ID": "69da3547-204b-4093-a225-54e084c24215",
"Application": "f3a90488ffee32c3acb6fcd0ca417cf6",
"Api-Version": 4.38.0,
"Content-Type": "application/json"
},
"body": {
"order_type": {
"id": 1,
"pickup_asap": true
},
"menu_item_ids" : [
"833c2e35-5066-4b1c-a813-fe5cb349a6aa"
]
}
}
Response
{
"status": "OK",
"code": 200,
"data": {
"cross_selling_items": [
{
"id": "dd8fdcd6-d1c0-41ee-8b59-ffb9ccbb7d3d",
"name": "Moringa Bowl",
"description": "Mango, Spinach, Banana, Moringa, Fresh Pineapple",
"internal_name": "",
"printer_id": 0,
"position": 1,
"tax_id": "56f60144-370d-4233-8e61-aee9d5471a3b",
"image": {
"thumbnail_small": "https://s3.eu-central-1.amazonaws.com/api.playground/images/item_images/_thumbs280/2023-07-25/76626b232c1aa12512d5bb15bbade9c3.png",
"thumbnail_medium": "https://s3.eu-central-1.amazonaws.com/api.playground/images/item_images/_thumbs720/2023-07-25/76626b232c1aa12512d5bb15bbade9c3.png",
"fullsize": "https://s3.eu-central-1.amazonaws.com/api.playground/images/item_images/2023-07-25/76626b232c1aa12512d5bb15bbade9c3.png"
},
"translations": {
"name": "Moringa Bowl",
"description": "Mango, Spinach, Banana, Moringa, Fresh Pineapple"
},
"allow_takeout": true,
"is_deliverable": true,
"is_dine_in_allowed": true,
"is_foodspot_allowed": true,
"is_self_serving": false,
"show_in_menu": true,
"state": 1,
"is_visible": true,
"is_visible_in_cms": true,
"is_visible_in_store_group": true,
"is_in_combo": true,
"temporary_disabled_until": null,
"allergens": [],
"food_type": {
"id": "vegetarian",
"translated_name": "Vegetarian"
},
"price_levels": [
{
"id": "b235b704-84d0-4d03-bb7c-acd51c994902",
"name": null,
"price": 750,
"delivery_price": 750,
"price_configuration_2": 750,
"price_configuration_3": 750,
"price_configuration_4": 750,
"price_configuration_5": 750,
"price_configuration_6": 750,
"price_configuration_7": 750,
"pos_id": "",
"state": 1,
"calories": 195,
"is_visible": true,
"translations": {
"name": "",
"description": ""
}
}
],
"modifier_groups": [
{
"id": "b0fb219e-4f72-44f1-b277-7feed29025c5",
"name": "Rice or Salad",
"internal_name": "",
"min_selected": 1,
"max_selected": 1,
"pos_min_selected": 0,
"pos_max_selected": 99,
"pos_id": "",
"pos_name": "",
"state": 1,
"is_visible": true,
"is_visible_in_store_group": true,
"is_visible_in_cms": true,
"type_id": 1,
"reference_type": "CoreGlobalModifierGroup",
"position": 0,
"translations": {
"name": "Rice or Salad"
},
"modifiers": [
{
"id": "31d03cb4-5002-43b1-8951-aaa1824d29d5",
"type_id": 1,
"reference_type": "CoreSimpleModifier",
"name": "No Edamame",
"internal_name": "",
"price": 0,
"delivery_price": 0,
"price_configuration_2": 0,
"price_configuration_3": 0,
"price_configuration_4": 0,
"price_configuration_5": 0,
"price_configuration_6": 0,
"price_configuration_7": 0,
"pos_id": "",
"pos_name": "",
"state": 1,
"is_visible": true,
"is_visible_in_store_group": true,
"is_visible_in_cms": true,
"temporary_disabled_until": null,
"calories": 25,
"allergens": [],
"image": {
"thumbnail_small": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/_thumbs280/2023-07-25/ab3b413f2058c9b639a9ad9da1e704b4.png",
"thumbnail_medium": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/_thumbs720/2023-07-25/ab3b413f2058c9b639a9ad9da1e704b4.png",
"fullsize": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/2023-07-25/ab3b413f2058c9b639a9ad9da1e704b4.png"
},
"translations": {
"name": "No Edamame"
},
"channel_visibility": [
"menu"
],
"position": 7,
"is_preselected": false
},
{
"id": "c49b3847-2d3f-4975-a690-fc9c8bc69091",
"type_id": 1,
"reference_type": "CoreSimpleModifier",
"name": "No Radish",
"internal_name": "",
"price": 0,
"delivery_price": 0,
"price_configuration_2": 0,
"price_configuration_3": 0,
"price_configuration_4": 0,
"price_configuration_5": 0,
"price_configuration_6": 0,
"price_configuration_7": 0,
"pos_id": "",
"pos_name": "",
"state": 1,
"is_visible": true,
"is_visible_in_store_group": true,
"is_visible_in_cms": true,
"temporary_disabled_until": null,
"calories": 40,
"allergens": [],
"image": {
"thumbnail_small": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/_thumbs280/2023-07-25/e18337ced14ced22e6ef4380aa89c104.png",
"thumbnail_medium": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/_thumbs720/2023-07-25/e18337ced14ced22e6ef4380aa89c104.png",
"fullsize": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/2023-07-25/e18337ced14ced22e6ef4380aa89c104.png"
},
"translations": {
"name": "No Radish"
},
"channel_visibility": [
"menu"
],
"position": 2,
"is_preselected": false
},
{
"id": "cb5c5146-de36-4586-bde7-b8a92903989c",
"type_id": 1,
"reference_type": "CoreSimpleModifier",
"name": "Organic Wild Rice",
"internal_name": "",
"price": 0,
"delivery_price": 0,
"price_configuration_2": 0,
"price_configuration_3": 0,
"price_configuration_4": 0,
"price_configuration_5": 0,
"price_configuration_6": 0,
"price_configuration_7": 0,
"pos_id": "",
"pos_name": "",
"state": 1,
"is_visible": true,
"is_visible_in_store_group": true,
"is_visible_in_cms": true,
"temporary_disabled_until": null,
"calories": null,
"allergens": [],
"image": {
"thumbnail_small": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/_thumbs280/2023-07-25/2864934613df10b0f1e97095390f0658.png",
"thumbnail_medium": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/_thumbs720/2023-07-25/2864934613df10b0f1e97095390f0658.png",
"fullsize": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/2023-07-25/2864934613df10b0f1e97095390f0658.png"
},
"translations": {
"name": "Organic Wild Rice"
},
"channel_visibility": [
"menu"
],
"position": 1,
"is_preselected": false
},
{
"id": "cacda3ea-4298-477e-a874-b5f02787152a",
"type_id": 1,
"reference_type": "CoreSimpleModifier",
"name": "Organic Arugula",
"internal_name": "",
"price": 0,
"delivery_price": 0,
"price_configuration_2": 0,
"price_configuration_3": 0,
"price_configuration_4": 0,
"price_configuration_5": 0,
"price_configuration_6": 0,
"price_configuration_7": 0,
"pos_id": "",
"pos_name": "",
"state": 1,
"is_visible": true,
"is_visible_in_store_group": true,
"is_visible_in_cms": true,
"temporary_disabled_until": null,
"calories": 25,
"allergens": [],
"image": {
"thumbnail_small": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/_thumbs280/2023-07-25/6ae112b7b131b991a1baf811b6e5647c.png",
"thumbnail_medium": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/_thumbs720/2023-07-25/6ae112b7b131b991a1baf811b6e5647c.png",
"fullsize": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/2023-07-25/6ae112b7b131b991a1baf811b6e5647c.png"
},
"translations": {
"name": "Organic Arugula"
},
"channel_visibility": [
"menu"
],
"position": 4,
"is_preselected": false
},
{
"id": "90e41b01-40a1-407e-b6eb-eebdcf5af12a",
"type_id": 1,
"reference_type": "CoreSimpleModifier",
"name": "Organic Baby Spinach",
"internal_name": "",
"price": 0,
"delivery_price": 0,
"price_configuration_2": 0,
"price_configuration_3": 0,
"price_configuration_4": 0,
"price_configuration_5": 0,
"price_configuration_6": 0,
"price_configuration_7": 0,
"pos_id": "",
"pos_name": "",
"state": 1,
"is_visible": true,
"is_visible_in_store_group": true,
"is_visible_in_cms": true,
"temporary_disabled_until": null,
"calories": 25,
"allergens": [],
"image": {
"thumbnail_small": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/_thumbs280/2023-07-25/86a15cb93d53a56b819d214e79e42cdd.png",
"thumbnail_medium": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/_thumbs720/2023-07-25/86a15cb93d53a56b819d214e79e42cdd.png",
"fullsize": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/2023-07-25/86a15cb93d53a56b819d214e79e42cdd.png"
},
"translations": {
"name": "Organic Baby Spinach"
},
"channel_visibility": [
"menu"
],
"position": 3,
"is_preselected": false
},
{
"id": "ff5f69ca-1137-4924-b7d7-b4f15ecf55aa",
"type_id": 1,
"reference_type": "CoreSimpleModifier",
"name": "Warm Organic Quinoa",
"internal_name": "",
"price": 0,
"delivery_price": 0,
"price_configuration_2": 0,
"price_configuration_3": 0,
"price_configuration_4": 0,
"price_configuration_5": 0,
"price_configuration_6": 0,
"price_configuration_7": 0,
"pos_id": "",
"pos_name": "",
"state": 1,
"is_visible": true,
"is_visible_in_store_group": true,
"is_visible_in_cms": true,
"temporary_disabled_until": null,
"calories": 120,
"allergens": [],
"image": {
"thumbnail_small": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/_thumbs280/2023-07-25/9216c8cc0281856facd22db16373fd3a.png",
"thumbnail_medium": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/_thumbs720/2023-07-25/9216c8cc0281856facd22db16373fd3a.png",
"fullsize": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/2023-07-25/9216c8cc0281856facd22db16373fd3a.png"
},
"translations": {
"name": "Warm Organic Quinoa"
},
"channel_visibility": [
"menu"
],
"position": 6,
"is_preselected": false
},
{
"id": "6da050d5-4f58-4abc-9b6a-65209f3780e2",
"type_id": 1,
"reference_type": "CoreSimpleModifier",
"name": "Organic Mesclun",
"internal_name": "",
"price": 0,
"delivery_price": 0,
"price_configuration_2": 0,
"price_configuration_3": 0,
"price_configuration_4": 0,
"price_configuration_5": 0,
"price_configuration_6": 0,
"price_configuration_7": 0,
"pos_id": "",
"pos_name": "",
"state": 1,
"is_visible": true,
"is_visible_in_store_group": true,
"is_visible_in_cms": true,
"temporary_disabled_until": null,
"calories": 20,
"allergens": [],
"image": {
"thumbnail_small": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/_thumbs280/2023-07-25/595c9060cbaaa2d88bfdd628edcdb30e.png",
"thumbnail_medium": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/_thumbs720/2023-07-25/595c9060cbaaa2d88bfdd628edcdb30e.png",
"fullsize": "https://s3.eu-central-1.amazonaws.com/api.playground/images/modifier_images/2023-07-25/595c9060cbaaa2d88bfdd628edcdb30e.png"
},
"translations": {
"name": "Organic Mesclun"
},
"channel_visibility": [
"menu"
],
"position": 5,
"is_preselected": false
}
],
"channel_visibility": [
"menu"
]
}
],
"required_modifier_group_ids": [],
"channel_visibility": [
"menu"
]
}
]
}
}
| Attribute | Type | Example Value | Description |
|---|---|---|---|
cross_selling_items.id |
string | "dd8fdcd6-d1c0-41ee-8b59-ffb9ccbb7d3d" |
Menu Item UUID |
cross_selling_items.name |
string | "Moringa Bowl" |
Name of Menu Item (in brand's default language) |
cross_selling_items.translations.name |
string | "Moringa Bowl" |
Name of Menu Item (to be presented to customer) - based on language provided in Content-Language header |
cross_selling_items.description |
string | "Mango, Spinach, Banana, Moringa, Fresh Pineapple" |
Description of Menu Item (in brand's default language) |
cross_selling_items.translations.description |
string | "Mango, Spinach, Banana, Moringa, Fresh Pineapple" |
Description of Menu Item (to be presented to customer) - based on language provided in Content-Language header |
cross_selling_items.price_levels |
array[PriceLevel] | Array of Price Levels for the Menu Item - see Menu Concepts for more information | |
cross_selling_items.modifier_groups |
array[ModifierGroup] | Array of Modifier Groups for the Menu Item - see Menu Concepts for more information |
After any modification to the cart (including adding one of the cross-sell items), a new call should be made to /venues/{venue_uuid}/menus/{menu_uuid}/cross-sellings to refresh the cross-sell item suggestions.
Initialize Payment
Once all the items, modifiers and combos have been selected by the customer, and they are ready to check out, the Payment Flow is initiated.
for the signed-in customers, the storing of the payment methods is available. See Store Payment Methods guide for more details.
To perform the payment, follow the Make a Payment guide.
The Payment implementation is different depending on the Payment Processor that is being used by the brand. See the PAR Pay guide to implement the PAR Pay Payment Processor
Place Order
Once payment initialization has been completed by the customer, you can proceed with posting the order to /orders:
Request
| Attribute | Type | Example Value | Description |
|---|---|---|---|
singular_point_id |
string | "db2f3288-63f4-4939-81f6-d0351bce9c70" |
Singular Point ID specific to the table. (See Get Singular Point ID) for more details) |
order_type.id |
int | 1 |
Type ID of Order Type for which order should be placed - see Order Types reference |
order_type.pickup_asap |
bool | true |
Whether order is being placed for ASAP (as soon as possible). For Full-Service orders the orders are always ASAP. |
order_type.pickup_at |
string | "2023-08-06 23:20:00" |
Specific pickup time selected / specified by customer |
order_type.menu_items.[i].id |
string | "833c2e35-5066-4b1c-a813-fe5cb349a6aa" |
Menu Item UUID |
order_type.menu_items.[i].quantity |
int | 2 |
Number of Menu Item with same price level and modifiers ordered |
order_type.menu_items.[i].price_level_id |
string | "76efaa5d-b849-4549-9468-72b8131b904a" |
UUID of Price Level of Menu Item that was selected by the customer |
order_type.customer_info.email |
string | "jane.doe@partech.com" |
Customer's e-mail address (to send order confirmation e-mail to) |
order_type.customer_info.first_name |
string | "Jane" |
Customer's first name (useful for identification at pickup) |
order_type.customer_info.last_name |
string | "Doe" |
Customer's last name (useful for identification at pickup) |
order_type.customer_info.phone_number |
string | "+112345566" |
Customer's phone number - shown to store in order to contact customer in case of issues |
order_type.payment_info.payment_init_hash |
string | "6d930b1593304c87f1092001ceb29ae2" |
Payment initialization identifier, representing payment for the order |
{
"method": "post",
"url": "https://api-public-playground.menu.app/api/orders",
"headers": {
"X-Request-ID": "69da3547-204b-4093-a225-54e084c24215",
"Application": "f3a90488ffee32c3acb6fcd0ca417cf6",
"Api-Version": 4.38.0,
"Content-Type": "application/json"
},
"body": {
"singular_point_id": "db2f3288-63f4-4939-81f6-d0351bce9c70",
"order_type": {
"id": 6,
"pickup_asap": true,
"pickup_at": "2023-08-06 23:20:00"
},
"menu_items": [
{
"id": "833c2e35-5066-4b1c-a813-fe5cb349a6aa",
"quantity": 2,
"price_level_id": "76efaa5d-b849-4549-9468-72b8131b904a"
}
],
"customer_info": {
"email": "jane.doe@partech.com",
"first_name": "Jane",
"last_name": "Doe",
"phone_number": "+112345566"
},
"payment_info": {
"payment_init_hash": "6d930b1593304c87f1092001ceb29ae2"
}
}
}