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, capital social y opción por el Simples Nacional y el MEI.
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 |
opcaoSimples | bool | Opción por el Simples |
opcaoMei | bool | Opción por el MEI |
| array | Actividades secundarias |
dataReferencia | string | Fecha de referencia |
opcaoSimples y opcaoMei sirven para prellenar optanteSimplesNacional y mei de Registrar empresa. Pida al usuario que confirme antes de enviar:
opcaoMei | opcaoSimples | Prellenar | CRT |
|---|---|---|---|
true | true o false | mei=true, optanteSimplesNacional=true | 4 MEI |
false | true | mei=false, optanteSimplesNacional=true | 1 Simples Nacional; con exceso de sublímite, cambie a 2 en la consola |
false | false | mei=false, optanteSimplesNacional=false | 3 Regime Normal |
| Cualquiera vacío | No prellene; pregunte al usuario | — |
Los dos campos vienen de la base de dataReferencia, no de una consulta en tiempo real: una adhesión o exclusión del Simples posterior a esa fecha todavía no aparece. El exceso de sublímite no aparece en los datos públicos. Vea «Régimen tributario» en Empresas.
Lo que esta consulta no trae. No devuelve la inscripción estatal (IE) ni distingue Lucro Presumido de Lucro Real. La IE está en el registro de la empresa: enviada en inscricaoEstadual al registrar, u obtenida de la SEFAZ en el registro automático. Lucro Presumido o Real es el régimen de PIS/COFINS, configurado en la consola.
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 |
naturezaJuridica.codigoNaturaleza jurídica
4 dígitos, por ejemplo 2062 sociedad limitada. El primer dígito indica el grupo; la lista completa es la tabla de naturaleza jurídica de CONCLA / IBGE.
| Valores | Significado |
|---|---|
| 1xxx | Administración pública |
| 2xxx | Entidades empresariales |
| 3xxx | Entidades sin fines de lucro |
| 4xxx | Personas físicas |
| 5xxx | Organizaciones internacionales y otras instituciones extraterritoriales |
cnaePrincipal.codigoActividad económica principal
Lista larga, no se reproduce aquí: consulte la tabla CNAE en CONCLA / IBGE.
| Valores | Significado |
|---|---|
| NNNNNNN | 7 dígitos sin puntuación, por ejemplo 6201501 |
endereco.municipio.codigo / municipioJurisdicao.codigoCódigo del municipio
Es el código de municipio de la Receita Federal, no el código IBGE de 7 dígitos usado en la emisión; para emitir, use el nombre en descricao con uf.
| Valores | Significado |
|---|---|
| NNNN | 4 dígitos, por ejemplo 7107 São Paulo |
endereco.ufEstado de la dirección
| Valores | Significado |
|---|---|
| AC | Acre |
| AL | Alagoas |
| AP | Amapá |
| AM | Amazonas |
| BA | Bahia |
| CE | Ceará |
| DF | Distrito Federal |
| ES | Espírito Santo |
| GO | Goiás |
| MA | Maranhão |
| MT | Mato Grosso |
| MS | Mato Grosso do Sul |
| MG | Minas Gerais |
| PA | Pará |
| PB | Paraíba |
| PR | Paraná |
| PE | Pernambuco |
| PI | Piauí |
| RJ | Rio de Janeiro |
| RN | Rio Grande do Norte |
| RS | Rio Grande do Sul |
| RO | Rondônia |
| RR | Roraima |
| SC | Santa Catarina |
| SP | São Paulo |
| SE | Sergipe |
| TO | Tocantins |
| EX | Exterior; empresa extranjera con CNPJ |
endereco.pais.codigoCódigo del país
Tabla de países del Banco Central, la misma de la NF-e.
| Valores | Significado |
|---|---|
| 1058 | Brasil |
| NNNN | Otro país, código de hasta 4 dígitos |
portePorte de la empresa
Código de la Receita Federal, devuelto tal como llega del registro.
| Valores | Significado |
|---|---|
| 00 | No informado |
| 01 | Microempresa |
| 03 | Empresa de pequeño porte |
| 05 | Demás |
| 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. |
