Back Office

The Xenial Back Office delivers operational management and data reporting features, as well as engineering environment that provides simple upgrades and functional modularity.

Xenial Back Office service consist of the following modules:

Staff presents the ability to maintain employee information and manage employee punch records.
Payroll interfaces with Heartland Ovation and enables you to submit and view payroll detailed data and associated audit reports for each payroll period.
Schedule provides the ability to create and manage labor schedules.
Forecast provides data for the Schedule module which is used to populate staff requirements, projected sales and help a scheduling manager the information to make the best decision regarding staffing efforts.
Daybook allows the staff and manager to communicate important messages or entry types in the form of:
- Journal entry – A note about an event or situation that needs to be communicated to the staff.
- Task – A specific piece of work to be done that falls outside of an employee’s typical job responsibilities.
- Approval – A management approval for requested time off or employee unavailability.
Inventory manages inventory item records, perform, inventory transactions, and manage inventory vendor records.
Webhook provides other applications with real-time data.

This document communicates the major new enhancements and updates in the latest release of Xenial Back Office.

The following Xenial components may be impacted by these releases:

Data Management
Portal
Pipeline Service
Enterprise Integration and Onboarding [EIO] Components

2021-03-01 | 3.1 Back Office

The information provided below includes data, functional, configuration, reporting, and infrastructure updates for this production version of Back Office for Staff, Payroll, Schedule, Forecast, Daybook, Inventory, and Webhook.

Supplemental Information

This release is not dependent on another component update.

Version History

Refer to Change Ticket: [CHANGE-3305] when speaking to a Xenial Team Member about these release notes.

Component	Current Version	New Version
Core	3.1.86	3.1.86-18

Improvements

Core	Backend	The Clear Cache lambda only receives notifications from one source, "dm.cart-system-apply," rather than the whole DM update stream.
Core	Backend	Back Office opens and operates as expected for Companies with over 1000 Sites.
Core	Backend	Payroll Detail reports are assigned to the Site at which the relevant work time occurred.
Core	Backend	Infrastructure improvements.
Core	Backend	The Employees module loads the Employee list as expected.

2021-02-24 | 3.2 Back Office

Supplemental Information

This release is not dependent on another component update.

Version History

Refer to Change Ticket: [CHANGE-3287, CHANGE-2819] when speaking to a Xenial Team Member about these release notes.

Component	Current Version	New Version
Webhook	3.2.7	3.2.13-1

Improvements

Webhook	Backend	Infrastructure improvements.
Webhook	Backend	Empty arrays are received from Data Streaming services as expected.
Webhook	Backend	Environment variables have been added to memory caches.
Webhook	Backend	Mapping has been added to properly process Order parameters from Online Ordering.
Webhook	Backend	Support for Donation items has been added to Order transformation.
Webhook	Backend, Process	Schedule update messages are published as expected and processed automatically.
Webhook	Backend	Test coverage reports for Webhook Subscriber have been updated.
Webhook	Backend	The Cloud Formation has been updated to duplicate resources across all regions.
Webhook	Backend	Serverless configuration files have been documented.
Webhook	Backend	Job Codes are created for all Site to which an Employee is assigned.
Webhook	Backend	New status records are created to indicate when an Employee's status changes.
Webhook	Backend	Employee status data is processed as expected.
Webhook	Backend	POS passwords are set and updated between systems as expected.
Webhook	Backend	File structures, file names, and commands have been unified with other components for consistency.
Webhook	Backend	Configurations are initialized as expected after variables are written.
Webhook	Backend	ECS names have been updated.
All	Backend	Updated validation schemes.

Older Releases

2021-01-13 | 3.1 Back Office

Supplemental Information

This release is not dependent on another component update.

Version History

Refer to Change Ticket: [CHANGE-3139] when speaking to a Xenial Team Member about these release notes.

Component	Current Version	New Version
Staff	3.1.8	3.1.25

Improvements

Staff	Backend	Infrastructure improvements.
Staff	Backend	Back Office opens and functions as expected for companies with 1000+ sites.
Staff	Backend	Image files were updated to use the new private image repository.

2021-01-06 | 3.2 Back Office

Supplemental Information

This release is dependent on Back Office version 3.1.71 or higher.

Version History

Refer to Change Ticket: [CHANGE-3048, CHANGE-3073, CHANGE-3115] when speaking to a Xenial Team Member about these release notes.

Component	Current Version	New Version
Webhook	3.1.38-5	3.2.7
Core	3.1.66-7	3.1.92

New Features

Core

Backend

A caching mechanism was created to process employee data.

Improvements

Webhook	Backend	Employee job creation includes logic to process compensation type and rates.
Webhook	Backend	Drawer events are processed in the proper order.
Webhook	Backend	Employees who are terminated or on leave have their status set to inactive.
Webhook	Backend	Streamlined calculation for the "PreviousPrice" field in the Discount Items object.
Webhook	Backend	Order level discounts produce the proper number of records.
Webhook	Backend	Payment type mappings have been updated to integrate properly with partners' operating systems.
Webhook	Backend	Temporary security keys function as expected on locally run machines.
Webhook	Backend	Drawer open and close events are always associated with the Drawer Owner, including when managers use the "Close Others' Drawers" function.
Webhook	Backend	Job code rates are assigned to all job codes for employees with job codes on multiple sites.
Webhook	Backend	Order level discounts function as expected for refund orders.
Webhook	Backend	Items with non-numeric placeholders and modifiers are omitted from reports sent to retail partners.
Webhook	Backend	The "employeeWorker" lambda function works for scheduled shifts as well as employees.
Webhook	Backend	Transports moved from the transformer to shared component files.
Webhook	Backend	Functionality added for orders to ignore deduplication and to collect subscription data.
Webhook	Backend	Compensation types sync successfully between all of an employee's jobs.
Webhook	Backend	The contactless payment flag is sent to retail partners with the expected value.
Webhook	Backend	The shared library version has been updated.
Webhook	Backend	App code is logged as expected.
Core	Backend	Infrastructure improvements.
Core	Backend	Back Office opens and functions as expected for companies with 1,000+ sites.
Core	Process, Backend	Xenial images are now stored in a private repository.
Core	Backend	Error messages do not display on the Employee page if workflow is unaffected.
Core	Backend	TimeClock processing has been extended to include the "Auto Clock Out on EOD" function.
Core	Backend	API validation was added for employee entity IDs.
Core	Backend	Notifications to the clear cache lambda have been consolidated into one notification called "dm.cart-system-apply".
Core	Backend	Endpoints were expanded to process employee site status updates in bulk.
Core	UI	Compensation type names are displayed to match the appropriate field as expected.
Core	UI	Site selection for filters on the Employees pages functions as expected.
Core	Backend	Employees assigned to one site can be updated with assignments to a second site as expected.
Core	Backend	The AWS region is set to to consume the payload lambda through environment variables.
Core	Backend	Payrolls are generated and divided properly.
Core	Backend	Employee payrolls are recalculated automatically when rates are created or updated, and payrolls can be recalculated manually over specific date ranges.
Core	Backend	Payroll details are associated with the site where the work time was generated, not with the Employee's primary site.

2020-12-13 | 3.1 Back Office

Supplemental Information

This release is not dependent on another component update.

Version History

Refer to Change Ticket: [CHANGE-2929] when speaking to a Xenial Team Member about these release notes.

Component	Current Version	New Version
Core	3.1.39	3.1.66-7

New Features

Core

Backend

Employee data is processed through a new caching mechanism.

Improvements

Core	UI	A message displays to inform users that they have no allowed sites when they are being redirected to the Portal for that reason.
Core	UI	Warning badges for employee shift punches only display when expected.
Core	UI	Adjustment History properly displays the times for breaks logged in a punch.
Core	UI	The "Status" filter on the Employees page functions as expected.
Core	UI	The "First Name," "Last Name," and "Employee Corporate Code" fields have been disabled for editing for employees.
Core	UI	The "Compensation Type" field for the "Add Job Rate" button is now a required field.
Core	Backend	The Min Activation Amount field validates as expected.
Core	Backend	Infrastructure improvements.
Core	Backend	Staff and Job Code requests are sent successfully for companies with over 400 sites.
Core	Backend	Employee data syncs with Pipeline within the expected time-frame.
Core	Backend	Client and server files use separate environment variables.
Core	Backend	Employee jobs are assigned and synced through "EmployeeJob/SaveAll" as expected.
Core	Backend	The Back Office "/info" endpoint is available.
Core	Backend	Employees with assigned jobs on multiple sites are updated properly.
Core	Backend	Clocking in functions as expected for employees assigned to a site with an active punch.

2020-12-02 | 3.1 Back Office

Supplemental Information

This release is not dependent on another component update.

Version History

Refer to Change Ticket: [CHANGE-2955] when speaking to a Xenial Team Member about these release notes.

Component	Current Version	New Version
Webhook	3.1.38	3.1.38-5

Improvements

Webhook	Backend	Financial reports display the correct number of items for discount processing.
Webhook	Backend	The "Close Others' Drawers" function associates both the opening and closing of an employee's drawer with that employee.
Webhook	Backend	Order level discounts are properly processed with negative values for the discount amount.

2020-11-11 | 3.1 Back Office

Supplemental Information

This release is not dependent on another component update.

Version History

Refer to Change Ticket: [CHANGE-2844] when speaking to a Xenial Team Member about these release notes.

Component	Current Version	New Version
Webhook	3.1.36	3.1.38

Improvements

Webhook	Backend	Attributes "CardType" and "TypeCode" added to the "CreditDebit" object.
Webhook	Backend	Xenial BO employee profile updated to generate job codes for employees with multiple sites.
Webhook	Backend	"DeleteFlag" attribute changed to "CancelFlag" attribute with a new structure to ensure deleted items do not appear in final orders.
Webhook	Backend	Mapping logic for "POSLogDateTime" tag changed to ensure all values update correctly.

2020-10-28 | 3.1 Back Office

Supplemental Information

This release is not dependent on another component update.

Version History

Refer to Change Ticket: [CHANGE-2784] when speaking to a Xenial Team Member about these release notes.

Component	Current Version	New Version
Webhook	3.1.35	3.1.36

Improvements

Webhook	Backend	Tip amount is displayed correctly in the response.
Webhook	Backend	Schema validation works as expected for unrecognized fields.
Webhook	Backend	Security enhancements.
Webhook	Backend	Time punches are uploaded to FTP as expected when a company has Data Stream and MMX subscriptions.
Webhook	Backend	Catering is added as a order destination.
Webhook	Backend	Fixes issues with case and data type mismatches.
Webhook	Backend	Paid In/Out transactions populate on financial reports.
Webhook	Backend	Redis Cache and Get Subscriptions features are moved to the shared library.

2020-09-27 | 3.1 Back Office

Supplemental Information

This release depends on Dispatcher 3.1.24 and BOH CORE 3.1.39.

Version History

Refer to Change Ticket: [CHANGE-2648] when speaking to a Xenial Team Member about these release notes.

Component	Current Version	New Version
Webhook	2.8.75-6	3.1.31

Improvements

Webhook	Backend	Supports single site synchronization for employees.
Webhook	Backend	Log volume size is reduced.
Webhook	Backend	Integrator tokens are no longer logged in Cloud Watch.
Webhook	Backend	Adds test capabilities and updates test logic.
Webhook	Backend	Timepunch objects can be published.
Webhook	Backend	Portal subscription results can be cached.
Webhook	Backend	Employee job codes are applied as expected when creating a new employee or updating an existing employee. Default job codes are applied properly if the job code field is empty.
Webhook	Backend	Employee sync is improved and log files are updated.
Webhook	Backend	Orders are only published when they transition to a ‘final’ state.
Webhook	Backend	Drawer events are published.
Webhook	Backend	Gift card item support is added.
Webhook	Backend	Site statuses are set to inactive for terminated employees.
Webhook	Backend	Site info is obtained from Portal.
Webhook	Backend	Employees.xml can be empty and can be updated over SFTP.
Webhook	Backend	Time zone formats are consistent on POS.
Webhook	Backend	POS custom code fields are updated properly when employees are linked with multiple instances.
Webhook	Backend	Refund order and job code mapping is updated.
Webhook	Backend	The XML structure for order-level discounts is updated.
Webhook	Backend	Order objects can be uploaded using FTP as expected.
Webhook	Backend	Payment, price, and change logic is updated.
Webhook	Backend	Authorization information is added to credit payments.
Webhook	Backend	The TransactionCount attribute is added to orders.
Webhook	Backend	SQS reading cycle includes a timeout that can be set using environment variables, and it can be interrupted to stop processing a stuck message.
Webhook	Backend	Performance is improved.
Webhook	Backend	Deleted orders are uploaded to FTP.
Webhook	Backend	Jobs are removed from employees when the job code is deleted from Portal.
Webhook	Backend	Updates to employee names sync as expected.
Webhook	Backend	Support for refund transactions is improved. Refund transactions are uploaded to the FTP as expected.
Webhook	Backend	Timepunches are uploaded to the FTP as expected.
Webhook	Backend	Tender type field mapping is updated.

2020-09-23 | 3.1 Back Office

Supplemental Information

This release is depends on Xenial Web Services version 3.1.30.

Version History

Refer to Change Ticket: [CHANGE-2418, CHANGE-2610, CHANGE-2381, CHANGE-2382] when speaking to a Xenial Team Member about these release notes.

Component	Current Version	New Version
Staff	2.8.10	3.1.8
Daybook	2.8.10	3.1.5
Inventory	2.8.10	3.1.3
Core	3.1.5-2	3.1.39

Improvements

Staff, Daybook, Inventory, Core	Backend	Supports external ECS configuration variables.
Staff	Backend	Column sorting behavior is updated.
Core	Backend	"Employee" breadcrumb link points to the new UI.
Core	Backend	The Employee Details page only loads job codes for for the employee's configured sites.
Core	Backend	Employees can be added to sites when Day Parts are not associated with the site
Core	Backend	The Site Name of an employee's active shift is sent to the POS when the employee attempts to clock in to a different site.
Core	Backend	Database queries are optomized for the new BOH DB indexes.
Core	Backend	Overlapping shifts are logged.
Core	Backend	The 'Shift' value is not set to null.
Core	Backend	The change history for POS credentials is recorded.
Core	Backend	Time punch messages sent to XWS include the employee POS code and role.
Core	Backend	Employee jobs are returned as expected for a GET request to the /Staff, /Employee, and /EmployeeDetail resources.
Core	Backend	Employee records are displayed as expected.

2020-08-27 | 3.1 Back Office

Supplemental Information

This release is not dependent on another component update.

Version History

Refer to Change Ticket: [CHANGE-2531] when speaking to a Xenial Team Member about these release notes.

Component	Current Version	New Version
Core	3.1.5	3.1.5-2

Improvements

Core

Backend

Change history of employee POS credentials is logged and employee credentials are correctly updated when changed in Deputy.

2020-07-19 | 2.8 and 3.1 Back Office

Supplemental Information

This release is dependent on Pipeline Dispatcher API 2.8.12, XWS 2.8.75-6, and BOH CORE 3.1.5.

Version History

Refer to Change Ticket: [CHANGE-2298, CHANGE-2354] when speaking to a Xenial Team Member about these release notes.

Component	Current Version	New Version
Core	2.8.21-6	3.1.5
Webhook	2.8.68-5	2.8.75-6

New Features

Core	User Interface	It is now possible to sync employees for a specific site.
Webhook	Backend	Webhook now supports single site synchronization.
Webhook	Backend	Webhook now supports the ARTS XML data standard for Retail/Hospitality, which enables the use of Macromatix for managing employee records.
Webhook	Backend	Timepunches can now be synced with the Macromatix back office solution.
Webhook	Backend	It is now possible to publish standard order objects to a specified HTTP destination endpoint.
Webhook	Backend	Webhook now supports the ARTS XML data standard for order objects.

Improvements

Core	Backend	Employees are now displayed on the Employees page if the job code applied to them is deleted.
Core	Backend	Employees are now able to access Portal after their primary assigned site is deleted.
Core	Backend	Unpaid break time is now subtracted from the total hours worked after a clock out punch.
Core	Backend	XWS now sends an update to Macromatix for each time punch.
Core	Backend	The Employee Edit page loads reliably when editing multiple employees from a large list of employees.
Core	Backend	Employees can now log in to their POS system using their Xenial IDs with passwords that have not been changed since before an update.
Core	Backend	It is now possible to untick the Primary Job checkbox on the Employee Edit page.
Core	Backend	It is now possible to add an additional primary job to an employee when that employee is assigned to an additional site.
Core	Backend	Filtering the Employee List in Back Office now works as expected when deselecting multiple filters.
Core	Backend	EOD process time now takes less than 1 minute.
Core	Backend	Users can now search on the Employee list.
Core	Backend	Users can now filter by job code on the Employee list.
Core	Backend	The ClockChitData request now returns TodayHours and WeekHours and is backwards compatible with previous POS versions.
Core	Backend	Authentication logs now include the auth request header and the failure reason.
Core	Backend	BOH Employee page now loads when it is set as the default landing page.
Core	Backend	Authentication logs now include JWT validation metadata.
Webhook	Backend	Users can now log in to the POS using their default credentials.
Webhook	Backend	Employee POS passwords are preserved when employees are set to active at a second site.
Webhook	Backend	Custom field values for employees are updated in multiple Deputy instances when changed in Back of House.
Webhook	Backend	Integrator tokens are no longer logged.
Webhook	Backend	Employee sync process works when a company has an inactive Macromatix subscription.
Webhook	Backend	Incoming order and time punch messages are now validated.
Webhook	Backend	Orders with the state set to closed can now be published.
Webhook	Backend	Employee sync performance is improved.

2020-07-05 | 2.8 Back Office

Supplemental Information

This release is not dependent on another component update.

Version History

Refer to Change Ticket: [CHANGE-2277] when speaking to a Xenial Team Member about these release notes.

Component	Current Version	New Version
Core	2.8.21-3	2.8.21-6

Improvements

Core	Backend	Updated logs to include: Authentication failures by creating log with auth request header and failure reason Authentication failures by creating log with claims and headers according to each token type (site, integrator, access, person), but does not include bearer token Full JwtValidation log data
Core	Process	Navigating to Back Office > Employees now loads without "Sequence contains no elements" error

2020-06-18 | 2.8 Back Office

Supplemental Information

This release is not dependent on another component update.

Version History

Refer to Change Ticket: [CHANGE-2177, CHANGE-2178, CHANGE-2180, CHANGE-2214] when speaking to a Xenial Team Member about these release notes.

Component	Current Version	New Version
API/UI	2.8.13	2.8.21-3
Forecast	2.7.4	2.8.10
Daybook	2.5.9	2.8.10
Inventory	2.7.19	2.8.10

Improvements

API/UI	Backend	Employee POS codes are now available in range 1000 to 9999
API/UI, Inventory, Forecast, Daybook	Backend	Updated BOH components to support a database name specified in a connection string
API/UI	Backend	Cleared lambda event failure so cross-service data syncs properly
API/UI	User Interface	Employee edit page now loads with all fields and values
API/UI	Backend	Planned approach to reduce processing times for EOD
API/UI	Process	Searching the employee list by name now works
API/UI	Process	Filtering the employee list by job codes now works

2020-05-31| 2.8 Back Office

Supplemental Information

This release is not dependent on another component update.

Version History

Refer to Change Ticket: [CHANGE-2097, CHANGE-2064] when speaking to a Xenial Team Member about these release notes.

Component	Current Version	New Version
API/UI	2.7.40	2.8.13
Webhook	2.7.37	2.8.62-5

New Features

API/UI	Backend	Created new endpoing with current payroll weekly statistics for an employee to support timeclock enhancement for chits
API/UI, Webhook	Backend	Added ability to create users automatically when processing employee webhook data and sync employees from different deputy instances with the same email as a single merged employee in BO
Webhook	Backend	Added ability to have all order data sent to the company's HTTP endpoint to support parsing and managing data from orders

Improvements

API/UI	Backend	Reduced employee list loading time
API/UI	User Interface	Employee information now displays on the Employees list
API/UI	Backend	Employee POS codes are now available in range 1000 to 9999
Webhook	Backend	Editing the "Employee POS Code" field now sends the "CustomFieldDataObject" and "ContactObject" fields in the request
Webhook	Backend	The following variables are now configurable via export to support different ECS policies and configurations: ECSService.DesiredCount, ScalingTarget.MaxCapacity, ScalingTarget.MinCapacity, ScalingPolicy.PolicyName, ELBAlarm
Webhook	Process	Editing an employee updates the existing employee instead of creating a new employee
Webhook	Backend	Adding a new person in Deputy creates the employee in BO and the user in Portal and sends the employee POS coe to Deputy if the person has no email
Webhook	Backend	Syncing Deputy now adds people to BOH with their email
Webhook	Process	Discarding people from Deputy: Terminates the employee on BO and its associated user in Portal loses its roles and sites No longer removes the company administrator role from the associated user in Portal Shows "Active" status for prevous day and "Terminate" status for current day for the employee
Webhook	Process	Updating people in Deputy: To company administrator now removes other roles To POS role now removes other roles
Webhook	Process	User now successfully logs in with default credentials

Back Office

2021-03-01 | 3.1 Back Office

2021-02-24 | 3.2 Back Office

Older Releases

2021-01-13 | 3.1 Back Office

2021-01-06 | 3.2 Back Office

2020-12-13 | 3.1 Back Office

2020-12-02 | 3.1 Back Office

2020-11-11 | 3.1 Back Office

2020-10-28 | 3.1 Back Office

2020-09-27 | 3.1 Back Office

2020-09-23 | 3.1 Back Office

2020-08-27 | 3.1 Back Office

2020-07-19 | 2.8 and 3.1 Back Office

2020-07-05 | 2.8 Back Office

2020-06-18 | 2.8 Back Office

2020-05-31| 2.8 Back Office

Search results