¶¶Òõ

Skip to main content

3.9.0

2024-10-17 | 3.9.63-2 ¶¶ÒõKitchen Management

The information provided below includes the user experience, process workflow, and infrastructure improvements and updates for this production version of ¶¶ÒõKitchen Management (XKM) API and UI.

Refer to Change Ticket CHANGE-10794 when speaking with a ¶¶ÒõTeam Member about this release.

Supplemental Information

This release is not dependent on another release.

Improvements

XKM-8599

Technical Improvement

Improved internal process to address application pause/resume events that interrupt file transfers and result in infinite spinner/throbber incidents.

2024-09-18 | 3.9.63-1 ¶¶ÒõKitchen Management

The information provided below includes the user experience, process workflow, and infrastructure improvements and updates for this production version of ¶¶ÒõKitchen Management (XKM) API and UI.

Refer to Change Tickets: CHANGE-10028, CHANGE-10062, CHANGE-10102, CHANGE-10026, CHANGE-10136, CHANGE-10145, CHANGE-10158, CHANGE-10179, CHANGE-10182, CHANGE-10208, CHANGE-10239, CHANGE-10256, CHANGE-10302, CHANGE-10306, CHANGE-10378, CHANGE-10390, and CHANGE-10430 when speaking with a ¶¶ÒõTeam Member about this release.

Supplemental Information

This release is not dependent on another release.

Improvements

XKM-7124

Ingredient Summary Pane

Ingredients are now cleared from the Ingredient Summary Pane on all related upstream displays when an order is bumped.

Prior to this update, the Ingredient Summary Pane was not entirely cleared on kitchen screens where the Ingredients Filters is set to Any Screen.

XKM-7615

Order Sorting

When XKM is upgraded to a new version, orders that were entered on the previous version are sorted on the kitchen displays as expected.

XKM-8057, XKM-8414, XKM-8419, XKM-8420, XKM-8421, XKM-8422, XKM-8440

Consolidate Like Items

Configure the application to consolidate like order items on receipts and labels regardless of how the items are consolidated on the kitchen screens.

For configuration information, see the Identical Items Print Method area of the Ordering Application → Printing section of Company/Site Preferences.

This update includes the following:

  • Consume order item attributes from XPOS that are required for like item consolidation. These attributes are: Always Print in Red, Segment ID, Item Discount Name, Item Discount Amount, and Unit Price.

  • New print template fields added for Item Label and Bump Chit. These fields are: Alternate Kitchen Name, Item Discount, Unit Price and Product ID.

    For configuration information, see Identical Items Print Method in the Options and Sorts section of the Receipt Templates editor.

  • Internal improvements to support template content tags.

  • Internal improvements to support consolidation for print on bump.

  • Internal improvements to support consolidation for item level bumps.

  • Internal database improvements to support Consolidate Like Items feature.

XKM-8073, XKM-8459, XKM-8460

Receipt Templates

Configure the preferred sorting method for different order item types on receipt templates.

Receipt Template Settings

The Options and Sorts page of the Receipt Templates editor now includes a new Sorting section.

From the Sorting section, select the preferred sorting method for Parent Items, Child Items, and Modifiers.

The available sorting methods include: Display Priority, and As Added.

The new Sorting section is now available for the following receipt types: Bump Chit, Final Receipt, Guest Check, Receipt, Refund, TSR Receipt, and Waste.

XKM-8205, XKM-8455, XKM-8456

Sort Order for Kitchen Screens and Receipts

XKM consumes new Item Sort Order configuration from XDM providing the ability for:

  • Kitchen Screens to display Item Priority in ascending or descending order—default displays item priority in ascending order.

  • Receipts to print order items in a specific order. Eligible receipt types: Bump Chit, Item Label, Customer Receipt (Final Receipt, Receipt, TSR Receipt).

For kitchen screen configurations, see Company Preferences for Ordering, Site Preferences for Ordering, and Item Priority for Cells in Kitchen Screen Settings.

For receipt configurations, see Receipt Templates.

XKM-8227

Recall Order

With this update, recalled orders with a negative timer value are able to be bumped from the kitchen display.

XKM-8273

Separate child items from their parent

XKM has the ability to display all child items as separate from their parent or solely based on specific child item tags.

See the Cell Body section of Kitchen Screen Cell Settings, for configuration information.

XKM-8283

Order Ready Screen

With this update, if there is not enough space on the Orders Ready column to display an order in its entirety, the order is not displayed.

The order is displayed once there is enough space to display it in its entirety.

XKM-8294

Prep Instructions

This update allows the system administrator to enable / disable the preparation instructions that appear when the user long presses an order item on the kitchen display.

Company/Site Preferences

This feature is configurable at the company and site level.

The following setting is located on the Ordering Application → Kitchen Settings section of the Company/Site Preferences editors.

  • Display Preparation instructions - Toggle Yes to display Preparation Instructions when the user long presses an order item on the kitchen display.

    Toggle No to NOT display Preparation Instructions when the user long presses an order item on the kitchen display.

Kitchen Screen Setting

Configure this feature for individual kitchen screens.

The following setting is located on the General → Screen Layout section of the Kitchen Screen Settings editor.

  • Display Preparation Instructions - From the dropdown, select the preferred option.

XKM-8295

Indent Modifiers / Child Items

Optionally indent child items / modifiers beneath their respective parent item on kitchen tickets to make it easier for users to identify child items / modifiers.

Kitchen Screen Settings

The following setting is located in the Cell Body section of the Cells page of the Kitchen Screen Settings editor:

  • Show Indentation For Modifiers/Child Items - Toggle to the preferred setting:

    • Toggle Yes to indent modifiers/child items beneath their parent item within the cell.

      Up to three (3) indentation levels are supported.

    • Toggle No to NOT indent modifiers/child items and vertically align them beneath their parent item.

Important

If the Enable Hierarchy setting is disabled for the kitchen screen (Cell Body section), the Show Indentation For Modifiers/Child Items setting is ignored.

XKM-8297, XKM-8332, XKM-8344, XKM-8345, XKM-8346, XKM-8351, XKM-8353, XKM-8394

Ingredient Portions

This update adds the ability to view ingredient (modifier) portions on a kitchen screen.

Kitchen Screen Setting

The following setting is located on the Cell Body section of the Cells page of the Kitchen Screen Settings editor:

  • Show Portions - Toggle Yes to display ingredient (modifier) portions and their respective measurements with their parent items on the kitchen screen.

    Modifiers appear below their parent item, left-justified, with the portion(s) displayed to the right, right-justified.

XKM-8299, XKM-8377, XKM-8410

Upstream Screens and Item Bump Events

This update adds the ability to suppress the display of items on Upstream Screens until the item is bumped from the previous screen in the flow.

Kitchen Screen Settings

The following setting is located on the Upstream Screens section of the General page of the Kitchen Screen Settings editor:

  • Suppress Item Display - When enabled, an item in an upstream flow is NOT displayed on this screen until the item is bumped (order bump or item bump) from the previous upstream screen(s).

From the Item Events section of the Cells page of the Kitchen Screen Settings editor, identify the events that define the lifecycle of an item on the screen.

This update adds the following Item Lifecycle Event:

  • Item Bump - When selected, items are NOT displayed on the next station until the item is bumped from the previous station.

The Print Item Label On Bump setting is updated to print an item label on Item Bump and Order Bump.

XKM-8317

Upgrade Installation

Technical improvements for internal processes and services.

XKM-8321

XKM API Encryption

This update adds the option to encrypt all XKM data that is sent to the POS via WebSocket channels, and decrypt data that comes from the POS via HTTP.

Encrypting data adds another level of security to prevent unauthorized persons from accessing the data.

¶¶ÒõPortal Company Setting

The Admin Options page of the Companies editor (Admin only) now includes the following toggle:

  • Allow XKM Encryption - Toggle Yes to encrypt all ¶¶ÒõKitchen Management (XKM) data that is sent to the POS.

    Toggle No to NOT encrypt ¶¶ÒõKitchen Management (XKM) data.

XKM-8328

Audible Alerts

When configured, a notification sounds when new orders appear on the screen.

This update ensures an audio alert is played regardless if order items are filtered from the new order.

See Audio Files and Audio Settings, for configuration information.

XKM-8337

Installation

This update includes the following changes:

  • XKM now starts successfully regardless if an inactive printer is configured for one or more screens.

  • If an issue occurs during initialization, XKM now sends log files before clearing the station and redirecting the user to the Shell.

XKM-8342

Kitchen Screens

Recall a bumped item by selecting the item on the recall screen. Use Recall Last to recall the entire last order.

Enabling Auto Recall Bumped Items recalls new or modified items to the screen.

XKM-8347

Kitchen Screens

Orders remain visible when drinks are claimed from a walkup station.

XKM-8352

Technical Improvement

Improved internal bump event process flow.

XKM-8362

Split Orders

XKM respects split orders and the order Total displays Multiple Orders message.

XKM-8385, XKM-8434, XKM-8435, XKM-8437

Item Sorting Rules

Define custom rules for how order items are sorted and prioritized on kitchen screens. The item sorting options include: Display Time and Item Priority.

Kitchen Screen Settings

For configuration instructions, see Item Sorting Rules on the Sorting Rules page of the Kitchen Screen Settings editor.

XKM-8397

Item Lifecycle Events

When Claim and Complete are NOT added as Item Lifecycle Events for a kitchen screen:

  • The Claim indicator is not displayed in the upper-right of the station header.

  • The Claim indicator for items is not reserved on the screen.

  • ‘Making Order’ is not displayed in the footer.

XKM-8428

Upstream Displays

When an order is bumped from a display where bump upstream is not enabled, the order items on displays with upstream relations are flagged with upstream indicators as expected and are NOT bumped.

XKM-8452

Technical Improvement

Technical improvements for internal processes and services.

2024-06-06 | 3.9.19-1 ¶¶ÒõKitchen Management

The information provided below includes the user experience, process workflow, and infrastructure improvements and updates for this production version of ¶¶ÒõKitchen Management (XKM) API and UI.

Supplemental Information

This release is not dependent on another release.

New Features

XKM-7976

Kitchen Printer Routing

XKM is updated to support an array of multiple item label printers for individual kitchen screens. The item labels conform to the print template specified for each printer.

This update ensures that in an environment where multiple kitchen stations display the same screen, the item labels printed at each kitchen station are specific to the items prepared at that station.

This benefits the staff members at each station by printing the appropriate label on item claim or bump, so that the label is ready to be attached to their prepared item as needed.

All printers assigned to a kitchen screen are listed on the Peripheral tab of Station Status.

For more information, see Kitchen Screen Routing to Multiple Printers.

Improvements

XKM-4891

Order Ready Screen

This update enables the user to customize the appearance of the Order Ready screen to suit business needs and preferences.

Data Management Configuration

From the Theme page of the Kitchen Screen Settings editor, configure the appearance of the following:

  • Main Screen

  • Screen Sections

  • Order Tiles

  • Order in Progress

  • Order Ready

XKM-5844

Combined Split Orders

Resolved an issue for XKM environments with the following configuration:

  • Display Combined Orders Method : Fixed

With this update, when two (2) or more split orders are combined at the POS, the order items from the combined orders are combined into one (1) order on the XKM display.

XKM-6694

Split Orders

The following identifies how deleted items appear on kitchen displays if the user splits an order at the POS, and then deletes an order item.

In environments with the following XKM configuration, the deleted item is displayed on the kitchen with the "Deleted" label:

  • Show Deleted Items: Yes

  • Display Split Orders Method: Fixed

If Identical Items Display Method is set to Consolidate Like Items, and a consolidated like item is deleted, the deleted item is separated from its like items and labeled as "Deleted".

In environments with the following XKM configuration, the deleted item is NOT displayed in the kitchen:

  • Show Deleted Items: No

  • Display Split Orders Method: Fixed

XKM-7137

Order Ready Screen

This update ensures that the Order Ready screen components are displayed at the appropriate size with respect to the screen resolution and the screen orientation (i.e. landscape or portrait).

XKM-7265

Split Orders

When an order with like items is split at the POS, the XKM now displays the like item quantities for each split order as expected.

XKM-7442

Kitchen Printing Settings

Implemented a Kitchen Screen Setting that controls the number of bump receipts that are printed when the same kitchen screen is used at multiple stations.

Kitchen Screen Setting

The following setting is located on the Printing page of the Kitchen Screen Settings editor in Data Management.

  • Consolidate Print Jobs - °Õ´Ç²µ²µ±ô±ðÌýYes to print only one (1) receipt when an order/item is bumped from this screen regardless of the number of kitchen stations where this screen is used.

    °Õ´Ç²µ²µ±ô±ðÌýNo to print a duplicate receipt for each kitchen station where this screen is used.

XKM-7510

Hold Timer for Upstream Displays

This update resolves an issue in upstream environments where the Hold Timer for an order was not set when an order was master bumped from the screen that triggers the Hold Timer.

When Show Hold Timer is enabled, the HoldTimerStarted and HoldTimerStopped values for a bumped order now match the BumpTime value of the MasterBump event if the order is bumped from the master screen before it is bumped from the hold timer upstream screens.

The Show Hold Timer setting is set in the Cell Header section of the Cells page of the Kitchen Screen Settings editor in Data Management.

In the event the Hold Timer is NOT started and the bumped order is recalled:

  • The HoldTimerStarted and HoldTimerStopped values for the order are cleared.

  • The HoldTimerStarted value is set when the hold timer begins for the order (i.e. when all order items on the upstream hold screens are bumped from the hold dependent screens).

  • The HoldTimerStopped value is set when the hold timer stops for the order (i.e. when the order is bumped from the screen that triggers the Hold Timer).

  • The values are sent one more time to the POS.

XKM-7616

Timestamp Print Variables

Kitchen timestamp variables are included in bump event print jobs.

This allows for the order start and order ready timestamps to be printed on receipts and chits.

The following order-level variables are now supported on Bump Chit and Item Label print jobs triggered by a kitchen bump event:

  • bump_time - Time when the order is bumped from the current screen.

  • first_arrival_time - Time when the first item included in this bump event’s print job was received by XKM.

  • last_arrival_time - Time when the last item updates occurred.

XKM-7755

Upstream Displays

Resolved an issue for upstream displays in an order session environment with the following configuration:

  • Display Combined Orders Method: Labeled

With this update, if an order is bumped from an upstream display, and then combined with another order on another display, the order items are combined as expected.

XKM-7762

Upstream Displays

The Hold Timer now appears and functions as expected in an environment where upstream indicators are enabled.

XKM-7926

Configuration Refresh

If an issue is encountered when upgrading XKM from the ¶¶ÒõPortal and refreshing the configuration data , the user is automatically redirected to the Shell where XKM can be reinstalled.

XKM-7950

Logging

When upgrading from XKM 3.7 to 3.8, all required logging data is now updated in local storage as expected.

XKM-7986

Receipt Templates

With this update, it is not required to define an Options and Sorts section for a receipt template.

From the Options and Sorts section of the Receipt Templates editor, define optional elements for a print template.

XKM-7991

Combine / Separate Item Quantities

When the quantity of consolidated claimed / completed items is decreased, the remaining order items on the display now respect the Identical Items Display Method setting.

This setting is defined in the Cell Body section of the Cells page of the Kitchen Screen Settings editor.

XKM-8002

Split Orders

This update resolves an issue with child items from a previously bumped order reappearing on the kitchen display after a Split Order operation was performed on the order at the POS.

This issue occurred when a combo meal with a quantity greater than one (1) with multiple identical child items was split or shared between multiple orders.

With this update, the child items from a previously bumped order do not reappear on the kitchen display after a Split Order operation is performed on the order at the POS.

XKM-8004

Split Orders

This update resolves an issue with split order Items and the autobump feature. This issue was encountered in environments with the following XKM configuration:

  • Display Combined Orders Method : Fixed

  • Display Split Orders Method : Fixed

With this update, all order items on the split order are autobumped together as expected. The autobump timer starts after the last update to any item on the displayed order.

XKM-8032

Display Font Size

When the user changes the Font Size for a kitchen display from the XKM popup menu, the font size is now immediately updated. Performing a configuration refresh is not required.

XKM-8035

Change Item Quantity

Resolved an issue that occurred in Order Session environments with the following XKM configuration:

  • Identical Items Display Method : As Received

  • Show Deleted Items : Yes

When the quantity of a combo meal item with multiple child items is reduced at the POS after it is sent to the kitchen, the combo meal item quantity is updated accordingly on the kitchen displays.

The deleted combo meal item is displayed as deleted in the original order session, but it is not displayed in the new order session.

XKM-8041, XKM-8149

Vehicle ID Indicator

The purpose of this update is to notify the drive-thru staff with a kitchen cell header indicator when an order is associated with a vehicle recognized by DTD Vision.

The XKM API is updated to accept the Vehicle ID (Vehicle_ID) included with an order.

Kitchen Screen Configuration

The following setting is available in the Cell Header Settings in the Cells section of the Kitchen Screen SettingsÌý±ð»å¾±³Ù´Ç°ù:

  • Show Vehicle ID - °Õ´Ç²µ²µ±ô±ðÌýYes to display the Vehicle Indicator in the cell header of the order when the associated vehicle is identified by DTD Vision.

    This setting is only available when Show Vehicle Info (located in the same section) is toggled Yes.

In a Header Template configuration, the Vehicle item can now be customized to show the Vehicle ID when the vehicle is identified by DTD Vision.

XKM-8052

Split Orders

When an order is split at the POS, all subsequent modifications made to the order items (including size changes) are now accurately reflected on the XKM displays without unexpectedly duplicating any items.

XKM-8054

Item Quantity

Resolved an issue that occurred in Order Session environments with the following XKM configuration:

  • Identical Items Display Method : As Received

  • Display Split Orders Method : Fixed

This issue occurred when a combo meal with a quantity greater than one (1) with different child items was shared between multiple orders.

With this update, order items from a previously bumped order do not reappear on the kitchen display after a Share Order operation with a fractional quantity is performed on the order at the POS.

XKM-8061

Kitchen Printing

This update adds support for up to six (6) indented levels for parent items, child items, modifiers, bundles, and combos printed on bump chits and item label receipts.

This enables the kitchen staff to more easily determine the order item relationships on the printed chit or label, so that they can prepare and serve the order correctly.

XKM-8076

Device Power Failure

This update addresses the following conditions that were discovered after a kitchen device encountered a power failure. The user was required to sign back in to register the device.

  • Implemented log file duplication.

  • IP validation on Android devices when network not found.

  • Addressed obsolete command execution.

  • Update config refresh time after app reload.

XKM-8084, XKM-8111

DataSync and Vision Updates

This update optimizes DataSync processing of DTD Vision service point updates that XKM receives from the POS.

With this update, there is no degradation in system performance when there are 100+ orders with associated service points in the application database.

Kitchen cells are updated and populated as expected following bump operations, and bump upstream indicators are displayed appropriately following service point updates.

XKM-8087

File Server Updates

Identified the following basic file server errors that may affect XKM performance:

  • Buffer issue caused by a port scanner application.

  • Socket send issue with large file size can potentially disrupt the application loading process.

  • Socket send issue with standard file size indicates high network load or low processor time.

XKM-8097

Kitchen Timestamps

To ensure consistency in Kitchen Timestamp values, the Preparation Start Time (prepStartTime) is now appropriately set on items that are received from the POS on-the-fly.

XKM-8139

DataSync and Vision Updates

This update optimizes DataSync processing of DTD Vision service point updates that XKM receives from the POS.

With this update, there is no extended delay before new orders appear on the kitchen displays when there are 350+ orders with associated service points in the application database.

XKM-8156

Order Retention Timer

Improved order retention to ensure all orders are purged from the database and removed from all kitchen displays after the configured retention time expires.

XKM-8159

Manual Bump

Updated the timer calculation used to govern bump overrides to ensure Open orders cannot be manually bumped ahead of the defined Min Bump Time.

XKM-8168

Bump Upstream - Bump Events

The bump upstream functionality is updated to ensure orders are bumped as expected in an upstream environment that includes three (3) or more upstream monitors.

This update adds the following rules for bump priority:

  • When a bump occurs on a screen that has direct bump upstreams, then this direct dependency is given top priority over any bump behavior type that exists on indirect paths.

  • When a bump occurs on an indirect bump upstream path with a different bump behavior type, then the ENTIRE ORDER is given top priority.

XKM-8191

Order Comments

Improved filtering to ensure order-level comments are not displayed when the associated order is filtered from the screen.

XKM-8195

Comments

Improved filtering to ensure order-level comments are not displayed when the associated order is filtered from the screen by order destination.

This update also ensures that orders that contain both item-level and order-level comments are able to bumped from all displays.

XKM-8207

Kitchen Displays

This update addresses reported incidents at a site where orders were not appearing on the kitchen display and the bump bars were not responding as expected.

This update improves the bump event handling process to resolve the reported display issues.

XKM-8211

Android MINIX Support

With this update, XKM is supported on Google Chrome version 66 (or greater) on Cordova devices.

XKM-8216

Kitchen Displays

This update improves order handling and payload processing to ensure orders received from the POS are displayed on the kitchen displays as expected.

XKM-8245

Bump Events

Improved workflow of bump events to eliminate the delay in orders disappearing from the display upon bump.

XKM-8260

Maintenance Time

If the user attempts to process orders during a site's scheduled Maintenance Time, the user may experience performance issues while the XKM configuration files are updated.

A future update will enable the administrator to define the duration of the maintenance time window. In the event of failure, the user will be notified that maintenance did not run and the user will be provided with the option to manually perform maintenance.