NCR Voyix Logo

Docs

Aloha POS

About Aloha POS

Implementing

Aloha POS

Creating the configuration file

Whether you insert data into, or completely replace, the standard checkout report, use a text editor, such as MSNotepad®, to create Checkout.cfg and place the file in the Data directory. You can customize Checkout.cfg to contain as many sections as necessary.

Understanding Checkout.cfg variables and rules

The following tables contain the variables you can use.

CustomFOHReports_Comps.png
CustomFOHReports_Delivery.png
CustomFOHReports_Employees.png
CustomFOHReports_EntreeCount.png
CustomFOHReports_GiftCertificates.png
CustomFOHReports_Gratuities.png
CustomFOHReports_GuestChecks.png
CustomFOHReports_GuestCounts.png
CustomFOHReports_Items.png
CustomFOHReports_OrderModeCharges.png
CustomFOHReports_PettyCashAccounts.png
CustomFOHReports_Promotions.png
CustomFOHReports_Refunds.png
CustomFOHReports_RevenueItems.png
CustomFOHReports_Rounding.png
CustomFOHReports_Sales.png
CustomFOHReports_StoreInformation.png
CustomFOHReports_ServiceCharges.png
CustomFOHReports_Surcharges.png
CustomFOHReports_System.png
CustomFOHReports_Taxes.png
CustomFOHReports_Tenders.png
CustomFOHReports_Tips.png
CustomFOHReports_Tipshare.png
CustomFOHReports_Voids.png

Understanding configuration rules

It is necessary to follow certain rules when creating your configuration file.

Print for all employee or by job code

Use a header to tell the system to print the custom information. You must dedicate the first line to a header; otherwise, anything placed before the header does not print. If the custom information is to print for all employees, use Default, as shown below. If the custom information is to print for a specific job code, or job codes, use a ‘jobcode’ header. The information prints until you insert another header to tell the system to print differently.

CustomFOHReports_HeaderExamples.png

Tip: The first line of your custom information must be a header.

Fill a line with a single character

For readability and dividing sections, you can insert a line composed entirely of a single character. You must use the ‘Fill’ command, enclosed inside greater and less than brackets. Common characters are -, *, or =.

CustomFOHReports_FillLine.png

Insert free text

You can insert free text for such things as section headings, labels for calculations, and more. Do not use closing and ending greater and less than brackets (<>) around any free text. These characters are reserved for a dynamic calculation or string.

CustomFOHReports_FreeText.png

Insert blank lines

Each line in the custom configuration file equals to a line printed for your custom information. If you want a blank line to print, insert a blank line in the configuration file. A line for a header is ignored.

CustomFOHReports_BlankLines.png

Insert dynamic calculations and strings

Dynamic calculations and strings are the main components of your custom information. A calculation is a count or equation of a value on which you want to report, such as the number of all comps, or the calculated total of all comp amounts. A string is the name of a supported variable pulled from within the system, such as the last name of an employee, or the date of business.

To configure, you must include three required elements, all inside of beginning and closing greater and less than brackets, as shown in the following:

<Val(width:formula)>

Val – Indicates the result will be a dynamic calculation or string.

Width - Specifies the number of spaces to use for the value, depending on if you are inserting a dynamic calculation or a string.

CustomFOHReports_Width.png

Formula – Specifies the equation of the calculation or the name of the string.

CustomFOHReports_Formula.png

Align text and values on a line

Whether you use free text, a dynamic calculation, or a string, you can align all or individual attributes on a line. Each line is left aligned, by default, but you can change the positioning with the Center and Right commands, as shown below. Given this, there is no need to use a Left command for a line. The attributes start left aligned again on the following line.

CustomFOHReports_Align.png

A Sample Checkout.cfg file and the resulting print is as follows:

CustomCheckoutReport_SampleCheckoutFile.png

Continue to "Refreshing POS data."

After running a refresh data, return to the main Custom Checkout Report page.

  • In this Article

  • Understanding Checkout.cfg variables and rules

  • Understanding configuration rules

NCR Voyix Logo

© 2025 NCR Voyix Corporation

Contact Us
Voyix Privacy Policy
Do Not Sell My Information
Legal Notice

NCR Payment Solutions, LLC is a registered ISO/MSP of Citizens Bank, N.A., Providence, RI.