centersl/odoo-docs
1
0
Fork 0
mirror of https://github.com/odoo/documentation.git synced 2026-03-26 13:59:55 +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#16680

Signed-off-by: Audrey Vandromme (auva) <auva@odoo.com>
This commit is contained in:
emmi-odoo
2026-02-25 11:18:24 +01:00
parent 41f79229ef
commit 6a5874f14f
3 changed files with 278 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 self-signed certificate is no longer required. The recommended approach is to use the
:doc:`Local Network Access <pos_lna>` method instead. :doc:`Local Network Access <pos_lna>` method instead.
To work with Odoo, some printer models that can be used without an To work with Odoo, some printer models that can be used without an :doc:`IoT system
:doc:`IoT system </applications/general/iot>` may require the HTTPS protocol to establish a secure </applications/general/iot>` may require the HTTPS protocol to establish a secure connection
connection between the browser and the printer. However, trying to reach the printer's IP address between the browser and the printer. However, trying to reach the printer's IP address using HTTPS
using HTTPS leads to a warning page on most web browsers. 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:: Generation, export, and import of self-signed certificates
:doc:`pos_lna` ==========================================================
Generate, export, and import self-signed certificates 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
For a long-term solution, you must generate a **self-signed certificate**. Then, export and import <pos/epos-ssc/certificate-import>` a self-signed certificate.
it into your browser.
.. important:: .. important::
**Generating** an SSL certificate should only be done **once**. If you create another - Generating a self-signed certificate should only be done **once**. Creating another
certificate, devices using the previous one will lose HTTPS access. 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:: .. 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:: .. 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 To export the certificate, follow the next steps:
connection by clicking :guilabel:`Advanced` and :guilabel:`Proceed to [IP address]
(unsafe)`.
.. figure:: epos_ssc/browser-https-insecure.png #. Once the printer's lights are solid, hover the mouse over the browser's search bar
:scale: 75% and click :guilabel:`Not secure`, then :guilabel:`Certificate details`.
:alt: warning page about the connection privacy on Google Chrome #. 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 To export the certificate, follow the next steps:
sign in, enter `epson` in the :guilabel:`ID` field and your printer serial number in the
:guilabel:`Password` field.
Click :guilabel:`Certificate List` in the :guilabel:`Authentication` section, and click #. Click :guilabel:`Not secure` next to the search bar.
:guilabel:`create` to generate a new **Self-Signed Certificate**. The :guilabel:`Common #. Go to :menuselection:`Connection not secure --> More information`.
Name` should be automatically filled out. If not, fill it in with the printer IP address #. Click :guilabel:`View certificate` in the :guilabel:`Security` tab, then
number. Select the years the certificate will be valid in the :guilabel:`Validity :guilabel:`Details`.
Period` field, click :guilabel:`Create`, and :guilabel:`Reset` or manually restart the #. Select the certificate, click :guilabel:`Export`, then select a folder in your local
printer. drive.
#. Click :guilabel:`Close`.
The self-signed certificate is generated. Reload the page and click :guilabel:`SSL/TLS` .. group-tab:: Mac OS
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,
.. tabs:: .. 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 To export the certificate, follow the next steps:
connection by clicking :guilabel:`Advanced` and :guilabel:`Proceed to [IP address]
(unsafe)`.
.. figure:: epos_ssc/browser-https-insecure.png #. Open the browser, type the printer's IP address in the search bar (e.g.,
:scale: 75% `https://192.168.1.25`), and press `Enter`.
:alt: Warning page about the connection privacy on Google Chrome #. 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 To export the certificate, follow the next steps:
sign in, enter `epson` in the :guilabel:`ID` field and your printer serial number in the
:guilabel:`Password` field.
Click :guilabel:`Certificate List` in the :guilabel:`Authentication` section, and click #. Open the browser, type the printer's IP address in the search bar (e.g.,
:guilabel:`create` to generate a new **Self-Signed Certificate**. The :guilabel:`Common `https://192.168.1.25`), and press `Enter`.
Name` should be automatically filled out. If not, fill it in with the printer IP address #. Click :guilabel:`Not secure` next to the search bar.
number. Select the years the certificate will be valid in the :guilabel:`Validity #. Go to :menuselection:`Connection not secure --> More information`.
Period` field, click :guilabel:`Create`, and :guilabel:`Reset` or manually restart the #. Click :guilabel:`View certificate` in the :guilabel:`Security` tab, then
printer. :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` .. _pos/epos-ssc/certificate-import:
in the :guilabel:`Security` section to ensure **Selfsigned Certificate** is correctly
selected in the :guilabel:`Server Certificate` section.
.. tab:: Export a self-signed certificate Self-signed certificate import
------------------------------
The export process is heavily dependent on the :abbr:`OS (Operating System)` and the The import process depends on the :abbr:`OS (Operating System)` and the browser.
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**, .. tabs::
#. click :guilabel:`Not secure` next to the search bar, and :guilabel:`Certificate is .. group-tab:: Windows 10
not valid`;
.. image:: epos_ssc/browser-warning.png To import a self-signed certificate from **Google Chrome**:
:alt: Connection to the printer not secure button in Google Chrome
#. go to the :guilabel:`Details` tab and click :guilabel:`Export`; #. Open the browser.
#. add `.crt` at the end of the file name to ensure it has the correct extension; #. Go to :menuselection:`Settings --> Privacy and security --> Security`, and click
#. select :guilabel:`Base64-encoded ASCII, single certificate`, at the bottom of the :guilabel:`Manage certificates`.
pop-up window; #. Click :guilabel:`Manage imported certificates from Windows` on the :guilabel:`Certificate
#. save, and the certificate is exported. 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:: .. note::
Make sure that the certificate ends with the extension `.crt`. Otherwise, some To import a self-signed certificate using **Mozilla Firefox** on Windows, see the steps in
browsers might not find the file during the import process. 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; .. tabs::
#. go to :menuselection:`Connection not secure --> More information --> Security tab
--> View certificate`;
.. image:: epos_ssc/mozilla-not-secure.png .. tab:: Google Chrome
:alt: Connection is not secure button in Mozilla Firefox
#. scroll down to the :guilabel:`Miscellaneous` section; To import a self-signed certificate, follow the next steps:
#. click :guilabel:`PEM (cert)` in the :guilabel:`Download` section;
#. save, and the certificate is exported.
.. 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 .. tab:: Mozilla Firefox
computer. Next, transfer the `.crt` file to the device using email, Bluetooth, or USB. Once
the file is on the device,
#. open the settings and search for `certificate`; To import a self-signed certificate, follow the next steps:
#. click :guilabel:`Certificate AC` (Install from device storage);
#. select the certificate file to install it on the device.
.. Note:: #. Open the browser.
The specific steps for installing a certificate may vary depending on the version of #. Go to :menuselection:`Settings --> Privacy & Security --> Security --> View
Android and the device manufacturer. 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. .. important::
Then, transfer the `.crt` file to the device using email, Bluetooth, or any file-sharing The specific steps for installing a certificate may vary depending on the Android version
service. and the device manufacturer.
Downloading this file triggers a warning pop-up window. Click :guilabel:`Allow` to download To import a self-signed certificate into an Android device, first create and export it from a
the configuration profile, and close the second pop-up window. Then, 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; #. Go to the device settings.
#. click :guilabel:`Profile Downloaded` under the user's details box; #. Type `certificate` in the search bar.
#. locate the downloaded `.crt` file and select it; #. Click :guilabel:`Certificate AC`, then :guilabel:`Install from device storage`.
#. click :guilabel:`Install` on the top right of the screen; #. Select the certificate file to install it on the device.
#. 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`.
.. 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`; To import a self-signed certificate into an iOS device, first create and export it from a
#. enable the installed certificate using the **slide button**; computer. Then, transfer the `.crt` file to the device via email, Bluetooth, or any
#. click :guilabel:`Continue` on the pop-up window. file-sharing service.
.. important:: Downloading this file triggers a warning popover. Click :guilabel:`Allow` to download the
- If you need to export SSL certificates from an operating system or web browser that has not configuration profile, and close the second popover. Then follow the next steps:
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.
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, Once the certificate is installed, authenticate it as follows:
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 #. Go to :menuselection:`Settings --> General --> About > Certificate Trust Settings`.
icon, indicating that the connection is secure. #. 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.

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

@@ -8,7 +8,7 @@ Local Network Access
is a security feature that limits a website's ability to send requests to servers on a local is a security feature that limits a website's ability to send requests to servers on a local
network. Access requires explicit user permission, which makes it possible to grant network access network. Access requires explicit user permission, which makes it possible to grant network access
to a specific web page. Using |LNA|, Odoo Point of Sale can communicate with devices with local to a specific web page. Using |LNA|, Odoo Point of Sale can communicate with devices with local
access, such as :ref:`supported ePOS printers <pos/epos_printers/supported-printers>`, directly access, such as :ref:`supported ePOS printers <pos/epos-printers/supported-printers>`, directly
from the browser and without requiring an :doc:`SSL certificate <epos_ssc>`. from the browser and without requiring an :doc:`SSL certificate <epos_ssc>`.
.. note:: .. note::
@@ -39,7 +39,7 @@ Browser permission
================== ==================
Once |LNA| is activated in Odoo and a device with local access, such as an :ref:`ePOS printer Once |LNA| is activated in Odoo and 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. permission to communicate with the devices on the local network.
.. image:: pos_lna/pos-lna.png .. image:: pos_lna/pos-lna.png

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

@@ -2,26 +2,54 @@
Receipt printers Receipt printers
================ ================
ePOS printers are designed to work seamlessly with Point of Sale systems. Once connected, these Receipt printers integrate with Point of Sale systems to receive print jobs directly from the POS.
devices automatically share information, allowing for direct printing of tickets from the POS system Once properly configured and connected, this integration enables automatic receipt printing for
to the ePOS printer. 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 :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 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.
#. :ref:`Access the POS settings <pos/use/settings>`. To link the printer with Point of Sale, follow the next steps:
#. Activate the :guilabel:`ePos Printer` feature.
#. Fill in the field with your ePos IP address.
.. image:: receipt_printers/setting.png #. Go to :menuselection:`Point of Sale --> Configuration --> Settings`.
:alt: setting to enable the ePos printer feature #. Scroll down to the :guilabel:`Connected Devices` section and enable :guilabel:`ePos Printers`.
#. Type the printer's IP address in the dedicated field.
#. Click :guilabel:`Save`.
.. note:: Enable the :doc:`pos_lna` to allow Point of Sale to communicate directly with the printer on the
When the printer connects to a network, it automatically prints a ticket with its IP address. same network. Alternatively, once the printer is connected to Odoo, ensure the connection is
secure and reliable by generating a :ref:`self-signed certificate <pos/epos-ssc/certificate>`.
.. _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 Directly supported ePOS printers
================================ ================================
@@ -33,15 +61,15 @@ Other Wi-Fi or Ethernet Epson printer models that support the **ePoS protocol**
compatible. compatible.
.. important:: .. important::
- The ePoS printer must be capable of operating in HTTP mode. - The 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 - 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 IP address**; otherwise, it may become unreachable. The static IP should be configured
the router. 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 The following printers require an :doc:`IoT system </applications/general/iot/devices/printer>` to
be compatible with Odoo: be compatible with Odoo:
@@ -50,17 +78,18 @@ be compatible with Odoo:
- Epson TM-T88 family (incompatible ePOS software) - Epson TM-T88 family (incompatible ePOS software)
- Epson TM-U220 family (incompatible ePOS software) - Epson TM-U220 family (incompatible ePOS software)
.. important:: .. _pos/epos-printers/troubleshooting:
- 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**.
.. seealso:: Troubleshooting
- :doc:`pos_lna` ===============
- :doc:`epos_ssc`
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.