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.

Importante

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.

Ver também

Configuração

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 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 ePos Printer.

  3. Type the printer’s IP address in the dedicated field.

  4. Clique em Salvar.

Enable Local Network Access to allow Point of Sale to communicate directly with the printer on the same network. Alternatively, once the printer is connected to Odoo, ensure the connection is secure and reliable by generating a self-signed certificate.

Nota

Leave the IP address field empty if using an iMin POS device, as these devices do not provide an IP address.

Ver também

Impressoras ePOS com suporte direto

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.

Importante

  • 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.

Nota

  • 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.

Importante

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.

Dica

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.

Ver também

iMin device troubleshooting guide

Printers with IoT system integration

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

  • Família Epson TM-T20 (software ePOS incompatível)

  • Família Epson TM-T88 (software ePOS incompatível)

  • Família Epson TM-U220 (software ePOS incompatível)

Solução de problemas

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.