Como consultar CNPJ na Receita Federal usando Python?

Exemplo de integração em Python com a API de Consulta CNPJ da Receita Federal da ArquivoNfe, para obtenção automatizada de dados cadastrais de empresas brasileiras.

A API permite consultar informações de empresas por meio do CNPJ, com opção de incluir o Quadro de Sócios e Administradores (QSA).

A integração utiliza processamento assíncrono por meio do request_id, permitindo enviar solicitações e consultar seus respectivos resultados posteriormente.

🔄 Fluxo de consulta assíncrona 

A API utiliza processamento assíncrono baseado em request_id. As consultas normalmente apresentam retornos muito rápidos, podendo ocorrer em milissegundos ou segundos, dependendo da consulta e dos sistemas envolvidos.

Fluxo:

1. Sem request_id → inicia a consulta e retorna o request_id.

2. Com request_id → retorna o resultado da consulta.

Essa arquitetura evita manter a sessão aguardando o processamento, que pode depender de sistemas externos, como o SINTEGRA.

📦 Consultas em lote

Para consultar várias empresas, a aplicação pode:

1. Enviar todas as requisições e armazenar os request_id retornados.

2. Percorrer novamente o lote e consultar os resultados.

Enquanto as demais requisições são enviadas, as primeiras muito provavelmente já estarão processadas. Assim, quando a aplicação consulta os respectivos request_id, boa parte dos resultados, senão todos, pode já estar disponível.

Esse modelo proporciona melhor aproveitamento dos recursos e maior eficiência no processamento de lotes.

Exemplo de envio e retorno da API em Python