Module Barcode

Return to user
documentation index

Return to
list of modules index

Barcode
Numero/ID of module	55
User doc. of module	This page
Developer doc. of module	Module Barcode (developer)

Introduction

The bar code module allows you to add bar codes where it can be usefull (like on products cards or third parties).

Installation

This module is included with the Dolibarr distribution, so there is no need to install it.

Configuration

To use this module, you must first enable it using an administrator account, via the menu option "Home - Setup - Modules".

Choose the tab where the module is listed. Then click on "Activate".

The module is now activated.

If a cog icon appears on module thumb or at end of the line of the module, click on it to access the setup page specific to the module.

Barcode encoding type

On the setup page, you choose for each barcode format you want to support, the engine that will build the graphical output (image) of bar code.

The engine available by default and supported by Dolibarr developers is php-barcode.

Eventually, you can install the program genbarcode (http://www.ashberg.de/php-barcode/download/#genbarcode) to have more format supported by this engine. You can also install new barcode generator engines (see in download area of http://www.dolibarr.org) to support more format.

Other options

Then, always on module setup page, choose which feature you want to enhance with barcodes:

• Products management
• Third parties management

Manager to auto define barcode numbers (Product)

Enable numbering module you want to use for suggesting and validating barcode number for products. Define also mask to make the automatic numbering generation working.

For example, if you choosed to use the EAN format ( http://en.wikipedia.org/wiki/International_Article_Number_(EAN) ) for products in previous setup, you can enter the value:

300999{000000}

• Where 300 is the country number (See http://www.gs1.org/barcodes/support/prefix_list)
• 999 is the Company number (according to country it may have more digits). To get a number for your company, you must contact the GS1 for your country: http://www.gs1.org/contact
• {000000} is the product number. You decide this number. It is counter with maximum 6 digits (according to country it may have less digits). Length is (8 - number of digits for your company number).
• Checksum digit is not required for EAN13 (it is added automatically)

Usage

Once the setup step is finished, you will see a new field "bar code" on some screens, depending on what you choosed for features to enhance (third party screen and/or product screen). You can then enter barcode values in such fields, using keyboard or barcode scanner:

Using keyboard

Just enter the number represented into the barcode. This suppose that number was printed under barcode graphic. This will be the case if you print the barcode stickker using the "'Print barcode'" feature provided with Dolibarr 3.6+ (menu Tools).

Using barcode scanner

If barcode number is not visible, or if you don't want to loose time typing all numbers, you can use a hardware barcode scanner. To be compatible with Dolibarr, your barcode scanner must support the "keyboard emulation": When you scan the barcode, it is like when typing the number from the keyboard. To find a barcode scanner supporting such emulation, you must have a look a technical specification of barcode. Scanner must provide the term:

• "HID" mode (for Human Interface Device)

or

• "Keyboard Wedge" or "Wedge" interface

More information on page: http://www.taltech.com/barcodesoftware/articles/which_barcode_scanner_interface

You can find bar code reader to read barcode EAN13 (13 numbers) and others to read barcode 39 (alphabet, unlimited number of characters).

Example:

• MOTOROla DS4208
• Datalogic QW2120
• EAN: 6913280798816