diff --git a/content/applications/sales/point_of_sale/hardware_network/epos_ssc.rst b/content/applications/sales/point_of_sale/hardware_network/epos_ssc.rst index 032267393d..413ff0e3eb 100644 --- a/content/applications/sales/point_of_sale/hardware_network/epos_ssc.rst +++ b/content/applications/sales/point_of_sale/hardware_network/epos_ssc.rst @@ -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 ` method instead. -To work with Odoo, some printer models that can be used without an -:doc:`IoT system ` 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 +` 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 ` still require secure +communication, which can be achieved by :ref:`generating `, +:ref:`exporting `, and/or :ref:`importing +` 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 ` 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 + `_ 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. diff --git a/content/applications/sales/point_of_sale/hardware_network/pos_lna.rst b/content/applications/sales/point_of_sale/hardware_network/pos_lna.rst index 203d80d52a..a11fd92bae 100644 --- a/content/applications/sales/point_of_sale/hardware_network/pos_lna.rst +++ b/content/applications/sales/point_of_sale/hardware_network/pos_lna.rst @@ -19,8 +19,8 @@ Activation ========== |LNA| is enabled by default and automatically used for compatible devices, such as -:ref:`ePOS printers `, when the :guilabel:`Use Local -Network Access` checkbox is enabled on the :ref:`printer form `. +:ref:`ePOS printers `, when the :guilabel:`Use Local +Network Access` checkbox is enabled on the :ref:`printer form `. .. 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 -`, is configured, the browser displays a popup requesting +`, is configured, the browser displays a popup requesting permission to communicate with the devices on the local network. .. image:: pos_lna/pos-lna.png diff --git a/content/applications/sales/point_of_sale/hardware_network/receipt_printers.rst b/content/applications/sales/point_of_sale/hardware_network/receipt_printers.rst index fc4fca1af6..50be63b91a 100644 --- a/content/applications/sales/point_of_sale/hardware_network/receipt_printers.rst +++ b/content/applications/sales/point_of_sale/hardware_network/receipt_printers.rst @@ -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 + `. + - ESC/POS printers that require a connection via an :doc:`IoT system + ` using either a USB or network-based interface. + + Bluetooth printers are not compatible with Odoo. + +.. seealso:: + - `Receipt printers without IoT (video tutorial) + `_ + - `Receipt printers with IoT (video tutorial) + `_ + +.. _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 ` or - :ref:`IoT `. +#. Set the :guilabel:`Printer Type` to :ref:`IP address ` or + :ref:`IoT `. #. 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) `, 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) `, 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 ` 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 - `_ are - compatible with Odoo **without** needing an :doc:`IoT system - `. - - Thermal printers using ESC/POS are compatible **with** an :doc:`IoT system - `. - - Epson printers using only USB connections are compatible **with** an :doc:`IoT system - `. - - 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.