How to add and configure fiscal and document printers?

This article provides instructions on adding and configuring fiscal and document printers using the cairo.DESK application and the cairo.ERP system. You will also find solutions to common problems that may occur during printer setup and use.

Adding a fiscal or document printer

To add a printer, you need to configure it in both the cairo.DESK application and the cairo.ERP system.

cairo.DESK Configuration (latest version)

Download cairo.DESK from our website: https://www.cairo.pl/~~instrukcje/~~en/instructions/
Open cairo.DESK.
Go to Settings > Desk Webservice.
Enter the data:
- Host: Received from our service.
- Authentication code: Available in ERP (ERP > ADMINISTRATION > PARAMETERS > WORKSTATION > GENERAL PARAMETERS). If not visible, contact our service.

Fiscal Printer Configuration

Configuration in ERP

Go to ERP > ADMINISTRATION > PARAMETERS > WORKSTATION > FISCAL PRINTER.
Fill in the fields:
- WORKSTATION: Identifier of the workstation being configured.
- STATUS: Enable fiscal printer support on the workstation.
- PRINTER ID: Unique identifier for the fiscal printer.
- PRINTER MODEL: Select cairo.DESK.
- FISCAL PRINTER IP NUMBER: Not required when cairo.DESK is selected.
- NIP PRINT SUPPORT: Specify whether to set the NIP flag on the receipt (only for printers supporting NIP printing).
- WAREHOUSE LIST: Select the warehouses where the printer should be available.
- MAXIMUM ITEM NAME LENGTH: For cairo.DESK, enter 39 characters.

Configuration in cairo.DESK

Open cairo.DESK.
Go to Settings > Fiscal printer.
Check the Active Status option.
Supported fiscal printer models are:
- NOVITUS
- POSNET (POSNET Thermal is not supported)
- ELZAB
- EMAR
Go to Settings and configure Connection Type:
- COM (cable connection): Select the COM Port to which the printer is connected.
- LAN (network connection): Enter the printer's IP and Port (e.g., 6666).
Select Save, then OK for the application to restart. If the connection is successful, a "ready" status will be checked.
Go to Workstations > Add.
Enter Workstation ID (e.g., fslinux001). Leave the Printer field blank.

Document Printer Configuration

Remember that the physical printer where the printout is to go must already be configured in Windows, and printouts from Windows should work correctly.

Configuration in ERP

Go to ERP > ADMINISTRATION > PARAMETERS > SYSTEM > SYSTEM PRINTER LIST > [End].
Enter printer data:
- PRINTER NAME: Custom printer name.
- PRINTER TYPE: Select cairo.DESK.
- NETWORK ALIAS: Printer network name (alias).
- DRIVER: Not used with cairo.DESK.
- LINES PER PAGE: Number of lines per page.
- LASER PRINTER: Check if it's a laser printer.
- DUPLEX: Check if the printer supports double-sided printing.
Add the printer to the workstation: Go to ERP > ADMINISTRATION > PARAMETERS > WORKSTATION > WORKSTATION PRINTER LIST > [End].
Point to the newly added printer and select LATIN-2.

Configuration in cairo.DESK

Open cairo.DESK.
Go to Workstation > Add.
Enter Workstation ID (printer alias from ERP).
Select the Printer from the Windows system.

Ended support for older programs

Support for the following programs has ended. If you encounter problems, contact service or switch to cairo.DESK:

Fiscal printer: flmenu, flfisk, fljfisk, serproxy (ELZAB FP-600, POSNET DF-300, EMAR EMAR-DUO)
Document printer: D2W Print

Troubleshooting common errors

Document printers

cairo.DESK - RPC server is unavailable:
- Problem: Missing .NET Runtime 8.0.6 (or newer) installed on Windows.
- Solution: Download and install the .NET Runtime 8.0.6 Windows Installers Arm64 from: https://dotnet.microsoft.com/en-us/download/dotnet/8.0. Restart your computer after installation.
cairo.DESK does not start - it shuts down:
- Problem: The cairo.DESK file in the path C:\Users\Sklep\AppData\Local\Cairosoft has a long, incorrect name.
- Solution: Shorten the file name to cairo.DESK.exe.
cairo.DESK - "Cannot retrieve templates from c.DESK" - no specified workstation path from which to retrieve templates:
- Solution:
  - Exchange folders: X:/wymiana/fslinuxXXX
  - Webservice connection: From Workstations in cairo.DESK, you need to add fslinuxXXX (specific workstation number).
cairo.DESK - "Target client not connected" - no specified print path from a given workstation for a given module:
- Solution:
  - Exchange folder: X:/csmag/[warehouse]/[module]/fslinuxXXX
  - Webservice: /[warehouse]/[module]/fslinuxXXX
cairo.DESK - Error sending label to cairo.DESK / Error during printing: No application is associated with the specified file for this operation:
- Problem: There is no default application for PDF files on the computer, such as Adobe Reader or Foxit Reader.
- Solution: Add a default application (we recommend Foxit Reader) in Windows settings: Default apps > Choose default applications by file type.
DeskClient: Couldn’t find printer for station or is not available - No printer specified in cairo.DESK at the workstation level:
- Problem: No printer specified in the workstation configuration in cairo.DESK.
- Solution: Ensure the printer is correctly assigned to the workstation in cairo.DESK.

Fiscal printers

cairo.DESK does not see the fiscal printer:
- Problem: The "ready" status is not checked. This may mean:
  - The fiscal printer cable is unplugged.
  - The fiscal printer is not turned on.
  - Damaged printer.
  - Damaged printer cable.
  - Damaged port on the computer.
- Solution: Check the above points.
cairo.DESK – receipt is not printing:
- Check the following:
  - If the item name on the receipt does not exceed 39 characters. If it exceeds, shorten the item name (from the general item data or from the receipt item level → ITEM NAME CORRECTION). It is also possible to fill in the fiscal item name if you do not want to change the main item name in the system.
  - If the item on the previous receipt was not printed with a different VAT rate.
  - If the item name does not contain special characters, such as "$", "&", etc.