B4 Guia

Passo 2 · Localizar e validar o NCM e o CEST

Como pesquisar o NCM na lista oficial, atualizar a lista pela internet, gerar o arquivo NCMs.txt e consultar NCM e CEST pelo GTIN da mercadoria.

Sistema: SoftWay Comercial (Retaguarda) · Atualizado em 21/11/2026

Conteúdo criado com apoio de inteligência artificial · em revisão pela equipe da B4 System

O NCM tem 8 números e é a base de toda a tributação. Errar um número muda o imposto. Por isso o sistema oferece três jeitos de achar o NCM certo: pesquisar na lista oficial, atualizar essa lista e perguntar à base da SEFAZ pelo GTIN (código de barras) da mercadoria.

#Pesquisar na Busca NCM

No Cadastro Mercadoria, clique no ícone ao lado do campo NCM/SH (o mesmo que mostra se o NCM é válido). Abre a Busca NCM.

Janela Busca NCM com os critérios de busca e a lista de resultados

Busca NCM: digite um pedaço da descrição e clique em Filtra NCM.

#O que fazer na tela

  1. Código: digite um NCM completo e válido (8 números) para buscar por ele.
  2. Descrição item: digite uma palavra da mercadoria, como CONDUTORES ou CARREGADORES. Use quando você não sabe o código.
  3. Filtra NCM: faz a pesquisa. Se você preencheu o código e ele for válido, o sistema busca por ele; se não, busca pela descrição.
  4. Ok: devolve o NCM da linha marcada para o cadastro da mercadoria e fecha a janela.
  5. Atualiza NCMs: baixa de novo a lista oficial de NCMs pela internet (veja abaixo).
  6. Baixar lista NCMs: gera o arquivo NCMs.txt na pasta do programa, com a lista completa.
  7. A lista de resultados mostra NCM, Descrição, Início e Fim da vigência. Marque a linha certa e clique em Ok.
Para que serve a vigência

O Início e o Fim dizem de quando a quando aquele NCM vale. Prefira os que ainda estão em vigor. Um NCM extinto pode ser rejeitado pela SEFAZ.

#Atualizar a lista de NCMs

Clique em Atualiza NCMs. O sistema apaga o arquivo antigo da lista (ACBrNCM.json) e pede a lista nova pela internet. Ao terminar, mostra o resultado numa janela de aviso. Faça isso de tempos em tempos, ou quando um NCM novo não aparecer na pesquisa. Precisa de internet.

#Baixar a lista para um arquivo

Clique em Baixar lista NCMs. Quando o arquivo é gerado, aparece rapidamente “Arquivo gerado com sucesso !”. O arquivo NCMs.txt fica na pasta onde o programa está instalado. Se der erro, o sistema mostra o texto do erro numa janela.

#Consultar o NCM e o CEST pelo GTIN

Se você tem o GTIN (código de barras de 8, 13 ou 14 números) da mercadoria, o sistema pode perguntar à base da SEFAZ, pelo serviço da SVRS, qual é o NCM e o CEST dela.

GTIN, NCM e CEST no cadastro da mercadoria

O botão ao lado do GTIN faz a consulta e preenche o NCM e o CEST se você aceitar.

#O que fazer na tela

  1. GTIN: digite o código de barras. Com 13 dígitos, o sistema confere o dígito verificador e recusa códigos inválidos ou que começam com 2 (uso interno).
  2. Botão de consulta ao lado do GTIN: faz a consulta. Exige pelo menos 8 dígitos no GTIN.
  3. NCM/SH: se a consulta achar a mercadoria, você pode atualizar este campo com o NCM encontrado.
  4. Cód. CEST: idem, com o CEST encontrado.

#O que aparece depois da consulta

Se a base achar a mercadoria, o sistema mostra Produto, NCM e CEST e pergunta “Deseja atualizar no cadastro ?”. Sim preenche NCM e CEST na tela (ainda precisa Salvar). Se a base não achar, aparece Retorno da consulta GTIN com o Código retorno e o Motivo.

Janela com o produto, o NCM e o CEST encontrados pela consulta

Em mercadoria já gravada, ao sair do campo GTIN de 13 dígitos (válido) com o NCM em branco, o sistema já pergunta se você quer pesquisar:

Pergunta: deseja pesquisar NCM e CEST na base da SEFAZ pelo serviço da SVRS

Confira antes de aceitar

A consulta traz o NCM e o CEST cadastrados pelo fabricante do código de barras. Eles podem estar diferentes do que o seu contador usa. Confira com ele antes de dizer Sim.

#Mensagens deste passo

O que aparece O que significa O que fazer
“Não existe nenhum registro para a pesquisa informada !” A Busca NCM não achou nada. Tentar outra palavra, ou Atualiza NCMs se a lista estiver velha.
“Arquivo gerado com sucesso !” O arquivo NCMs.txt foi criado. Procurar na pasta do programa.
“Código GTIN informado inválido !” O dígito verificador do GTIN de 13 números não bate, ou começa com 2. Conferir o código de barras.
“A informação do campo GTIN, não é uma informação válida !” e “Este campo deve conter obrigatoriamente 8, 13 ou 14 dígitos.” O GTIN tem outro tamanho. Digitar 8, 13 ou 14 números, ou deixar em branco.
“Retorno da consulta GTIN” com Código retorno e Motivo A base não devolveu a mercadoria. Anotar o motivo e preencher o NCM à mão.
“O GTIN informado está cadastrado com Código : …” Outra mercadoria já usa esse GTIN (como código principal, referência ou GTIN). Conferir se é duplicidade.
© 2026 B4 System · B4 Guia, manual de treinamento. Material criado com apoio de inteligência artificial e em revisão pela equipe da B4 System; pode conter imprecisões. Os exemplos usam dados fictícios e as telas são ilustrações geradas a partir do sistema.