[IMP] barcode: New images, style, rewrite for 18.0

closes odoo/documentation#13020

Signed-off-by: Zaz Linkous (stul) <stul@odoo.com>
Co-authored-by: Felicia Kuan <feku@odoo.com>

content/applications/inventory_and_mrp/barcode/setup/software.rst

@@ -1,101 +1,145 @@
 =============================
-Activate the Barcodes in Odoo
+Product and location barcodes
 =============================
 
-.. _inventory/barcode/software:
+.. |GTIN| replace:: :abbr:`GTIN (Global Trade Item Number)`
 
-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.
+Inventory operations like product configuration can be streamlined by taking advantage of barcode
+scanning features. Assigning barcodes to products and locations is a key step in using the
+**Barcode** app, and users can conveniently populate fields with a barcode scanner. This reduces
+manual entry, minimizes errors, and speeds up common tasks like product selection, location
+assignment, and inventory adjustments.
 
 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.
+Barcode nomenclature
+--------------------
 
-.. image:: software/software_01.png
-    :align: center
+Most retail products use EAN-13 barcodes, also known as Global Trade Identification Numbers (GTIN).
+To create a new |GTIN| for a product, a company must have a GS1 Company Prefix. See :doc:`GS1
+nomenclature <../operations/gs1_nomenclature>` for more information about using this system.
 
-.. _inventory/barcode/set-barcodes:
+Odoo supports using any string as a barcode, so users can also create custom internal references to
+use with barcode scanners. See :doc:`Default nomenclature <../operations/barcode_nomenclature>` to
+learn about optional conventions around barcodes and default values in Odoo
 
-Set Product Barcodes
-====================
+To change the barcode nomenclature, go to :menuselection:`Inventory app --> Configuration -->
+Settings` and scroll down to the :guilabel:`Barcode` section to select the nomenclature under
+:guilabel:`Barcode Scanner`.
 
-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.
-
-.. _barcode/setup/location:
-
-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.
+.. image:: software/barcodes-setup-change-nomenclature.png
+   :alt: Changing barcode nomenclature in Inventory app settings.
 
 .. _barcode/setup/barcodelookup:
 
-Barcode Lookup
-==============
+Barcode lookup
+--------------
 
-`Barcode Lookup <https://www.barcodelookup.com/>`_ allows you to scan (or enter) products' barcodes
-(:abbr:`UPC (Universal Product Code)`, :abbr:`EAN (European Article Number)`, or :abbr:`ISBN
-(International Standard Book Number)`) to automatically create them in your Odoo database, complete
-with product names, descriptions, images, categories, etc.
+Odoo can automatically add product information using the :guilabel:`Stock Barcode Database` setting
+for any :abbr:`UPC (Universal Product Code)`, :abbr:`EAN (European Article Number)`, or :abbr:`ISBN
+(International Standard Book Number)` barcode.
 
-To use Barcode Lookup to scan and create products in Barcode, go to :menuselection:`Inventory -->
-Configuration --> Settings`, scroll down to the :guilabel:`Barcode` section, and enable
-:guilabel:`Stock Barcode Database`.
+To enable automatic barcode look up, go to :menuselection:`Inventory app --> Configuration -->
+Settings` and scroll down to the :guilabel:`Barcode` section to tick the box for :guilabel:`Stock
+Barcode Database`.
 
 .. note::
-   If your database is hosted on **Odoo.sh** or **on-premise**, you must also :ref:`configure
-   an API key <barcodelookup/configuration>`.
-   If your database is hosted on **Odoo Online**, you can use Barcode Lookup without further
-   configuration.
+   Databases hosted on **Odoo.sh** or **on-premise**, require :ref:`configuring an API key
+   <barcodelookup/configuration>`.
+
+.. _inventory/barcode/set-barcodes:
+
+Set product barcodes
+====================
+
+Barcodes can be assigned to existing products from the *Product Barcodes* configuration page or from
+any product form in the **Inventory**, **Manufacturing** or **Purchase** apps. The barcode field can
+be populated either by typing or using scanner input.
+
+When adding a new product, the :ref:`barcode lookup feature <barcode/setup/barcodelookup>` can be
+used to automatically find information about a product based on its barcode, and new products can be
+added to the database directly from the **Barcode** app by scanning a barcode.
+
+From Barcode app
+----------------
+
+New products definitions can be added to the database product lists as well as having their on-hand
+inventory tracked from the **Barcode** app, if the :ref:`Barcode Lookup feature
+<barcode/setup/barcodelookup>` is enabled. To create a new receipt for scanning new products, choose
+one of two methods:
+
+#. From the **Barcode** front page, tap :guilabel:`Operations`, tap :guilabel:`Receipts`, and then
+   tap the :guilabel:`New` button.
+#. Scan a printed :guilabel:`Receipts (WHIN)` inventory command barcode.
+
+.. image:: software/barcode-new-receipt.png
+   :alt: Empty new receipt form.
+
+Scanning a product that is not currently in inventory prompts a message that the product does not
+exist, with a button option to :guilabel:`Create New Product`. Pressing this button will search the
+`Barcode Lookup <https://www.barcodelookup.com/>`_ database for a product matching the code and
+format, create a new product definition in the Odoo database with the available information, and add
+that product to the receipt to track the quantity on hand in inventory.
+
+.. image:: software/barcode-scan-for-new-product.png
+   :alt: New product confirmation dialog.
+
+.. note::
+   Even if a transfer order with a product created through **Barcode** is cancelled, the product
+   remains available in the products list in the **Inventory** app unless it is deleted.
+
+From a product form
+-------------------
+
+Barcodes can be added to both existing products and new products as they are created through the
+products configuration form. To access a product's form, go to :menuselection:`Inventory app -->
+Products --> Products` and select the product to add a barcode to.
+
+In the :guilabel:`General Information` tab, click the :guilabel:`Barcode` field to either type in
+the barcode or use a scanner to input the barcode value.
+
+.. image:: software/barcode-add-to-product-form.png
+   :alt: The 'Barcode' field on a product form with an active cursor.
+
+.. note::
+   If using :doc:`product variants <../../../sales/sales/products_prices/products/variants>`,
+   configure barcodes on individual variants and not the product template to allow scanning to
+   retrieve the variants.
+
+From Inventory settings
+-----------------------
+
+To access the *Product Barcodes* configuration page, go to :menuselection:`Inventory app -->
+Configuration --> Settings`. In the :guilabel:`Barcode` section, under the :guilabel:`Barcode
+Scanner` feature, click :icon:`fa-arrow-right` :guilabel:`Configure Product Barcodes`. From this
+list view, click the :guilabel:`Barcodes` column for any product to enter its barcode. Barcode
+scanners will populate this field when the product is scanned.
+
+.. image:: software/product-barcodes-configure.png
+   :alt: Selecting the Barcode field in the Product Configuration form.
+
+.. tip::
+   To filter for the products that do not have barcodes yet, click the :icon:`fa-sort-desc`
+   :guilabel:`(Toggle Search Panel)` icon to add a custom filter where the :guilabel:`Barcode`
+   property is :guilabel:`is not set`.
+
+   .. image:: software/barcode-filter-for-no-barcode.png
+      :alt: 'Add Custom Filter' pop-up with 'Barcode is not set' configured.
+
+.. _barcode/setup/location:
+
+Print location barcodes
+=======================
+
+Barcodes can be assigned to locations to track of where products are stored and manage transfers,
+and are automatically available if the :doc:`Storage Locations
+<../../inventory/warehouses_storage/inventory_management/use_locations>` feature is enabled.
+
+To print barcodes for locations, go to :menuselection:`Inventory app --> Configuration -->
+Settings`, scroll down to the :guilabel:`Warehouse` section and click :icon:`fa-arrow-right`
+:guilabel:`Locations`. Tick the boxes for locations and the :guilabel:`Print` button will appear,
+downloading a PDF with barcodes for all selected locations.
+
+.. image:: software/print-storage-location-barcodes.png
+   :alt: Multiple storage locations selected with 'Print' button at the top of the view.

content/applications/inventory_and_mrp/inventory/product_management/configure/packaging.rst

@@ -12,9 +12,9 @@ For example, different packages for cans of soda, such as a 6-pack, a 12-pack, o
 specific, not generic.
 
 .. tip::
-   Packaging can be used in conjunction with Odoo :ref:`Barcode <inventory/barcode/software>`. When
-   receiving products from suppliers, scanning the packaging barcode automatically adds the number
-   of units in the packaging to the internal count of the product.
+   Packaging can be used in conjunction with Odoo :doc:`Barcode <../../../barcode/setup/software>`.
+   When receiving products from suppliers, scanning the packaging barcode automatically adds the
+   number of units in the packaging to the internal count of the product.
 
 Configuration
 =============
@@ -172,8 +172,8 @@ warehouse. Next, in the :guilabel:`Applicable on` section, tick the :guilabel:`P
 Apply route on packaging
 ------------------------
 
-Then, to apply the route, go to :menuselection:`Inventory app --> Products --> Products`, and
-select the product that uses packaging.
+Then, to apply the route, go to :menuselection:`Inventory app --> Products --> Products`, and select
+the product that uses packaging.
 
 In the product form, switch to the :guilabel:`Inventory` tab. In the :guilabel:`Packaging` section
 that contains :ref:`configured packagings <inventory/product_management/packaging-setup>`, click the