Aplicacao

A consulta em lote é a forma mais eficiente de validar grandes volumes de CNPJs e CPFs em uma única operação. Ideal para consultas massivas pontuais como saneamento de base, migração de sistema, auditoria fiscal e enriquecimento de cadastros existentes.

O serviço opera através da troca segura de arquivos via FTPS ou pela interface web da plataforma. Você envia uma planilha com os documentos a serem consultados (Excel, CSV ou TXT) e recebe os resultados processados no mesmo formato, prontos para importar no seu sistema.

Ilustração de processamento de consultas em lote

Como funciona

  • 01
    Envio seguro

    Upload dos arquivos via FTPS seguro ou pela interface web da plataforma.

  • 02
    Processamento

    Consultas automatizadas em lote nos principais portais publicos de informacao.

  • 03
    Resultado

    Retorno dos dados processados nos formatos Excel, CSV ou TXT, prontos para uso.

Quando usar a consulta em lote

A consulta em lote faz sentido sempre que você precisa processar grandes volumes de uma vez, sem a necessidade de tempo real. Os principais cenários são:

  • Saneamento de base completa — revalidar toda a base de clientes ou fornecedores periodicamente
  • Migração de sistema — antes de carregar dados em um novo ERP ou CRM, validar e atualizar tudo de uma vez
  • Auditoria fiscal e SPED — conferir a regularidade de centenas ou milhares de fornecedores antes de fechamentos contábeis
  • Onboarding inicial — processar uma base recém-comprada ou herdada de outra empresa
  • Pré-campanha de marketing — validar a base antes de uma campanha grande, evitando envios para CNPJs baixados ou CPFs irregulares

O que pode ser consultado em lote

Praticamente todos os endpoints da nossa API REST estão disponíveis no modo lote. Os mais usados são:

  • Consulta CNPJ na Receita Federal — razão social, situação cadastral, CNAE, endereço, quadro societário
  • Consulta CPF na Receita Federal — situação cadastral e dados básicos
  • Simples Nacional e SIMEI — identificação de optantes em massa
  • Sintegra (Inscrição Estadual) — validação em todos os 27 estados
  • Certidões Negativas — PGFN, FGTS, TST, MTE, CND Estadual
  • Listas restritivas — CEIS, CEPIM, CNEP, OFAC, ONU para due diligence

Perguntas frequentes

Qual o volume mínimo para usar consulta em lote?

Não há volume mínimo técnico. Mas o serviço faz mais sentido a partir de algumas centenas de documentos — abaixo disso, normalmente é mais ágil usar a API REST individual.

Em quanto tempo recebo o resultado?

Depende do volume e do tipo de consulta. Lotes pequenos (até 5 mil documentos) são processados em algumas horas. Lotes maiores podem levar de algumas horas a poucos dias úteis. O cronograma é alinhado no início de cada projeto.

Quais formatos de arquivo são aceitos?

Excel (.xlsx, .xls), CSV e TXT. O arquivo deve conter uma coluna com os números de CNPJ ou CPF (com ou sem formatação). Para consultas Sintegra, também é necessária a coluna de UF.