[REF] Inventory and MRP: Update TOC tree

closes odoo/documentation#5591 Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-08-23 11:21:39 -07:00
parent e0d6f97dfc
commit 7b67d69abd
79 changed files with 134 additions and 64 deletions
@@ -0,0 +1,67 @@
+===========================
+Set up your barcode scanner
+===========================
+
+.. _barcode/setup/hardware:
+
+Getting started with barcode scanning in Odoo is fairly easy. Yet, a
+good user experience relies on an appropriate hardware setup. This guide
+will help you through the task of choosing and configuring the barcode
+scanner.
+
+Find the barcode scanner that suits your needs
+==============================================
+
+The 3 recommended type of barcode scanners to work with the Odoo
+**Inventory** and **Barcode Scanning** apps are the **USB scanner**, **the bluetooth
+scanner** and the **mobile computer scanner**.
+
+.. image:: hardware/hardware02.png
+    :align: center
+
+-   If you scan products at a computer location, the **USB scanner** is the
+    way to go. Simply plug it in the computer to start scanning. Just
+    make sure when you buy it that the scanner is compatible with
+    your keyboard layout or can be configured to be so.
+
+-   The **bluetooth scanner** can be paired with a smartphone or a tablet and
+    is a good choice if you want to be mobile but don't need a big
+    investment. An approach is to log in Odoo on you smartphone, pair
+    the bluetooth scanner with the smartphone and work in the
+    warehouse with the possibility to check your smartphone
+    from time to time and use the software 'manually'.
+
+-   For heavy use, the **mobile computer scanner** is the handiest solution.
+    It consists of a small computer with a built-in barcode scanner.
+    This one can turn out to be a very productive solution, however
+    you need to make sure that is is capable of running Odoo smoothly.
+    The most recent models using Android + Google Chrome or Windows +
+    Internet Explorer Mobile should do the job. However, due to the
+    variety of models and configurations on the market, it is
+    essential to test it first.
+
+Configure your barcode scanner
+==============================
+
+Keyboard layout
+---------------
+
+.. image:: hardware/hardware01.png
+    :align: center
+
+An USB barcode scanner needs to be configured to use the same keyboard
+layout as your operating system. Otherwise, your scanner won't translate
+characters correctly (replacing a 'A' with a 'Q' for example). Most
+scanners are configured by scanning the appropriate barcode in the user
+manual.
+
+Automatic carriage return
+-------------------------
+
+By default, Odoo has a 50 milliseconds delay between each successive
+scan (it helps avoid accidental double scanning). If you want to
+suppress this delay, you can configure your scanner to insert a carriage
+return at the end of each barcode. This is usually the default
+configuration and can be explicitly configured by scanning a specific
+barcode in the user manual ('CR suffix ON', 'Apply Enter for suffix',
+etc.).
@@ -0,0 +1,77 @@
+=============================
+Activate the Barcodes in Odoo
+=============================
+
+.. _inventory/barcode/software:
+
+The barcode scanning features can save you a lot of time usually lost
+switching between the keyboard, the mouse and the scanner. Properly
+attributing barcodes to products, pickings locations, etc. allows you to
+work more efficiently by controlling the software almost exclusively
+with the barcode scanner.
+
+Configuration
+=============
+
+To use this feature, you first need to activate the *Barcode*
+functionality via :menuselection:`Inventory --> Settings --> Barcode Scanner`. Once you
+have ticked the feature, you can hit save.
+
+.. image:: software/software_01.png
+    :align: center
+
+Set Product Barcodes
+====================
+
+You can easily assign barcodes to your different products via the
+*Inventory* app. To do so, go to :menuselection:`Settings --> Configure Products Barcodes`.
+
+.. image:: software/software_02.png
+    :align: center
+
+Then, you have the possibility to assign barcodes to your products
+directly at creation on the product form.
+
+.. image:: software/software_03.png
+    :align: center
+
+.. image:: software/software_04.png
+    :align: center
+
+.. note::
+         Be careful to add barcodes directly on the product variants and not on
+         the template product. Otherwise, you won’t be able to differentiate
+         them.
+
+Set Locations Barcodes
+======================
+
+If you manage multiple locations, you will find useful to attribute a
+barcode to each location and stick it on the location. You can configure
+the locations barcodes in :menuselection:`Inventory --> Configuration --> Locations`.
+
+.. image:: software/software_05.png
+    :align: center
+
+.. image:: software/software_06.png
+    :align: center
+
+.. note::
+         You can easily print the barcode you allocate to the locations via the
+         *Print* menu.
+
+Barcode Formats
+===============
+
+Most retail products use EAN-13 barcodes, also known as GTIN (Global Trade Identification Numbers).
+GTIN are used by companies to uniquely identify their products and services. While GTIN and UPC are
+often used synonymously, GTIN refers to the number a barcode represents, while UPC refers to the
+barcode itself. More information about GTIN can be found on the GS1 website.
+
+In order to create GTIN for items, a company must have a GS1 Company Prefix. This prefix is the
+number that will appear at the beginning of each GTIN, and will identify the company as the owner of
+the barcode any the products it appears on. To learn more about GS1 Company Prefixes, or purchase a
+license for a prefix, visit the GS1 Company Prefix page.
+
+Odoo users are able to use GTIN barcodes to identify their products. However, since Odoo supports
+any numeric string as a barcode, it is also possible to define a custom barcode for internal use.