Correção de Produtos via XML de Compra

Esta tela preenche automaticamente o código de barras (GTIN/CEAN) de produtos que estão cadastrados sem ele, lendo o código diretamente do XML da última nota de compra em que o produto apareceu. Em vez de procurar produto por produto e digitar o código à mão, o sistema localiza o item dentro do XML do fornecedor, confere e sugere o código para você revisar e aplicar em lote.

O que é: uma ferramenta de higienização de cadastro. Lista os produtos ativos sem código de barras, encontra o GTIN no XML da compra mais recente de cada um e atualiza o campo Cód. Barras (GTIN) do produto, com revisão do operador.

Por que ler do XML e não de outro lugar: o código de barras gravado no item da nota nem sempre existe (em parte das importações ele é copiado do próprio produto — que está vazio). O XML do fornecedor, guardado pelo sistema, é a fonte confiável do GTIN real do produto.

Quando usar

• Após migrações/importações em que muitos produtos ficaram sem código de barras.
• Periodicamente, como faxina de cadastro, para preparar os produtos para leitura por leitor de código de barras (PDV, conferência, etc.).
• Sempre que o produto já tiver sido comprado pelo menos uma vez com XML importado.

Pré-requisitos

• O produto precisa ter pelo menos uma compra de entrada importada por XML, e esse XML precisa estar guardado no sistema.
• O fornecedor precisa ter informado o GTIN no XML (nem todo fornecedor preenche).
• Permissão de acesso à tela e, para gravar, a permissão de aplicar correções (ver "Permissões" abaixo).

Abrindo a tela

Abra a tela pelo menus Cadastros > Gerenciar Cadastros. Procure a opção Correção de produto via XML

Passo a passo

1. Pesquisar os produtos sem código de barras

1. (Opcional) Digite um termo no campo Filtro para restringir por código, descrição ou referência de fábrica.
2. (Opcional) Marque "Somente produtos de revenda" para ignorar itens de uso interno/serviço.
3. Clique em Pesquisar.

A grade lista todos os produtos ativos sem código de barras, já com a referência da última compra de cada um (fornecedor, número e data da nota). Essa etapa é rápida — ainda não abre os XMLs.

2. Processar todos (ler os XMLs)

Clique em Processar todos. O sistema abre os XMLs das compras, localiza cada produto dentro da nota e preenche a coluna CEAN encontrado, atualizando a coluna Status. Uma barra de progresso acompanha o andamento.

O processamento roda em segundo plano: a tela continua respondendo e você pode acompanhar o progresso. Cada XML é lido uma única vez, mesmo que vários produtos venham da mesma nota — por isso é rápido mesmo com muitos produtos.

3. Revisar os resultados

Ao terminar, as linhas ficam coloridas conforme o resultado, e os casos confiáveis já vêm pré-marcados na coluna Aplicar?:

• Verde — código de barras encontrado e confiável (pré-marcado para aplicar).
• Amarelo — encontrado, mas precisa da sua conferência (divergência ou código já usado por outro produto). Não vem marcado.
• Vermelho — não foi possível obter o código (sem compra, XML indisponível, item não localizado ou fornecedor não informou o GTIN).

Você pode marcar/desmarcar manualmente qualquer linha na coluna Aplicar?.

4. Aplicar selecionados

Confira as linhas marcadas e clique em Aplicar selecionados. O sistema grava o código de barras nos produtos marcados, registra a alteração no histórico de atividades e atualiza a coluna CEAN atual.

Se alguma linha marcada tiver código já usado por outro produto, o sistema avisa e pede confirmação antes de aplicar. Confirme apenas se tiver certeza (ver "Código já usado" abaixo).

%%INSIRA PRINT DA CONFIRMAÇÃO DE APLICAÇÃO E DA MENSAGEM DE SUCESSO%%

Entendendo a coluna Status

Como o sistema encontra o código de barras

O ponto central é localizar, dentro do XML da compra, qual item corresponde ao seu produto. O sistema faz isso sempre pelo código do produto no fornecedor (o cProd do XML), usando a posição do item (nItem) apenas como confirmação. Ele procura o código em três fontes, nesta ordem:

1. Código do fornecedor gravado na própria nota (quando a importação registrou).
2. De-para Produto × Fornecedor — a tabela de "código do produto no fornecedor" que o sistema monta nas importações.
3. Referência de Fábrica do cadastro do produto (campo Ref. Fábrica), que muitas vezes guarda o código do fornecedor.

Por que não usar só a posição do item: a posição (1º, 2º, 3º item da nota) sozinha é frágil — pode apontar o produto errado. Por isso a regra é validar sempre pelo código; a posição só serve para reforçar a certeza.

Divergência: se o código apontar um item e a posição apontar outro, a linha fica como "Revisar" (amarelo) e não é marcada automaticamente — cabe a você conferir.

Se a compra mais recente não trouxer um GTIN válido, o sistema tenta automaticamente as compras anteriores do mesmo produto, da mais recente para a mais antiga, até encontrar um código válido.

Notas canceladas são ignoradas: o sistema não considera notas de entrada canceladas ao procurar o código.

Validações do código de barras

• Aceita apenas GTIN numérico com 8, 12, 13 ou 14 dígitos.
• Confere o dígito verificador do GTIN; códigos com dígito inválido são recusados.
• Descarta valores inválidos como SEM GTIN e sequências de zeros.
• Quando o produto também está sem o GTIN tributável, ele é preenchido junto, a partir do XML.

Código já usado por outro produto

Se o GTIN encontrado já existe em outro produto, a linha é marcada como "Já usado pelo produto X" e não vem pré-selecionada. Isso normalmente indica:

• Produtos duplicados no cadastro (o mesmo item cadastrado duas vezes) — o ideal é unificar.
• Ou um fornecedor reaproveitando o mesmo código para itens diferentes (raro).

Aplique nesses casos somente após confirmar que é o produto correto.

Permissões

A tela respeita o sistema de Permissões V2:

• Acesso à tela: controlado pela permissão de acesso da própria tela (criada automaticamente ao cadastrá-la), liberável por perfil/operador.
• Aplicar correções: ação CADASTRO.PRODUTO.CORRECAOXML.APLICAR. Quando bloqueada, o operador pode abrir, pesquisar e processar (ver as sugestões), mas o botão Aplicar selecionados fica desabilitado.

Assim é possível, por exemplo, deixar um operador conferir os resultados sem permissão de gravar, e reservar a aplicação para um supervisor.

Boas práticas

• Comece marcando "Somente produtos de revenda" para focar no que vende.
• Aplique primeiro os verdes (confiáveis) e trate os amarelos em uma segunda passada, com calma.
• Use a aplicação em lote, mas confira sempre os conflitos antes de confirmar.
• O histórico de cada alteração fica registrado no log de atividades do produto (quem aplicou, qual código, de qual nota).

Perguntas frequentes

Glossário