Default barcode nomenclature

Barcode nomenclatures define how barcodes are recognized and categorized. When a barcode is scanned, it is associated to the first rule with a matching pattern. The pattern syntax is described in Odoo’s nomenclature list using a regular expression, and a barcode is successfully read by Odoo if its prefix and/or length matches the one defined in the barcode’s rule.

Odoo Barcode supports UPC (Universal Product Code), EAN (European Article Number), and GS1 encoding. The pre-configured nomenclatures in Odoo are Default Nomenclature and Default GS1 Nomenclature. The default nomenclature uses UPC and EAN encoding, and supports UPC/EAN conversion.

Important

UPC and EAN barcodes must be purchased from GS1 to use these barcodes. GS1 is the only official provider of UPC/EAN and GS1 GTINs in the world.

Set up barcode nomenclature

To use default nomenclature, navigate to Inventory app ‣ Configuration ‣ Settings. Under the Barcode section, click the checkbox next to Barcode Scanner to enable barcodes. Doing so installs the Barcode app in the database.

Next, ensure that the Default Nomenclature setting is selected in the Barcode Nomenclature field. Then, click Save.

Enabled barcode setting with Default Nomenclature selected.

Once the nomenclature is saved and selected, the Barcode Nomenclatures settings can be accessed, via a hidden menu that is only discoverable after enabling developer mode.

Once developer mode is enabled, navigate to Inventory app ‣ Configuration ‣ Barcode Nomenclatures menu, and select Default Nomenclature.

From this page, the Barcode Nomenclature is specified at the top as the Default Nomenclature.

Under that, the UPC/EAN Conversion field is set to Always, by default. This setting determines if a UPC/EAN barcode should be automatically converted one way or another when trying to match a rule with the other encoding.

The other available options for this field are Never, EAN-13 to UPC-A, and UPC-A to EAN-13.

Important

For UPC/EAN conversion to work for every barcode scanned, the setting in the UPC/EAN Conversion field must be set to Always.

The last field at the top of the page is the Is GS1 Nomenclature field. For the Default Nomenclature, this field should remain unchecked. This is because the Default Nomenclature uses UPC and EAN encoding, not GS1 encoding.

Default Nomenclature page setting fields.

Further down the page, there is a list showcasing the Rule Name, Type, Encoding, and Barcode Pattern for the rules and barcode patterns that Odoo supports for the default nomenclature.

The default nomenclature list contains all the information that can be condensed with a UPC/EAN barcode.

Use UPC/EAN barcodes in Odoo

For product identification using UPC/EAN barcodes in Odoo, businesses must obtain barcodes purchased directly from GS1.

The UPC and EAN barcode formats are predominantly used in their own regions. UPC is used only in the United States and Canada, while EAN is used everywhere else globally.

A UPC is usually a 12-digit barcode used to identify most products, while EAN barcodes use 13-digit barcodes to identify products.

UPC codes can be converted to EAN by prefixing them with a zero. In Odoo, by default, UPC/EAN barcodes are automatically converted one way or another when trying to match a rule with the other encoding.

Refer to the default nomenclature list to see a comprehensive list of all barcode patterns and rules to follow.

Create rules

UPC and EAN barcodes contain specific information in the barcode. Scanning these codes from the default nomenclature list automatically fills corresponding data in the Odoo database.

Adding new barcode rules to this list ensures that non-standard (user-created) formats are interpreted accurately.

To create new rules, first activate developer mode. Then, navigate to Inventory app ‣ Configuration ‣ Barcode Nomenclatures. Select the Default Nomenclature list item.

On the Default Nomenclature page, select Add a line at the bottom of the table, which opens a Create Rules pop-up window to create a new rule.

Create Rules pop-up window on Default Nomenclature page.

The Rule Name field is used internally to identify what the barcode represents.

The Sequence field represents the priority of the rule; meaning the smaller the value, the higher the rule appears on the table.

The barcode Type field represents different classifications of information that can be understood by the system (e.g., Package, Lot, Location, Coupon, etc.).

The Encoding field specifies which encoding the barcode uses; this rule only applies if the barcode uses this specific encoding. The available Encoding options are: EAN-13, EAN-8, UPC-A, and GS1-28.

The Barcode Pattern field represents how the sequence of letters or numbers is recognized by the system to contain information about the product. Odoo follows the sequential order of this table, and uses the first rule it matches, based on the sequence.

Note

Barcode patterns can also define how numerical values, such as weight or price, are encoded in the barcode.

They are indicated by {NNN}, where N defines where the number’s digits are encoded. Floats are also supported with the decimals, indicated by D, such as {NNNDD}.

In this case, the barcode field on the associated records must show these digits as zeros.

After filling in the information, click the Save & New button to save the rule, and instantly start creating another rule. Or, click Save & Close to save the rule, and return to the table of rules.

Tip

When the Barcode Pattern field contains .*, it means it can contain any number of characters - those characters being any number or type of character.

Default nomenclature list

The table below contains Odoo’s list of Default Nomenclature rules. Barcode patterns are written in regular expressions.

Rule Name

Type

Encoding

Barcode Pattern

Price Barcodes 2 Decimals

Priced Product

EAN-13

23…..{NNNDD}

Discount Barcodes

Discounted Product

Any

22{NN}

Weight Barcodes 3 Decimals

Weighted Product

EAN-13

21…..{NNDDD}

Customer Barcodes

Client

Any

042

Coupon & Gift Card Barcodes

Coupon

Any

043|044

Cashier Barcodes

Cashier

Any

041

Location barcodes

Location

Any

414

Package barcodes

Package

Any

PACK

Lot barcodes

Lot

Any

10

Magnetic Credit Card

Credit Card

Any

%.*

Product Barcodes

Unit Product

Any

.*