PECR in Torgsoft Hybrid: Z Report Offline, ORDERNUM and ID Errors, Synchronization, and Receipt Templates

Torgsoft Hybrid is designed for retail outlets that work with a remote Torgsoft database and need to continue sales when the connection to the server is temporarily unavailable. Hybrid also supports pECR. When contacting specialists, users may have questions about why Field 'ORDERNUM' not found or Field 'ID' not found appears when closing a shift offline, whether this means that the State Tax Service rejected the document, whether a Z report can be generated again after such a message, what happens to offline receipts after the connection is restored, why the required pECR template cannot be selected or opens incorrectly, and where the fiscal receipt appearance is configured. It is important not to confuse three different levels: the offline mode of Torgsoft Hybrid itself, the pECR offline mode, and printed fiscal document templates.

What is Torgsoft Hybrid and how its offline mode differs from pECR offline mode

Torgsoft Hybrid offline mode

Hybrid works with local data at the workstation. If the connection to the remote Torgsoft server is lost, the cashier can continue performing some operations locally, and the accumulated data packages are synchronized with the main database after the connection is restored.

The Torgsoft Hybrid documentation provides for:

• sales;

• returns;

• stock status;

• printing regular and fiscal receipts;

• working with pECR;

• local accumulation of operations with subsequent synchronization.

The main Hybrid window displays the number of packages waiting to be synchronized.

pECR offline mode

This is a fiscal mode provided for by Law No. 265 and Procedure No. 317.

If there is no connection specifically between the pECR and the fiscal server of the State Tax Service, the pECR can process settlement transactions offline using a previously obtained range of fiscal numbers.

The law establishes two restrictions:

• no more than 36 consecutive hours;

• no more than 168 hours during a calendar month.

Once either of these limits is reached, the pECR must stop processing offline transactions until it switches back online. 

Therefore: Hybrid offline ≠ pECR offline.

In practice, these modes may occur simultaneously, for example, when a store completely loses its Internet connection. Technically, however, they are different states.

That is why, when contacting support, it is not enough to say: «Our cash register was offline». You need to clarify:

1. Could Hybrid not access the main Torgsoft server?

2. Could the pECR not access the fiscal server of the State Tax Service?

3. Or were both connections unavailable at the same time?

What happens to pECR receipts offline

When the pECR switches to offline mode, settlement documents receive fiscal numbers from the range reserved by the State Tax Service. The pECR itself must check the connection before generating each subsequent offline document and automatically switch back online once the connection is restored. 

After the connection is restored, a package is sent to the State Tax Service containing:

• a notification about the start of offline mode;

• settlement documents created offline;

• fiscal Z reports, if they were generated;

• a notification about the end of offline mode.

The pECR generates this package automatically; the user does not need to manually create Form No. 4-pECR for each offline session. The package must be sent to the fiscal server within one hour after the connection is restored. 

This is important for understanding the Z report issue: offline documents are not drafts that can be arbitrarily deleted and generated again. They are part of the sequence of fiscal documents within an offline session.

Can a Z report be generated while the pECR is offline?

Yes. If it is time to close the shift while working offline, the fiscal Z report must be generated after the last settlement document of that shift and before the next shift is opened. The fiscal numbers of the last receipt and the Z report are taken sequentially from the offline range.

The general pECR shift rules also apply:

• one Z report is generated during one shift;

• the shift duration must not exceed 24 hours;

• if settlement transactions have been performed, a Z report is generated daily. 

Therefore, the lack of an Internet connection itself is not a reason to leave a shift open until the next day if the pECR is operating normally in offline mode.

Field 'ID' not found and Field 'ORDERNUM' not found errors: what they mean

It is important to distinguish these two messages from fiscal server messages immediately.

For example: error code: 9 DocumentValidationError is a response from the State Tax Service to a generated fiscal document. Field 'ID' not found or Field 'ORDERNUM' not found, however, are internal messages from the Hybrid software module that occurred while preparing a Z report.

The State Tax Service does not return the fiscal error code ORDERNUM not found to the cashier.

Therefore, in such a situation, there is no need to look for the cause in the registration of the business unit, Form 20-OPP, the product tax group, or the qualified electronic signature unless other signs specifically indicate one of these causes.

Field 'ID' not found when generating an offline Z report

This scenario was actually recorded during Torgsoft development.

The internal work history dated November 27, 2024 records a fix for a situation where an attempt to generate a Z report for a pECR that had switched offline resulted in the message: An unexpected error occurred: Field 'ID' not found.

Therefore, this is not a theoretical example or a universal name for any pECR failure. It refers to a specific historical Hybrid defect.

What should not be inferred from the word ID itself

You should not independently conclude that:

• «the ID field has been deleted» from the database;

• it needs to be created with an SQL query;

• the local database is necessarily corrupted;

• the cache must be cleared;

• Hybrid must be reinstalled with all local data deleted.

The internal record confirms the existence of the defect and its correction, but it is not a reason for the user to manually repair the database structure.

If this message appears now in the current version of Hybrid, the case should be submitted for technical diagnostics.

Field 'ORDERNUM' not found when generating an offline Z report

A second separate case was recorded on September 25, 2025.

The development history explicitly states that the Field 'ORDERNUM' not found error that occurred when attempting to generate a Z report while the pECR was offline was fixed.

For the user, the principle is the same. ORDERNUM in this message is the technical name of a field used by Hybrid. It should not be interpreted as an instruction for the cashier to manually correct an «order number» or a receipt fiscal number.

Most importantly, this does not mean that the State Tax Service rejected the Z report because of an incorrect ORDERNUM.

If Hybrid was unable to generate the document locally, the actual status of the shift and offline documents must first be established.

What to do if ID or ORDERNUM appears when generating a Z report

Step 1. Do not click Z report repeatedly

A cashier's first reaction is often to repeat the same action. This is not recommended when working with a pECR.

First, you need to determine:

• whether the Z report was generated at all;

• whether it received a fiscal number;

• whether it remained local only;

• whether the pECR managed to transmit it after a brief restoration of the Internet connection;

• whether the shift is still considered open.

If the document already exists, attempting to close the shift again may result in a different situation, for example, a message that the Z report has already been registered.

Step 2. Record the exact message

Do not report only: «The Z report cannot be generated» to support.

You will need:

• the full message text;

• a screenshot;

• date and time;

• the pECR on which the operation was performed;

• whether Hybrid showed online or offline status;

• whether the pECR was in offline mode;

• the Torgsoft Hybrid version.

ID, ORDERNUM, DocumentValidationError, ZRepAlreadyRegistered are different situations and must be checked differently.

Step 3. Check the shift status

You need to determine:

• whether the shift is open or closed;

• what the last successfully registered fiscal document was;

• whether there were offline receipts after it;

• whether there is a Z report in the local history;

• whether it received a fiscal number.

If the connection to the State Tax Service has already been restored, you should also check the actual status on the fiscal server.

Step 4. Check the offline session

Record:

• when the pECR switched offline;

• how many receipts were created;

• whether there is an unused range of offline numbers remaining;

• whether the limit of 36 consecutive hours has been exceeded;

• whether 168 hours have been used during the calendar month.

If the maximum period has already been exhausted, the pECR must block further offline settlement transactions until the online connection is restored. 

However, exceeding the limit and ORDERNUM not found are not the same cause.

Step 5. Check the Hybrid version

Both specific scenarios — ID and ORDERNUM during an offline Z report — have already been fixed by the developers.

Therefore, for an old installation, the first technical step is to update Torgsoft Hybrid to the current release rather than trying to work around the issue manually.

The Hybrid 1.11.13 branch is already being tested in internal 2026 materials, so recommendations from old instructions to remain on early 1.10.x or 1.11.x versions are not suitable for a currently operating cash register.

At the same time, the update must preserve local data. If Hybrid contains unsynchronized operations, you should not first uninstall the software and delete its local data and then try to recover the receipts.

Step 6. After the Internet connection is restored, allow the pECR to complete synchronization

The pECR should automatically switch from offline to online once the connection is restored. Accumulated fiscal documents are transmitted to the State Tax Service in the prescribed sequence. 

Separately, Hybrid must synchronize its local operations with the main Torgsoft database.

Again, it is important not to confuse pECR synchronization with the State Tax Service and Hybrid synchronization with Torgsoft. These are two different data exchanges.

What not to do after an offline Z report failure

Until the status of the documents has been clarified, do not:

• delete local fiscal receipts;

• manually change ID, ORDERNUM, or other database fields;

• clear the entire local Hybrid database;

• reinstall the software and delete unsynchronized data;

• open a new shift without checking the status of the previous one;

• generate a Z report repeatedly;

• repeat sales merely because they have not yet appeared in the main database;

• change the fiscal numbers of offline documents.

If the issue occurred at a cash register that is currently operating without a connection, the main task is to preserve the sequence of locally generated documents.

Can Hybrid show one status and the State Tax Service another after returning online?

Such a situation should be considered separately from the original ID or ORDERNUM error.

For example:

1. the cash register was operating offline;

2. several receipts were created;

3. a local message appeared while generating the Z report;

4. the Internet connection was then restored;

5. some documents were transmitted;

6. the user repeated the operation.

After this, there may be three states:

What needs to be corrected is not the numbers in one of these sources, but the disrupted connection between them.

Therefore, if the status is unclear after the Internet connection is restored, the safe sequence is: check the State Tax Service → check local pECR documents → check the Hybrid synchronization queue → only then continue closing the shift.

How to configure pECR in Torgsoft Hybrid

pECR support is a separate Hybrid feature. In the Torgsoft documentation, it is described in the «Software ECR in Hybrid» section.

To work with it, you need to:

1. add a pECR to Hybrid;

2. specify the cryptographic libraries;

3. configure the cashier's qualified electronic signature;

4. select the business unit and registered pECR;

5. check taxes and payment methods;

6. select the pECR for this workstation;

7. select a printer;

8. set the required printing mode for sales — fiscal or mixed;

9. check that products that must be fiscalized have the corresponding attribute in Torgsoft.

The pECR actions menu in Hybrid includes:

• opening a shift;

• X report;

• Z report;

• cash deposit;

• cash withdrawal.

This is a separate Hybrid menu, so instructions for the main desktop version of Torgsoft do not always correspond exactly to the location of buttons in Hybrid.

Receipt template and fiscal data are not the same thing

Another common source of confusion is when a user sees incorrect text on a printed receipt and tries to use the template to correct something that is actually determined by the pECR settings.

The template controls how data is presented when printed.

For example, it determines:

• line placement;

• column width;

• font size;

• QR code;

• placement of the business unit name;

• display of taxes;

• the order in which details are printed.

But such data as:

• sale amount;

• payment form;

• payment method;

• tax group;

• fiscal number;

• shift number;

• pECR details,

are taken from the operation itself and its settings.

Therefore, for example, if a card payment is transmitted in the receipt with an incorrect payment method, directly changing the text in FastReport is the wrong approach.

Which pECR templates Torgsoft Hybrid uses

Separate templates are used for different types of fiscal documents.

The Hybrid working materials provide the following mapping:

This is important when selecting a template manually.

If you need to change the Z report, working with .rp48, which is the regular sales receipt template, will not change how the Z report is printed. It uses its own template.

Where to select a template in Hybrid

The «Software ECR» settings provide two modes for templates.

«Select»

Clicking the document name opens the selection of available templates.

Use this mode if, for example, you need to:

• switch to a template for a different paper width;

• select the Ukrainian version;

• restore a verified standard template.

«Open for editing»

Hybrid opens the selected file in FastReport. Use this mode if you need to change its appearance.

For example:

• increase the font size;

• change field widths;

• rearrange permitted blocks;

• adjust spacing.

Do not remove mandatory details from a fiscal document simply because they are «not needed on paper». Requirements for the form and content of a fiscal receipt are established by Regulation No. 13.

Why Hybrid does not see the required template file

There are several things to check.

Incorrect document type

If the Z report settings are open, you need to select the corresponding Z report file rather than a sales template.

An old version of Hybrid is being used

Early Hybrid implementations had certain limitations and improvements related to pECR template support. Therefore, if a file used in the main Torgsoft application is not displayed in the selection window, first check the Hybrid version.

Do not rename .rp53 to .fr3 simply to make the file appear in the window unless you know which format the specific version expects.

The file is corrupted or was edited incorrectly

A FastReport template may stop opening after unsuccessful manual editing.

In this case, it is safer to:

1. not edit it as a text file;

2. select the standard template;

3. check printing;

4. then restore the customized version separately.

FastReport expression errors in Hybrid templates

A separate class of issues may look approximately like this: Memo3: Error in expression ... ';' expected. This is not a pECR error or a response from the State Tax Service.

Technical support requests have recorded, among other things, an issue with the expression: Software ECR."EDRPOU/DRFO/passport No." when working with a template. In such cases, support updated Hybrid and the templates.

Therefore, if the receipt was registered but instead of printing normally FastReport displays Memo... Error in expression, you need to check the print form rather than fiscalize the sale again. This distinction is essential.

How to distinguish the problems

Do not try to fix one message using a method intended for another.

If the Z report was generated but was not printed

The absence of a paper Z report does not automatically mean that it does not exist in the fiscal system.

Possible causes include:

• the paper roll has run out;

• the printer is turned off;

• the wrong printer is selected in Hybrid;

• the .rp53 file is corrupted;

• FastReport was unable to generate the print form.

Therefore, the correct verification procedure is:

1. determine whether the Z report was generated as a fiscal document;

2. check the shift status;

3. check the fiscal number;

4. only then investigate the printing issue.

Do not close the shift again simply because no paper came out of the printer.

If the Z report template is incorrect, should the Z report be generated again?

No, if the fiscal document itself has already been correctly generated and registered and the issue concerns only its printed presentation.

For example:

• the Z report has been registered;

• the shift is closed;

• but a line is cut off on paper;

• or FastReport did not display a particular block.

This is a template issue.

A different situation is when:

• the Z report was not created;

• Hybrid terminated the operation because of ORDERNUM not found.

In this case, the shift may remain open, so the program status must first be corrected.

Payment method in Hybrid pECR receipts

A list of available payment methods is configured in the Hybrid pECR settings.

For these methods, you can specify, among other things:

• use for cashless payment;

• use for another payment form;

• use for prepayment;

• use for debt;

• the default method for payment through an integrated bank terminal;

• the default method for a cashless transaction without an integrated terminal.

For cashless payments, the cashier can also select an available payment method manually.

This has practical significance for templates: if the wrong payment method is printed on the receipt, first check the operation settings rather than the text field in .rp48.

Practical example: the cash register was offline and the Z report could not be generated

A store operates until 20:00. At 18:20, the Internet connection is lost. The pECR switches to offline mode and uses the reserved range. By 20:00, the cashier processes another 14 sales. At 20:05, the cashier clicks Z report and receives: Field 'ORDERNUM' not found.

Correct actions:

1. Do not click Z five more times.

2. Take a screenshot of the message.

3. Record the Hybrid version.

4. Check whether a local Z report exists and whether the shift remains open.

5. Do not delete the 14 offline receipts.

6. Do not clear the local database.

7. After the Internet connection is restored, check pECR synchronization with the State Tax Service.

8. Separately check the Hybrid package queue.

9. If the Z report was not created, update/check Hybrid and complete the shift after establishing the correct status.

10. If the Z report already exists, do not duplicate it.

Preserving the sequence of offline documents is more important here than trying to remove the message from the screen as quickly as possible.

Practical example: the Z report exists, but FastReport displays an error

Another situation:

1. the cashier generates a Z report;

2. the pECR successfully registers it;

3. the shift closes;

4. during printing, Memo2 or Memo3: Error in expression appears.

In this case, do not:

• generate the Z report again;

• open a shift;

• edit the fiscal number;

• clear offline packages.

You need to:

1. confirm that the Z report is registered;

2. check .rp53;

3. temporarily select the standard template;

4. update Hybrid if an old template set is being used;

5. correct the customized print form separately.

When the Hybrid cache can be cleared

The Torgsoft documentation does include a Hybrid cache clearing function. It is used, in particular, when:

• the user has been changed;

• another database has been connected;

• user restrictions or permissions have been changed and current data needs to be retrieved.

However, clearing the cache is not a universal way to fix ORDERNUM or ID errors during Z report generation.

You should not give the cashier an instruction such as: ORDERNUM → clear the cache → generate the Z report again. There are insufficient grounds for this.

It is particularly dangerous to confuse the reference data cache with local documents that are still waiting to be synchronized.

Should Hybrid be reinstalled when ID not found appears?

Not as the first step.

A safer sequence is:

1. determine the version;

2. check the shift status;

3. record unsynchronized operations;

4. check whether a current update is available;

5. create backups of the required data;

6. update Hybrid using the standard procedure;

7. if the issue persists, provide the local data to support for analysis.

Do not delete a working installation together with local data before synchronization.

Especially since ID not found and ORDERNUM not found already have a history of fixes specifically in the Hybrid code.

What to check after updating Hybrid

After updating the cash register, do not limit the check to whether the software starts.

For a workstation with a pECR, check:

• user authorization;

• connection to the required database;

• the selected pECR;

• the cashier's qualified electronic signature;

• the business unit;

• the printer;

• printing mode — fiscal or mixed;

• payment methods;

• X report;

• standard templates;

• opening and closing a test working shift in an allowed operating scenario;

• Hybrid synchronization with the server.

In current support requests, updating Hybrid, configuring the pECR and bank terminals, and checking cash register operation after an update remain typical technical tasks.

What information to provide to technical support

For ORDERNUM, ID, or an offline Z report issue, prepare:

1. the exact message text;

2. a screenshot;

3. the Torgsoft version;

4. the Torgsoft Hybrid version;

5. the pECR number;

6. the cashier's name;

7. the date and time the shift was opened;

8. the time when the pECR switched offline;

9. the number or time of the last successful receipt;

10. the approximate number of offline receipts;

11. whether the Z report was generated locally;

12. whether it has a fiscal number;

13. whether the connection to the State Tax Service has been restored;

14. whether synchronization of offline documents has been completed;

15. how many Hybrid packages remain in the queue;

16. whether the pECR template was changed;

17. for a printing issue — the template name and extension.

Do not delete local receipts or manually edit the database before the issue is checked.

Frequently asked questions

No. In Torgsoft's internal history, this is recorded as a separate Hybrid defect that occurred while generating a Z report when the pECR was offline.

The same applies. This scenario was separately fixed in Hybrid back in 2024.

No. These are internal technical fields. The user should not edit the fiscal database structure to resolve such a message.

No. They are already part of the offline session and may have fiscal numbers from the reserved range. Once the connection is restored, they must be transmitted to the State Tax Service in the prescribed sequence. 

First check whether the previous attempt actually failed to create the document and what shift status the pECR shows after synchronization.

One offline session may last up to 36 hours, but this does not override the rules for Z reports and shift duration. A pECR shift must not exceed 24 hours, and if settlement transactions are performed, a Z report must be generated daily. 

Check the Hybrid synchronization package queue. Fiscal transmission of a document to the State Tax Service and transmission of a sales operation to the main Torgsoft database are separate processes.

This is a print template issue, not a reason to process the sale again. Similar cases involving Ukrainian template variables have been recorded by technical support.

The pECR template set uses .rp53. The standard fiscal sales receipt uses .rp48.

Yes. Hybrid provides an «Open for editing» mode for pECR templates, which opens the form in FastReport.

First check the pECR payment method settings and the selection on the payment form. Do not change the name directly in the template to mask an incorrect operation detail.

What this guide does not cover

The Torgsoft mobile application is a separate product.

Messages related to local document numbering on Android/iOS, mobile form elements, the mobile database, or the mobile application server service should not be included in the Torgsoft Hybrid guide.

Even if the message contains the words «pECR», «offline», or «local number», the diagnostic procedure may be different.

Therefore, mobile pECR errors should be covered in a separate article about the mobile application, while this guide should remain focused on Hybrid.

Main procedure for checking pECR in Torgsoft Hybrid

If a problem occurs during offline operation, it is useful to follow one sequence: determine what exactly is offline → record the message → check the shift status → check local fiscal documents → do not delete offline packages → check the Hybrid version → after the connection is restored, check transmission to the State Tax Service → separately check Hybrid synchronization with the main database.

For Field 'ID' not found and Field 'ORDERNUM' not found, it is particularly important not to turn old Hybrid technical defects into instructions for manually repairing the database. Both cases have already been fixed at the software level. If they recur in the current version, preserve the local documents, record the status of the offline session, and submit the specific shift for technical inspection.