Consulta de CNPJ por Lote
Consulta de CNPJ en lote:
toda tu lista de una vez.
Envía hasta 10.000 CNPJ por la API o sube un archivo CSV en el panel y recibe la razón social, la situación de registro, el CNAE, la dirección y los socios de cada empresa. Solo los CNPJ encontrados consumen crédito.
50 créditos gratis al mes, sin tarjeta de crédito.
Qué recibes
Diez mil CNPJ. Una solicitud.
La cola, el paralelismo y los reintentos quedan de nuestro lado. Tú envías la lista y la sigues.
Hasta 10.000 CNPJ por lote
La lista entera va en un POST y el jobId vuelve al instante. Los duplicados se eliminan, así que cada CNPJ se consulta y se cobra una sola vez.
Resultados parciales durante el proceso
Cada consulta de estado muestra cuántos CNPJ ya se procesaron y los registros listos, sin esperar a que termine el lote.
Los mismos campos que la Consulta de CNPJ
Cada CNPJ encontrado vuelve con el registro completo: razón social, situación de registro, CNAE, dirección y cuadro de socios. Uno no encontrado vuelve con found: false.
razao_socialsituacao_cadastralcnae_principalmunicipioufQSAPlanilla, sin programar
En el panel, sube un archivo CSV o TXT o pega la lista. La columna de CNPJ se detecta sola, y el resultado sale en un CSV listo para abrir en Excel.
Cómo funciona
Envía la lista. Sigue el lote.
El procesamiento es asíncrono: tu solicitud no se queda esperando a que terminen diez mil consultas.
- 01
Envía la lista
Un POST /cnpj/bulk con el arreglo de CNPJ. La respuesta llega al instante con el jobId, y el procesamiento sigue en segundo plano.
- 02
Sigue el lote
Consulta GET /cnpj/bulk/{jobId} cuando quieras. El seguimiento no consume crédito y funciona incluso con saldo cero.
- 03
Usa el resultado
Un ítem por CNPJ, con el mismo registro de la consulta individual. En el panel, descargas el CSV listo.
¿Un CNPJ a la vez? Usa la Consulta de CNPJ. Para personas físicas, existe la Consulta de CPF por Lote.
Intégrala en cualquier lenguaje
Dos pasos: envías la lista de CNPJ y luego consultas el lote. Nada más allá de HTTP.
# Paso 1: POST con un arreglo de CNPJs en JSON
curl -X POST "https://api.cpfhub.io/cnpj/bulk" \
-H "x-api-key: TU_API_KEY" \
-H "content-type: application/json" \
-d '{"cnpjs": ["11222333000181", "12ABC34501DE35"]}'
# → 202 Accepted { "jobId": "4a1ef25e-052c-4464-..." }
# Paso 2: polling hasta que el estado sea "done"
curl "https://api.cpfhub.io/cnpj/bulk/4a1ef25e-052c-4464-9657-4148f53bb0fc" \
-H "x-api-key: TU_API_KEY"{
"success": true,
"data": {
"id": "4a1ef25e-052c-4464-9657-4148f53bb0fc",
"status": "done",
"total_records": 2,
"processed": 2,
"found": 1,
"not_found": 1,
"skipped": 0,
"error": null,
"cnpjs": [
{
"cnpj": "11222333000181",
"found": true,
"data": {
"cnpj": "11222333000181",
"razao_social": "EMPRESA EXEMPLO LTDA",
"situacao_cadastral": "Ativa",
"cnae_principal": "6201501",
"uf": "SP",
"municipio": "SAO PAULO"
}
},
{
"cnpj": "12ABC34501DE35",
"found": false,
"data": null
}
]
}
}50 créditos gratis al mes, sin tarjeta.
Seguimiento
Sabes dónde está el lote.
Tres estados posibles y cinco contadores. Sabes si el lote está corriendo, si terminó o si se detuvo.
processing
El lote está corriendo. Consultar el estado devuelve el progreso y los CNPJ ya consultados.
done
El lote terminó. La respuesta trae un ítem por CNPJ, con el registro completo de los encontrados.
failed
El lote se detuvo. El campo error explica el motivo, y solo se cobraron los CNPJ ya encontrados.
Contadores del lote
total_recordsCuántos CNPJ válidos y únicos entraron en el lote.
processedCuántos ya se consultaron.
foundCuántos existen en la base. Es lo que pagas.
not_foundCuántos no tienen registro. No se cobran.
skippedCuántos quedaron fuera porque el saldo se acabó durante el procesamiento.
Dónde usarla
Cuando la lista es demasiado larga.
Situaciones en las que revisar un CNPJ a la vez llevaría días, y nadie lo haría.
Depuración de proveedores
Descubre qué proveedores están dados de baja, inaptos o suspendidos antes del próximo pago.
Cartera de clientes B2B
Actualiza la razón social, la dirección y el CNAE de toda la cartera y encuentra las empresas que cerraron.
Migración de ERP o CRM
Antes de llevar el registro al sistema nuevo, confirma qué CNPJ existen y estandariza los datos.
Revisión periódica de la cartera
Corre el lote cada mes y ve qué clientes cambiaron de situación de registro, de tamaño o de opción por el Simples Nacional.
Segmentación por CNAE y región
Agrupa tu lista de empresas por actividad, tamaño, estado y municipio para planificar ventas y atención.
Due diligence en adquisiciones
¿Recibiste la cartera de otra empresa? El lote muestra cuántos CNPJ están activos sin que nadie los revise uno por uno.
Cómo cobra
Pagas por los CNPJ que existen.
Una lista antigua tiene CNPJ mal escritos, repetidos o que nunca existieron. Aquí, nada de eso consume crédito.
1 crédito
por CNPJ encontrado, como en la consulta individual
R$ 0
por CNPJ no encontrado, inválido o repetido
10.000
CNPJ por lote, todos los lotes que necesites
En planes sin excedente, el lote solo se acepta si hay saldo para todos los CNPJ válidos. Si el saldo se acaba durante el procesamiento, los CNPJ restantes vuelven como skipped, sin consulta y sin cobro.
Preguntas frecuentes
¿Cuántos CNPJ puedo consultar por lote?
Hasta 10.000 por envío. Para listas más grandes, divídelas en bloques y envía un lote por cada uno. Los duplicados se eliminan, así que cada CNPJ se consulta y se cobra una sola vez.
¿Puedo enviar una planilla?
Sí. En el panel de CPFHub.io, en Consultas, CNPJ por Lote, sube un archivo CSV o TXT o pega la lista. La columna de CNPJ se detecta automáticamente, y el resultado se puede descargar en CSV. Los archivos XLSX todavía no se aceptan: guarda la planilla como CSV antes de enviarla.
¿Cuánto cuesta consultar CNPJ en lote?
1 crédito por CNPJ encontrado, el mismo costo de la consulta individual, descontado del mismo saldo del plan, incluidos los 50 créditos mensuales del plan Gratis. Los CNPJ no encontrados, inválidos o repetidos no consumen crédito, y seguir el estado del lote tampoco.
¿Qué datos vuelven por cada CNPJ?
El mismo registro de la Consulta de CNPJ: razón social, nombre comercial, situación de registro, CNAE principal y secundarios, naturaleza jurídica, dirección, contactos, tamaño, capital social, opciones por el Simples Nacional y el MEI y el cuadro de socios, con el CPF del socio persona física enmascarado. El CSV del panel trae las columnas principales.
¿Cómo funciona el lote por la API?
Envía los CNPJ en POST /cnpj/bulk con el body {"cnpjs": [...]}. La API responde 202 con el jobId. Consulta GET /cnpj/bulk/{jobId} hasta que el estado sea done o failed. Mientras el lote corre, la respuesta ya trae los resultados parciales.
¿Y si el saldo se acaba a mitad del lote?
En planes sin excedente, el lote solo se acepta si el saldo cubre todos los CNPJ válidos. Si el saldo se acaba durante el procesamiento, los CNPJ restantes vuelven como skipped, sin consulta y sin cobro. Recarga y envía solo los que faltaron.
¿Con qué frecuencia se actualizan los datos?
Los datos vienen de la base pública del CNPJ publicada por la Receita Federal de Brasil, actualizada mensualmente. El lote no consulta a la Receita en tiempo real: cada registro refleja la última base mensual.
¿El lote acepta el CNPJ alfanumérico?
Sí. La lista puede mezclar CNPJ numéricos y alfanuméricos, con o sin formato. Los dígitos verificadores se validan antes del procesamiento, y los CNPJ inválidos quedan fuera, sin costo.
Consulta tu lista
de CNPJ hoy mismo.
- 50 créditos gratis al mes
- Sin tarjeta de crédito
- Atención 24 h por WhatsApp