Get Menu Items
post
/config/sim/v1/menuitems/getMenuItems
Gets all the Menu Items configured
Request
Supported Media Types
- application/json
- multipart/form-data
Request body
Root Schema : MenuItemsGetRequestBody
Type:
Show Source
object
-
include:
string
Example:
locations
-
includeAll:
string
This can take 2 values: basic or detailed. If 'basic' is specified, The response contains all the properties of the object except
Ext values. If 'detailed' is specified, The response contains all the properties of the object. Example:detailed
-
languages:
string
If specified, limits translated strings returned.Example:
en-US, de-DE, es-MX
-
limit:
integer
Number of results returned in this page. Not required if paging parameters are not supported.Example:
10
-
offset:
integer
Starting resource record index. Not required if paging parameters are not supportedExample:
2
-
orderBy:
string
Sorts the response by the specified field name and sort order.Example:
objectNum
-
searchCriteria:
string
Search criteria to filter results based on field valueExample:
where equals(active,1)
Response
Supported Media Types
- application/json
200 Response
A collection of Menu Items in organization.
Root Schema : MenuItemv1GetResponse
Type:
Show Source
object
-
count:
integer
Current response record count.Example:
9
-
hasMore:
boolean
Flag indicating if there are more objects to fetch.Example:
true
-
items:
array items
Array of Menu Item objects of the organization.
-
limit:
integer
Server page sizeExample:
10
-
offset:
integer
Starting resource record indexExample:
0
-
totalResults:
integer
Total number of rows (excluding the paging parameters)Example:
100
Nested Schema : items
Type:
array
Array of Menu Item objects of the organization.
Show Source
-
Array of:
object MenuItemv1
Model for an Integrated Menu Item Object
Nested Schema : MenuItemv1
Type:
object
Model for an Integrated Menu Item Object
Show Source
-
definitions:
array definitions
Array of definitions of the menu item master
-
dietaryLabels:
array dietaryLabels
An array of dietary labels for menu item
-
familyGroupName:
object familyGroupName
Family Group Name
-
familyGroupObjectNum:
integer
Object number of the family groupExample:
1
-
hierUnitId:
integer
Unique reference of the hierarchy unitExample:
1
-
hierUnitName:
object hierUnitName
Hier Unit Name
-
hierUnitObjNum:
integer
Object Number of the hierarchy unit
-
majorGroupName:
A group of string objects representing the name of the major group in the configured languages.
-
majorGroupObjectNum:
integer
Object Number of the major group.Example:
1
-
masterGroupName:
A group of string objects representing the name of master group in the configured languages.
-
masterGroupObjectNum:
integer
Object number of the master group.Example:
1
-
miMasterOptions:
string
A string of 0s & 1s of length 8 representing the enablement or disablement of the options associated with the menu item master. If not specified, this will represent the default options associated with the menu item masterExample:
00000000
-
miMasterOptionsExt:
object MenuItem_miMasterOptionsExt
-
name:
object name
Name
-
objectNum:
integer
Object Number of the menu item master.Example:
1
-
reportGroupName:
A group of string objects representing the name of the report group in the configured languages.
-
reportGroupObjectNum:
integer
Object number of the report groupExample:
1
Nested Schema : familyGroupName
Type:
object
Family Group Name
Example:
{
"en-US":"Coffee",
"de-DE":"Kaffee",
"es-MX":"Cafe"
}
Nested Schema : hierUnitName
Type:
object
Hier Unit Name
Example:
{
"en-US":"Coffee",
"de-DE":"Kaffee",
"es-MX":"Cafe"
}
Nested Schema : MenuItem_miMasterOptionsExt
Type:
Show Source
object
-
core:
boolean
Selecting the core option designates the menu item as a core item, ensuring it is always available for sale and cannot be disabled using effectivity groups. When this option is chosen, the effectivity group selection grid is disabled, and any previously selected effectivity groups are disregarded during the sales process. miMasterOptions Option Bit = 4Example:
false
-
disabled:
boolean
Selecting the 'disabled' option deactivates the menu item for transactions and renders it unavailable for sale. Choosing this option takes precedence over other selections, such as the core menu item option and effectivity groups assigned to the master. miMasterOptions Option Bit = 5Example:
false
-
disableEditByWSEditMenuItem:
boolean
A flag indicating to prevent the menu item from appearing or being edited by OPS Function, Edit Menu Item. This prevents configuration changes to all definitions of the item. This option does not affect configuration of Menu Item Availability. miMasterOptions Option Bit = 2Example:
false
-
nonRevenue:
boolean
Select to enforce non-revenue menu items. Non-revenue menu items do not add value to the sales reports, but add value to the guest check. miMasterOptions Option Bit = 3Example:
false
Nested Schema : name
Type:
object
Name
Example:
{
"en-US":"Coffee",
"de-DE":"Kaffee",
"es-MX":"Cafe"
}
Nested Schema : MenuItem_definitions
Type:
Show Source
object
-
allergenClassName:
object allergenClassName
Allergen Class Name
-
components:
array components
An array of components associated with the menu item
-
consumerAdvisoryDesc:
string
The consumer advisory description of the menu itemExample:
Menu Item 1
-
consumerItemDescription:
object consumerItemDescription
Consumer Item Description
-
consumerItemName:
object consumerItemName
Consumer Item Name
-
customMenuLevels:
array customMenuLevels
An array of custom menu levels associated with the menu item. It contains as many child attributes depending upon the custom levels configured
-
dataExtensions:
array dataExtensions
An array of data extensions for the menu item
-
defaultCondiments:
array defaultCondiments
An array of Default Condiment of a Menu Item
-
defSequenceNum:
integer
Indicates the definition sequence number, which is the number of the definition in the revenue center for this master record.Sequence Number should be with 1-64Example:
1
-
firstName:
object firstName
First Name
-
guestCount:
integer
Guest count for the menu item to increment the check guest count when added.Example:
1
-
images:
array images
An array of images associated with the menu item
-
kdsPrepTime:
integer
The number of minutes necessary to prepare this itemExample:
10.3
-
longDescriptor:
object longDescriptor
Long Descriptor
-
mainLevel:
string
A string value of 0s & 1s of lenth 8 representing Main Levels on which the definition is active.Example:
11001111
-
mainLevelExt:
object MenuItem_mainLevelExt
An object containing the descriptive options list associated with the Main level
- menuItemClassName: object menuItemClassName
- menuItemClassObjNum: integer
- menuItemType: string
-
nluGroupObjNum:
integer
Object number of the NLU Group associated with this menu itemExample:
1
-
nluNum:
Unique NLU number for this menu item (up to 12 digits).Example:
1
-
nutrients:
array nutrients
An array of nutrients of the menu item
-
overrideAllergenClassObjNum:
integer
Object number of the Allergen Class for the menu item definition to override its menu item class settingExample:
1
-
overridePrintClassObjNum:
integer
Object number of the Print ClassExample:
1
-
prefixLevelOverride:
integer
Select to allow the condiment prefix to override the price level of the item it modifies.Example:
1
-
prices:
array prices
Array of prices associated with the menu item definition
-
printClassName:
object printClassName
Print Class Name
-
productionItems:
array productionItems
An array of production items associated with the menu item
-
quantity:
integer
Quantity of a Menu ItemExample:
1
-
secondName:
object secondName
Second Name
-
slu:
array slu
Array of SLU keys and names to which the Menu Item Definition belongs
-
sluSortPriority:
integer
Use this field when Page Design Layout optionExample:
0
-
subLevel:
string
A string value of 0s & 1s of lenth 8 representing Sub Levels on which the definition is activeExample:
11001111
-
subLevelExt:
object MenuItem_subLevelExt
An object containing the descriptive options list associated with the Sub Level
-
surcharge:
integer
Surcharge for the menu itemExample:
1
-
tags:
array tags
An array of tags associated with the menu item
-
tareWeight:
integer
Weight of the empty package for an item sold by weightExample:
1.23
-
thirdName:
object thirdName
Third Name
Nested Schema : allergenClassName
Type:
object
Allergen Class Name
Example:
{
"en-US":"Coffee",
"de-DE":"Kaffee",
"es-MX":"Cafe"
}
Nested Schema : components
Type:
array
An array of components associated with the menu item
Show Source
Nested Schema : consumerItemDescription
Type:
object
Consumer Item Description
Example:
{
"en-US":"Coffee",
"de-DE":"Kaffee",
"es-MX":"Cafe"
}
Nested Schema : consumerItemName
Type:
object
Consumer Item Name
Example:
{
"en-US":"Coffee",
"de-DE":"Kaffee",
"es-MX":"Cafe"
}
Nested Schema : customMenuLevels
Type:
array
An array of custom menu levels associated with the menu item. It contains as many child attributes depending upon the custom levels configured
Show Source
Nested Schema : dataExtensions
Type:
array
An array of data extensions for the menu item
Show Source
Nested Schema : defaultCondiments
Type:
array
An array of Default Condiment of a Menu Item
Show Source
Nested Schema : firstName
Type:
object
First Name
Example:
{
"en-US":"Coffee",
"de-DE":"Kaffee",
"es-MX":"Cafe"
}
Nested Schema : longDescriptor
Type:
object
Long Descriptor
Example:
{
"en-US":"Coffee",
"de-DE":"Kaffee",
"es-MX":"Cafe"
}
Nested Schema : MenuItem_mainLevelExt
Type:
object
An object containing the descriptive options list associated with the Main level
Show Source
-
mainLevel1:
boolean
Flag indicating if the menu item is active on Main Level 1Example:
false
-
mainLevel2:
boolean
Flag indicating if the menu item is active on Main Level 2Example:
false
-
mainLevel3:
boolean
Flag indicating if the menu item is active on Main Level 3Example:
false
-
mainLevel4:
boolean
Flag indicating if the menu item is active on Main Level 4Example:
false
-
mainLevel5:
boolean
Flag indicating if the menu item is active on Main Level 5Example:
false
-
mainLevel6:
boolean
Flag indicating if the menu item is active on Main Level 6Example:
false
-
mainLevel7:
boolean
Flag indicating if the menu item is active on Main Level 7Example:
false
-
mainLevel8:
boolean
Flag indicating if the menu item is active on Main Level 8Example:
false
Nested Schema : prices
Type:
array
Array of prices associated with the menu item definition
Show Source
Nested Schema : printClassName
Type:
object
Print Class Name
Example:
{
"en-US":"Coffee",
"de-DE":"Kaffee",
"es-MX":"Cafe"
}
Nested Schema : productionItems
Type:
array
An array of production items associated with the menu item
Show Source
Nested Schema : secondName
Type:
object
Second Name
Example:
{
"en-US":"Coffee",
"de-DE":"Kaffee",
"es-MX":"Cafe"
}
Nested Schema : slu
Type:
array
Array of SLU keys and names to which the Menu Item Definition belongs
Show Source
Nested Schema : MenuItem_subLevelExt
Type:
object
An object containing the descriptive options list associated with the Sub Level
Show Source
-
subLevel1:
boolean
Flag indicating if the menu item is active on Sub Level 1Example:
false
-
subLevel2:
boolean
Flag indicating if the menu item is active on Sub Level 2Example:
false
-
subLevel3:
boolean
Flag indicating if the menu item is active on Sub Level 3Example:
false
-
subLevel4:
boolean
Flag indicating if the menu item is active on Sub Level 4Example:
false
-
subLevel5:
boolean
Flag indicating if the menu item is active on Sub Level 5Example:
false
-
subLevel6:
boolean
Flag indicating if the menu item is active on Sub Level 6Example:
false
-
subLevel7:
boolean
Flag indicating if the menu item is active on Sub Level 7Example:
false
-
subLevel8:
boolean
Flag indicating if the menu item is active on Sub Level 8Example:
false
Nested Schema : thirdName
Type:
object
Third Name
Example:
{
"en-US":"Coffee",
"de-DE":"Kaffee",
"es-MX":"Cafe"
}
Nested Schema : MenuItem_components
Type:
Show Source
object
-
componentName:
integer
A group of string objects representing the name of component object in configured languagesExample:
1
-
componentObjNum:
integer
Object number of the componentExample:
1
Nested Schema : MenuItem_customMenuLevels
Type:
Show Source
object
-
activeOnAllLevels:
boolean
Flag indicating if the menu item is active on all levelsExample:
false
-
customLevel:
string
Flag indicating if the menu item is active on Custom LevelExample:
11001111
-
customLevelExt:
object MenuItem_customLevelExt
Flag indicating if the menu item is active on Custom Level
- menuLevelObjNum: integer
Nested Schema : MenuItem_customLevelExt
Type:
object
Flag indicating if the menu item is active on Custom Level
Show Source
-
subLevel1:
boolean
Flag indicating if the menu item is active on Custom LevelExample:
false
Nested Schema : MenuItem_dataExtensions
Type:
Show Source
object
-
columnName:
string
Name of the extention fieldExample:
extension column 1
-
value:
string
Value of the extention fieldExample:
value 1
Nested Schema : MenuItem_defaultCondiments
Type:
Show Source
object
-
condimentSetName:
object condimentSetName
A group of string objects representing the name of Condiment Set in configured languages. This value is excluded by default in GET response.
-
condimentSetObjNum:
integer
Object number of the condiment setExample:
1
- menuItemDefaultCondimentId: integer
-
optionExt:
object MenuItem_optionExt
An object containing the descriptive options list associated with the default condiments of the menu item. This value is excluded by default in GET response.
-
options:
string
A string value of 0s & 1s of length 8 representing the enablement or disablement of the options associated with the default condiments of the menu item. This value is excluded by default in GET response.Example:
1000000
-
sortGroup:
integer
Sort group of the condiment setExample:
1
Nested Schema : condimentSetName
Type:
object
A group of string objects representing the name of Condiment Set in configured languages. This value is excluded by default in GET response.
Example:
{
"en-US":"Coffee",
"de-DE":"Kaffee",
"es-MX":"Cafe"
}
Nested Schema : MenuItem_optionExt
Type:
object
An object containing the descriptive options list associated with the default condiments of the menu item. This value is excluded by default in GET response.
Show Source
-
chargeForEntireSalesCount:
boolean
Flag to charge customers for the condiment count. Deselect to charge only when the item count exceeds the default count. This is set by default for an Enhanced Prefix Mode Menu Item.Example:
false
-
displayWhenInDefaultState:
boolean
Flag to show the default condiment. Set to false to prevent condiments from appearing in the check detail, sending to KDS and Order Device printers, and printing on the customer receipt/guest check, even if the print class is set to print to KDS and Order Device printers.Example:
false
Nested Schema : MenuItem_images
Type:
Show Source
object
-
altText:
string
The image alternative text of the menu itemExample:
pizza
-
description:
string
The description text of the menu itemExample:
pizza description
-
imageIndex:
integer
Image Number for referenceExample:
1
-
isCloudImage:
boolean
Flag indicating if the image is stored on the CloudExample:
true
-
size:
string
The size of the imageExample:
1
-
url:
string
The URL of the image of the menu itemExample:
https://oracleObjectStore.com/images/coffee822815.jpg
Nested Schema : MenuItem_nutrients
Type:
Show Source
object
-
nutrientSetName:
object nutrientSetName
Nutrient Set Name
-
nutrientSetObjNum:
integer
Object number of the nutrient setExample:
1
Nested Schema : nutrientSetName
Type:
object
Nutrient Set Name
Example:
{
"en-US":"Coffee",
"de-DE":"Kaffee",
"es-MX":"Cafe"
}
Nested Schema : MenuItem_prices
Type:
Show Source
object
-
activeOnMenuLevel:
integer
Level in which each price becomes active.Example:
1
-
effectivityGroupName:
object effectivityGroupName
Effectivity Group Name
-
effectivityGroupObjNum:
integer
The effectivity group, if any, that determines when a price is activeExample:
1
-
options:
string
A string value of 0s & 1s of length 8 representing the enablement or disablement of the options associated with the Menu Item PriceExample:
10000100
-
optionsExt:
object MenuItem_optionsExt
An object containing the descriptive options list associated with the Menu Items Price
-
parentTaxClassOverrideName:
object parentTaxClassOverrideName
Parent Tax Class Override Name
-
parentTaxClassOverrideObjNum:
integer
Object number of the parent tax class to use for the price recordExample:
1
-
prepCost:
integer
Prep cost amount for menu items in the price groupExample:
1.23
-
price:
integer
Price of the menu itemExample:
2.34
-
priceSequenceNum:
integer
Unique number of the detailExample:
1
-
serviceChargeGroupName:
object serviceChargeGroupName
Service Charge Group Name
-
serviceChargeGroupObjNum:
integer
Object number of the service charge group associated with the price recordExample:
1
-
taxClassOverrideName:
object taxClassOverrideName
Tax Class Override Name
-
taxClassOverrideObjNum:
integer
Object Number of the Tax Class, if any, to use for each price recordExample:
1
Nested Schema : effectivityGroupName
Type:
object
Effectivity Group Name
Example:
{
"en-US":"Coffee",
"de-DE":"Kaffee",
"es-MX":"Cafe"
}
Nested Schema : MenuItem_optionsExt
Type:
object
An object containing the descriptive options list associated with the Menu Items Price
Show Source
-
priceForFixedPriceMealCourse:
boolean
Flag indicating to use the menu item (bulk purchase) tax class override over the condiment parent tax classExample:
false
-
priceForFixedPriceMealCourseAndRegularMenuItem:
boolean
Flag indicating to exclude the condiment parent item from the menu item (bulk purchase) tax class override countExample:
false
Nested Schema : parentTaxClassOverrideName
Type:
object
Parent Tax Class Override Name
Example:
{
"en-US":"Coffee",
"de-DE":"Kaffee",
"es-MX":"Cafe"
}
Nested Schema : serviceChargeGroupName
Type:
object
Service Charge Group Name
Example:
{
"en-US":"Coffee",
"de-DE":"Kaffee",
"es-MX":"Cafe"
}
Nested Schema : taxClassOverrideName
Type:
object
Tax Class Override Name
Example:
{
"en-US":"Coffee",
"de-DE":"Kaffee",
"es-MX":"Cafe"
}
Nested Schema : MenuItem_productionItems
Type:
Show Source
object
-
productionItemCount:
integer
The number of portions required to complete the menu item.Example:
1.4
-
productionItemName:
object productionItemName
Production Item Name
-
productionItemObjNum:
integer
Object number of the production itemExample:
false
Nested Schema : productionItemName
Type:
object
Production Item Name
Example:
{
"en-US":"Coffee",
"de-DE":"Kaffee",
"es-MX":"Cafe"
}
Nested Schema : MenuItem_slu
Type:
Show Source
object
-
sluName:
object sluName
SLU Name
-
sluObjNum:
integer
Object number of the SLU key to which the Menu Item Definition belongsExample:
1
-
sluSeqNum:
integer
SLU sequence to which the Menu Item Definition belongs. This value ranges between 1-8Example:
1
Nested Schema : sluName
Type:
object
SLU Name
Example:
{
"en-US":"Coffee",
"de-DE":"Kaffee",
"es-MX":"Cafe"
}
Nested Schema : MenuItem_dietaryLabels
Type:
Show Source
object
-
dietaryLabelName:
string
Name of the dietary labelExample:
Dietary Label 1
-
dietaryLabelsObjNum:
integer
Object number of the dietary labelExample:
1