Skip to main content
APM supports both thermal and dot matrix printers with multiple connection types. This guide walks you through configuring printers for your POS system.

​
Adding a New Printer

1

Navigate to Printers

From the main menu, select Printers to open the printer management page.Click the + Add Printer button to create a new printer configuration.
2

Configure Basic Settings

Enter the basic printer information:Printer ID (PrinterId)
A unique identifier for this printer used by Appsiel to route print jobs.Example: ImpresoraCocina, PrinterCheckout1Printer Type (PrinterType)
Select the printer type:
  • Térmica - Thermal receipt printers (most common)
  • Matricial - Dot matrix printers
3

Choose Connection Type

Select how the printer connects to your system:

​
TCP (Network Connection)

Available for both thermal and dot matrix printers.IP Address (IpAddress)
The fixed IP address of the printer on your local network.
Example: 192.168.1.100Port (Port)
TCP/IP port number (typically 9100 for thermal printers).
Default: 9100
The connection URI is automatically generated as: tcp://192.168.1.100:9100

​
USB (Local Connection)

Only available for dot matrix printers.Local Printer Name (LocalPrinterName)
The exact name of the printer as registered in Windows.
Example: EPSON LX-300+ II
To find the printer name, open Windows Settings > Devices > Printers & scanners

​
IPP (Internet Printing Protocol)

Only available for dot matrix printers.URI (Uri)
The complete IPP connection string.
Example: ipp://192.168.1.50/ipp/print
4

Configure Paper Settings

Paper settings are only available for thermal printers. Dot matrix printers use standard paper sizes.
Paper Width (PaperWidthMm)
Select the paper width in millimeters:
  • 58mm - Narrow receipt paper
  • 80mm - Standard receipt paper (most common)
5

Set Printer Options

These options are only available for thermal printers.
Beep on Print (BeepOnPrint)
Enable sound notification when printing completes.Open Cash Drawer After Print (OpenCashDrawerAfterPrint)
Automatically trigger the cash drawer to open after printing a receipt.Open Cash Drawer Without Print (OpenCashDrawerWithoutPrint)
Allow the cash drawer to open without printing (for quick access).
6

Save Configuration

Click Save Printer to save your configuration.The printer will be immediately available for print job routing.

​
Advanced: Copy to Multiple Printers

You can configure a printer to copy print jobs to additional printers using the CopyToPrinterIds property. 
{
  "PrinterId": "MainPrinter",
  "ConnectionType": "TCP",
  "IpAddress": "192.168.1.100",
  "Port": 9100,
  "CopyToPrinterIds": [
    "BackupPrinter",
    "KitchenPrinter"
  ]
}
When a print job is sent to MainPrinter, it will automatically be copied to both BackupPrinter and KitchenPrinter.

​
Connection URI Format

APM automatically generates a universal connection URI based on your configuration:
Connection TypeURI FormatExample
TCPtcp://{IpAddress}:{Port}tcp://192.168.1.100:9100
USBusb://{LocalPrinterName}usb://EPSON LX-300+ II
IPPUser-provided URIipp://192.168.1.50/ipp/print

​
Troubleshooting

  • Verify the IP address is correct and the printer is powered on
  • Check that port 9100 (or your configured port) is not blocked by firewall
  • Test connectivity with ping {IP_ADDRESS} from command prompt
  • Ensure the printer is on the same network as the APM server
  • Verify the printer name matches exactly (case-sensitive)
  • Ensure printer drivers are installed in Windows
  • Check that the printer is set as “Ready” in Windows Printers settings
  • Restart the WorkerService after installing new printer drivers
  • Verify the cash drawer is properly connected to the printer’s RJ11/RJ12 port
  • Check that the drawer is compatible with ESC/POS kick commands
  • Test with “Open Cash Drawer Without Print” enabled

Template Editor

Design custom receipt templates

API Reference

Printer configuration API endpoints

Build docs developers (and LLMs) love

Get started for freeTalk to us