[MOV] documentation structure reorganization

This commit aims to improve the documentation's navigability by redefining some categories' purposes and titles. There is a redirection rule for each documentation page moved. This ensures that users won't have a 404 error message. task-3217827 closes odoo/documentation#8063 Signed-off-by: Jonathan Castillo (jcs) <jcs@odoo.com>
2024-03-04 12:02:08 +01:00
parent af91b7c2b6
commit bf7fa31503
562 changed files with 644 additions and 643 deletions
@@ -0,0 +1,58 @@
+===============
+Connect a scale
+===============
+
+A scale can be connected to the :abbr:`IoT (Internet of Things)` box on an Odoo database in a few
+easy steps. After setup, the *Point of Sale* app can be used to weigh products, which is helpful if
+their prices are calculated based on weight.
+
+Connection
+==========
+
+To link the scale to the :abbr:`IoT (Internet of Things)` box, connect it with a :abbr:`USB
+(Universal Serial Bus)` cable.
+
+.. note::
+   In some cases, a serial port to :abbr:`USB (Universal Serial Bus)` adapter may be needed.
+
+If the scale is `compatible with Odoo IoT Box <https://www.odoo.com/page/iot-hardware>`_, there is
+no need to set up anything because it will be automatically detected as soon as it is connected.
+
+.. image:: scale/iot-choice.png
+   :align: center
+   :alt: IOT box auto detection.
+
+The :abbr:`IoT (Internet of Things)` box may need to be restarted and the scale's drivers may need
+to be downloaded to the box in some cases. To update the drivers, go to the :abbr:`IoT (Internet of
+Things)` box homepage and click on :guilabel:`Drivers List`. Then, click on :guilabel:`Load
+Drivers`.
+
+.. image:: scale/driver-list.png
+   :align: center
+   :alt: View of the IoT box settings and driver list.
+
+If loading the drivers still doesn't allow for the scale to function, it may be that the scale is
+not compatible with the Odoo :abbr:`IoT (Internet of Things)` box. In this case, a different scale
+will need to be used.
+
+Use a scale in a point of sale (POS) system
+===========================================
+
+To use the scale in the *Point of Sale app*, go to :menuselection:`PoS app --> 3-Dot Menu on the PoS
+--> Settings`, then enable the :abbr:`IoT (Internet of Things)` box feature. After this is complete,
+the scale device can be set.
+
+Select the scale from the :guilabel:`Electronic Scale` drop-down menu. Then click :guilabel:`Save`
+to save the changes, if required.
+
+.. image:: scale/electronic-scale-feature.png
+   :align: center
+   :alt: List of the external tools that can be used with PoS and the IoT box.
+
+The scale is now available in all the :abbr:`PoS (Point of Sale)` sessions. Now, if a product has a
+price per weight set, clicking on it on the :guilabel:`PoS` screen opens the scale screen, where the
+cashier can weigh the product and add the correct price to the cart.
+
+.. image:: scale/scale-view.png
+   :align: center
+   :alt: Electronic Scale dashboard view when no items are being weighed.