diff --git a/content/applications/general/iot/devices/scale.rst b/content/applications/general/iot/devices/scale.rst index 371dfbb033..eaae14fe2e 100644 --- a/content/applications/general/iot/devices/scale.rst +++ b/content/applications/general/iot/devices/scale.rst @@ -3,13 +3,9 @@ Connect a scale =============== .. important:: - - In EU member states, `certification is legally required - `_ - 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 + `_ + 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 @@ -33,7 +29,8 @@ settings: #. Click :guilabel:`Save`. .. seealso:: - :doc:`Connect an IoT system to a POS ` + - :doc:`Connect an IoT system to a POS ` + - :ref:`Configure a POS for a scale ` The scale is then available in all the :doc:`POS's sessions `. If a product is configured with a price per weight, selecting it on the :guilabel:`PoS screen` opens diff --git a/content/applications/sales/point_of_sale.rst b/content/applications/sales/point_of_sale.rst index 79162e3ad9..49b6e92312 100644 --- a/content/applications/sales/point_of_sale.rst +++ b/content/applications/sales/point_of_sale.rst @@ -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 diff --git a/content/applications/sales/point_of_sale/pos_hardware.rst b/content/applications/sales/point_of_sale/pos_hardware.rst new file mode 100644 index 0000000000..bb8e650dfc --- /dev/null +++ b/content/applications/sales/point_of_sale/pos_hardware.rst @@ -0,0 +1,108 @@ +======== +Hardware +======== + +Odoo Point of Sale supports integration with a variety of hardware, including :doc:`payment +terminals ` and cash drawers, as well as :doc:`customer displays +`, :ref:`scales `, :doc:`barcode scanners `, +:doc:`ePOS printers `, and in-store :doc:`electronic shelf labels +`. + +.. _pos/scale: + +Scale +===== + +.. important:: + In EU member states, `certification is legally required + `_ + 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 ` 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 European regulation, + + + +Additional guidelines +~~~~~~~~~~~~~~~~~~~~~ + +:doc:`The 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 `. +#. 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. diff --git a/content/applications/sales/point_of_sale/pos_hardware/legal-requirements.png b/content/applications/sales/point_of_sale/pos_hardware/legal-requirements.png new file mode 100644 index 0000000000..c45c9e4d1f Binary files /dev/null and b/content/applications/sales/point_of_sale/pos_hardware/legal-requirements.png differ diff --git a/content/applications/sales/point_of_sale/pos_hardware/weigh.png b/content/applications/sales/point_of_sale/pos_hardware/weigh.png new file mode 100644 index 0000000000..48d9a8efcb Binary files /dev/null and b/content/applications/sales/point_of_sale/pos_hardware/weigh.png differ