[IMP] Pos: iot six module part added to the six doc

This PR adds the documentation for a new Pos IoT Six module which will
soon replace the old Six module.

task-3555605

closes odoo/documentation#6435

X-original-commit: bc98b8c491
Signed-off-by: Yaroslav Soroko (yaso) <yaso@odoo.com>
Co-authored-by: Yaroslav Soroko (yaso) <yaso@odoo.com>
Co-authored-by: Loredana Perazzo <lrpz@odoo.com>

content/applications/sales/point_of_sale/payment_methods/terminals/six.rst

@@ -2,56 +2,83 @@
 SIX
 ===
 
-Connecting a SIX payment terminal allows you to offer a fluid payment flow to your customers and
+Connecting a **SIX payment terminal** allows you to offer a fluid payment flow to your customers and
 ease the work of your cashiers.
 
 .. warning::
-   - Starting in July 2022, it will **not** be possible anymore to connect and use a Six payment
-     terminal in PoS.
-   - Even though Worldline has recently acquired SIX Payment Services and both companies use Yomani
-     payment terminals, the firmware they run is different. Terminals received from Worldline are
-     therefore not compatible with this integration.
+   Even though Worldline has acquired SIX Payment Services and both companies use Yomani payment
+   terminals, the firmware they run is different. Terminals received from Worldline are, therefore,
+   not compatible with this integration.
 
 Configuration
 =============
 
-Configure the Payment Method
+Install the POS IoT Six module
+------------------------------
+
+To activate the POS IoT Six module, go to :guilabel:`Apps`, remove the :guilabel:`Apps` filter, and
+search for **POS IoT Six**. This module adds the necessary driver and interface to your database to
+detect Six terminals.
+
+.. note::
+   This module replaces the **POS Six** module.
+
+Connect an IoT box
+------------------
+
+Connecting a Six payment terminal to Odoo is requires :doc:`using a Raspberry Pi or virtual (for
+Windows OS only) IoT box </applications/productivity/iot/config/connect>`.
+
+Configure the terminal ID
+-------------------------
+
+Navigate to your IoT Box homepage, where you can find the  :guilabel:`Six payment terminal` field
+once your database server is connected to the IoT box. Click :guilabel:`Configure`, fill in the
+:guilabel:`Terminal ID` field with the ID received from Six, and click :guilabel:`Connect`. Your
+Six terminal ID should appear in the :guilabel:`Current Terminal Id` section.
+
+.. image:: six/terminal-id.png
+   :alt: Setting the Six terminal ID
+
+Odoo automatically restarts the IoT box when the Six terminal ID is configured. If your Six terminal
+is online, it will be automatically detected and connected to the database. Check the IoT box
+homepage under the :guilabel:`Payments` section to confirm the connection.
+
+.. image:: six/id-configured.png
+   :alt: Confirming the connection to the Six payment terminal
+
+.. _six/configure:
+
+Configure the payment method
 ----------------------------
 
-First, make sure that the :guilabel:`POS Six` module is installed. For this, go to
-:guilabel:`Apps`, remove the :guilabel:`Apps` filter, and search for *POS Six*.
-
-.. image:: six/pos-six-module.png
-   :align: center
-   :alt: The POS Six module.
-
-Back in :menuselection:`Point of Sale --> Configuration --> Payment Methods`, click
-:guilabel:`Create` to create a new payment method for SIX, select the payment terminal option
-:guilabel:`SIX`, and enter the payment terminal IP address.
+From your database, go to :menuselection:`Point of Sale --> Configuration --> Payment Methods` to
+create a new payment method specifically for Six. Click :guilabel:`New`, enter a :guilabel:`Name`,
+set the :guilabel:`Journal` field as :guilabel:`Bank`, the :guilabel:`Use a Payment Terminal` field
+as :guilabel:`SIX IOT`, and select the corresponding device in the :guilabel:`Payment Terminal
+Device` field.
 
 .. image:: six/new-payment-method.png
-   :align: center
-   :alt: Create a new payment method for the SIX payment terminal.
+   :alt: Creating a new payment method for the SIX payment terminal
 
-Pay with a Payment Terminal
+Pay with a payment terminal
 ===========================
 
-In the :abbr:`PoS (Point of Sale)` interface, at the moment of the payment, select a payment method
-using a payment terminal. Verify that the amount in the tendered column is the one that has to be
-sent to the payment terminal and click on :guilabel:`Send`. To cancel the payment request, click on
-:guilabel:`Cancel`.
+When processing a payment, select :ref:`your Six payment method <six/configure>` in the
+:guilabel:`Payment Method` section and click :guilabel:`Send`. To cancel the payment request, click
+:guilabel:`Cancel`. Once the payment is successful, the status switches to :guilabel:`Payment
+Successful`.
 
-.. image:: six/pos-send-payment.png
-   :align: center
-   :alt: The PoS interface.
+.. image:: six/payment.png
+   :alt: Paying with Six
 
-When the payment is done, the status will change to :guilabel:`Payment Successful`. If needed,
-reverse the last transaction by clicking on :guilabel:`Reverse`.
+.. note::
+   - Once your payment is processed, the type of card used and the transaction ID appear on the
+     payment record.
+   - The language used for error messages is the same as the Six terminal. Configure the terminal to
+     change the language or contact Six.
+   - By default, the port used by the Six terminal is `7784`.
 
-.. image:: six/pos-reverse-payment.png
-   :align: center
-   :alt: The Reverse button on the PoS interface.
-
-If there is any issue with the payment terminal, you can still force the payment using the
-:guilabel:`Force Done` button. This will allow you to validate the order in Odoo even if there are
-connection issues between the payment terminal and Odoo.
+.. tip::
+   If there are connection issues between the payment terminal and Odoo, you can still force the
+   payment validation in Odoo using the :guilabel:`Force Done` button.