Skip to content

[ADD] POS: Scale certification content #13792

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: 18.0
Choose a base branch
from
Open
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
13 changes: 5 additions & 8 deletions content/applications/general/iot/devices/scale.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,9 @@ Connect a scale
===============

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

To connect a scale to the IoT system, use a USB cable. In some cases, you may need a serial-to-US
adapter to complete the connection. If the scale is `compatible with an IoT system
Expand All @@ -33,7 +29,8 @@ settings:
#. Click :guilabel:`Save`.

.. seealso::
:doc:`Connect an IoT system to a POS </applications/sales/point_of_sale/configuration/pos_iot>`
- :doc:`Connect an IoT system to a POS </applications/sales/point_of_sale/configuration/pos_iot>`
- :ref:`Configure a POS for a scale <pos/scale>`

The scale is then available in all the :doc:`POS's sessions </applications/sales/point_of_sale>`.
If a product is configured with a price per weight, selecting it on the :guilabel:`PoS screen` opens
Expand Down
1 change: 1 addition & 0 deletions content/applications/sales/point_of_sale.rst
Original file line number Diff line number Diff line change
Expand Up @@ -209,6 +209,7 @@ To get an overview of all orders, regardless of the session, click the vertical
:titlesonly:

point_of_sale/configuration
point_of_sale/pos_hardware
point_of_sale/employee_login
point_of_sale/receipts_invoices
point_of_sale/preparation
Expand Down
108 changes: 108 additions & 0 deletions content/applications/sales/point_of_sale/pos_hardware.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,108 @@
========
Hardware
========

Odoo Point of Sale supports integration with a variety of hardware, including :doc:`payment
terminals <payment_methods/terminals>` and cash drawers, as well as :doc:`customer displays
<shop/customer_display>`, :ref:`scales <pos/scale>`, :doc:`barcode scanners <shop/barcode>`,
:doc:`ePOS printers <configuration/epos_printers>`, and in-store :doc:`electronic shelf labels
<pricing/electronic_labels>`.

.. _pos/scale:

Scale
=====

.. important::
In EU member states, `certification is legally required
<https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=uriserv%3AOJ.L_.2014.096.01.0107.01.ENG>`_
to use a scale as an integrated device.

Prerequisite
------------

Connecting a scale requires the use of an **IoT System**.

.. seealso::
- :doc:`../../general/iot/connect`
- :doc:`../../general/iot/devices/scale`

Configuration
-------------

Scale connection
~~~~~~~~~~~~~~~~

#. :ref:`Access the POS settings <configuration/settings>` and select the POS, or click the
:icon:`fa-ellipsis-v` (:guilabel:`vertical ellipsis`) icon on a POS card and click
:guilabel:`Edit`.
#. Scroll down to the :guilabel:`Connected Devices` section and enable :guilabel:`IoT Box`.
#. Select the scale in the :guilabel:`Electronic Scale` field.
#. Click :guilabel:`Save`.

Product configuration
~~~~~~~~~~~~~~~~~~~~~

#. Go to :menuselection:`Inventory --> Configuration --> Settings`.
#. Scroll down to the :guilabel:`Products` section and activate :guilabel:`Units of Measure`.
#. Go to :menuselection:`Point of Sale --> Products --> Products`.
#. Select a product to weigh.
#. Ensure the :guilabel:`Point of Sale` checkbox is activated for the product to be available in
POS.
#. Go to the :guilabel:`Point of Sale` tab and activate :guilabel:`To Weigh With Scale`. This
enables the product to be weighed directly on the connected scale at the POS.
#. Return to the :guilabel:`General Information` tab and set a :guilabel:`Sales Price` per
:guilabel:`kg`.

.. important::
The selected unit of measure for weighable products must be :guilabel:`kg` to ensure compliance
with **European regulations**.

.. seealso::
:doc:`../../inventory_and_mrp/inventory/product_management/configure/uom`

European regulations
--------------------

As scales used in commercial transactions are certified, Odoo must adhere to specific European
requirements. If the database does not meet these European regulations, a distinct
:icon:`fa-balance-scale` (:guilabel:`red scale`) icon displays prominently in red.

Click this red icon opens to modal window that explains the reasons for non-compliance. To
automatically implement the necessary changes to the Odoo settings and achieve compliance, click
:guilabel:`Apply changes`. Once the database meets regulatory requirements, the
:icon:`fa-balance-scale` (:guilabel:`scale`) icon turns green, indicating full compliance.

.. image:: pos_hardware/legal-requirements.png
:scale: 75 %

.. note::
.. raw:: html

Once the database complies with the <b>European regulation</b>,
<i class="fa fa-balance-scale" style="color:#d9555c;"></i> <i class="fa fa-arrow-right"></i>
<i class="fa fa-balance-scale" style="color:#008818;"></i>

Additional guidelines
~~~~~~~~~~~~~~~~~~~~~

:doc:`The customer display <shop/customer_display>` and POS display must each be at least 6 inches.
However, we recommend using a larger screen for better end-user readability.

Usage guideline
---------------

#. :ref:`Open a POS session <pos/session-start>`.
#. Select the product to weigh on the POS interface or scan its barcode, which opens a modal window.
#. Place the product on the scale and wait for the weight to be displayed.
#. Once the weight is determined, the price is automatically computed.
#. Click :guilabel:`Order` :icon:`fa-angle-double-right` to add the product to the cart.
#. Remove the previous product to weigh a second item.

.. image:: pos_hardware/weigh.png
:alt: weighing window
:scale: 85 %

.. important::
Make sure the scale returns to `zero` before weighing a new product. If it does not, the
:guilabel:`Order` :icon:`fa-angle-double-right` button remains unclickable until it is reset.
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.