Module Barcode

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

= Installation =

= Configuration =

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:


 * 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: or
 * "HID" mode (for Human Interface Device)
 * "Keyboard Wedge" or "Wedge" interface

Example:
 * MOTOROla DS4208
 * Datalogic QW2120