Metadata-Version: 2.1
Name: odoo-addon-pos_self_service_weighing_product
Version: 16.0.1.0.0.1
Summary: Configure a PoS to be a self-service product weighing station
Home-page: https://github.com/OCA/pos
Author: Coop IT Easy SC, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
License: AGPL-3
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 16.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Requires-Python: >=3.10
Requires-Dist: odoo-addon-base-pos-self-service-weighing<16.1dev,>=16.0dev
Requires-Dist: odoo<16.1dev,>=16.0a

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

=============================
Self-Service Product Weighing
=============================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:69b6ba12cf00ab896f8b388df7d466d4ff8f3c4dc1ca9efceaed34ff6c7fe9e5
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fpos-lightgray.png?logo=github
    :target: https://github.com/OCA/pos/tree/16.0/pos_self_service_weighing_product
    :alt: OCA/pos
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/pos-16-0/pos-16-0-pos_self_service_weighing_product
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/pos&target_branch=16.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

Configure a PoS to be a self-service product weighing station.

This module allows customers to weigh products and print labels with a barcode identifying the product and containing its weight or its price.

**Table of contents**

.. contents::
   :local:

Usage
=====

This module allows to generate 2 types of barcodes, depending on type of the barcode nomenclature corresponding to the barcode of the selected product:

#. Weight barcodes (type ``weight``)
#. Price barcodes (type ``price`` or ``price_to_weight`` (see ``pos_price_to_weight`` module))

Please note that the weight encoded in weight barcodes is always expressed in kilograms, independently of any configuration.
The number of decimal places is defined by the barcode nomenclature corresponding to the barcode of the product.

Depending on the type of the barcode, the value string below the barcode expresses either:

* The encoded weight in the unit of measure of the product
* The price (in the currency used by the PoS), followed by the weight in the unit of measure of the product (between parentheses)

For price barcodes, the price encoded in the barcode includes taxes or not, depending on the type of tax used (``price_include`` field) on the product.
This is to ensure that the value is correctly interpreted when the barcode is scanned (it is computed in the same way).
The value string below the barcode expresses the price with or without taxes depending on the PoS configuration (``iface_tax_included`` field).

Known issues / Roadmap
======================

* For weight barcodes, if the weight read from the scale has a greater precision than the barcode nomenclature, and the barcode nomenclature a greater precision than the unit of measure rounding, there can be a difference between the price displayed on the scale screen and the price computed when the barcode is scanned, because the value will be rounded once in the scale screen, but twice when using the barcode.
  For example: the scale returns 1.2345: the scale screen displays 1.23, the barcode encodes 1.235 and when scanned it becomes 1.24.
* This module has been tested using the kilogram unit of measure.
  It will probably not work completely correctly using other units of measure, even derived from the kilogram.
  The scale screen itself (from the ``point_of_sale`` module) doesn't handle units of measure correctly: it considers that the value returned by the scale is in the same unit of measure as the product.
  For example: with a product using the gram unit of measure, if the scale returns 0.1, the scale screen considers that it is 0.1 gram and displays it like this; however, the weight displayed in the barcode value string will be 100 g and the price will be computed from this, because this module always assumes that the weight returned by the scale is in kilograms.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/pos/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/pos/issues/new?body=module:%20pos_self_service_weighing_product%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
~~~~~~~

* Coop IT Easy SC

Contributors
~~~~~~~~~~~~

* `Coop IT Easy SC <https://coopiteasy.be>`_:

  * hugues de keyzer

Maintainers
~~~~~~~~~~~

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

This module is part of the `OCA/pos <https://github.com/OCA/pos/tree/16.0/pos_self_service_weighing_product>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
