2c4e558804
closes odoo/documentation#7931
X-original-commit: f8c1f3538d
Signed-off-by: Brandon Seltenrich (brse) <brse@odoo.com>
109 lines
4.6 KiB
ReStructuredText
109 lines
4.6 KiB
ReStructuredText
=====================
|
|
Barcode scanner setup
|
|
=====================
|
|
|
|
.. _barcode/setup/hardware:
|
|
|
|
Follow this guide to choose and set up a barcode scanner compatible with Odoo's *Inventory* and
|
|
*Barcode* apps.
|
|
|
|
.. figure:: hardware/barcode-scanner.png
|
|
:align: center
|
|
:alt: An image of an example barcode scanner.
|
|
|
|
Scanner types
|
|
=============
|
|
|
|
Before setting up a barcode scanner, it is important to determine which type of scanner best meets
|
|
the needs of the business. There are three main types of scanners that can be used with Odoo, each
|
|
with their own benefits and use cases:
|
|
|
|
- **USB scanners** are connected to a computer, and are suitable for businesses that scan products at
|
|
a fixed location, like at the checkout line in a grocery store.
|
|
- **Bluetooth scanners** pair with a smartphone or tablet, making them both a cost-effective and
|
|
portable barcode scanner option. In this scenario, Odoo is installed on the smartphone, allowing
|
|
warehouse operators to handle operations, and check stock, directly through their mobile devices.
|
|
- **Mobile computer scanners** are mobile devices with a built-in barcode scanner.
|
|
|
|
.. important::
|
|
If using a USB scanner, ensure the scanner is compatible with the keyboard layout of the
|
|
computer.
|
|
|
|
If using a mobile computer scanner, ensure the device can run the Odoo mobile app properly.
|
|
Recent models that use Android OS with the Google Chrome browser, or Windows OS with Microsoft
|
|
Edge, should work. However, testing is crucial due to the variety of available models and
|
|
configurations.
|
|
|
|
.. seealso::
|
|
`Odoo Inventory & Barcode • Compatible Hardware <https://www.odoo.com/app/inventory-hardware>`_
|
|
|
|
Configuration
|
|
=============
|
|
|
|
When setting up the barcode scanner, make sure the following configurations are correct so the
|
|
scanner can properly interpret barcodes with Odoo.
|
|
|
|
Keyboard layout
|
|
---------------
|
|
|
|
When using a USB barcode scanner, match its keyboard layout with the operating system's layout for
|
|
proper interpretation of characters. Generally, the scanning mode should be set to accept a USB
|
|
keyboard (HID), with the language set based on the keyboard that is in use.
|
|
|
|
To configure the keyboard layout for a **Zebra** scanner, scan the keyboard wedge barcode for the
|
|
desired language in the scanner's user manual.
|
|
|
|
.. figure:: hardware/keyboard-barcode.png
|
|
:align: center
|
|
:alt: Example of a user manual for keyboard layout.
|
|
|
|
Examples of keyboard language settings in the Zebra scanner user manual.
|
|
|
|
Automatic carriage return
|
|
-------------------------
|
|
|
|
Odoo has a default 100-millisecond delay between scans to prevent accidental double scanning. To
|
|
synchronize with the barcode scanner, set it to include a *carriage return* (:dfn:`character like
|
|
the "Enter" key on a keyboard`) after each scan. Odoo interprets the carriage return as the end of
|
|
the barcode input; so Odoo accepts the scan, and waits for the next one.
|
|
|
|
Typically, on the scanner, a carriage return is included by default. Ensure it is set by scanning a
|
|
specific barcode in the user manual, like `CR suffix ON` or `Apply Enter for suffix`.
|
|
|
|
Zebra scanner
|
|
=============
|
|
|
|
When using Zebra scanners, ensure the following keystroke configurations are set to prevent errors.
|
|
|
|
Begin on the Zebra scanner's home screen, and select the :guilabel:`DataWedge` app (the app is
|
|
represented by a :guilabel:`(light blue barcode)` icon).
|
|
|
|
On the :guilabel:`DataWedge Profiles` page, select the profile option to access the Zebra scanner's
|
|
settings.
|
|
|
|
.. warning::
|
|
It is **not** suggested to use the "DWDemo" profile, as it does not work properly in every
|
|
circumstance.
|
|
|
|
Instead, it is recommended to create a new, personal profile. Once a new profile is created, add
|
|
the *Odoo Mobile* app and *Google Chrome* app in the :guilabel:`Associated Apps` on the scanner's
|
|
home screen.
|
|
|
|
Once the profile is selected, scroll down to the :guilabel:`Keyboard Output` option, and ensure the
|
|
:guilabel:`Enable/disable keystroke output` option is :guilabel:`Enabled`.
|
|
|
|
.. image:: hardware/enable-keystroke.png
|
|
:align: center
|
|
:alt: Show keystroke option in the Zebra scanner's DataWedge app.
|
|
|
|
Once that option is enabled, go back to the :guilabel:`Profile` options page, and go to the
|
|
:guilabel:`Keystroke output` section. Then, open the :guilabel:`Key event options` submenu. Under
|
|
:guilabel:`Characters`, ensure the :guilabel:`Send Characters as Events` option is checked.
|
|
|
|
.. important::
|
|
The :guilabel:`Send Characters as Events` option **must** be checked on the Zebra scanner, or
|
|
Odoo **cannot** recognize the barcodes that are scanned.
|
|
|
|
Once all those steps have been taken, perform a test scan to ensure the Zebra scanner is working
|
|
properly, as intended.
|