centersl/odoo-docs
1
0
Fork 0
mirror of https://github.com/odoo/documentation.git synced 2026-03-27 14:10:23 +07:00
Code Issues Packages Projects Releases Wiki Activity

[IMP] pos/e-pos-printers: Update ePos printers 19.0

Browse Source 
task-5085342

closes odoo/documentation#17014

X-original-commit: dae176ce29
Signed-off-by: Audrey Vandromme (auva) <auva@odoo.com>
Signed-off-by: Emmanuel Minga (EMMI) <emmi@odoo.com>
This commit is contained in:
emmi-odoo
2026-02-25 10:18:24 +00:00
parent d9c10309f6
commit 68daeb4dad
3 changed files with 276 additions and 261 deletions
Download Patch File Download Diff File Expand all files Collapse all files

442
content/applications/sales/point_of_sale/hardware_network/epos_ssc.rst
View File

@@ -9,281 +9,269 @@ Self-signed certificate for ePOS printers
self-signed certificate is no longer required. The recommended approach is to use the
:doc:`Local Network Access <pos_lna>` method instead.
To work with Odoo, some printer models that can be used without an
:doc:`IoT system </applications/general/iot>` may require the HTTPS protocol to establish a secure
connection between the browser and the printer. However, trying to reach the printer's IP address
using HTTPS leads to a warning page on most web browsers.
To work with Odoo, some printer models that can be used without an :doc:`IoT system
</applications/general/iot>` may require the HTTPS protocol to establish a secure connection
between the browser and the printer. However, trying to reach the printer's IP address using HTTPS
results in a warning page in most web browsers. Force the connection to establish an HTTPS link and
enable the printer in Odoo.
.. _pos/epos-ssc/certificate:
.. seealso::
:doc:`pos_lna`
Generation, export, and import of self-signed certificates
==========================================================
Generate, export, and import self-signed certificates
=====================================================
For a long-term solution, you must generate a **self-signed certificate**. Then, export and import
it into your browser.
Printers that operate without an :doc:`IoT system </applications/general/iot>` still require secure
communication, which can be achieved by :ref:`generating <pos/epos-ssc/certificate-generation>`,
:ref:`exporting <pos/epos-ssc/certificate-export>`, and/or :ref:`importing
<pos/epos-ssc/certificate-import>` a self-signed certificate.
.. important::
**Generating** an SSL certificate should only be done **once**. If you create another
certificate, devices using the previous one will lose HTTPS access.
- Generating a self-signed certificate should only be done **once**. Creating another
certificate causes devices using the previous one to lose HTTPS access.
- Printers that use an :doc:`IoT system </applications/general/iot>` do not need a
self-signed certificate, as the IoT box generates it automatically.
- For stable results, it is strongly recommended to use the Google Chrome browser to generate
the self-signed certificate.
.. note::
To export self-signed certificates from an operating system or a web browser that is not
mentioned in this documentation, search for `export SSL certificate` and the name of your
browser or operating system in the preferred search engine. Similarly, to import self-signed
certificates, search for `import SSL certificate root authority` in the preferred search engine.
.. _pos/epos-ssc/certificate-generation:
Self-signed certificate generation
----------------------------------
The generation process depends on the :abbr:`OS (Operating System)` and the browser.
.. tabs::
.. tab:: Windows 10 & Linux OS
.. group-tab:: Windows 10 & Linux
To generate a self-signed certificate on **Google Chrome**, follow the next steps:
#. Open the browser, type the printer's IP address in the search bar (e.g.,
`https://192.168.1.25`), and press `Enter`.
#. On the security warning page, click :guilabel:`Advanced`, then :guilabel:`Proceed to
[IP address] (unsafe)` to force the connection.
#. On the EPSON platform, click :guilabel:`Advanced Settings`, then :guilabel:`Administrator
Login` to log in to the printer's homepage.
#. Type the initial password located at the back of the printer in the :guilabel:`Current
Password` field, then press `Enter`.
#. Go to :menuselection:`Network Security --> SSL/TLS --> Certificate`.
#. On the :guilabel:`Certificate` page, click :guilabel:`Update` under the
:guilabel:`Self-signed Certificate` section.
#. Adapt the :guilabel:`Common Name` field to retain only the IP address, then click
:guilabel:`Next`, then :guilabel:`OK`. Wait for the printer's lights to stop blinking.
.. image:: epos_ssc/browser-https-insecure.png
:alt: Warning page about the connection privacy on Google Chrome
:scale: 75 %
.. note::
The Epson homepage may vary depending on the printer model used. For the Epson TM-m30 ii,
log in to the Epson homepage by typing `epson` as the username and the printer's serial
number as the password.
.. group-tab:: Mac OS
To generate a self-signed certificate using the `Keychain Access
<https://support.apple.com/en-gb/guide/keychain-access/kyca8916/mac>`_ app on Mac, follow the
next steps:
#. Access the :guilabel:`Keychain Access` app on Mac.
#. Go to :menuselection:`Access --> Certificate Assistant --> Create a Certificate`.
#. Enter a name for the certificate.
#. Select an identity type, then the type of certificate.
#. Click :guilabel:`Create`.
#. Review the certificate, then click :guilabel:`Done`.
.. _pos/epos-ssc/certificate-export:
Self-signed certificate export
------------------------------
The export process depends on the :abbr:`OS (Operating System)` and the browser.
.. tabs::
.. group-tab:: Windows 10 & Linux
.. tabs::
.. tab:: Generate a self-signed certificate
.. tab:: Google Chrome
Navigate to the ePOS' IP address (e.g., `https://192.168.1.25`) and force the
connection by clicking :guilabel:`Advanced` and :guilabel:`Proceed to [IP address]
(unsafe)`.
To export the certificate, follow the next steps:
.. figure:: epos_ssc/browser-https-insecure.png
:scale: 75%
:alt: warning page about the connection privacy on Google Chrome
#. Once the printer's lights are solid, hover the mouse over the browser's search bar
and click :guilabel:`Not secure`, then :guilabel:`Certificate details`.
#. Click the :guilabel:`Details` tab in the :guilabel:`Certificate Viewer` popover, then
click :guilabel:`Export`.
#. Add `.crt` next to the IP address in the :guilabel:`File name` field.
#. Set the :guilabel:`Save as type` field to `Base64-encoded ASCII, single certificate`.
#. Click :guilabel:`Save`.
Warning page on Google Chrome, Windows 10
.. tab:: Mozilla Firefox
Then, sign in using your printer credentials to access the ePOS printer settings. To
sign in, enter `epson` in the :guilabel:`ID` field and your printer serial number in the
:guilabel:`Password` field.
To export the certificate, follow the next steps:
Click :guilabel:`Certificate List` in the :guilabel:`Authentication` section, and click
:guilabel:`create` to generate a new **Self-Signed Certificate**. The :guilabel:`Common
Name` should be automatically filled out. If not, fill it in with the printer IP address
number. Select the years the certificate will be valid in the :guilabel:`Validity
Period` field, click :guilabel:`Create`, and :guilabel:`Reset` or manually restart the
printer.
#. Click :guilabel:`Not secure` next to the search bar.
#. Go to :menuselection:`Connection not secure --> More information`.
#. Click :guilabel:`View certificate` in the :guilabel:`Security` tab, then
:guilabel:`Details`.
#. Select the certificate, click :guilabel:`Export`, then select a folder in your local
drive.
#. Click :guilabel:`Close`.
The self-signed certificate is generated. Reload the page and click :guilabel:`SSL/TLS`
in the :guilabel:`Security` section to ensure **Selfsigned Certificate** is correctly
selected in the :guilabel:`Server Certificate` section.
.. tab:: Export a self-signed certificate
The export process is heavily dependent on the :abbr:`OS (Operating System)` and the
browser. Start by accessing your ePOS printer settings on your web browser by navigating
to its IP address (e.g., `https://192.168.1.25`). Then, force the connection as
explained in the **Generate a self-signed certificate tab**.
If you are using **Google Chrome**,
#. click :guilabel:`Not secure` next to the search bar, and :guilabel:`Certificate is
not valid`;
.. image:: epos_ssc/browser-warning.png
:alt: Connection to the printer not secure button in Google Chrome browser.
#. go to the :guilabel:`Details` tab and click :guilabel:`Export`;
#. add `.crt` at the end of the file name to ensure it has the correct extension;
#. select :guilabel:`Base64-encoded ASCII, single certificate`, at the bottom of the
pop-up window;
#. save, and the certificate is exported.
.. warning::
Make sure that the certificate ends with the extension `.crt`. Otherwise, some
browsers might not see the file during the import process.
If you are using **Mozilla Firefox**,
#. click the **lock-shaped** icon on the left of the address bar;
#. go to :menuselection:`Connection not secure --> More information --> Security tab
--> View certificate`;
.. image:: epos_ssc/mozilla-not-secure.png
:alt: Connection is not secure button in Mozilla Firefox browser
#. scroll down to the :guilabel:`Miscellaneous` section;
#. click :guilabel:`PEM (cert)` in the :guilabel:`Download` section;
#. save, and the certificate is exported.
.. tab:: Import a self-signed certificate
The import process is heavily dependent on the :abbr:`OS (Operating System)` and the
browser.
.. tabs::
.. tab:: Windows 10
Windows 10 manages certificates, which means that self-signed certificates must be
imported from the certification file rather than the browser. To do so,
#. open the Windows File Explorer and locate the downloaded certification file;
#. right-click on the certification file and click :guilabel:`Install
Certificate`;
#. select where to install the certificate and for whom - either for the
:guilabel:`Current User` or all users (:guilabel:`Local Machine`). Then, click
:guilabel:`Next`;
#. on the `Certificate Store` screen, tick :guilabel:`Place all certificates in
the following store`, click :guilabel:`Browse...`, and select
:guilabel:`Trusted Root Certification Authorities`;
.. image:: epos_ssc/win-cert-wizard-store.png
#. click :guilabel:`Finish`, accept the pop-up security window;
#. restart the computer to make sure that the changes are applied.
.. tab:: Linux
If you are using **Google Chrome**,
#. open Chrome;
#. go to :menuselection:`Settings --> Privacy and security --> Security -->
Manage certificates`;
#. on the :guilabel:`Local certificates` tab, click :guilabel:`Installed by you` under the :guilabel:`Custom` section;
#. click :guilabel:`Import` next to :guilabel:`Trusted Certificates`, and select
the exported certification file from your local drive;
#. accept all warnings;
#. click :guilabel:`ok`;
#. restart your browser.
If you are using **Mozilla Firefox**,
#. open Firefox;
#. go to :menuselection:`Settings --> Privacy & Security --> Security --> View
Certificates... --> Import`;
#. in the pop-up window, open the :guilabel:`Servers` tab;
#. click :guilabel:`Add Exception...`;
#. enter the printer's IP address in the :guilabel:`Location` field, then
click :guilabel:`Get Certificate`;
#. tick the :guilabel:`Permanently store this exception` checkbox and confirm;
#. restart your browser.
.. tab:: Mac OS
On Mac OS, you can secure the connection for all browsers by following these steps:
#. open Safari and navigate to your printer's IP address. Doing so leads to a warning page;
#. on the warning page, go to :menuselection:`Show Details --> visit this website --> Visit
Website`, validate;
#. reboot the printer so you can use it with any other browser.
To generate and export an SSL certificate and send it to IOS devices, open **Google Chrome**
or **Mozilla Firefox**. Then,
.. group-tab:: Mac OS
.. tabs::
.. tab:: Generate a self-signed certificate
.. tab:: Google Chrome
Navigate to the ePOS' IP address (e.g., `https://192.168.1.25`) and force the
connection by clicking :guilabel:`Advanced` and :guilabel:`Proceed to [IP address]
(unsafe)`.
To export the certificate, follow the next steps:
.. figure:: epos_ssc/browser-https-insecure.png
:scale: 75%
:alt: Warning page about the connection privacy on Google Chrome
#. Open the browser, type the printer's IP address in the search bar (e.g.,
`https://192.168.1.25`), and press `Enter`.
#. On the security warning page, click :guilabel:`Advanced`, then :guilabel:`Proceed
to [IP address] (unsafe)` to force the connection.
#. Click :guilabel:`Not secure` next to the search bar, then :guilabel:`Certificate is
not valid`.
#. Go to the :guilabel:`Details` tab and click :guilabel:`Export`.
#. Add `.crt` at the end of the file name to ensure it has the correct extension.
#. Select `Base64-encoded ASCII, single certificate`, at the bottom of the
popover.
#. Click :guilabel:`Save`.
Warning page on Google Chrome, Windows 10
.. tab:: Mozilla Firefox
Then, sign in using your printer credentials to access the ePOS printer settings. To
sign in, enter `epson` in the :guilabel:`ID` field and your printer serial number in the
:guilabel:`Password` field.
To export the certificate, follow the next steps:
Click :guilabel:`Certificate List` in the :guilabel:`Authentication` section, and click
:guilabel:`create` to generate a new **Self-Signed Certificate**. The :guilabel:`Common
Name` should be automatically filled out. If not, fill it in with the printer IP address
number. Select the years the certificate will be valid in the :guilabel:`Validity
Period` field, click :guilabel:`Create`, and :guilabel:`Reset` or manually restart the
printer.
#. Open the browser, type the printer's IP address in the search bar (e.g.,
`https://192.168.1.25`), and press `Enter`.
#. Click :guilabel:`Not secure` next to the search bar.
#. Go to :menuselection:`Connection not secure --> More information`.
#. Click :guilabel:`View certificate` in the :guilabel:`Security` tab, then
:guilabel:`Details`.
#. Select the certificate, click :guilabel:`Export`, then select a folder in your local
drive.
#. Click :guilabel:`Close`.
The self-signed certificate is generated. Reload the page and click :guilabel:`SSL/TLS`
in the :guilabel:`Security` section to ensure **Selfsigned Certificate** is correctly
selected in the :guilabel:`Server Certificate` section.
.. _pos/epos-ssc/certificate-import:
.. tab:: Export a self-signed certificate
Self-signed certificate import
------------------------------
The export process is heavily dependent on the :abbr:`OS (Operating System)` and the
browser. Start by accessing your ePOS printer settings on your web browser by navigating
to its IP address (e.g., `https://192.168.1.25`). Then, force the connection as
explained in the **Generate a self-signed certificate tab**.
The import process depends on the :abbr:`OS (Operating System)` and the browser.
If you are using **Google Chrome**,
.. tabs::
#. click :guilabel:`Not secure` next to the search bar, and :guilabel:`Certificate is
not valid`;
.. group-tab:: Windows 10
.. image:: epos_ssc/browser-warning.png
:alt: Connection to the printer not secure button in Google Chrome
To import a self-signed certificate from **Google Chrome**:
#. go to the :guilabel:`Details` tab and click :guilabel:`Export`;
#. add `.crt` at the end of the file name to ensure it has the correct extension;
#. select :guilabel:`Base64-encoded ASCII, single certificate`, at the bottom of the
pop-up window;
#. save, and the certificate is exported.
#. Open the browser.
#. Go to :menuselection:`Settings --> Privacy and security --> Security`, and click
:guilabel:`Manage certificates`.
#. Click :guilabel:`Manage imported certificates from Windows` on the :guilabel:`Certificate
Manager` page.
#. Click :guilabel:`Import` in the :guilabel:`Certificates` popover.
#. In the :guilabel:`Certificate Import Wizard`, click :guilabel:`Next`, then
:guilabel:`Browse` to select the certificate, and click :guilabel:`Next` again.
#. Select the :guilabel:`Place all certificates in the following store` option.
#. Click :guilabel:`Browse`, select the :guilabel:`Trusted Root Certification Authorities`
folder, and click :guilabel:`OK`.
#. Click :guilabel:`Next`, then :guilabel:`Finish`.
#. Click :guilabel:`Yes` in the :guilabel:`Security Warning` popover.
.. warning::
Make sure that the certificate ends with the extension `.crt`. Otherwise, some
browsers might not find the file during the import process.
.. note::
To import a self-signed certificate using **Mozilla Firefox** on Windows, see the steps in
the :guilabel:`Linux` tab.
If you are using **Mozilla Firefox**,
.. group-tab:: Linux
#. click the **lock-shaped** icon on the left of the address bar;
#. go to :menuselection:`Connection not secure --> More information --> Security tab
--> View certificate`;
.. tabs::
.. image:: epos_ssc/mozilla-not-secure.png
:alt: Connection is not secure button in Mozilla Firefox
.. tab:: Google Chrome
#. scroll down to the :guilabel:`Miscellaneous` section;
#. click :guilabel:`PEM (cert)` in the :guilabel:`Download` section;
#. save, and the certificate is exported.
To import a self-signed certificate, follow the next steps:
.. tab:: Android OS
#. Open the browser.
#. Go to :menuselection:`Settings --> Privacy and security --> Security`, and click
:guilabel:`Manage certificates`.
#. Click :guilabel:`Installed by you` under the :guilabel:`Custom` section on the
:guilabel:`Local certificates` tab.
#. Click :guilabel:`Import` next to :guilabel:`Trusted Certificates`, and select the
exported certification file from your local drive.
#. Accept all warnings.
#. Click :guilabel:`ok`.
To import an SSL certificate into an Android device, first create and export it from a
computer. Next, transfer the `.crt` file to the device using email, Bluetooth, or USB. Once
the file is on the device,
.. tab:: Mozilla Firefox
#. open the settings and search for `certificate`;
#. click :guilabel:`Certificate AC` (Install from device storage);
#. select the certificate file to install it on the device.
To import a self-signed certificate, follow the next steps:
.. Note::
The specific steps for installing a certificate may vary depending on the version of
Android and the device manufacturer.
#. Open the browser.
#. Go to :menuselection:`Settings --> Privacy & Security --> Security --> View
Certificates`.
#. In the :guilabel:`Certificate Manager` popover, click the :guilabel:`Your
Certificates` tab, then :guilabel:`Import`, and select the certificate in your local
drive.
#. Click the :guilabel:`Servers` tab in the :guilabel:`Certificate Manager` popover.
#. Click :guilabel:`Add Exception`.
#. Enter the printer's IP address in the :guilabel:`Location` field, then click
:guilabel:`Get Certificate`.
#. Enable the :guilabel:`Permanently store this exception` option and confirm.
.. tab:: iOS
.. group-tab:: Android OS
To import an SSL certificate into an iOS device, first create and export it from a computer.
Then, transfer the `.crt` file to the device using email, Bluetooth, or any file-sharing
service.
.. important::
The specific steps for installing a certificate may vary depending on the Android version
and the device manufacturer.
Downloading this file triggers a warning pop-up window. Click :guilabel:`Allow` to download
the configuration profile, and close the second pop-up window. Then,
To import a self-signed certificate into an Android device, first create and export it from a
computer. Then, transfer the `.crt` file to the device via email, Bluetooth, or USB. Once
the file is on the device, install the EPSON ePOS SDK for JavaScript if required, then follow
the next steps:
#. go to the **Settings App** on the iOS device;
#. click :guilabel:`Profile Downloaded` under the user's details box;
#. locate the downloaded `.crt` file and select it;
#. click :guilabel:`Install` on the top right of the screen;
#. if a passcode is set on the device, enter the passcode;
#. click :guilabel:`Install` on the top right of the certificate warning screen and the pop-up
window;
#. click :guilabel:`Done`.
#. Go to the device settings.
#. Type `certificate` in the search bar.
#. Click :guilabel:`Certificate AC`, then :guilabel:`Install from device storage`.
#. Select the certificate file to install it on the device.
.. image:: epos_ssc/ssl-ios-verified.png
.. note::
Download the certificate on a computer if the tablet restricts direct downloads. Forward
the file via email, then open it directly from the tablet to complete the installation.
The certificate is installed, but it still needs to be authenticated. To do so,
.. group-tab:: iOS
#. go to :menuselection:`Settings --> General --> About > Certificate Trust Settings`;
#. enable the installed certificate using the **slide button**;
#. click :guilabel:`Continue` on the pop-up window.
To import a self-signed certificate into an iOS device, first create and export it from a
computer. Then, transfer the `.crt` file to the device via email, Bluetooth, or any
file-sharing service.
.. important::
- If you need to export SSL certificates from an operating system or web browser that has not
been mentioned, search for `export SSL certificate` + `the name of your browser or operating
system` in your preferred search engine.
- Similarly, to import SSL certificates from an unmentioned OS or browser, search for `import SSL
certificate root authority` + `the name of your browser or operating system` in your preferred
search engine.
Downloading this file triggers a warning popover. Click :guilabel:`Allow` to download the
configuration profile, and close the second popover. Then follow the next steps:
Check if the certificate was imported correctly
===============================================
#. Go to the **Settings** app on the iOS device.
#. Click :guilabel:`Profile Downloaded` under the user's details box.
#. Locate the downloaded `.crt` file and select it.
#. Click :guilabel:`Install` in the top-right corner.
#. Enter a passcode if needed.
#. Click :guilabel:`Install` in the top-right corner of the certificate warning screen and
the popover.
#. Click :guilabel:`Done`.
To confirm your printer's connection is secure, connect to its IP address using HTTPS. For example,
navigate to `https://192.168.1.25` in your browser. If the SSL certificate has been applied
correctly, you should no longer see a warning page, and the address bar should display a padlock
icon, indicating that the connection is secure.
Once the certificate is installed, authenticate it as follows:
#. Go to :menuselection:`Settings --> General --> About > Certificate Trust Settings`.
#. Enable the installed certificate using the :icon:`fa-toggle-on` (switch) toggle.
#. Click :guilabel:`Continue` in the popover.
Certificate import verification
===============================
To confirm the printer's connection is secure, connect to its IP address using HTTPS. For example,
navigate to `https://192.168.1.25` in a browser. If the self-signed certificate has been applied
correctly, no warning page appears, and the address bar should display a padlock icon, indicating a
secure connection.

6
content/applications/sales/point_of_sale/hardware_network/pos_lna.rst
View File

@@ -19,8 +19,8 @@ Activation
==========
|LNA| is enabled by default and automatically used for compatible devices, such as
:ref:`ePOS printers <pos/epos_printers/supported-printers>`, when the :guilabel:`Use Local
Network Access` checkbox is enabled on the :ref:`printer form <pos/epos_printers/configuration>`.
:ref:`ePOS printers <pos/epos-printers/supported-printers>`, when the :guilabel:`Use Local
Network Access` checkbox is enabled on the :ref:`printer form <pos/epos-printers/configuration>`.
.. important::
The ePOS printer must have a **static IP address**; otherwise, it may become unreachable. The
@@ -30,7 +30,7 @@ Browser permission
==================
Once a device with local access, such as an :ref:`ePOS printer
<pos/epos_printers/supported-printers>`, is configured, the browser displays a popup requesting
<pos/epos-printers/supported-printers>`, is configured, the browser displays a popup requesting
permission to communicate with the devices on the local network.
.. image:: pos_lna/pos-lna.png

89
content/applications/sales/point_of_sale/hardware_network/receipt_printers.rst
View File

@@ -4,23 +4,46 @@
Receipt printers
================
ePOS printers are designed to integrate with Point of Sale systems and can receive print jobs
directly from the POS once they are properly configured and connected.
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.
.. _pos/epos_printers/configuration:
.. 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 :doc:`IoT system
</applications/general/iot/connect>`.
- ESC/POS printers that require a connection via an :doc:`IoT system
</applications/general/iot/connect>` using either a USB or network-based interface.
Bluetooth printers are not compatible with Odoo.
.. seealso::
- `Receipt printers without IoT (video tutorial)
<https://youtu.be/OUUi6N_xT-U?si=NZ9PPrsXDUcJ4kSy>`_
- `Receipt printers with IoT (video tutorial)
<https://youtu.be/ORojunUs5Bs?si=FrDJ0N-9f8SJlQrA>`_
.. _pos/epos-printers/configuration:
Configuration
=============
To use an ePos printer in Point of Sale:
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:
#. Go to :menuselection:`Point of Sale --> Configuration --> Settings`.
#. Scroll down to the :guilabel:`Connected Devices` section and enable :guilabel:`Receipt Printers`.
#. Click the :guilabel:`Printers` field, then select :guilabel:`Create`.
#. In the :guilabel:`Create Receipt Printers` popup, enter the printer's :guilabel:`Name`.
#. Specify the printer's purpose by selecting either :guilabel:`Preparation` or :guilabel:`Receipt`.
#. Set the :guilabel:`Printer Type` to :ref:`IP address <pos/epos_printers/supported-printers>` or
:ref:`IoT <pos/epos_printers/iot-supported-printers>`.
#. Set the :guilabel:`Printer Type` to :ref:`IP address <pos/epos-printers/supported-printers>` or
:ref:`IoT <pos/epos-printers/iot-supported-printers>`.
#. Depending on the selected :guilabel:`Printer Type`, enter the :guilabel:`Epson Printer IP
Address` or select the relevant :guilabel:`IoT Device`.
#. Enable :guilabel:`Use Local Network Access` to allow the printer to be detected through
@@ -28,11 +51,15 @@ To use an ePos printer in Point of Sale:
#. Click :guilabel:`Save`.
.. note::
- When the printer connects to a network, it automatically prints a receipt with its IP address.
- Once configured, printers can be managed from :menuselection:`Point of Sale -->
Configuration --> Printers`.
Once configured, printers can be managed from :menuselection:`Point of Sale --> Configuration
--> Printers`.
.. _pos/epos_printers/supported-printers:
.. seealso::
- :doc:`pos_lna`
- :doc:`epos_ssc`
- :doc:`/applications/general/iot/devices/printer`
.. _pos/epos-printers/supported-printers:
Directly supported ePOS printers
================================
@@ -44,15 +71,15 @@ Other Wi-Fi or Ethernet Epson printer models that support the **ePoS protocol**
compatible.
.. important::
- The ePoS printer must be capable of operating in HTTP mode.
- When using :doc:`Local Network Access (LNA) <pos_lna>`, the ePOS printer must have a **static
IP address**; otherwise, it may become unreachable. The static IP should be configured through
the router.
- The printer must be capable of operating in HTTP mode.
- When using :doc:`Local Network Access (LNA) <pos_lna>`, the printer must have a **static
IP address**; otherwise, it may become unreachable. The static IP should be configured
through the router.
.. _pos/epos_printers/iot-supported-printers:
.. _pos/epos-printers/iot-supported-printers:
ePOS printers with IoT system integration
=========================================
Printers with IoT system integration
====================================
The following printers require an :doc:`IoT system </applications/general/iot/devices/printer>` to
be compatible with Odoo:
@@ -61,18 +88,18 @@ be compatible with Odoo:
- Epson TM-T88 family (incompatible ePOS software)
- Epson TM-U220 family (incompatible ePOS software)
.. important::
- Epson printers using Wi-Fi/Ethernet connections and following the `EPOS SDK Javascript protocol
<https://download4.epson.biz/sec_pubs/pos/reference_en/technology/epson_epos_sdk.html>`_ are
compatible with Odoo **without** needing an :doc:`IoT system
</applications/general/iot/devices/printer>`.
- Thermal printers using ESC/POS are compatible **with** an :doc:`IoT system
</applications/general/iot/devices/printer>`.
- Epson printers using only USB connections are compatible **with** an :doc:`IoT system
</applications/general/iot/devices/printer>`.
- Epson printers that connect via Bluetooth are **not compatible**.
.. _pos/epos-printers/troubleshooting:
.. seealso::
- :doc:`pos_lna`
- :doc:`epos_ssc`
- :doc:`/applications/general/iot/devices/printer`
Troubleshooting
===============
To resolve common hardware issues, including connectivity failures, configuration errors, and
physical maintenance, follow the instructions below:
- 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.