REST API

Integre inteligência fiscal ao seu produto.

API REST completa para classificação tributária NCM-first. ICMS, PIS/COFINS, IPI, CBS e IBS em uma chamada. Sandbox gratuito com dados reais, SDKs prontos e latência inferior a 20ms.

Criar conta grátis Ver documentação

Sandbox ilimitado Sem cartão OpenAPI 3.1

  $ curl -X POST \
    "https://api.fiscum.com.br/v1/regras-fiscais" \
    -H "X-API-Key: fsc_live_..." \
    -H "Content-Type: application/json" \
    -d '{"cabecalho":{"cnpj":"12345678000190","crt":3,"regimeTrib":"R","amb":1,"contribuinte":1},"uf":["SP"],"produto":[{"codigo":"7891234567890","descricao":"AGUA MINERAL 500ML","tipoCodigo":0}]}'

  // Resposta em <20ms (cache hit)
  {
    "grupo": [{ "ncm": "22021000", "regra": [{
      "uf": "SP", "aliqicms": 18,
      "cfopVenda": "5405"
    }]}]
  }
          

Para quem é

Construída para quem constrói

A API Fiscum é a camada fiscal que falta no seu produto. Uma integração, todas as regras tributárias do Brasil.

Software Houses

Adicione classificação fiscal ao seu ERP, PDV ou sistema fiscal sem construir e manter um motor de regras próprio. Foque no seu produto.

ERPs e Sistemas Fiscais

Integração direta com TOTVS, SAP, Senior e qualquer sistema via REST. Regras de todas as UFs atualizadas em tempo real.

E-commerce e Marketplaces

Cálculo tributário correto no checkout. NCM-first para produtos a granel, importados e fabricação própria que EAN não cobre.

Como integrar

Três passos para a primeira chamada

Do cadastro à primeira resposta em menos de 5 minutos. Sem burocracia, sem reunião comercial.

Crie sua conta

Cadastro gratuito, sem cartão de crédito. Acesso imediato ao sandbox de homologação com dados fiscais reais.

Obtenha sua API key

Gere sua chave no painel. Uma key para sandbox, outra para produção. Rotação automática disponível.

Faça a primeira chamada

Use o cURL, SDK ou Postman Collection. A resposta chega em menos de 20ms com todas as alíquotas calculadas.

Endpoints principais

Endpoints organizados por categoria

Cobertura completa de classificação tributária, consultas NCM/GTIN, calculadoras, webhooks e gestão de conta.

Regras Fiscais

POST /v1/regras-fiscais
POST /v1/alterados
POST /v1/produto/classificar
POST /v1/regime-especial/buscar

NCM

GET /v1/ncm/{ncm}
GET /v1/ncm/{ncm}/validar
POST /v1/ncm/sugerir
GET /v1/ncm/{ncm}/historico
GET /v1/ncm/{ncm}/reforma

GTIN

GET /v1/gtin/{gtin}/validar
GET /v1/gtin/{gtin}/enriquecer
POST /v1/gtin/bulk

Calculadoras

POST /v1/calcular/difal
POST /v1/calcular/icms-st
POST /v1/calcular/municipio
POST /v1/calcular/transparencia-fiscal

Webhooks e Changelog

POST /v1/webhooks/subscribe
GET /v1/webhooks
DELETE /v1/webhooks/{id}
GET /v1/changelog

Conta e Sistema

POST /v1/auth/api-key/gerar
DELETE /v1/auth/api-key/{id}
GET /v1/status-cliente/{cnpj}
GET /v1/minha-conta/uso
GET /v1/health
GET /v1/metrics

Ver documentação completa →

SDKs e ferramentas

Comece na sua linguagem

SDKs oficiais, Postman Collection e especificação OpenAPI 3.1 para gerar clientes em qualquer linguagem.

Node.js

npm install @fiscum/sdk

TypeScript nativo, promises, retries automáticos.

Python

pip install fiscum

Tipado, async/await, compatível com FastAPI e Django.

Postman Collection

Importar via URL

Todos os endpoints prontos para testar no Postman.

OpenAPI 3.1

fiscum.com.br/openapi.yaml

Gere clientes em qualquer linguagem automaticamente.