POS Printer Configuration

POS Printer Configuration is used to set up receipt printers, thermal printers, and native print service profiles used by the application. Users can define multiple printer profiles, choose the connection type, adjust paper and ESC/POS parameters, and run a test print.

Menu Route

General Printer

/apsconfig

This menu only appears in the Zayeen application, not when Zayeen is opened in a regular web browser. Use the Zayeen app for Windows, iOS, or Android so the POS Printer Configuration page and local printer service are available.

When to Use

When setting up a receipt or thermal printer for the first time.
When one outlet uses multiple printers and each printer should be saved as a separate profile.
When the printer connection changes, for example from Bluetooth to TCP/IP or from SMB to USB.
When print output is too wide, too narrow, or the page break and paper cut behavior is incorrect.
When users want to test the printer directly without creating a live transaction.

Basic Concepts

APS Server List is the list of saved printer profiles.
New Server creates a new printer profile by copying the currently selected profile.
Delete Server removes the selected profile. It is only useful when more than one profile exists.
Printer Type defines how the application connects to the printer: SMB, USB, Bluetooth/Serial, or TCP/IP.
Save Config stores all printer profiles in the local service so other modules can use them.
Test Print sends a sample receipt to the currently selected printer profile.

Printer Connection Types

SMB is commonly used on Windows or macOS for shared printers. The main field is sharingPrinter.
USB Printer is used when the printer is connected directly through USB. The important fields are vendorId and productId.
Bluetooth/Serial Printer is used for Bluetooth or serial printers. On desktop platforms, the same field can hold a serial port such as COM3 or /dev/tty....
TCP/IP Printer is used for network printers. The key fields are printerIpAddress and printerPort.
Available printer types depend on the platform. For example, iOS is directed to TCP/IP, while Android commonly starts from Bluetooth.

Workflow

Open Settings / System & Display / POS Printer Configuration.
Select a printer profile from APS Server List, or click New Server to add a new one.
Fill or rename the printer Name. When the name changes successfully, the profile key also changes.
Choose the correct Printer Type.
Fill the connection fields according to the printer type, for example IP and port for TCP/IP, sharing printer for SMB, or USB vendor/product IDs for USB.
Set print options such as Auto Cut, Enable Cash Drawer, copy count, DPI, characters per line, and paper width in millimeters.
Open Advanced Page Break when the printer needs custom form feed, cut, or line-based page control.
Click Save Config, then run Test Print to confirm the printer receives the output correctly.

Important Fields

Field / Option	Explanation
Name	Printer profile name used to distinguish cashier, kitchen, warehouse, or other outlet printers.
Sharing Printer	Used for SMB printers. Typical format is `\\server\printer` on Windows.
Bluetooth Address / Serial Port	Used for Bluetooth or serial printers.
Printer IP Address and Printer Port	Used for TCP/IP printers. Port `9100` is common, but the actual port depends on the printer setup.
USB Vendor ID and USB Product ID	Used for USB printers and must match the connected device.
Enable Auto Cut	Controls whether the printer cuts the paper automatically after printing.
Enable Cash Drawer	Controls whether the print service should trigger the cash drawer pulse.
Number Of Copies To Print	Defines how many copies should be printed for one request.
Printer DPI	Thermal printer resolution. A common value is `203`.
Characters Per Line	Defines the maximum line width used by ESC/POS layout generation.
Printer Width MM	Defines the paper width, commonly around `58` mm or `80` mm.
Advanced Page Break	Used to override form feed, cut behavior, line length, or page length values.

Detect and Test Print

Detect Printer only appears for Bluetooth/Serial printer type. It asks the local service for available serial devices and lets the user choose one.
Test Print sends a sample receipt with header, items, totals, taxes, payments, and footer to the selected printer.
If test print fails, verify the connection type and addressing values before changing receipt layout or template settings.

Things to Check

This menu only appears in the Zayeen application for Windows, iOS, or Android. It normally does not appear when Zayeen is opened in a regular browser.
The local printer service is only available in the Zayeen app runtime. In a regular browser, APS/native print features are usually not available.
Deleting a profile does not remove the physical printer. It only removes the saved local configuration.
Renaming a profile to a name already used by another profile is rejected because printer keys must remain unique.
If print output is too long, cut incorrectly, or wraps badly, recheck Enable Auto Cut, Characters Per Line, Printer Width MM, and Advanced Page Break.
After changing the printer setup, run a test print before using the printer for operational POS or receipt printing.