diff --git a/content/applications/general/iot/devices/scale.rst b/content/applications/general/iot/devices/scale.rst index daebc1312..6a7d2c429 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 @@ -23,27 +19,11 @@ scale's drivers `. the Odoo IoT system `_. In such cases, a different scale must be used. -Once the scale is connected to the IoT system, follow these steps to configure it in the POS -settings: - -#. :ref:`Access the POS settings ` and select your POS, or click the - vertical ellipsis button (:guilabel:`⋮`) 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`. +Once the scale is connected to the IoT system, :ref:`configure it in the POS settings `. .. seealso:: :doc:`Connect an IoT system to a POS ` -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 -the scale popup. The cashier can then weigh the product to automatically add the correct price to -the cart. - -.. image:: scale/scale-view.png - :scale: 80% - :alt: Electronic Scale dashboard view when no items are being weighed. - Ariva S scales ============== diff --git a/content/applications/general/iot/devices/scale/scale-view.png b/content/applications/general/iot/devices/scale/scale-view.png deleted file mode 100644 index 49437b31a..000000000 Binary files a/content/applications/general/iot/devices/scale/scale-view.png and /dev/null differ diff --git a/content/applications/sales/point_of_sale.rst b/content/applications/sales/point_of_sale.rst index 51d168fc3..b3e82c1fb 100644 --- a/content/applications/sales/point_of_sale.rst +++ b/content/applications/sales/point_of_sale.rst @@ -212,6 +212,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 000000000..4aa4dfbe6 --- /dev/null +++ b/content/applications/sales/point_of_sale/pos_hardware.rst @@ -0,0 +1,110 @@ +======== +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 `. +#. 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`. + +.. tip:: + Alternatively, click the :icon:`fa-ellipsis-v` (:guilabel:`Dropdown menu`) icon on a POS card and + click :guilabel:`Edit` to access this setting. + +Product configuration +~~~~~~~~~~~~~~~~~~~~~ + +In order to weigh products using an integrated scale, go to :menuselection:`Point of Sale --> +Products --> Products`, create a product or open an existing product form, and configure it as +follows: + +#. Ensure the :guilabel:`Point of Sale` checkbox is activated for the product to be available in + POS. +#. On the :guilabel:`General Information` tab, define a :guilabel:`Sales Price` per :guilabel:`kg`. + + .. note:: + This step requires to enable the :doc:`Units of Measure + <../../inventory_and_mrp/inventory/product_management/configure/uom>` feature. To activate it: + + #. Go to :menuselection:`Inventory --> Configuration --> Settings`. + #. Scroll down to the :guilabel:`Products` section and activate :guilabel:`Units of Measure`. +#. 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. + +.. 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 +-------------------- + +When using scales in commercial transactions, the database integrated with a scale must be +configured to meet specific European requirements. This includes supporting at least three decimal +places for accuracy and using proper rounding for units of measure, such as `kg` instead of generic +`units`. + +If the database is not compliant, a red :icon:`fa-balance-scale` (:guilabel:`scale`) icon displays +as a warning. Click this icon to view the reasons for non-compliance and then select +:guilabel:`Apply changes` to automatically apply the necessary changes to the settings. Once the +database meets all regulatory requirements, the :icon:`fa-balance-scale` (:guilabel:`scale`) icon +turns green. + +.. image:: pos_hardware/legal-requirements.png + :scale: 75 % + +.. admonition:: Additional guidelines + + Both the :doc:`customer ` and POS displays must have a minimum diagonal + size of 6 inches. For optimal readability, larger screens are recommended. + +Using a scale in PoS +-------------------- + +#. :ref:`Open a POS session `. +#. Select the product to weigh on the order screen or scan its barcode. +#. Place the product on the scale and wait for the weight to be displayed in the popup window. +#. 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 from the scale. + +.. 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 000000000..c45c9e4d1 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 000000000..48d9a8efc Binary files /dev/null and b/content/applications/sales/point_of_sale/pos_hardware/weigh.png differ