LC 214/2025 · Reforma tributária do consumo

IBS e CBS classificados
por API.

A e-fiscal determina o cClassTrib e o CST corretos para cada produto e operação fiscal — pronta para integrar com qualquer sistema de emissão de NF-e ou ERP.

Ver documentação → Solicitar acesso →

// classifica medicamento ANVISA — venda padrão

$ GET /api/v1/classificar/30049099?cfop=5102

HTTP 200

{

"cclasstrib": "200009",

"cst": "200",

"p_red_ibs": 60, "p_red_cbs": 60,

"dispositivo": "art. 128 — Anexo XII",

"camada": 1, "is_fallback": false

}

CSTs
IBS/CBS

cClassTribs
mapeados

138+

NCMs pré-
classificados

CFOPs com
override

200

NCMs por
lote

Arquitetura

Duas camadas, na ordem certa.

A operação (CFOP) é avaliada antes do produto (NCM). Isso evita classificações erradas em transferências, exportações e bonificações.

Entrada

Recebe NCM e CFOP

O NCM do produto é obrigatório. O CFOP da operação é opcional — quando informado, ativa a avaliação da Camada 2. Pontuação no NCM é ignorada automaticamente.

GET /api/v1/classificar/{ncm}?cfop=5102

Camada 2 — prioridade máxima

O CFOP determina o cClassTrib?

Alguns CFOPs fixam o cClassTrib independentemente do produto — transferência entre filiais, exportação, bonificação, combustíveis. 35 CFOPs mapeados.

Sim — override

Retorna direto

Ex: CFOP 5152 → 410002 sempre, independente do NCM

Não — continua

Vai para Camada 1

Os demais CFOPs seguem para classificação por produto.

Camada 1 — padrão

Busca o NCM na tabela

Percorre do mais específico ao mais geral: 8 dígitos → 6 → 4 → 2 (capítulo). Se nenhum bater, retorna 000001 com is_fallback: true.

138+ NCMs mapeados · fallback automático para 000001

✓

Resultado

Campos prontos para o Grupo UB da NF-e

Campos retornados

cClassTribCST pRedIBSpRedCBS dispositivo_lc214 camadais_fallback

Referência

Endpoints.

Todas as requisições exigem o header X-Api-Key: sua-chave.

GET /api/v1/classificar/{ncm} Endpoint principal ▾

Classifica um item aplicando Camada 2 (CFOP) e Camada 1 (NCM) em sequência. O parâmetro cfop ativa o override da operação.

Parâmetros

ncmstring8 dígitos. Pontuação ignorada automaticamente.

cfopstring?CFOP da operação. Pode sobrescrever a classificação do NCM.

destinatariostring?publico · pcd · prouni · zfm

Resposta — transferência entre filiais (CFOP 5152)

{ "cclasstrib": "410002", "cst": "410", "valores_zerados": true, "camada": 2 }

POST/api/v1/classificar/loteAté 200 NCMs▾

Classifica múltiplos itens em uma chamada. Cada item pode ter NCM, CFOP e destinatário independentes. Ideal para sincronizar catálogos.

Body

{ "itens": [{ "ncm": "30049099", "cfop": "5102" }, ...] }

POST/api/v1/classificar/eanClassificar por EAN via IA▾

Classifica um produto pelo código de barras (EAN) e descrição usando IA. Se o EAN já estiver na base, retorna direto. Se não, a IA classifica, salva e retorna com score de confiança (1–5).

Body

{ "ean": "7891910000197", "descricao": "AÇÚCAR REFINADO 1KG" }

GET/api/v1/cclasstribTabela de referência▾

Lista todos os cClassTribs com CST, percentuais de redução e dispositivo legal. Filtros: ?cst=200 · ?documento=nfce · ?relevancia=4

GET/api/v1/cfop/overridesCFOPs com override▾

Lista os 35 CFOPs que ativam a Camada 2 — transferências entre filiais, exportações, bonificações, amostras e combustíveis. Útil para exibir no ERP ao lado do campo CFOP.

GET/api/v1/ncm/{ncm}/mapeamentosAuditoria▾

Mostra todos os cClassTribs mapeados para um NCM, com variações por destinatário e a precisão da busca (8, 6, 4 ou 2 dígitos).

GET/api/v1/statusHealth check▾

Status da API, versão, módulos ativos e data da última sincronização com o SVRS.

Resposta

{ "status": "ok", "versao": "2.0.0", "modulos": ["classificacao_ncm", "classificacao_cfop", "ean_ia"] }

IBS e CBS classificados
por API.

Duas camadas, na ordem certa.

Endpoints.

Solicitar token.

Solicitação recebida.

IBS e CBS classificadospor API.

Duas camadas, na ordem certa.

Endpoints.

Solicitar token.

Solicitação recebida.

IBS e CBS classificados
por API.