1. Configuration and Content API Guide
  2. Tasks
  3. v2
  4. Devices
  5. Order Devices

Get Order Devices

post

/config/sim/v2/devices/getOrderDevices

Gets all the Order Devices configured

Request

Supported Media Types
Body ()
A request body
Root Schema : OrderDeviceGetRequestBodyv2
Type: object
The input Body model that needs to be given.
Show Source
  • Objects included in response
    Example: hierUnitId
  • 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
  • If specified, limits translated strings returned
    Example: 1,2,3
  • If using paging, number of results returned in this page.
  • Starting resource record index. Not required if paging parameters are not supported
  • Sorts the response by the specified field name and sort order.
    Example: objectNum:asc
  • Search criteria to filter results based on field value
    Example: where equals(objectNum,1)
Back to Top

Response

Supported Media Types

200 Response

A collection of Order Devices objects of the organization
Body ()
Root Schema : OrderDevicesGetResponsev2
Type: object
Show Source
Nested Schema : items
Type: array
Array of Order Devices objects of the organization.
Show Source
Nested Schema : OrderDevicesv2
Type: object
Show Source
  • Object number of the backup order device in the event of a communication failure or other problem.
    Example: 0
  • Specify how condiments will be sorted on the selected order device. The options are:1 - No condiment sorting ??? (Condiments are listed in the order entered by the user) 2 - Sort allowed condiments ??? (Required condiments are not sorted) 3 - Sort all condiments (All condiments are sorted)
    Example: 1
  • instructions (up to 250 characters) for the workstation's script to handle order output based on custom instructions in the script in case of using Custom Print Handling
    Example: Custom Instructions
  • Object number of the relevant order device record.
    Example: 0
  • The remote device to which orders print. For a local device, orders print at the Local Order Receipt printer set for the workstation from which the order is placed. 1 ??? Remote 2 - Local
    Example: 1
  • Unique hierarchy unit value
    Example: 1
  • Hierarchy unit object number
    Example: 1
  • A string value of 0s & 1s of length 48 representing the enablement or disablement of the options associated with the Printer Order Device. Applicable if primaryDeviceType = 0
    Example: 000000000000000000000000000000000000000000000000
  • kdsOptionsExt
  • kdsSettings
  • Object number of the secondary language for the print output. Applicable only if primaryDeviceType = 0
    Example: English
  • Object number of the third language for the print output. Applicable only if primaryDeviceType = 0
    Example: English
  • Object number of the primary language for the order device. Applicable only if primaryDeviceType = 0
    Example: 1
  • The number of lines to advance before printing the order on order chits. Applicable only if primaryDeviceType = 0
    Example: 0
  • The number of lines to advance after printing the order on order chits. Applicable only if primaryDeviceType = 0
    Example: 0
  • the maximum number of lines (0-99) to print on each page of an order chit. Applicable only if primaryDeviceType = 0
    Example: 0
  • the type of menu items to output to the order device. 1 ??? All Items 2 ??? Only Items with Condiments 3 ??? Only items without condiments
    Example: 1
  • name
    A string that contains translations of name
  • Object number of the Order Device
    Example: 1
  • Object number of the order device to which orders sent to this device should be redirected. Typically, this field is set to itself.
    Example: 0
  • The remote device to which orders print. For a local device, orders print at the Local Order Receipt printer set for the workstation from which the order is placed. 1 ??? Remote 2 - Local
    Example: 0
  • Object number of the Primary Distribution Group for the KDS. Applicable only if primaryDeviceType = 1
    Example: 1
  • A string value of 0s & 1s of length 48 representing the enablement or disablement of the options associated with the Printer Order Device. Applicable if primaryDeviceType = 0
    Example: 000000000000000000000000000000000000000000000000
  • printerOptionsExt
  • the sort and consolidation method for the order device 0 ??? Do Not Sort 1 ??? Seat Consolidated 2 ??? Seat No Consolidation 3 ??? Print Group Consolidated 4 ??? Print Group No Consolidation 5 ??? Seat & Print Group Consolidated 6 ??? Seat & Print Group No Consolidation 7 ??? Print Group and Seat Consolidated 8 ??? Print Group and Seat No Consolidation Applicable only if primaryDeviceType = 0
    Example: 0
Nested Schema : kdsOptionsExt
Type: object
Show Source
  • A Boolean flag indicating to have the alert time calculation ignore the menu item prep time.
    Example: false
  • A Boolean flag indicating to display the quantity of every condiment ordered on a non-DOM KDS. This feature is not supported with DOM enabled.
    Example: false
  • A Boolean flag indicating to allow bumping of marked items and orders.
    Example: false
  • A Boolean flag indicating to prevent KDS users from bumping an order by double-clicking it on the display.
    Example: false
  • A Boolean flag indicating to show the menu item count on the KDS Display if using DOM
    Example: false
  • A Boolean flag indicating to make new orders flash when appearing on the KDS Display if not using DOM.
    Example: false
  • A Boolean flag indicating to cause the KDS to display the order subtotal if using DOM. Note that Subtotal is only displayed in certain layouts - 301, 305, 306, 309, 312, 315 , 317, 320, 401 and 402.Subtotal = Menu Item Sales Total + Discount + Tax + Auto Service Charge + Service Charge + Rounding Total
    Example: false
  • A Boolean flag indicating to print identical items separately if they are posted separately. Deselect to consolidate identical items onto one line, preceded by the quantity.
    Example: false
  • A Boolean flag indicating select to remove voided items from the KDS Display. Deselect to show the letter V next to voided items if using DOM.
    Example: false
  • A Boolean flag indicating to consolidate identical items with different modifiers onto one line, preceded by the quantity on the KDS Display. This feature is not supported with DOM or a DOM KDS chit layout style.
    Example: false
  • A Boolean flag indicating to prevent an Expo Station from marking a sub-order as Done when it is marked as Done on another Expo Station.
    Example: false
  • A Boolean flag indicating to show voided chits in front of the original order.
    Example: false
  • A Boolean flag indicating to print condiments in a continuous line on each order chit. Deselect to print each condiment on a separate line beneath the referenced menu item.
    Example: false
  • A Boolean flag indicating to not allow the order to be expedited before the order is paid if using DOM
    Example: false
  • A Boolean flag indicating to prevent an order from being bumped from the order device, until after the order has been paid for if using DOM
    Example: false
  • A Boolean flag indicating to print a check or receipt at the Runner Chit printer when the order is bumped from the Expo.
    Example: false
  • A Boolean flag indicating to print a runner chit when an order is complete at all Prep Stations and before the order is bumped from the KDS Expo Display.
    Example: false
  • A Boolean flag indicating to print a runner chit when the order is marked Done at the Expo Station.
    Example: false
  • A Boolean flag indicating to print a runner chit when the order is marked Done at a Prep Station.
    Example: false
  • A Boolean flag indicating to if enabled, any item voids on the POS will immediately bump the associated item chit on the KDS. This option cannot be used with DOM, and requires Single Item Per Sub Order to be enabled. This option is required to enable Option 33 ??? Hide Void Chit When Item Voided and Option 34 ??? Show Void Chit Even if Item No Longer in Production.
    Example: false
  • A Boolean flag indicating to show an icon on order chits from any course other than the first course to indicate that a previous course exists for this check. This feature only works on systems using KDS Coursing functionality with KDS Controller option Display Next Course after Previous Course Complete.
    Example: false
  • A Boolean flag indicating if enabled, a void chit will show for an item that has been bumped from the KDS prior to being voided on the POS. This option cannot be used with DOM, and requires Single Item Per Sub Order to be enabled. This option requires Option 32 - Remove Original Chit When Item Voided.
    Example: false
  • A Boolean flag indicating to show every item on an order on its own chit.
    Example: false
  • A Boolean flag indicating to sort menu items by their print group. If a print group is not assigned, items print in order of their record number.
    Example: false
  • A Boolean flag indicating to sort items by seat number. Deselect to show items in the order in which they were ordered.
    Example: false
  • A Boolean flag indicating to sort voided items to the top of the screen if not using DOM.
    Example: false
  • A Boolean flag indicating to hide the subtotal and paid amounts on chits when the Display Subtotal option is set.
    Example: false
  • A Boolean flag indicating to unconsolidate multiple quantities of similar menu items if condiments are selected for each item.
    Example: false
  • A Boolean flag indicating to print the order number using a larger and bold font on the top and bottom of runner chits.
    Example: false
Nested Schema : kdsSettings
Type: object
Show Source
Nested Schema : name
Type: object
A string that contains translations of name
Example:
{
    "1":"Property",
    "2":"Eigentum",
    "3":"Propiedad"
}
Nested Schema : printerOptionsExt
Type: object
Show Source
  • A Boolean flag indicating to not send voids of previous round items to the kitchen.
    Example: false
  • A Boolean flag indicating to print the prefix on a separate line above the condiment. Deselect to print the prefix on the same line as the condiment.
    Example: false
  • A Boolean flag indicating to print a flag to denote menu items that are part of a combo meal.
    Example: false
  • A Boolean flag indicating to print menu items in each different language before printing condiments when printing in multiple languages.
    Example: false
  • A Boolean flag indicating to print both names configured for a menu item. Deselect to print one name.
    Example: false
  • A Boolean flag indicating to print guest check information lines after the order device header. Deselect to suppress the printing.
    Example: false
  • A Boolean flag indicating to print guest check information lines after the order device trailer. Deselect to suppress the printing.
    Example: false
  • A Boolean flag indicating to print guest check information lines before the order device header. Deselect to suppress the printing.
    Example: false
  • A Boolean flag indicating to print condiments in red ink or in inverse. Deselect to print condiments in red/inverse or black, depending on the Print Class Red/Black option setting.
    Example: false
  • A Boolean flag indicating to print a dining course header and to group menu items by dining course.
    Example: false
  • A Boolean flag indicating to print a separate order chit for each menu item in the current service round (dopplebon style). Deselect to print one order chit for all menu items in the current service round.
    Example: false
  • A Boolean flag indicating to print an order summary chit before printing an order's dopplebon order chits. Deselect to suppress dopplebon summary chit printing.
    Example: false
  • A Boolean flag indicating to show the revenue center name with each order sent to the order device. Deselect to hide the name.
    Example: false
  • A Boolean flag indicating to print seat numbers with each individual menu item.
    Example: false
  • A Boolean flag indicating to print secondary items being broadcast from other order devices.
    Example: false
  • A Boolean flag indicating to print secondary items in red. Deselect to print secondary items in black.
    Example: false
  • A Boolean flag indicating to send menu items sent to this order printer as secondary items to other order printers.
    Example: false
  • A Boolean flag indicating to print the order using single-width characters.
    Example: false
  • A Boolean flag indicating to print the employee name and number of the transaction operator. Deselect to print the employee name and number of the check operator.
    Example: false
  • A Boolean flag indicating to print a VV VOID VV line, in red or inverse, in front of voided menu items. Deselect to print voided items in red
    Example: false
  • A Boolean flag indicating to suppress printing extra line spacing between secondary items on order chits.
    Example: false

400 Response

400 Bad Request
Body ()
Root Schema : ErrorDetails
Type: object
Response body when the request returns an error.
Show Source
Back to Top