API de Tabelas Fiscais — NCM, CEST, CFOP e CNAE em JSON grátis (OpenAPI)

Comece em 10 segundos

curl https://tabelasfiscais.com.br/api/v1/ncm/22030000

Ou abra direto no navegador: /api/v1/ncm/22030000 — a API é GET-only com CORS liberado, então dá para testar por link e chamar do front-end.

Especificação OpenAPI

A API é descrita em OpenAPI 3.1: https://tabelasfiscais.com.br/api/openapi.json. Importe no Postman, Insomnia, Bruno ou no Swagger Editor para navegar, testar e gerar clients — com schemas, parâmetros e exemplos de todos os endpoints.

NCM (com IPI e II)

GET /api/v1/ncm/{codigo} — dados de um código (aceita 01012100 ou 0101.21.00); inclui ipi (com vigente_desde, fonte e historico[]), ii (Imposto de Importação/TEC: alíquota aplicada, tec_mercosul, bit_bk, excecao_nacional, tem_ex_tarifario), cest[] e hierarquia. Experimente: cerveja · carne com LETEC
GET /api/v1/ncm/{codigo}?em=AAAA-MM-DD — alíquota de IPI vigente numa data (campo ipi.em). Experimente: em 2023
GET /api/v1/ncm/buscar?q={termo} — busca por código ou descrição (paginação &page=). Experimente: ?q=cerveja
GET /api/v1/ncm/capitulos — lista dos capítulos
GET /api/v1/ncm/capitulo/{cap} — códigos de um capítulo
GET /api/v1/ncm/meta — versão/atualização dos dados

CEST

GET /api/v1/cest/{codigo} — dados de um CEST + NCMs relacionados. Experimente: /cest/0300200
GET /api/v1/cest/buscar?q={termo} — busca por código ou descrição

CFOP

GET /api/v1/cfop/{codigo} — dados de um CFOP + operações equivalentes nos outros âmbitos. Experimente: /cfop/5102
GET /api/v1/cfop/buscar?q={termo} — busca CFOP; cada resultado traz grupo e grupo_nome (entrada/saída · interna/interestadual/exterior) para desambiguar códigos-espelho. Experimente: ?q=devolução

CNAE

GET /api/v1/cnae/{codigo} — dados de uma subclasse + hierarquia (seção → classe). Experimente: /cnae/4751201
GET /api/v1/cnae/buscar?q={termo} — busca por código ou atividade

Exemplo de resposta

Requisição:

curl https://tabelasfiscais.com.br/api/v1/ncm/22030000

Resposta (resumo):

{
  "codigo": "2203.00.00",
  "codigo_num": "22030000",
  "descricao": "Cervejas de malte.",
  "nivel": 8,
  "capitulo": "22",
  "vigente": true,
  "ipi": {
    "aliquota": "3.9",
    "vigente_desde": "2022-08-01",
    "fonte": "TIPI — Decreto nº 11.158/2022",
    "historico": [ { "aliquota": "3.9", "valid_from": "2022-08-01", "valid_to": null } ]
  },
  "ii": {
    "aliquota": "18",
    "tec_mercosul": "20",
    "bit_bk": null,
    "excecao_nacional": null,
    "tem_ex_tarifario": false,
    "fonte": "TEC (Res. Gecex 272/21) — Resolução Gecex nº 812..."
  },
  "cest": [ { "cest": "03.002.00", "segmento": "Cervejas, chopes, refrigerantes…" } ],
  "ato": { "tipo": "Res Camex", "numero": "272", "ano": "2021" },
  "pai": { "codigo": "22.03", "codigo_num": "2203", "descricao": "Cerveja de malte." },
  "filhos": [],
  "_links": { "html": "https://tabelasfiscais.com.br/ncm/22030000" }
}

Erros e limites

400 — {"erro":"parametro_obrigatorio","parametro":"q"} (busca sem q)
404 — {"erro":"nao_encontrado"} (código inexistente) ou {"erro":"endpoint_nao_encontrado"}
429 — limite por IP excedido (60/min; buscas 30/min). Os cabeçalhos RateLimit-* mostram o saldo — respeite-os e use cache local.