Consulta de registro
Consulta de CNPJ
Datos registrales oficiales de una empresa a partir del CNPJ de 14 dígitos.
/openapi/v3/consultas/cnpj/{cnpj}token, timestamp y sign, vea Autenticación.Devuelve los datos registrales de un número de identificación fiscal de persona jurídica de 14 dígitos: razón social, nombre comercial, situación registral, naturaleza jurídica, CNAE, dirección registrada, contactos y capital social.
La respuesta es un objeto simple, sin sobre de la plataforma. La tabla de campos enumera todos los campos posibles; cuando la fuente no tiene datos para un campo, este vuelve vacío, y esos campos se han omitido del ejemplo. Solicitud GET: el cuerpo firmado es la cadena vacía y el CNPJ forma parte de la ruta firmada.
Parámetros de ruta
cnpj* | string | CNPJ |
* Campo obligatorio
ni | string | CNPJ |
tipoEstabelecimento | string | Tipo de establecimiento |
nomeEmpresarial | string | Razón social |
nomeFantasia | string | Nombre de fantasía |
| object | Situación registral |
| object | Naturaleza jurídica |
dataAbertura | string | Fecha de apertura |
| object | CNAE principal |
| object | Dirección registrada |
| object | Municipio de jurisdicción fiscal |
| array | Teléfonos |
correioEletronico | string | Correo electrónico |
capitalSocial | number | Capital social |
porte | string | Código de porte |
situacaoEspecial | string | Situación especial |
dataSituacaoEspecial | string | Fecha de la situación especial |
Los errores de formato y de dígito verificador (10016010, 10016011) se rechazan localmente en la plataforma: no consumen cuota ni se facturan. Los errores de autenticación (401 / 403 / 429) usan el sobre de la plataforma; vea el modelo de errores en Consulta de registro.
tipoEstabelecimentoTipo de establecimiento
| Valores | Significado |
|---|---|
| 1 | Matriz |
| 2 | Sucursal |
situacaoCadastral.codigoSituación registral
| Valores | Significado |
|---|---|
| 1 | Nula |
| 2 | Activa |
| 3 | Suspendida |
| 4 | Inapta |
| 8 | Dada de baja |
| Código | HTTP | |
|---|---|---|
| 10016010 | 400 | Formato de CNPJ inválido (se requieren 14 dígitos). Compruebe caracteres de formato indebidos. |
| 10016011 | 400 | Dígitos verificadores del CNPJ inválidos. Valide localmente con el algoritmo mod-11 antes de llamar. |
| 10016012 | 400 | CNPJ no encontrado en el registro oficial. |
| 10016020 | 503 | Fuente de datos upstream temporalmente no disponible. Reintente con backoff exponencial (empiece en 1 s, duplique hasta 30 s, añada jitter); si persiste, contacte con la plataforma. |