Guias da API de CNPJ
Doze guias curtos para usar a consulta de empresas no seu sistema. Cada exemplo roda contra a API de verdade.
- Validar o CNPJ, inclusive o alfanumérico, antes de consultarConfira os dígitos verificadores no seu sistema e só gaste consulta com CNPJ que pode existir. Funciona com o CNPJ de números e com o novo, com letras.
- Preencher um cadastro pelo CNPJA pessoa digita o CNPJ e o formulário se preenche sozinho: razão social, endereço, telefone e e-mail públicos, com o código IBGE da cidade.
- Autocompletar empresa pelo nomeQuem não sabe o CNPJ digita o nome e escolhe na lista. A busca devolve até 50 empresas ativas, com cidade, estado e se é matriz ou filial.
- Conferir a situação cadastral antes de emitir a notaAntes de faturar para uma empresa, veja se ela está ativa na Receita. A ficha traz a situação e a data em que ela começou.
- Ler os sócios e entender a máscara do CPFA rota de sócios traz nome, qualificação, data de entrada e faixa etária. O CPF de quem é pessoa física nunca sai inteiro: vem só a máscara.
- Tratar o 402 e o retry-after sem ser bloqueadoSão 60 consultas por minuto e 2.000 por dia, por IP, sem chave. Quem fica dentro desse limite nunca é bloqueado. Quem passa recebe 402 com o código limite_gratis e espera o retry-after antes de voltar. Este guia mostra a regra e o código.
- Guardar as respostas do jeito certoCada resposta diz por quanto tempo pode ser guardada. Respeitar esse tempo deixa o seu sistema mais rápido e longe do limite.
- Consultar CNPJ de dentro do Claude e do ChatGPTCom o conector oficial da Wortic, você pede em português e a IA consulta a empresa na base da Receita, sem escrever código.
- Enriquecer uma planilha de CNPJs dentro do limiteUma lista de CNPJs vira uma lista com razão social, situação e estado. Uma consulta por segundo, sem repetir CNPJ e sem gastar consulta com número errado.
- Matriz e filial na respostaCada endereço de uma empresa tem o seu CNPJ. Os 8 primeiros números são a raiz e juntam matriz e filiais; os 4 seguintes dizem qual endereço é.
- O que a base do CNPJ diz e o que ela não dizA ficha mostra o cadastro que a empresa declarou à Receita. Saber o que ela não traz evita conclusão errada no seu sistema.
- Como a API responde sem banco de dadosA API lê a base da Receita direto de arquivos jsonW, o formato de dados da Wortic, grátis para usar. Não há servidor de banco entre o pedido e a resposta.