diff --git a/content/applications/sales/point_of_sale/overview.rst b/content/applications/sales/point_of_sale/overview.rst index 70b431ba9..b4c35aa27 100644 --- a/content/applications/sales/point_of_sale/overview.rst +++ b/content/applications/sales/point_of_sale/overview.rst @@ -10,3 +10,4 @@ Overview overview/getting_started overview/register overview/https + overview/epos_ssc diff --git a/content/applications/sales/point_of_sale/overview/epos_ssc.rst b/content/applications/sales/point_of_sale/overview/epos_ssc.rst new file mode 100644 index 000000000..a3faa12a1 --- /dev/null +++ b/content/applications/sales/point_of_sale/overview/epos_ssc.rst @@ -0,0 +1,91 @@ +========================================= +Self-signed certificate for ePOS printers +========================================= + +ePos printers are designed specifically to work with your Point of Sale system, which sends the +tickets directly to the printer. + +Some models don't require an IoT box, but the connection between your web browser and the printer +may require a :doc:`secure connection with the HTTPS protocol `. If so, a self-signed +certificate is necessary to use your printer. + +.. note:: + Please check the following list of compatible `Epson ePOS printers + `_. This list includes the + following models: + + - TM-H6000IV-DT (Receipt printer only) + - TM-T70II-DT + - TM-T88V-DT + - TM-L90-i + - TM-T20II-i + - TM-T70-i + - TM-T82II-i + - TM-T83II-i + - TM-T88V-i + - TM-U220-i + - TM-m10 + - TM-m30 + - TM-P20 (Wi-Fi® model) + - TM-P60II (Receipt: Wi-Fi® model) + - TM-P60II (Peeler: Wi-Fi® model) + - TM-P80 (Wi-Fi® model) + +Generate a Self-signed certificate +================================== + +Access your ePOS printer's settings with your web browser by navigating to its IP address, for +example, `http://192.168.1.25`. + +.. note:: + - The printer automatically prints the IP address during startup. + - We recommend assigning a **fixed IP address** to the printer from the network router. + +Go to :menuselection:`Authentication --> Certificate List` and create a new **Self-Signed +Certificate**. + +- **Common Name**: the IP address of the ePos Printer, for example, `192.168.1.25` +- **Validity Period**: `10` + +Create and reboot the printer, go to :menuselection:`Security --> SSL/TLS`, and check if +**Selfsigned Certificate** is selected. + +Export the Self-signed certificate +================================== + +To avoid having to accept the self-signed certificate several times, you can export it and then +import it to your web browser or mobile device. + +To do so, access your ePOS printer's settings with your web browser by navigating to its IP address, +for example, `https://192.168.1.25`. Then, accept the self-signed certificate. + +.. note:: + Note that the protocol is now **HTTPS**. + +Click on :menuselection:`Not secure --> Certificate is not valid`. + +.. image:: epos_ssc/browser-warning.png + :align: center + :alt: The web browser indicates that the connection to the printer is not secure. + +Go to the *Details* tab and click on **Export**. + +.. image:: epos_ssc/certificate-details.png + :align: center + :alt: Details of the ePOS printer certificate + +Import the Self-signed certificate to your browser (Chrome) +=========================================================== + +In your Chrome browser, go to :menuselection:`Settings --> Privacy and security --> Security --> +Manage certificates`, then open the *Authorities* tab, click on **Import**, and select all +functionalities of the certificate. + +.. tip:: + You can directly access these settings by navigating to `chrome://settings/certificates`. + +Import the Self-signed certificate to your Android device +========================================================= + +On your Android device, open the settings and search for *certificate*. Then, click on **Certificate +AC** (Install from device storage), and select the certificate. diff --git a/content/applications/sales/point_of_sale/overview/epos_ssc/browser-warning.png b/content/applications/sales/point_of_sale/overview/epos_ssc/browser-warning.png new file mode 100644 index 000000000..380da8b0c Binary files /dev/null and b/content/applications/sales/point_of_sale/overview/epos_ssc/browser-warning.png differ diff --git a/content/applications/sales/point_of_sale/overview/epos_ssc/certificate-details.png b/content/applications/sales/point_of_sale/overview/epos_ssc/certificate-details.png new file mode 100644 index 000000000..700299968 Binary files /dev/null and b/content/applications/sales/point_of_sale/overview/epos_ssc/certificate-details.png differ diff --git a/content/applications/sales/point_of_sale/overview/https.rst b/content/applications/sales/point_of_sale/overview/https.rst index b25e8ca61..73af98af7 100644 --- a/content/applications/sales/point_of_sale/overview/https.rst +++ b/content/applications/sales/point_of_sale/overview/https.rst @@ -16,4 +16,7 @@ Technical --> Parameters --> System Parameters`, then create a new parameter, ad values and click on *Save*. - **Key**: `point_of_sale.enforce_https` -- **Value**: `True` \ No newline at end of file +- **Value**: `True` + +.. seealso:: + - :doc:`epos_ssc` \ No newline at end of file