Código de Produto

Integração Básica do RUB — entidade obrigatória, de contexto Empresa.

O que é um Código de Produto

O Código de Produto é o código de barras que identifica uma Embalagem de um Produto Empresa — o valor exato que o leitor do dispositivo móvel enxerga quando aponta para a etiqueta ou para o produto: um EAN-13, um DUN-14 (código de caixa), um código interno de balança, ou qualquer outra simbologia usada pela retaguarda.

É por meio do Código de Produto que o RUB traduz uma leitura física (o colaborador passou o leitor em um código) para uma identidade lógica (produto 4482, Embalagem "fardo com 6"). Sem esse cadastro, o dispositivo lê números e não sabe a que produto eles correspondem — nenhuma tarefa de recebimento, contagem, auditoria de etiqueta ou consulta de preço funciona sem essa tradução.

Todos os códigos que poderão ser lidos pelos dispositivos móveis para identificar o produto devem ser informados — não apenas o "principal". Um mesmo produto costuma ter mais de um código: um por Embalagem (unidade, fardo, caixa) e, às vezes, mais de um por promoções ou requisitos do fabricante.

Um produto, várias embalagens, vários códigos

graph TD
    PE["Produto Empresa<br/>4482 — ARROZ TIPO 1 5KG"]
    PE --> E1["Embalagem<br/>QTD = 1 — UNIDADE"]
    PE --> E6["Embalagem<br/>QTD = 6 — FARDO C/ 6"]
    E1 --> C1["Código de Produto<br/>7896006700016"]
    E6 --> C2["Código de Produto<br/>17896006700013"]

Cada Código de Produto aponta para uma Embalagem específica — não diretamente para o produto. É essa indireção que permite ao RUB saber, ao ler 17896006700013, que o colaborador está lidando com 6 unidades do produto 4482 de uma só vez (por exemplo, ao dar entrada em um fardo fechado), sem precisar abri-lo e ler unidade por unidade.

Tipos comuns de código

  • EAN-13 / EAN-8 — código de barras convencional impresso pelo fabricante, normalmente ligado à Embalagem unitária.
  • DUN-14 / ITF-14 — código de caixa/fardo, usado no recebimento de mercadorias fechadas; aponta para a Embalagem maior (caixa, fardo, pallet).
  • Código de balança — gerado internamente pela balança da loja para produtos de peso variável (ex.: prefixo 2 seguido do PLU e do peso ou preço embutidos); o RUB decodifica esse padrão para chegar ao produto correto.
  • Código interno / PLU curto — usado internamente por algumas retaguardas antes de o produto ter um EAN definitivo; deve ser integrado da mesma forma, como mais um Código de Produto válido.

Modelo de dados

CampoTipoObrigatórioDescrição
PRODUTOTEXTO(32)SimCódigo do Produto Empresa ao qual o código pertence.
CODIGOTEXTO(32)SimCódigo de barras propriamente dito (EAN, DUN-14, código de balança, etc.).
QTDDECIMALSimQuantidade da Embalagem a que o código se refere (aceita fração).

QTD não é "quantos códigos existem": é a chave que localiza a Embalagem correspondente. Um Código de Produto com QTD = 6 só é válido se já existir uma Embalagem com QTD = 6 cadastrada para o mesmo produto.

Chave e identidade

A chave é o próprio CODIGO — em geral único no sistema, independentemente do produto: dois produtos diferentes não devem compartilhar o mesmo código de barras. PRODUTO + QTD indicam a Embalagem à qual esse código está associado.

Relacionamentos

graph LR
    CB["Código de Produto<br/>CODIGO, QTD"] -->|PRODUTO + QTD| EMB["Embalagem"]
    EMB -->|PRODUTO| PE["Produto Empresa"]
  • Um Código de Produto pertence a uma Embalagem (via PRODUTO + QTD), que por sua vez pertence a um Produto Empresa.
  • Uma Embalagem pode ter zero, um ou mais Códigos de Produto — é comum uma mesma Embalagem ganhar um segundo código com o tempo (reimpressão de rótulo, código regional, promoção).
  • Depende da Embalagem já existir; a Embalagem, por sua vez, depende do Produto Empresa.

Exemplos de uso

Cenário 1 — Cadastro inicial

O produto 4482 tem duas Embalagens (unidade e fardo com 6), cada uma com seu código de barras. Ambos os códigos são informados junto com o cadastro do produto e de suas Embalagens.

Cenário 2 — Produto de peso variável

O queijo mussarela fatiado (produto 7301, Embalagem "GRAMA", QTD = 1) recebe um único Código de Produto de balança, com prefixo 2. Ao ler 2007301 no dispositivo, o RUB identifica o produto 7301 e sabe que a quantidade lida deve ser interpretada em gramas.

Cenário 3 — Novo código de barras para uma Embalagem existente

O fabricante muda a arte da embalagem do fardo com 6 do produto 4482 e o novo lote sai de fábrica com um EAN diferente. O ERP adiciona o novo Código de Produto para a mesma Embalagem (PRODUTO = 4482, QTD = 6), sem remover o código antigo — ambos continuam válidos enquanto houver estoque físico com a etiqueta antiga circulando na loja.

Cenário 4 — Código compartilhado por engano (erro comum)

Dois produtos diferentes acabam recebendo o mesmo CODIGO por erro de cadastro no ERP (por exemplo, reaproveitamento de EAN de um produto descontinuado). Isso é uma inconsistência: ao ler esse código, o dispositivo não tem como saber a qual dos dois produtos ele se refere. A correção correta é sempre desativar/remover o código do produto que não deve mais usá-lo antes de associá-lo ao novo.

Boas práticas

  • Cadastre todos os códigos que podem aparecer fisicamente na loja para aquele produto — inclusive códigos "secundários" usados apenas por algumas embalagens de fábrica.
  • Nunca reutilize um CODIGO para dois produtos diferentes ao mesmo tempo; se um EAN for descontinuado, remova-o do produto antigo antes de vinculá-lo a outro.
  • Garanta que a Embalagem referenciada por PRODUTO + QTD já exista antes de enviar o Código de Produto — a ordem de carga é sempre Produto Empresa → Embalagem → Código de Produto.
  • Para produtos de peso variável, mantenha o padrão de prefixo de balança consistente entre todas as lojas da rede, para que o RUB decodifique o código da mesma forma em qualquer unidade.

Referência na API

O contrato técnico completo dos endpoints de consulta e associação de códigos de barras (resolução de código em GET /{tenantLoja}/api/rest/barcode/{barcode}, schemas aninhados em ProductFull e cargas CSV) encontra-se documentado no Swagger oficial: