v 8.0 v 12.0 Third Party 2156
Download for v 8.0
Odoo Online
On Premise
Odoo Apps Dependencies Social Network (mail)
Technical Name base_gs1_barcode
Versions 14.0 8.0 12.0 13.0 15.0
You bought this module and need support? Click here!

GS1 Barcodes

This module provides an API to decoding the content of structured barcodes like GS1-128 or GS1-Datamatrix.

GS1-128 (formerly known as UCC-128, EAN 128 or UCC/EAN-128), and GS1-Datamatrix are standards for encoding item identification and logistics data. Physically, GS1-128 is represented as a 1-dimension Code-128 barcode and GS1-Datamtrix is represented as a 2-dimensions Datamatrix barcode.

When those barcodes are read, their content can be decode into multiple values using a set of standard "Application Identifiers". For example, most pharmacy items have a GS1-Datamatrix barcode containg their GTIN, lot number and expiry date.

This module does not directly allow you to print or scan barcodes. Instead, the focus of this module is on decoding the data contained in barcodes. To this end, it provides objects to fine-tune the Application Identifiers and the associated data types.


To configure the Application Identifiers and the associated data types, go to Sales -> Settings -> Product Categories & Attributes -> GS1-128/GS1-Datamatrix Decoding

You can configure the barcode string separator and prefix in the System parameters. Use None to indicate a null prefix.


You can use the functionality provided by this module in your own customization or other OCA modules.

For further information, please visit:

Known issues / Roadmap

Group separator

When an "Application Identifiers" has variable-length data, the barcodes must contain a special character (<GS>, group separator) but as this is not an ASCII character. Some barcode readers will not include this character: decoding the structured data will then be impossible. Other readers will translate GS1 to ASCII character 29, but this character is not printable, and some applications may not record it. Yet other readers will let you configure how to map <GS>, which may help improve compatibility.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed feedback here.


Numérigraphe (http://numerigraphe.com)



Odoo Community Association

This module is maintained by the OCA.

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

To contribute to this module, please visit http://odoo-community.org.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.
Please choose a rating from 1 to 5 for this module.