Primeiros passos
Sobre
Uma forma simples de consultar empresas brasileiras pelo CNPJ.
Para que serve
Os dados de CNPJ são públicos, mas nem sempre é fácil chegar até eles: ficam atrás de CAPTCHA ou espalhados em vários arquivos. Aqui você manda o número do CNPJ e recebe a resposta em JSON, sem chave e sem cadastro.
GET /06.990.590/0001-23Quer só ver funcionando? Na página de testes você digita o CNPJ e recebe o comprovante de inscrição, um resumo e o JSON.
Como funciona
Esta API não guarda uma base própria. Quando você faz uma consulta, ela confere se o CNPJ é válido e pergunta para a Minha Receita. Se ela não responder, tenta a ReceitaWS. Você recebe o que o provedor devolveu, e o header X-Source diz qual foi.
- Funciona com CNPJ numérico e alfanumérico, com ou sem pontos, barra e traço.
- CNPJs inválidos são recusados na hora, sem gastar consulta dos provedores.
- Dá para chamar direto do navegador (CORS liberado).
- Nada do que você consulta fica guardado.
Créditos
Este projeto é feito pela JUCA Soft e é um cliente da Minha Receita e de outros provedores do mesmo serviço. Os dados, a infraestrutura e o trabalho de manter tudo atualizado são deles, e é por causa desse trabalho aberto que esta API existe.
Quer ter a sua própria versão?
Se você precisa de mais controle ou de disponibilidade garantida, o caminho é rodar a sua própria API de CNPJ. Um bom ponto de partida é a base do projeto BrasilAPI, que é de código aberto. Para hospedar a base completa, veja também como montar o seu servidor da Minha Receita.