TRAY® Product Release Notes
Version: Combined 7.02
Key HighlightsClient Enhancements
Server (HQ) Enhancements
Web, Data & TRAY API Enhancements
|
Client Enhancements (POS & KDS)
POS
Change Behavior of RefundCheck Permission to be a Must Have Permission
STR-2993
Description
We have changed the behavior of the RefundCheck permission to be a 'Must Have' permission. Going forward, if no roles at the site have the “RefundCheck” permission, initiating the 'Refund' button will prompt the user with an error message that states: Could Not Authorize - Missing Permission RefundCheck:
Given that this permission is a 'Must Have' permission, if no users have this permission assigned, it will allow all of the roles at the site to initiate the 'Refund' action.
POS Sales Summary Report - Enhancements
STR-9509
Description
Going forward, the printed POS Sales Summary Report will now include a section at the top of the printed report that will display the break down of net sales by revenue, aligning with the printed POS Server Checkout Report. The 'Net Sales By Revenue Center' will show the 'Service' Type broken down, total net sales, gross sales and total revenue breakdowns, as shown below:
POS Server Checkout Report Enhancements
STR-9507
Description
We have made several enhancements to the printed POS Server Checkout Report, including:
- Splitting of the 'No Sales' section across Trading Day Times (TDT) if the staff has a shift that crosses multiple days
- The Printed Server Checkout Report will account for a two day max shift; if a staff member has been clocked in for >2 consecutive days, then the Server Checkout Report will print data to include only the current and previous trading days
- Conditional rendering is required for fields like Tip Pool, GiftCard Cash Out, Added Gratuity and Cash Drop; we will only be displaying these fields when there is applicable data to present
- We will be including a Refunds section, as shown below:
Customizable Service Selection Button Size
Description
Previously, the Service Selection Screen on the POS had fixed button sizes. To improve usability and flexibility across locations, we have introduced a configuration option that allows button size adjustments based on business needs.
Additionally, we will implement a dynamic search functionality to improve service selection efficiency. A new search box has been added to the top bar of the Service Selection Screen, enabling staff to quickly locate services. As the user types, the service list will be filtered in real-time, ensuring a faster and more streamlined selection process:
Configuration Details:
- Button Sizes : This will be part of POS setting JSON
- Config Name : ServiceButtonSize
- Small (4x)
- Medium(3x)
- Large(2x) [Default Configuration]
Mandatory & Optional Check Name Prompt
STR-9915
Description
Users can now configure whether entering a check name is mandatory or optional during different stages of the order process. To configure this prompt, we have added more options in the dropdown under the 'Services' Tab (HQ > Revenue Centers > Services > Edit Service> Ask for Check Name). The new options will allow businesses to configure whether entering a check name is mandatory or optional at different stages of the order process.
Currently, the “Ask for Check Name” feature has options to prompt staff at the start of the check or at the time of payment, but staff are also able to skip the prompt to enter a check name. To enforce consistency and allow more flexibility for locations who wish to opt out, we will update the options within the Services tab with the following:
- At Start of Check (Optional) → Staff can enter a check name but can skip it.
- At Start of Check (Mandatory) → Staff must enter a check name before proceeding.
- At the Time of Payment (Optional) → Staff can enter a check name but can skip it before completing payment.
- At the Time of Payment (Mandatory) → Staff must enter a check name before processing payment.
Restrict Transfers for Tax-Exempt Checks
STR-9864
Description
The new transfer UI currently does not enforce conditions for transferring items between tax-exempt and non-tax-exempt checks. To ensure accurate tax handling and compliance, the following restrictions need to be implemented:
- Going forward, the system will allow transfers only between checks with the same tax status (both tax-exempt or both non-tax-exempt).
- The system will restrict transfers between checks with differing tax statuses (tax-exempt to non-tax-exempt and vice versa).
This update will ensure consistency in tax calculations and prevent unintended mismatches between checks.
Countdown Warning Dialogue Updates
ENT-5245
Description
We have made enhancements to the warning dialogue that displays when an item has an active countdown implemented and the user attempts to order a quantity that exceeds the available remaining items. Going forward, when the user attempts to fire any item quantity greater than the number of items available, they will see an updated error message that is more accurate:
This will allow the user to re-enter a smaller quantity, if desired, and will allow for a more accurate idea of the remaining quantity of items available for future ordering purposes.
POS Manager Section Assignment
STR-9772
Description
Going forward, when sections are created in HQ, Admin users will be able to assign sections directly from the POS.
From the Section UI on the POS (POS > Manager Functions > Sections), Admin users will be able to view any active sections, listed alphabetically. Next to each section will be a selection option that will display a drop-down list of eligible staff, based on the corresponding HQ configuration of eligible sections. Please note, if a section is inactive, or does not have any assigned destinations, it will not be listed.
From this screen, Admin users can then assign eligible staff to sections with the ability to assign a single staff member to more than one section at a time. Checks cannot be started from an outside source if the corresponding TRAY destination within that section does not have an assigned staff. Once assignment is complete, the Admin user will hit 'Confirm', effectively updating any staff assignments to the respective section. Please note - this functionality will not be supported in Offline Mode.
Similarly, we will track the details of all of the POS Section Assignments, as well as any of the changes across existing assignments, on the TRAY HQ POS Activity Report.
Pre-Authorization Support in Split Payment Flow
STR-9739
Description
Pre-authorization functionality is now supported within the new Split Payment UI while using FreedomPay. Going forward, should the user need to pre-auth a split payment (i.e. split by two guests, pay for guest 1) and FreedomPay is enabled, the user will be able to effectively pre-auth the split payment amount (i.e. 50% of the total payment) for both guests on the same check.
POS Transfer UI Enhancements
STR-9273
Description
We have introduced a new item and check transfer UI to streamline the transfer process across the POS, as shown below:
Going forward, when a user with appropriate permissions (outlined below) can select from the following Item Transfer Options:
- Start New Check - this will transfer the item(s) to a new check; the user will be brought to a new check screen with that item in the cart
- Other Check - this will transfer the item(s) to an existing check; the user will be prompted with a list of existing checks to select from
- Other Guest - this will transfer the item(s) to a different guest than they are currently assigned to; the user will be prompted with a list of other guests on the existing check to transfer the item to
Similarly, the user will be able to select from the following Check Transfer Options:
- Other Staff - this will transfer the check selected to another staff member; should the site be using timekeeping, the list of staff available will be limited to staff who are clocked in
- Other Service - this will transfer the check to another service (please note, the list of services displayed will not include the current service assigned to the check)
- Other Destination - this will transfer the check to an alternate destination available within the check’s designated service
Permission | Definition |
TransferGuestItems | Permission to transfer items to a new guest |
TransferCheckItems | Permission to transfer items to a new check |
OtherChecks | Permission to transfer items to an existing check |
TransferCheckOwner | Permission to transfer a check to a new owner |
TransferAllStaff | This permission should not be configured at the site for clients using the timekeeping feature, ensuring that when a site is using time keeping, they can only transfer checks to users who are clocked in. |
TransferCheckService | Permission to transfer a check to a new service |
TransferCheckDestination | Permission to transfer a check to a new destination |
Similarly, the TRAY HQ Reports will now accurately reflect the correct transfer logging across all transfer permissions listed above, including the correct assignment of the 'transfer from' and 'transfer to' staff details, for more accurate reporting purposes.
Please note - the new Transfer UI will be controlled by a Global Feature Flag and can be enabled per client request.
KDS
Remove Auto-Offline Android Health Check
INFRAP-7394
Description
The native Android internet health check is not required to accurately reflect online/offline device status so we will be removing and reverting to the heartbeat check to the TRAY Server, as it is effectively serving the same purpose.
Server Enhancements (HQ, API, DataAPI, Web)
HQ
Expanded Enterprise Service Template Push
ENT-2173
Description
We have added a 'Push Service Templates' button at the top right of the Service Templates UI (TRAY HQ > Revenue Centers > Service Template > Next to 'Add Service Template' Button on Top Right) that will now allow Enterprise users to push a Service Template from the Node and select up to 1500 sites at once. Similarly, the user could choose to perform a Node > Node Push and select multiple nodes, should they have access. The Service Template push will adhere to the following parameters:
- Once a push is performed, all the fields related to a service template are to be pushed.
- Once a push is performed, all the fields except: New, Accepted and Completed related to a service template are to be pushed
- The Select service template drop-down will have an “All“ option to select/deselect all the listed service templates at once as shown in Image 3.
- The push will support the ability to push a minimum of 50 templates to at least 1500 locations at once within 10 seconds
Once, the user clicks on the Apply button after selecting the list of templates to be pushed to the respective stores, a pop-up notifying Push has started should be presented to the user with a link to HQ Activity where the information is being logged.
The TRAY HQ activity will show the information of starting (Service template Push has started) and ending time (Service template push has ended) (within a new category - Push_ServiceTemplate) along with the time elapsed for the completion of this activity as shown below:
A See Details link will show more information in the case of both a successful and unsuccessful push for all the service templates:
POS Sales Summary Report - Date Selector
STR-7176
Description
We have reintroduced the ability to select the desired date when printing the POS Sales Summary Report. Going forward, the user will be able to select any date up to the current date and print the associated POS Sales Summary Report from their device for the date selected.
Product & Modifier Group Dropdown UI Alphabetization
ENT-4192
Description
Going forward, all product, product modifier and modifier group drop downs will be listed alphabetically for a more navigable user experience. We will also now show the PLU/EID of the respective item instead of the less relevant Database ID for all product, product modifiers and modifiers. This alphabetization will extend to modifier group contents, product modifier assignments, dependent products, the menu product push and any other relevant dropdown list view.
Labor Reports Sorted by Employee Last Name
STR-8867
Description
Going forward, we will be updating the sorting logic across relevant TRAY HQ Labor Reports to now sort by employee last name. To give the most flexibility for sorting purposes, we will now:
- Split the Staff Name into two columns with Last Name and First Name in that order
- Sort the relevant HQ Labor Reports (Time Card Report, Breaks Report, Staff Summary Report) by Last Name, First Name and Role (all ascending)
- All the relevant exports (CSV, PDF or Excel) will similarly adopt the new format with columns and sorting
HQ Activity for Reason Tracking
ENT-4767
Description
We have enhanced the HQ Activity Report to now track any created or deleted 'Reasons' at the site level within the newly added 'See Details' link, as previously we only supported tracking for Node level reason creation and deletion logging.
HQ Terms & Services Acknowledgement
INFRAP-6996
Description
We have added the 'Terms & Services' link to the bottom of the TRAY HQ Login page that will now point the user to the detailed overview of the TRAY Terms and Services that the user is agreeing to when logging into TRAY HQ.
Pricing Export
ENT-5274
Description
This enhancement to the pricing export utility will be able to export all pricing from all selected sites underneath a specific Node or Sub-Node. The utility will also be able to export pricing just for specific items if needed, in order to easily view, and modify prices by altering the export and reimporting it.
Going forward, a user with applicable permissions (outlined below) will be able to select items from the 'Products' List UI (Main Page) > Select 'Export Pricing' and the relevant items should be exported at the Node or Sub-Node.
Permissions
- Import Pricing - Site/Node level permission to use Import Pricing and Export Pricing buttons
- Export Pricing - Site/Node level permission to use Import Pricing and Export Pricing buttons
The HQ Activity will log a similar information similar to what we do for the pricing import.
Menu UI Enhancements - Filtering & Sorting Options
ENT-5273
Description
As we make continued enhancements across the TRAY HQ Menu UI, we have implemented the following changes:
Under the Menu Tab, we have created two additional sub-tabs: Products on the left and Menus on the right of the screen:
We have introduced six columns within the product listing table:
- Status
- Image
- Product Name (KDS Name)
- PLU (DB ID)
- Category
- Price
Users with applicable permissions (Edit Product, Edit Price) can change the price of any product by selecting the price hyperlink which will then bring up a separate 'Edit Price' dialog:
Similarly, users with applicable permissions (Edit Visibility) can change the visibility of any product by simply clicking on the hyperlink text from within this updated UI:
There will be a few filtering and sorting options that will allow for a streamlined user experience when the user needs to search or filter the product list accordingly:
- Status
- Type
- Category
- Sort
- Name/PLU
With the action buttons to:
- Filter (apply filter)
- Reset (reset filter)
Permissions
- Edit Product - the ability to edit/change a product/modifier in hQ
- Edit Price - the ability to edit a product/modifier price in HQ
- Edit Visibility - the ability to edit a product/modifier visibility status in HQ
Adjust Tip Credit Overtime Wage Calculation Logic
STR-10061
Description
The current tip credit overtime calculation logic is as follows:
- (Minimum Wage * Overtime Rate) - Max Tip Credit
We have updated the logic to accommodate a dynamic tip credit calculation, and going forward will be using the following logic:
- (Minimum Wage * Overtime Rate) - Dynamic Tip Credit
Example 1 Overtime Wage Calculation Logic :
- Min Wage: 7.25
- Max Tip Credit: 5.12
- Configured Wage: 2.13
- Current: (7.25*1.5) - 5.12 = 5.755
- Expected: (7.25*1.5) - 5.12 = 5.755
Example 2 Overtime Wage Calculation Logic :
- Example:
- Min Wage: 7.25
- Max Tip Credit: 5.12
- Configured Wage: 3.00
- Current: (7.25*1.5) - 5.12 = 5.75
- Expected: (7.25*1.5) - 4.25 = 6.625
HQ Server Checkout Report 'Tenders' Calculation to Include Tax
STR-10134
Description
Previously, the TRAY Server Checkout Reports (both POS and HQ) displayed a 'Net' payment amount calculation for tenders. To alleviate confusion around this datapoint calculation, the new printed POS Server Checkout Report and the TRAY HQ Server Checkout Report will have corrected logic that will be calculated using the following: base + tax + tip = total for each tender type.
Hold For Cook Time - ASAP & Scheduled
INFRAP-7227
Description
When orders are fired from any source (i.e. POS, handheld, kiosk, Web, third party) and the 'Hold Items Based on Cook Time' configuration setting (Site Settings → Operations → Kitchen Operations) is enabled, then the same logic should be followed in all cases and orders should fire dynamically based on their configured cook time within TRAY HQ → Products/Modifiers.
Monthly HQ Daily Sales Report
STR-9932
Description
We have added the ability for HQ Report Users to be able to run the TRAY HQ Daily Sales Report (DSR) for up to one month for one site. The filter options will allow for the following date selections:
- Custom Date (Individual date picker)
- Custom Range (Date Selector - Max 35 Days)
- Today
- Yesterday
- This Week
- Last Week
- Week Starting From
- This Month
- Last Month
- Month Starting From (Based on Calendar Date)
TRAY HQ Daily Sales Report & Financial Management Tender Type Ordering
STR-9903
Description
Going forward, we will be presenting the Tender Type data breakdown within the TRAY HQ Daily Sales Report (DSR) and the TRAY HQ Financial Management Report in the following order:
- Credit Card
- Gift Card
- Other
- Cash
- OLO Tenders
Venue Level Tax Configuration
ENT-5311
Description
To alleviate the pain point of having to manually adjust tax inclusivity or tax exclusivity status across products individually, especially when using the 'Bulk Add' functionality for products, we will now support the ability for a user to determine the venue-level tax configuration (i.e. tax inclusive or tax exclusive) across categories.
Tax Behavior Settings:
- Tax Exclusive (Default Setting)
- Tax Inclusive
Global Flag to Disable Modifier Group Price Overrides/PLU's
ENT-5310
Description
We have implemented a Global Flag to disable Modifier Group Price Overrides/PLU's for each site or node selected.
If this flag is enabled for a particular site or node, then:
- The custom PLU and price for the modifier linked to a particular modifier group will be overwritten and replace the existing base modifier value during a product or menu push.
- By default, the flag will be enabled for all sites.
- If the flag is disabled for a particular site or node, then:
- The custom PLU and price for the modifier linked to the mod group will not be overwritten over the base modifier during a product or menu push.
Site Creation Wizard Restrictions
ENT-5031
Description
Going forward, when a using the Site Creation Wizard functionality within TRAY HQ, a user will only be able to access Nodes and create sites within Nodes that they have access to.
Non-Admin Site Creation
ENT-5029
Description
Going forward, when a user creates a new site or copies an existing site(s), those sites will be automatically to the users profile if they are a non-Admin user.
Subsection Image Support
STR-9474
Description
This enhancement introduces the ability to add images to subsections within the POS Menu UI, providing a more visually appealing and organized menu display. By enabling subsection images, clients can better categorize and highlight subsection content, allowing for more streamlined and interactive menu engagement.
Enterprise Reason Code Push Enhancement
ENT-5006
Description
Previously, there was a system restriction that restricted users with the relevant push permissions from pushing reason codes to 2000 stores simultaneously. Going forward, the TRAY HQ Enterprise Reason Code Push will support the following:
- Push all the fields for the reason codes to the destination site(s).
- The Select Reason Code drop-down will have an “All“ option to select/deselect all the listed reason codes at once
- Support the ability to do execute a Reason Code Push of a minimum of 50 reason codes to at least 1500 locations simultaneously
Once, the user clicks on the Apply button after selecting the list of reason codes to be pushed to the respective stores, a pop-up notifying Push has started should be presented to the user with a link to HQ Activity where the information is being logged.
HQ activity will show the information related to the start (Reason Code push has started) and end time (Reason code push has ended) (within a new category - Push_ReasonCode) along with the time elapsed for the completion of this activity as shown below:
A 'See Details' link will show more information in the below format in case of both a successful and unsuccessful push for all the reason codes:
Category 'Select' Option for Products
ENT-4961
Description
Previously, when a new product was created, a category was automatically assigned to the product which did not always lead to the correct category assignment. Going forward, when creating a new product within the product dialog, the 'Select' Option will now be the default category assignment so that the user will have to manually select a category to save the product.
Should the user not select a category, they will be prompted with the following error, 'Please assign a category', when trying to save:
Once a category is selected and saved, the ‘Select' option will no longer be available in the drop-down (i.e. existing products with category assignments will not see the 'select' option within the product UI).
Tooltips for Menu & Pricing UI
ENT-4947
Description
Going forward, when the Modifier Group Price Overrides/PLU's' flag is disabled, an info (i) icon will now appear beside both the 'Price' and 'PLU' fields for a modifier within a modifier group which says:
- Price Field: Custom price will not be applied. The base price of the modifier will be used since the 'Modifier Group Price Overrides/PLU’s' flag is disabled."
- PLU Field: Custom PLU will not be applied. The base PLU of the modifier will be used since the 'Modifier Group Price Overrides/PLU’s' flag is disabled."
API
Enhancements to Employees API
INFRAP-7126
Description
As part of the continued enhancements to the Employees API, we have implemented the following changes:
- Publishing - After an employee is added or updated via the API, TRAY should automatically publish the changes to the POS. This will allow staff to be able to immediately log into the POS after being added by an integrator.
- Required EIDs - TRAY will use the EID to assign the correct ID. The following fields have been changed to accept the relevant EID in the request:
- Jobs
- Pay classes
- Revenue Centers
- Printer Assignment - When creating a new staff through the API, all receipt printers will be automatically assigned to the staff being created
- Unsetting a value for an employee - In order to support the ability to 'unset' a value, the request will send the value as null.
- For example, if I want to remove the termination date from a staff, I would send the following:
-
terminationDate: null
-
- For example, if I want to remove the termination date from a staff, I would send the following:
- Values to be updated - When sending the request to update a value for a staff, the request should only contain the fields that the integrator wants to update.
- For example, if I want to just update first name, I would sent the following:
-
{ “firstName”: “Daniel”}
-
- For example, if I want to just update first name, I would sent the following:
New Taxation for Pricing API
INFRAP-7253
Description
Previously, the pricing API used for Olo was looking at the old taxation calculation to determine if a product is taxable or non-taxable. Going forward, we have updated the pricing api to look for new taxation calculations in order to calculate the isTaxable field instead of the outdated category-level taxes.
DataAPI
Add EID to v1/payClasses
INFRAP-7125
Description
We have added the EID to the pay classes endpoint in the Data API in order to support the Add employee API.
{noformat}"payClasses": [
{
"id": 0,
"name": "string",
"getwage": 0,
"getoverTimeWage": 0,
"status": "string"
"eid": 0
}
]{noformat}
Original Time Entry Details in timeClockAudits API
INFRAP-7032
Description
Previously with time clock audits, we were only returning the original time entry data if that value (time in, time out, tips, etc) had been changed. Given that certain third party integrators do not store historical data, they were not able to use the timeClockAudit endpoint without the complete original time entry data.
Due to these limitations, we have updated the original time entry data for all values to be returned for time clock audit records.
Going forward, when returning time clock audits, the following fields will return the values that match the original time entry.
- originalTimeIn
- originalTimeOut
- originalTips
- originalJob
- originalRate
[
{
"originalShift": {
"breaks": [
],
"timeOut": "2024-12-17 11:07:00 UTC",
"job": 3479,
"tips": 16.0,
"timeIn": "2024-12-17 09:06:00 UTC",
},
"newShift": {
"breaks": [
{
"timeOut": "2024-12-17 09:10:00 UTC",
"timeIn": "2024-12-17 09:15:00 UTC",
"breakType": "Unpaid",
"breakOutId": 3
}
],
"timeOut": "2024-12-17 11:09:00 UTC",
"job": 3479,
"tips": 16.0,
"timeIn": "2024-12-17 09:07:00 UTC",
},
"employeeId": 1925,
"auditDate": "2024-12-18 16:05:47 UTC",
"id": 1,
"hqUserId": 212,
"timeEntryId": 1
}
]
Web
Currency Support for Web Ordering
INFRAP-6162
Description
Going forward, we will support the ability to set the currency of a venue to SAR and for this currency to reflect accordingly across the TRAY Web Ordering platform as SR. This will similarly reflect at both the item and the modifier level as well as on the POS cart UI.
Optimization
- Optimize HQ Activity Report
- Optimize HQ Financial Management Report - Guest and Checks Count
Bugs
HQ
HQ Activity Product Un-Assignment Logging
ENT-4071
Description
Previously, when a product was removed from a menu, it was logged as 'Product has been deleted' in the HQ Activity Report. We have updated this to now reflect the accurate details of the product un-assignment, as shown below:
Item Tax Discrepancy of 0.01
STR-10091
Description
As part of this fix, we have addressed a tax discrepancy of 0.01 per item quantity. This affects users during transactions involving guest transfers, check transfers, staff transfers, discounts, etc. Going forward, the system will accurately calculate and apply taxes without discrepancies for each item quantity.
DataAPI
7Shift Syncing Staff & Shifts
INFRAP-7255
This fix address two 7Shifts issues related to syncing staff and syncing shifts:
- Instances where the system took inactive employees in TRAY and created them as active employees in 7Shifts.
- Instances where moving a shift from one staff to another staff effectively deleted the original shift and created a new shift in 7Shifts, while still displaying the original shift as active in the TRAY Database.
KDS
Fix Receipt Printing Issue on Confirmation Payment Screen
STR-9639
The POS system's confirmation payment screen features a dialogue box asking users if they want a receipt, with options to 'Print' or 'No Thanks'. However, previously when the 'Print' button was selected, no receipt was being generated. The issue was occurring when the local printer was used with third-party receipts disabled, preventing receipt printing. Going forward, selecting the 'Print' button will function correctly when the printer is assigned to staff and third-party receipts are enabled.
Remove Erroneous Remote Printing Error Messages
STR-9296
Description
Printing any report from a hjandheld device (or devices using remote print functionality) previously displayed two individual toast messages:
- ”Printer Error”
- ”No Local Printers - Printing Remotely”
However, in these cases, the print command was successfully sent to a printer so we have since updated the toast message to indicate the accurate remote printer selected (i.e. “Printing from POS 4 Printer”).
Note, when no printer is selected, the user will still continue see the following error message: “Cannot print - No printer selected” to indicate that a printer selection needs to be indicated.
Comments
0 comments
Article is closed for comments.