TF Fiscal
Documentación

Consulta de registro

Consulta de CNPJ

Datos registrales oficiales de una empresa a partir del CNPJ de 14 dígitos.

GET/openapi/v3/consultas/cnpj/{cnpj}

Requiere las cabeceras de firma 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

Parámetros de ruta

  • cnpjstringobligatorio

    14 dígitos, solo dígitos. Los CNPJ con formato se rechazan: la / en 40.673.061/0001-34 se interpretaría como separador de ruta.

    Ejemplo: 40673061000134

Respuestas

200

Consulta realizada. Datos registrales de la empresa.

  • nistring

    CNPJ, 14 dígitos.

  • tipoEstabelecimentostring

    Tipo de establecimiento: 1 matriz, 2 sucursal.

    Valores:12
  • nomeEmpresarialstring

    Razón social registrada.

  • nomeFantasiastring

    Nombre comercial.

  • situacaoCadastralobject

    Situación registral.

  • naturezaJuridicaobject

    Naturaleza jurídica (código + descripción).

  • dataAberturastring

    Fecha de apertura, yyyy-MM-dd.

  • cnaePrincipalobject

    Actividad económica principal (código + descripción).

  • enderecoobject

    Dirección registrada. Para componer la línea completa de la calle, concatene tipoLogradouro + logradouro; la fuente los devuelve por separado.

  • municipioJurisdicaoobject

    Municipio de jurisdicción fiscal (código + descripción).

  • telefonesarray

    Teléfonos.

  • correioEletronicostring

    Correo electrónico.

  • capitalSocialnumber

    Capital social.

  • portestring

    Código de tamaño de la empresa.

  • situacaoEspecialstring

    Situación especial (p. ej. recuperación judicial); normalmente ausente.

  • dataSituacaoEspecialstring

    Fecha de vigencia de la situación especial.

Errores

CódigoHTTP
10016010400

Formato de CNPJ inválido (se requieren 14 dígitos). Compruebe caracteres de formato indebidos.

10016011400

Dígitos verificadores del CNPJ inválidos. Valide localmente con el algoritmo mod-11 antes de llamar.

10016012400

CNPJ no encontrado en el registro oficial.

10016020503

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.

Validación local y facturación

Los errores de formato y de dígito verificador (10016010, 10016011) se rechazan localmente en la plataforma y nunca llegan a la fuente upstream: 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.

AnteriorConsulta de registroSiguienteConsulta de CPF