Motor de regras fiscais com NCM como chave primária. ICMS por estado, PIS/COFINS, IPI e CBS/IBS da Reforma Tributária em um único retorno JSON. Estrutura JSON limpa e documentada. Integração em minutos.
Construído do zero com as premissas corretas — NCM como chave primária, Reforma Tributária nativa, formato padronizado e documentado.
O NCM é a chave primária de toda a tributação. Produto sem EAN? Funciona. EAN inválido? Funciona. Fabricação própria sem código de barras? Funciona. Nunca falha por dependência de código comercial.
A Calculadora CBS/IBS/IS da Receita Federal roda como sidecar local embarcado. Conformidade garantida com as alíquotas e regras oficiais, atualizadas automaticamente pelo repositório público da RF.
JSON de retorno com campos padronizados e bem documentados. Troca a URL e a chave — nenhum código de parsing precisa ser alterado. Campos novos chegam como extensões não-obstrutivas.
Notificação automática quando regras dos seus NCMs são alteradas. DOU monitorado diariamente. CONFAZ monitorado para Convênios ICMS. Sem polling, sem chamadas desnecessárias.
Integração com a API GS1 Brasil (CNP) para resolver automaticamente o NCM a partir do GTIN. Quando você tem só o código de barras, o Classifica descobre o NCM e retorna as regras corretas.
Cada NCM retorna o cronograma completo da Reforma Tributária: alíquotas CBS e IBS por ano, quando PIS/COFINS são extintos, quando ICMS e ISS encerram. Planejamento tributário integrado ao retorno.
OpenAPI 3.1 disponível para download. Autenticação via API Key no header X-API-Key ou Authorization: Bearer.
| Método | Endpoint | Descrição | Auth |
|---|---|---|---|
| POST | /v1/auth/api-key/gerar | Rotaciona a API Key do parceiro. A chave anterior é invalidada. | API Key |
| DELETE | /v1/auth/api-key/{id} | Revoga a API Key do parceiro pelo ID. | API Key |
| POST | /v1/regras-fiscais | Consulta principal. Retorna regras ICMS (27 UFs), PIS/COFINS, IPI, CBS/IBS por NCM. Até 500 produtos por chamada. | API Key |
| GET | /v1/ncm/{ncm} | Info completa de um NCM + TIPI + CEST. | API Key |
| GET | /v1/ncm/{ncm}/validar | Verifica existência de um NCM na base vigente. | API Key |
| POST | /v1/ncm/sugerir | Busca NCMs por similaridade textual de descrição de produto. | API Key |
| GET | /v1/ncm/{ncm}/historico | Alterações regulatórias por UF. Filtrável com parâmetro ?uf=XX. | API Key |
| GET | /v1/ncm/{ncm}/reforma | Timeline CBS/IBS 2026–2033. Filtrável com parâmetro ?uf=XX. | API Key |
| GET | /v1/gtin/{gtin}/validar | Valida check digit de um código GTIN/EAN. | API Key |
| GET | /v1/gtin/{gtin}/enriquecer | Resolve GTIN para NCM com fallback multi-fonte. | API Key |
| POST | /v1/gtin/bulk | Enriquecimento GTIN para NCM em lote. Até 100 GTINs por chamada. | API Key |
| POST | /v1/calcular/difal | Cálculo de DIFAL para operações interestaduais. | API Key |
| POST | /v1/calcular/icms-st | Cálculo de ICMS-ST + MVA. | API Key |
| POST | /v1/calcular/municipio | Cálculo de ICMS municipal. | API Key |
| POST | /v1/calcular/transparencia-fiscal | Decomposição tributária completa para transparência fiscal. | API Key |
| GET | /v1/changelog | Lista paginada de alterações regulatórias (DOU, CONFAZ, SEFAZs). Filtros por UF, NCM, tipo e data. | API Key |
| POST | /v1/webhooks/subscribe | Cadastra endpoint para receber notificações push de mudanças regulatórias. | API Key |
| DELETE | /v1/webhooks/{id} | Remove um webhook cadastrado. | API Key |
| GET | /v1/webhooks | Lista todos os webhooks ativos da conta. | API Key |
| GET | /v1/status-cliente/{cnpj} | Status operacional do cliente por CNPJ. | API Key |
| GET | /v1/minha-conta/uso | Métricas de consumo da conta (requisições, limites, uso). | API Key |
| POST | /v1/produto/classificar | Classificação ABC de produto. | API Key |
| POST | /v1/regime-especial/buscar | Busca regimes especiais tributários por UF, com filtros por CNAE e tipo. | API Key |
| POST | /v1/alterados | Produtos com regras alteradas desde a última consulta do CNPJ. | API Key |
| GET | /v1/health | Verificação de saúde do sistema. Não requer autenticação. | Público |
| GET | /v1/metrics | Métricas operacionais: latência, cache hit rate, contadores e uptime. | API Key |
Cada campo segue nomenclatura fiscal padronizada. Os campos cbs, ibs e _fiscum são extensões Fiscum.
Em menos de 5 minutos você faz a primeira chamada. Escolha a linguagem:
Infraestrutura projetada para latência abaixo de 20ms no p99 com dados sempre consistentes.
Banco de regras com índices otimizados e suporte a vigências temporais. Regras históricas preservadas — auditoria retroativa de qualquer data.
TTL configurável por regra. Cache invalidado automaticamente quando a regra é alterada. Hit rate médio de 98% em produção.
A Calculadora CBS/IBS/IS da Receita Federal roda como container dedicado. Atualizada automaticamente via repositório oficial. Nunca desatualizada.
Workers assíncronos para processamento de batches grandes, monitoramento do DOU e CONFAZ, e disparo de webhooks. Zero perda de eventos mesmo sob carga.
Autenticação, criptografia e conformidade com LGPD em todas as camadas.
Access token 15 minutos + refresh token 30 dias via OAuth2. API Key para integração server-to-server com rotação automática opcional.
Limites configuráveis por API Key. Headers X-RateLimit-Remaining e Retry-After em todas as respostas para controle do cliente.
Toda comunicação criptografada com TLS 1.3. Certificados com auto-renovação. HSTS habilitado.
Os NCMs consultados não são dados pessoais. Nenhum dado de titular é processado na consulta de regras. DPA disponível para contratos Enterprise.
Sandbox com dados fiscais reais. Sem cartão de crédito.