[ADD] inventory: new V13 doc "barcode nomenclature"

inventory/barcode/operations.rst

@@ -9,3 +9,4 @@ Daily Operations
    operations/adjustments
    operations/internal
    operations/transfers_scratch
+   operations/barcode_nomenclature

inventory/barcode/operations/barcode_nomenclature.rst

@@ -0,0 +1,98 @@
+==============================
+Work with Barcode Nomenclature
+==============================
+
+There are different situations in which barcode nomenclatures can be
+useful. A well-known use case is the one of a point of sales that sells
+products in bulk. The customers will scale their products themselves and
+get the printed barcode to stick on the product. This barcode will
+contain the weight of the product and help compute the price
+accordingly.
+
+Create a Barcode Nomenclature
+=============================
+
+Odoo supports *Barcode Nomenclatures*, which determine the mapping and
+interpretation of the encoded information.
+
+To configure the *Barcode Nomenclature*, you need to activate the
+debug mode. To do so, go to *Inventory > Configuration > Barcode
+Nomenclature*.
+
+You can create a barcode nomenclature from there, and then add a line to
+create your first rule.
+
+.. image:: media/barcode_nomenclature_01.png
+    :align: center
+
+The first step is to specify the *rule name*, for example *Weight
+Barcode* with 3 decimals. Then, you have to specify the type for
+barcode nomenclature, like the *Weighted Product*.
+
+.. image:: media/barcode_nomenclature_02.png
+    :align: center
+
+The *Barcode Pattern* is a regular expression that defines the
+structure of the barcode. In this example, 21 defines the products on
+which the rule will be applied. Those are the numbers by which the
+product barcode should start. The 5 “dots” are the following numbers of
+the product barcode and are there to identify the product in question.
+The “N” defines a number and the “D” defines the decimals.
+
+.. note::
+        You can define different rules and order their priority thanks to the
+        sequence. The first rule that matches the scanned barcode will then be
+        applied.
+
+Configure your Product
+======================
+
+1. The barcode of the product should start by “21”;
+
+2. The 5 “dots” are the other numbers of your product barcode, allowing to identify the product;
+
+3. The barcode should contain 0’s when you did defined D’s or N’s. In our case, we need to set 5 zeros because we condigures “21………{NNDDD}”;
+
+4. In EAN-13, the last number is a check number.
+
+.. image:: media/barcode_nomenclature_03.png
+    :align: center
+
+In case you weight 1,5kg of pasta, the balance will print you the
+following barcode: *2112345015001*. If you scan this barcode in your
+PoS, or when receiving the products in your barcode app, Odoo will
+automatically create a new line for the product, for a quantity of
+1,5kg.
+
+For the point of sale, a price depending on the quantity will also be
+computed.
+
+.. image:: media/barcode_nomenclature_04.png
+    :align: center
+
+Rule Types
+==========
+
+-  **Priced Product**: it allows you to identify the product and specify its price, used in PoS;
+
+-  **Discounted Product**: it allows you to identify the product and specify the applied discount product, used in PoS;
+
+-  **Weighted Product**: it allows you to identify the product and specify its weight, used in both PoS and in Inventory;
+
+-  **Client**: it allows you to identify the customer, for example used with loyalty program;
+
+-  **Cashier**: it allows you to identify the cashier when entering the PoS;
+
+-  **Location**: it allows you to identify the location on a transfer when multi-location is activated;
+
+-  **Package**: it allows you to identify packages on a transfer when packages are activated;
+
+-  **Lot**: it allows you to identify the lot number of a product on a transfer;
+
+-  **Credit Card**: it doesn’t need manual modification, exists for data from the Mercury module;
+
+-  **Unit Product**: it allows you to identify a product for both PoS and Transfers.
+
+.. note::
+        When the barcode pattern contains .*, it means that it can contain any
+        number of characters. Those characters can be any number.