Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions content/applications/sales/point_of_sale/overview.rst
Original file line number Diff line number Diff line change
Expand Up @@ -10,3 +10,4 @@ Overview
overview/getting_started
overview/register
overview/https
overview/epos_ssc
91 changes: 91 additions & 0 deletions content/applications/sales/point_of_sale/overview/epos_ssc.rst
Original file line number Diff line number Diff line change
@@ -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 <https>`. If so, a self-signed
certificate is necessary to use your printer.

.. note::
Please check the following list of compatible `Epson ePOS printers
<https://c4b.epson-biz.com/modules/community/index.php?content_id=91>`_. 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.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
5 changes: 4 additions & 1 deletion content/applications/sales/point_of_sale/overview/https.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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`
- **Value**: `True`

.. seealso::
- :doc:`epos_ssc`