Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[ADD] integration: introducing barcodelookup documentation #11774

Closed
wants to merge 1 commit into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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