Skip to content

Commit

Permalink
[ADD] integration: barcodelookup documentation
Browse files Browse the repository at this point in the history
Task-4464181

closes #11774

Signed-off-by: Audrey Vandromme (auva) <[email protected]>
  • Loading branch information
sjai-odoo authored and auva-odoo committed Jan 29, 2025
1 parent c792d37 commit eee06ac
Show file tree
Hide file tree
Showing 5 changed files with 69 additions and 0 deletions.
1 change: 1 addition & 0 deletions content/applications/general/integrations.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,3 +8,4 @@ Integrations
integrations/unsplash
integrations/geolocation
integrations/google_translate
integrations/barcodelookup
40 changes: 40 additions & 0 deletions content/applications/general/integrations/barcodelookup.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
:show-content:

==============
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.

.. _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 <https://www.barcodelookup.com/api>`_ 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
<barcode/setup/barcodelookup>`.
Original file line number Diff line number Diff line change
Expand Up @@ -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 <barcode/setup/barcodelookup>` to quickly create new
products by scanning their barcodes during internal transfers.

Create a transfer from scratch
==============================

Expand Down
20 changes: 20 additions & 0 deletions content/applications/inventory_and_mrp/barcode/setup/software.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <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.

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 <barcodelookup/configuration>`.
If your database is hosted on **Odoo Online**, you can use Barcode Lookup without further
configuration.
4 changes: 4 additions & 0 deletions content/applications/websites/ecommerce/products.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
</applications/general/integrations/barcodelookup>`.

.. _ecommerce/products/import-products:

Import products
Expand Down

0 comments on commit eee06ac

Please sign in to comment.