Como fazer consultas em lote no Sintegra (Inscrição Estadual, CNPJ ou CPF) usando Python

Exemplo de integração em Python com a API SINTEGRA da ArquivoNFe, para consulta em lote de dados cadastrais por UF.

A API permite realizar consultas utilizando CNPJ, CPF ou Inscrição Estadual (IE), conforme a disponibilidade da consulta para cada UF.

🔄 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 retorno do script Python para consulta em lote