Classificar NCM (Nomenclatura Comum do Mercosul) pra 3.000 a 50.000 produtos de um cliente é uma das tarefas mais chatas da implantação. Cada produto tem uma descrição livre no cadastro do cliente ("PARAFUSO SEXT 5X30 INOX A2") e precisa virar um código NCM de 8 dígitos que o fisco aceita. Fazer manualmente leva ~30 segundos por produto — em uma base média de 8.000 SKUs isso vira ~66 horas de tédio + risco de erro fiscal. A classificação NCM com IA do Acelerador resolve em ~2 horas de processamento total.

Onde encontrar

Duas entradas:

1. Direto na tela Cadastros → SB1 · Produtos, botão "Classificar NCM com IA"
2. Durante o import SPED, quando o parser identifica SKUs novos sem NCM

Arquitetura em 3 camadas de cache

A classificação NCM é cara em API externa (BrasilAPI tem rate limit). Pra escalar, o Acelerador usa cascata:

Camada L1 — Memória

Cache em memória do browser durante a sessão. Se o mesmo NCM já foi buscado nos últimos minutos, resposta imediata. Zerado ao fechar a aba.

Camada L2 — Supabase (tabela ncm_cache)

Cache persistente no banco. Cada NCM já classificado (por qualquer cliente do tenant) fica gravado com:

• Código NCM (8 dígitos)
• Descrição oficial (do Mercosul)
• Alíquota IBPT estimada (impostos.br)
• Data da última atualização
• Contador de uso

TTL de 30 dias. Se cai fora do TTL, revalida na próxima consulta.

Camada L3 — BrasilAPI

Só cai aqui se L1 e L2 não têm. Throttle de 1 req/s pra não abusar da API pública.

Resultado: ~92% das classificações resolvem em L1/L2, ~8% vão pra L3. Em uma base de 8.000 SKUs, o rate limit da BrasilAPI (que seria fatal com 8000 requests) fica em ~640 requests reais — ~11 minutos de throttle.

Sugestão automática por descrição

Pra produto novo sem NCM, o agente classifica automaticamente usando Claude Sonnet 4.6 lendo:

• Descrição do produto (texto livre)
• Segmento do cliente (CNAE)
• Base histórica de NCMs já usados pelo cliente
• Regras da NCM (mãe do capítulo, posição, subposição, item, subitem)

O modelo devolve NCM sugerido com confidence score:

• confidence ≥ 0.85 — auto-aprovado
• 0.7 ≤ confidence < 0.85 — auto-aprovado com marker "revisão sugerida"
• confidence < 0.7 — cai na tela de revisão manual

Tela de revisão manual

Produtos com baixa confiança aparecem numa tela dedicada com:

• Descrição original do produto
• Top 3 NCMs candidatos (com racional)
• Alíquotas de cada candidato
• Botão de aceitar + botão de digitar manual
• Contexto: outros produtos parecidos que o cliente já classificou

Consultor decide em ~5 segundos por SKU em vez de 30 segundos partindo do zero.

Integração com Reforma Tributária 2026

Quando o NCM é decidido, ele automaticamente vincula:

• F2A (alíquota CBS/IBS) — aplica alíquota do NCM correto
• F2B (cesta básica) — marca se o NCM está na lista oficial
• F2H (Imposto Seletivo) — marca se é NCM sujeito a IS
• CJE (configurador por item) — cadastra vinculação automática

Isso significa que classificar NCM não é uma tarefa isolada — é o input que alimenta toda a Reforma Tributária 2026 no Protheus do cliente.

Envio ao Protheus

Depois de classificado e revisado, o SB1 vai pro Protheus via U_BEEITSYNC. Grava campo B1_POSIPI (NCM) + campo custom B1_XALIQCB (CBS alíquota) + B1_XALIQIE (IBS Estadual) + B1_XALIQIM (IBS Municipal), e vincula o CJE correspondente. Tudo rastreável em audit_log.

Um caso real

Distribuidora com 12.000 SKUs, ~40% sem NCM cadastrado. Sem IA:

• Consultor classifica manual: ~30 s por SKU x 4800 = 40 h
• Digitação no Protheus: ~10 s por SKU x 4800 = 13 h
• Total: 53 h

Com IA:

• Import da base de produtos: 2 min
• Classificação automática: ~11 min (11k respondidos por cache, 1k via BrasilAPI throttled)
• Revisão de baixa confiança (~200 SKUs): ~30 min
• Envio ao Protheus batch: ~4 min
• Total: ~48 minutos — redução de 98,5%

Como testar

Cria conta gratuita em implantacao.com.br/signup:

1. Sobe uma planilha ou SPED com produtos do cliente
2. Vai em SB1 · Produtos e clica "Classificar NCM com IA"
3. Revisa as sugestões de baixa confiança
4. Envia ao Protheus

Trial de 14 dias sem cartão. Veja também: sugTES e Configurador RT 2026.

← Voltar pro blog