Skip to content

Commit 4b1e13a

Browse files
committed
[ADD] POS: Scale certification content
task-4893590 closes #14235 X-original-commit: 927c7ae Signed-off-by: Loredana Perazzo (lrpz) <lrpz@odoo.com>
1 parent a787316 commit 4b1e13a

File tree

6 files changed

+115
-24
lines changed

6 files changed

+115
-24
lines changed

content/applications/general/iot/devices/scale.rst

Lines changed: 4 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -3,13 +3,9 @@ Connect a scale
33
===============
44

55
.. important::
6-
- In EU member states, `certification is legally required
7-
<https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=uriserv%3AOJ.L_.2014.096.01.0107.01.ENG>`_
8-
to use a scale as an integrated device.
9-
- Odoo is not certified in several countries, including France, Germany, and Switzerland. If you
10-
reside in one of these countries, you can still use a scale but without integration into your
11-
Odoo database. Alternatively, you can acquire a *non-integrated* certified scale that prints
12-
certified labels, which can then be scanned into your Odoo database.
6+
In EU member states, `certification is legally required
7+
<https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=uriserv%3AOJ.L_.2014.096.01.0107.01.ENG>`_
8+
to use a scale as an integrated device.
139

1410
To connect a scale to the IoT system, use a USB cable. In some cases, you may need a serial-to-US
1511
adapter to complete the connection. If the scale is `compatible with an IoT system
@@ -23,27 +19,11 @@ scale's drivers <iot_updating_iot/handlers>`.
2319
the Odoo IoT system <https://www.odoo.com/page/iot-hardware>`_. In such cases, a different scale
2420
must be used.
2521

26-
Once the scale is connected to the IoT system, follow these steps to configure it in the POS
27-
settings:
28-
29-
#. :ref:`Access the POS settings <configuration/settings>` and select your POS, or click the
30-
vertical ellipsis button (:guilabel:``) on a POS card and click :guilabel:`Edit`.
31-
#. Scroll down to the :guilabel:`Connected Devices` section and enable :guilabel:`IoT Box`.
32-
#. Select the scale in the :guilabel:`Electronic Scale` field.
33-
#. Click :guilabel:`Save`.
22+
Once the scale is connected to the IoT system, :ref:`configure it in the POS settings <pos/scale>`.
3423

3524
.. seealso::
3625
:doc:`Connect an IoT system to a POS </applications/sales/point_of_sale/configuration/pos_iot>`
3726

38-
The scale is then available in all the :doc:`POS's sessions </applications/sales/point_of_sale>`.
39-
If a product is configured with a price per weight, selecting it on the :guilabel:`PoS screen` opens
40-
the scale popup. The cashier can then weigh the product to automatically add the correct price to
41-
the cart.
42-
43-
.. image:: scale/scale-view.png
44-
:scale: 80%
45-
:alt: Electronic Scale dashboard view when no items are being weighed.
46-
4727
Ariva S scales
4828
==============
4929

Binary file not shown.

content/applications/sales/point_of_sale.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -212,6 +212,7 @@ To get an overview of all orders, regardless of the session, click the vertical
212212
:titlesonly:
213213

214214
point_of_sale/configuration
215+
point_of_sale/pos_hardware
215216
point_of_sale/employee_login
216217
point_of_sale/receipts_invoices
217218
point_of_sale/preparation
Lines changed: 110 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,110 @@
1+
========
2+
Hardware
3+
========
4+
5+
Odoo Point of Sale supports integration with a variety of hardware, including :doc:`payment
6+
terminals <payment_methods/terminals>` and cash drawers, as well as :doc:`customer displays
7+
<shop/customer_display>`, :ref:`scales <pos/scale>`, :doc:`barcode scanners <shop/barcode>`,
8+
:doc:`ePOS printers <configuration/epos_printers>`, and in-store :doc:`electronic shelf labels
9+
<pricing/electronic_labels>`.
10+
11+
.. _pos/scale:
12+
13+
Scale
14+
=====
15+
16+
.. important::
17+
In EU member states, `certification is legally required
18+
<https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=uriserv%3AOJ.L_.2014.096.01.0107.01.ENG>`_
19+
to use a scale as an integrated device.
20+
21+
Prerequisite
22+
------------
23+
24+
Connecting a scale requires the use of an **IoT System**.
25+
26+
.. seealso::
27+
- :doc:`../../general/iot/connect`
28+
- :doc:`../../general/iot/devices/scale`
29+
30+
Configuration
31+
-------------
32+
33+
Scale connection
34+
~~~~~~~~~~~~~~~~
35+
36+
#. :ref:`Access the POS settings <configuration/settings>`.
37+
#. Scroll down to the :guilabel:`Connected Devices` section and enable :guilabel:`IoT Box`.
38+
#. Select the scale in the :guilabel:`Electronic Scale` field.
39+
#. Click :guilabel:`Save`.
40+
41+
.. tip::
42+
Alternatively, click the :icon:`fa-ellipsis-v` (:guilabel:`Dropdown menu`) icon on a POS card and
43+
click :guilabel:`Edit` to access this setting.
44+
45+
Product configuration
46+
~~~~~~~~~~~~~~~~~~~~~
47+
48+
In order to weigh products using an integrated scale, go to :menuselection:`Point of Sale -->
49+
Products --> Products`, create a product or open an existing product form, and configure it as
50+
follows:
51+
52+
#. Ensure the :guilabel:`Point of Sale` checkbox is activated for the product to be available in
53+
POS.
54+
#. On the :guilabel:`General Information` tab, define a :guilabel:`Sales Price` per :guilabel:`kg`.
55+
56+
.. note::
57+
This step requires to enable the :doc:`Units of Measure
58+
<../../inventory_and_mrp/inventory/product_management/configure/uom>` feature. To activate it:
59+
60+
#. Go to :menuselection:`Inventory --> Configuration --> Settings`.
61+
#. Scroll down to the :guilabel:`Products` section and activate :guilabel:`Units of Measure`.
62+
#. Go to the :guilabel:`Point of Sale` tab and activate :guilabel:`To Weigh With Scale`. This
63+
enables the product to be weighed directly on the connected scale at the POS.
64+
65+
.. important::
66+
The selected unit of measure for weighable products must be :guilabel:`kg` to ensure compliance
67+
with **European regulations**.
68+
69+
.. seealso::
70+
:doc:`../../inventory_and_mrp/inventory/product_management/configure/uom`
71+
72+
European regulations
73+
--------------------
74+
75+
When using scales in commercial transactions, the database integrated with a scale must be
76+
configured to meet specific European requirements. This includes supporting at least three decimal
77+
places for accuracy and using proper rounding for units of measure, such as `kg` instead of generic
78+
`units`.
79+
80+
If the database is not compliant, a red :icon:`fa-balance-scale` (:guilabel:`scale`) icon displays
81+
as a warning. Click this icon to view the reasons for non-compliance and then select
82+
:guilabel:`Apply changes` to automatically apply the necessary changes to the settings. Once the
83+
database meets all regulatory requirements, the :icon:`fa-balance-scale` (:guilabel:`scale`) icon
84+
turns green.
85+
86+
.. image:: pos_hardware/legal-requirements.png
87+
:scale: 75 %
88+
89+
.. admonition:: Additional guidelines
90+
91+
Both the :doc:`customer <shop/customer_display>` and POS displays must have a minimum diagonal
92+
size of 6 inches. For optimal readability, larger screens are recommended.
93+
94+
Using a scale in PoS
95+
--------------------
96+
97+
#. :ref:`Open a POS session <pos/session-start>`.
98+
#. Select the product to weigh on the order screen or scan its barcode.
99+
#. Place the product on the scale and wait for the weight to be displayed in the popup window.
100+
#. Once the weight is determined, the price is automatically computed.
101+
#. Click :guilabel:`Order` :icon:`fa-angle-double-right` to add the product to the cart.
102+
#. Remove the previous product from the scale.
103+
104+
.. image:: pos_hardware/weigh.png
105+
:alt: weighing window
106+
:scale: 85 %
107+
108+
.. important::
109+
Make sure the scale returns to `zero` before weighing a new product. If it does not, the
110+
:guilabel:`Order` :icon:`fa-angle-double-right` button remains unclickable until it is reset.
15.7 KB
Loading
6.38 KB
Loading

0 commit comments

Comments
 (0)