Como consultar CNPJ via API no Dart e Flutter.

Aprenda a consultar CNPJ via API no Dart e Flutter com o pacote http: código pronto, leitura do JSON, tratamento de erros e boas práticas. API de CNPJ grátis, sem chave e sem cadastro.

Por que usar a API do openCNPJ no Dart e Flutter

Em apps Flutter, consultar o CNPJ permite preencher formulários de cadastro com um toque. Com o pacote http e o dart:convert, você recebe os dados da empresa em um Map pronto para a interface.

Grátis, sem chave de acesso e sem cadastro.
Resposta em JSON com razão social, situação cadastral, endereço, CNAEs, sócios e Simples Nacional.
Aceita o CNPJ numérico e o novo CNPJ alfanumérico.
Limite de 10 requisições por segundo por IP.

O que você precisa

Dart 3 ou Flutter, com o pacote http (dart pub add http).

Consultar um CNPJ no Dart e Flutter

O endpoint é GET https://api.opencnpj.com.br/cnpj/{cnpj}. Envie o CNPJ com 14 caracteres, sem pontos, barra ou hífen. O exemplo abaixo consulta o CNPJ 06.990.590/0001-23:

import 'dart:convert';
import 'package:http/http.dart' as http;

Future<void> main() async {
  const cnpj = '06990590000123';
  final resposta = await http.get(Uri.parse('https://api.opencnpj.com.br/cnpj/$cnpj'));

  if (resposta.statusCode != 200) {
    throw Exception('HTTP ${resposta.statusCode}');
  }

  final empresa = jsonDecode(utf8.decode(resposta.bodyBytes)) as Map<String, dynamic>;
  print(empresa['razao_social']);
  print(empresa['estabelecimento']['situacao_cadastral']);
}

Requer o pacote http (dart pub add http). Funciona também no Flutter.

Remover a máscara do CNPJ

Se o CNPJ vem formatado (06.990.590/0001-23) de um formulário, banco de dados ou planilha, limpe a pontuação antes de montar a URL. A mesma regra funciona para o CNPJ alfanumérico:

String limparCnpj(String cnpj) =>
    cnpj.replaceAll(RegExp(r'[^0-9A-Za-z]'), '').toUpperCase();

final cnpj = limparCnpj('06.990.590/0001-23'); // "06990590000123"

Campos mais usados da resposta

Campo	Conteúdo
`razao_social`	Nome empresarial
`estabelecimento.nome_fantasia`	Nome fantasia
`estabelecimento.situacao_cadastral`	`Ativa`, `Suspensa`, `Inapta`, `Baixada` ou `Nula`
`estabelecimento.atividade_principal`	CNAE principal, com código e descrição
`estabelecimento.cidade.nome` e `estabelecimento.estado.sigla`	Município e UF
`estabelecimento.cep`, `logradouro`, `numero`, `bairro`	Endereço
`simples.simples` e `simples.mei`	Opção pelo Simples Nacional e MEI
`socios`	Quadro de sócios e administradores

A lista completa de campos está na documentação da API.

Tratando erros

Verifique o status HTTP antes de ler o JSON. Dart: use resposta.statusCode.

Status	O que significa	O que fazer
`200`	CNPJ encontrado	Ler o JSON
`400`	Formato de CNPJ inválido	Conferir os 14 caracteres
`404`	CNPJ não encontrado na base	Informar ao usuário
`429`	Limite de requisições excedido	Aguardar e tentar de novo
`500`	Erro interno	Tentar novamente mais tarde

Os erros também vêm em JSON, com os campos status, titulo e detalhes.

Boas práticas

Defina um timeout na requisição, por exemplo com .timeout(const Duration(seconds: 10)) no Future.
Guarde o resultado em cache se o mesmo CNPJ for consultado com frequência.
Em processamentos em lote, respeite o limite de 10 requisições por segundo.
Os dados refletem a base pública mais recente processada e não substituem certidões oficiais.

Perguntas frequentes

A API de CNPJ do openCNPJ é gratuita?

Sim, 100% grátis. Não há chave de acesso nem cadastro. O limite é de 10 requisições por segundo por IP.

Funciona no Flutter Web?

Sim. A API libera CORS, então a mesma chamada funciona no Android, no iOS e no navegador.

Por que usar utf8.decode no corpo da resposta?

Para garantir que acentos como em “São Paulo” sejam lidos corretamente, independentemente do cabeçalho interpretado pelo pacote.

De onde vêm os dados do CNPJ?

Dos dados abertos do CNPJ publicados pela Receita Federal, complementados por bases públicas. Os dados podem ter defasagem e não substituem certidões oficiais. Veja a origem dos dados.