Nomenclatura do código de barras GS1
A nomenclatura GS1 consolida vários dados de produtos e da cadeia de suprimentos em um único código de barras. O Odoo recebe os GTIN (Global Trade Item Numbers) exclusivos, adquiridos por empresas, para permitir remessas globais, vendas e listagem de produtos de e-Commerce.
Configure a nomenclatura GS1 para ler códigos de barras de caixas lacradas e identificar informações essenciais do produto, como GTIN (Global Trade Item Number), número de lote, informações de quantidade e muito mais.
Odoo's default GS1 rules <barcode/operations/default-gs1-nomenclature-list>
Why's my barcode not working? <barcode/operations/troubleshooting>
Configurar a nomenclatura do código de barras
Para usar a nomenclatura GS1, navegue até o . Em seguida, na seção Código de barras, marque a caixa Leitor de código de barras. Em seguida, selecione nas opções de nomenclatura de código de barras padrão.
A lista de regras e padrões de código de barras GS1 que o Odoo suporta por padrão podem ser acessados clicando no ícone ➡️ (seta) à direita da seleção Nomenclatura do código de barras.
Na tabela pop-up Abrir: Nomenclatura", visualize e edite os GS1 :guilabel:`Nomes de regras disponíveis no Odoo. A tabela contém todas as informações que podem ser condensadas com um código de barras GS1, juntamente com o Padrão de código de barras correspondente.
Usar códigos de barras GS1 no Odoo
Para a identificação de produtos usando códigos de barras GS1 no Odoo, as empresas obtêm um "GTIN <https://www.gs1.org/standards/get-barcodes>`_ exclusivo como identificador de produto internacionalmente distinto adquirido da GS1. Esse GTIN (Global Trade Item Number) é combinado com detalhes específicos do produto seguindo o padrão de código de barras designado pela GS1. O arranjo de números e letras do padrão de código de barras deve estar de acordo com as convenções da GS1 para uma interpretação precisa pelos sistemas globais em toda a cadeia de suprimentos.
Todo código de barras começa com um identificador de aplicação (A.I.) de 2 a 4 dígitos. Esse prefixo obrigatório indica universalmente o tipo de informação que o código de barras contém. O Odoo segue as regras da GS1 para identificar informações, conforme detalhado na lista de regras padrão da GS1 <barcode/operations/default-gs1-nomenclature-list>. A inclusão do A.I. (Application Identifier) relevante da lista permite que o Odoo interprete corretamente os códigos de barras GS1. Embora a maioria dos padrões de código de barras tenha um requisito de comprimento fixo, alguns deles, como lotes e números de série, têm comprimento flexível.
Consulte a Lista de nomenclatura GS1 <barcode/operations/default-gs1-nomenclature-list> para ver uma lista abrangente de todos os padrões e regras de código de barras a serem seguidos. Ou consulte o documento de uso GS1 <barcode/operations/gs1_usage> para obter exemplos específicos de combinação de GTIN (Global Trade Item Number) com informações do produto e configuração do fluxo de trabalho.
Lots workflow <barcode/operations/gs1-lots>
Non-unit quantities workflow <barcode/operations/quantity-ex>
Criar regras
As regras GS1 são um formato específico de informações contidas no código de barras, começando com um A.I. (Application Identifier) e contendo um comprimento definido de caracteres. A leitura de códigos de barras GS1 da lista GS1 padrão <barcode/operations/default-gs1-nomenclature-list> preenche automaticamente os dados correspondentes no base de dados do Odoo.
Adicionar regras de código de barras GS1 no Odoo garante a interpretação precisa de formatos GS1 exclusivos e não padronizados.
Para fazer isso, comece ativando o modo de desenvolvedor <developer-mode> e navegando até o arquivo Nomenclaturas de código de barras na lista em . Em seguida, selecione o item da lista Nomenclatura GS1 padrão.
Na página Nomenclatura GS1 padrão, selecione Adicionar uma linha na parte inferior da tabela, o que abrirá uma janela para criar uma nova regra. O campo Nome da regra é usado internamente para identificar o que o código de barras representa. Os Tipos do código de barras são classificações diferentes de informações que podem ser compreendidas pelo sistema (por exemplo, produto, quantidade, data de validade, embalagem, cupom). A Sequência representa a prioridade da regra; isso significa que quanto menor o valor, mais acima a regra aparece na tabela. O Odoo segue a ordem sequencial dessa tabela e usará a primeira regra que corresponder com base na sequência. O Padrão de código de barras é como a sequência de letras ou números é reconhecida pelo sistema para conter informações sobre o produto.
Após preencher as informações, clique no botão Salvar e Novo para criar outra regra ou clique em Salvar e Fechar para salvar e retornar à tabela de regras.
Solução de problemas de código de barras
Como é difícil trabalhar com códigos de barras GS1, aqui há algumas verificações a serem feitas quando os códigos de barras não estiverem funcionando como esperado:
Ensure that the Barcode Nomenclature setting is set as . Jump to the nomenclature setup section <barcode/operations/set-up-barcode-nomenclature> for more details.
Ensure that the fields scanned in the barcode are enabled in Odoo. For example, to scan a barcode containing lots and serial numbers, make sure the Lots & Serial Numbers feature is enabled in Odoo's settings <barcode/operations/lot-setup> and on the product <barcode/operations/lot-setup-on-product>.
Omit punctuation such as parentheses () or brackets [] between the A.I. (Application Identifier) and the barcode sequence. These are typically used in examples for ease of reading and should not be included in the final barcode. For more details on building GS1 barcodes, go to this section <barcode/operations/create-GS1-barcode>.
When a single barcode contains multiple encoded fields, Odoo requires all rules to be listed in the barcode nomenclature for Odoo to read the barcode. This section <barcode/operations/create-new-rules> details how to add new rules in the barcode nomenclature.
Test barcodes containing multiple encoded fields, piece by piece, to figure out which field is causing the issue.
Ao testar um código de barras que contenha o GTIN (Global Trade Item Number), o número do lote e a quantidade, comece lendo apenas o GTIN (Global Trade Item Number). Em seguida, teste o GTIN (Global Trade Item Number) com o número do lote e, por fim, tente ler o código de barras inteiro.
After diagnosing the encoded field is unknown, add new rules <barcode/operations/create-new-rules> to Odoo's default list to recognize GS1 barcodes with unique specifications.
Embora o novo campo seja lido, as informações não serão vinculadas a um campo existente no Odoo sem as personalizações do desenvolvedor. No entanto, é necessário adicionar novas regras para garantir que o restante dos campos no código de barras seja interpretado corretamente.
Lista de nomenclatura GS1
A tabela abaixo contém a lista padrão de regras GS1 do Odoo. Os padrões de código de barras são escritos em expressões regulares. Somente as três primeiras regras exigem um dígito verificador como caractere final.
Rule Name |
Type |
Barcode Pattern |
GS1 Content Type |
Odoo field |
|---|---|---|---|---|
Serial Shipping Container Code |
Package |
(00)(\d{18}) |
Numeric identifier |
Package name |
Global Trade Item Number (GTIN) |
Unit Product |
(01)(\d{14}) |
Numeric identifier |
Barcode field on product form |
GTIN of contained trade items |
Unit Product |
(02)(\d{14}) |
Numeric identifier |
Packaging |
Ship to / Deliver to global location |
Destination location |
(410)(\d{13}) |
Numeric identifier |
Destination location |
Ship / Deliver for forward |
Destination location |
(413)(\d{13}) |
Numeric identifier |
Source location |
I.D. of a physical location |
Location |
(414)(\d{13}) |
Numeric identifier |
Location |
Batch or lot number |
Lot |
(10) ([!"%-/0-9:-?A-Z_a-z]{0,20}) |
Alpha-numeric name |
Lot |
Serial number |
Lot |
(21) ([!"%-/0-9:-?A-Z_a-z]{0,20}) |
Alpha-numeric name |
Serial number |
Packaging date (YYMMDD) |
Packaging Date |
(13)(\d{6}) |
Date |
Pack date |
Best before date (YYMMDD) |
Best before Date |
(15)(\d{6}) |
Date |
Best before date |
Expiration date (YYMMDD) |
Expiration Date |
(17)(\d{6}) |
Date |
Expiry date |
Variable count of items |
Quantity |
(30)(\d{0,8}) |
Measure |
UoM: Units |
Count of trade items |
Quantity |
(37)(\d{0,8}) |
Measure |
Qty in units for containers (AI 02) |
Net weight: kilograms (kg) |
Quantity |
(310[0-5])(\d{6}) |
Measure |
Qty in kg |
Length in meters (m) |
Quantity |
(311[0-5])(\d{6}) |
Measure |
Qty in m |
Net volume: liters (L) |
Quantity |
(315[0-5])(\d{6}) |
Measure |
Qty in L |
Net volume: cubic meters (m3) |
Quantity |
(316[0-5])(\d{6}) |
Measure |
Qty in m3 |
Length in inches (in) |
Quantity |
(321[0-5])(\d{6}) |
Measure |
Qty in inches |
Net weight/volume: ounces (oz) |
Quantity |
(357[0-5])(\d{6}) |
Measure |
Qty in oz |
Net volume: cubic feet (ft3) |
Quantity |
(365[0-5])(\d{6}) |
Measure |
Qty in ft3 |
Packaging type |
Packaging Type |
(91) ([!"%-/0-9:-?A-Z_a-z]{0,90}) |
Alpha-numeric name |
Package type |