From bcce6dd5dc56635aea6020d12928653c863377a9 Mon Sep 17 00:00:00 2001 From: sjai-odoo Date: Wed, 1 Jan 2025 09:24:40 +0000 Subject: [PATCH] [ADD] integration: barcodelookup documentation Task-4464181 closes odoo/documentation#11906 X-original-commit: eee06ac7c4407c1ad927d2a7bbfdac0e34549380 Signed-off-by: Audrey Vandromme (auva) Signed-off-by: Jainam Shah (sjai) --- content/applications/general/integrations.rst | 1 + .../general/integrations/barcodelookup.rst | 40 +++++++++++++++++++ .../barcode/operations/transfers_scratch.rst | 4 ++ .../barcode/setup/software.rst | 20 ++++++++++ .../websites/ecommerce/products.rst | 4 ++ 5 files changed, 69 insertions(+) create mode 100644 content/applications/general/integrations/barcodelookup.rst diff --git a/content/applications/general/integrations.rst b/content/applications/general/integrations.rst index 35cefcc9a..442cbdee9 100644 --- a/content/applications/general/integrations.rst +++ b/content/applications/general/integrations.rst @@ -8,3 +8,4 @@ Integrations integrations/unsplash integrations/geolocation integrations/google_translate + integrations/barcodelookup diff --git a/content/applications/general/integrations/barcodelookup.rst b/content/applications/general/integrations/barcodelookup.rst new file mode 100644 index 000000000..3e2544db4 --- /dev/null +++ b/content/applications/general/integrations/barcodelookup.rst @@ -0,0 +1,40 @@ +:show-content: + +============== +Barcode Lookup +============== + +`Barcode Lookup `_ 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. + +.. _barcodelookup/configuration: + +Configuration +------------- + +If your database is hosted on **Odoo Online**, you can use Barcode Lookup without configuration. + +If your database is hosted on **Odoo.sh** or **on-premise**, proceed as follows: + +#. Visit the `Barcode Lookup website `_ and click + :guilabel:`Sign Up for the API`. +#. Choose the appropriate plan based on the number of barcodes you need to scan. +#. Fill in the required details and complete the registration process. +#. Copy the API key. +#. In Odoo, open the Settings app, scroll down to the :guilabel:`Integrations` section, and, under + :guilabel:`Barcode Database`, paste the Barcode Lookup :guilabel:`API Key`. + +Use +--- + +To fill in product information using Barcode Lookup, create a new product and fill in the +:guilabel:`Barcode` field. The product's details are then automatically imported from Barcode +Lookup, updating the following fields: :guilabel:`Name`, :guilabel:`Price`, :guilabel:`Description`, +:guilabel:`Tax`, :guilabel:`Image`, :guilabel:`Weight`, :guilabel:`Attributes`, :guilabel:`Product +category`, and :guilabel:`Volume`. You can then modify any field(s) as needed. + +.. seealso:: + :ref:`Create new products during internal transfers using the Barcode Lookup database + `. diff --git a/content/applications/inventory_and_mrp/barcode/operations/transfers_scratch.rst b/content/applications/inventory_and_mrp/barcode/operations/transfers_scratch.rst index 5e5fb9f47..760a889b8 100644 --- a/content/applications/inventory_and_mrp/barcode/operations/transfers_scratch.rst +++ b/content/applications/inventory_and_mrp/barcode/operations/transfers_scratch.rst @@ -170,6 +170,10 @@ out. the same lot or serial number is shared between different products, scan the product barcode first, then the barcode of the lot/serial number. +.. seealso:: + :ref:`Connect to the Barcode Lookup database ` to quickly create new + products by scanning their barcodes during internal transfers. + Create a transfer from scratch ============================== diff --git a/content/applications/inventory_and_mrp/barcode/setup/software.rst b/content/applications/inventory_and_mrp/barcode/setup/software.rst index a3b49774e..1aaebe050 100644 --- a/content/applications/inventory_and_mrp/barcode/setup/software.rst +++ b/content/applications/inventory_and_mrp/barcode/setup/software.rst @@ -77,3 +77,23 @@ 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. + +.. _barcode/setup/barcodelookup: + +Barcode Lookup +============== + +`Barcode Lookup `_ 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. + +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`. + +.. note:: + If your database is hosted on **Odoo.sh** or **on-premise**, you must also :ref:`configure + an API key `. + If your database is hosted on **Odoo Online**, you can use Barcode Lookup without further + configuration. diff --git a/content/applications/websites/ecommerce/products.rst b/content/applications/websites/ecommerce/products.rst index 986cbf141..8a0df7995 100644 --- a/content/applications/websites/ecommerce/products.rst +++ b/content/applications/websites/ecommerce/products.rst @@ -36,6 +36,10 @@ page. When you :guilabel:`Save`, the product page is automatically published. :guilabel:`Go to Website` smart button to access the product page, then toggle the switch from :guilabel:`Unpublished` to :guilabel:`Published`. +.. seealso:: + :doc:`Create new products using the Barcode Lookup database + `. + .. _ecommerce/products/import-products: Import products