Receipt printers

Receipt printers integrate with Point of Sale systems to receive print jobs directly from the POS. Once properly configured and connected, this integration enables automatic receipt printing for every completed transaction.

Important

Epson printers are strongly recommended. The following printers are compatible with Odoo:

  • Network-based printers that support the ePOS communication protocol (without IoT), such as the TM-m30 iii (model 112 or 152).

  • ePOS printers with USB connectivity that need to be connected to an IoT system.

  • ESC/POS printers that require a connection via an IoT system using either a USB or network-based interface.

Bluetooth printers are not compatible with Odoo.

See also

Configuration

To configure the printer, connect it to a power source, then to the network using either Wi-Fi or an Ethernet cable. Then, power the printer on; an automatic ticket with the printer’s IP address gets printed upon connection. Keep it for the configuration process.

To link the printer with the Point of Sale, follow the next steps:

  1. Go to Point of Sale ‣ Configuration ‣ Settings.

  2. Scroll down to the Connected Devices section and enable Receipt Printers.

  3. Click the Printers field, then select Create.

  4. In the Create Receipt Printers popup, enter the printer’s Name.

  5. Specify the printer’s purpose by selecting either Preparation or Receipt.

  6. Set the Printer Type to IP address, IMIN, or IoT.

  7. Depending on the selected Printer Type, enter the Epson Printer IP Address or select the relevant IoT Device.

  8. Enable Use Local Network Access to allow the printer to be detected through Local Network Access (LNA).

  9. Click Save.

Note

Once configured, printers can be managed from Point of Sale ‣ Configuration ‣ Printers.

See also

Directly supported ePOS printers

The Epson TM-m30 i/ii/iii (Wi-Fi or Ethernet only) models are strongly recommended, as they have been fully tested with Odoo Point of Sale.

Other Wi-Fi or Ethernet Epson printer models that support the ePoS protocol should also be compatible.

Important

  • The printer must be capable of operating in HTTP mode.

  • When using Local Network Access (LNA), the printer must have a static IP address; otherwise, it may become unreachable. The static IP should be configured through the router.

iMin POS systems

iMin POS devices are Android-based systems that combine POS management and printing functionality.

Note

  • Odoo is compatible with Swan 2 and Falcon 2 POS devices, which can be purchased from iMin business partners.

  • Falcon 2 devices require the base device to be connected to the dock before printing receipts.

  • iMin POS devices are network-based and do not require an IoT system to operate.

Important

Do not use iMin POS devices to print preparation orders.

To configure an iMin POS device, connect it to a network via Ethernet or WI-Fi, then follow the next steps:

  1. Install the latest iMinOS version.

  2. Download and install the Odoo and Android System WebView apps from iMin’s App Store.

  3. Optionally, install a security certificate if any connected devices require HTTPS, such as payment terminals or preparation printers. To do so, go to Settings ‣ Security ‣ More security settings ‣ Encryption & credentials, then click Install a certificate.

Once the device is set up, install the POS iMin module and connect the device to your Odoo database, leaving the IP address field empty. This action automatically links the device with Odoo.

Tip

To ensure the device’s printer works correctly, access the TestTools app on the device interface. A test ticket is automatically printed. If not, click Print.

See also

iMin device troubleshooting guide

Printers with IoT system integration

The following printers require an IoT system to be compatible with Odoo:

  • Epson TM-T20 family (incompatible ePOS software)

  • Epson TM-T88 family (incompatible ePOS software)

  • Epson TM-U220 family (incompatible ePOS software)

Troubleshooting

To resolve common hardware issues, including connectivity failures, configuration errors, and physical maintenance, follow the instructions below:

  • If Google Chrome denies access to local devices, printers and IoT boxes will fail to connect. Grant the necessary browser permissions to restore the connection.

  • Check the printer’s blinking lights to help identify the source of a problem.

  • If the printer does not print the first automatic ticket with the IP address, check the network cable or Wi-Fi connection.

  • If the receipt comes out blank, the paper roll may be upside down; try flipping it.

  • If the POS cannot connect to the printer, make sure the printer’s IP address entered in Odoo matches the one on the first automatically printed ticket. Also, ensure the router assigns the printer a static IP address.