Setting up and printing checks in Torgsoft: from sales receipt to fiscal document

Printing a receipt is the final and most important stage of interaction with the customer, directly affecting customer trust and the legal safety of the business. Entrepreneurs regularly contact technical support with receipt-related questions: text is cut off at the edges, templates stop working after updates, the program shows unclear errors such as «Field not found», or there is a need to add a logo and configure receipt sending via Viber instead of paper printing. An incorrectly configured receipt can cause both technical delays at the checkout and fines due to missing mandatory details. This article brings together the key aspects of working with receipts in Torgsoft — from selecting the receipt tape width to customization and troubleshooting typical failures.

1. Sales receipt (non-fiscal) and fiscal receipt: what is the difference and how the mixed mode works

In Torgsoft, there is a clear distinction between fiscal and non-fiscal (sales) receipts, which allows you to keep records flexibly:

• Non-fiscal (sales) receipt. Used for internal accounting, issuing warranties, or as an informational receipt for the customer. It is printed on a regular receipt printer. It does not require connecting a pECR or a cash register.

• Fiscal receipt. An official settlement document that confirms the sale and is transmitted to the State Tax Service (STS) through a software ECR (pECR) or a hardware fiscal registrar. It contains strict mandatory details, such as a QR code, fiscal number, tax data, and payment method (cash/card). To print a fiscal receipt, the product in the program must have the «Fiscal» attribute in the product type settings.

The receipt type is selected in the menu: Settings — Parameters — Receipt — Receipt type.

2. Logic for selecting a template for 58 mm and 80 mm printers

The most common reason for complaints that «the information does not fit on the receipt» or «the printer cuts off the right edge» is a mismatch between the selected template and the width of the thermal label or receipt tape.

Torgsoft provides standard document templates adapted for the two most common printer widths: 57/58 mm (marked in the program as «56 mm») and 80 mm. If you have a printer with 58 mm tape, but the program uses an 80 mm template by default, the printer physically cannot print the full width and will cut off part of the text or the QR code.

How to choose the correct template:

1. Go to Settings — Print template settings.

2. Find the required document in the list, for example, «Fiscal cash receipt ».

3. Click the arrow in the «Template» column and select a file that contains the mark «56» in its name, for example, 1. Чек 56 с решіткою 1.03.2025.rp48 or updated templates from the developers.

3. Branding: configuring a unique receipt appearance (FastReport)

Torgsoft allows you to customize non-fiscal receipts and the visual (printed) part of fiscal receipts using the built-in FastReport editor.

You can add your store logo, text about exchange/return conditions, a greeting, or change fonts. How to do this:

1. Go to Settings — Parameters — Receipt and next to the «Receipt print template» field, click the Configure button (or through Print template settings — Settings...).

2. The editor window will open. To add a logo, select the «Picture» object tool, mark the place on the receipt (usually at the top), and upload your image.

3. To add advertising text, use the «Text» tool and place it, for example, in the receipt footer.

4. Save the template via File — Save as... so as not to overwrite the standard system template.

4. How to change the QR code size in a pECR receipt

If the QR code in the pECR receipt template was initially configured too large, it may overlap the text or barcode. The QR code size does not change automatically after replacing the printer: it is printed as specified in the receipt template. If the QR code is too large or too small to be scanned with a smartphone, its size must be changed manually in the template editor.

To change the QR code size:

1. Open the fiscal receipt template for editing in FastReport (as described above).

2. Find the QR code object in the template and select it. For a QR code, the scale is changed not through the Barcode Editor window, but in the properties of the object itself. In the QR code properties panel, find the Zoom field (Scale) and change its value: for example, reduce the scale if the QR code is too large, or increase it if it is too small to be scanned with a smartphone.

3. Save the template.

5. Paper receipt printing and electronic receipt in Torgsoft

According to the law, a receipt can be issued not only in paper form, but also electronically. This is convenient for online stores or environmentally conscious businesses.

To send pECR fiscal receipts electronically (via SMS, Viber, or Email), you need to have the «Mass mailings to customers» option activated. Settings:

1. Go to Settings — Parameters — Additional features — Software ECR.

2. Select the Message template (usually the type «By software ECR receipt») and the Delivery service (for example, TurboSMS or AlphaSMS).

3. You can add a variable to the template (a link to the receipt on the STS server).

4. To avoid wasting receipt tape, enable the «Do not print a paper receipt when sending electronically» parameter. If the message is sent successfully, the printer will not start.

5. When paying for the goods, the program will ask for the customer's phone number or email (if it is in the database, the data will be filled in automatically).

6. How to print a receipt copy

The algorithm for printing a copy depends on what type of receipt it was:

• Copy of a non-fiscal (sales) receipt. Go to the menu Warehouse — Expense list. Find the required sale, select it, click the Print button, and choose «Receipt». Access to this action must be enabled for the salesperson role.

• Copy of a pECR fiscal receipt. A copy of a fiscal document cannot be printed through the regular expense list. Go to Settings — Software ECR — Software ECR analytics. Find the required receipt in the list of processed documents and click the print button. This receipt will contain all original fiscal details.

7. Typical errors: «Field not found» / «Error in expression» when printing

The most common technical problem users face when printing receipts, especially after power outages or remote connection issues, is critical errors such as: Field not found: Product list."Price" or Error in expression 'Software ECR."USREOU/RNOKPP/passport No."': ';' expected.

Cause. Receipt templates in Torgsoft are usually configured for variables in Ukrainian. If because of a failure (for example, clearing the configuration file) the program started with the Russian interface, it cannot find the Ukrainian field names in the database.

Solution (takes 1 minute):

1. Check the interface language of Torgsoft. To do this, go to Settings → Parameters → Service → Program language and set Ukrainian. After changing the language, restart Torgsoft and try printing the receipt again. If the error was caused by a mismatch between the interface language and the variables in the template, the receipt should print without an error.

2. After restarting Torgsoft, it will be in Ukrainian again, and receipts will start printing without errors.

Variable-related errors (for example, the missing "Change" field) may also occur if you use an outdated template after updating Torgsoft. If the error occurred because of an outdated template after a Torgsoft update, you do not need to download templates separately from the website. Current pECR receipt templates are added during the program update. Go to Settings → Print template settings and select the current receipt template dated from 01.03. Then save the settings and try printing the receipt again.