Consultar CNPJ con Javascript y Node.JS

Vea cómo consultar datos de empresas por el CNPJ utilizando la API de CNPJ.ws, con datos de la Receita Federal, Sintegra y Suframa usando Javascript/Node.js

¡Consultar un CNPJ utilizando la API de CNPJ.ws con Javascript y Node.JS es muy fácil!

Mantener el registro de clientes/proveedores o incluso hacer una consulta a los datos de empresas para facilitar algún registro interno de tu sistema es algo muy común y la API de CNPJ.ws proporciona una manera fácil y rápida para desarrollar esta integración.

Con la integración podemos usar la API para consultar la dirección, inscripción estatal, situación cadastral, CNAE y muchas otras informaciones que pueden ser importantes en el momento del registro del cliente o proveedor a través del CNPJ.

Los datos retornados por la API son obtenidos de diversos organismos públicos (Receita Federal, Sintegra, SERPRO, Suframa, etc.), aglutinados y organizados para facilitar el uso por otros sistemas a través de una API Rest.

Instalación

Nosotros desarrollamos un paquete para facilitar esta integración, vea en Github.

Recordando que puedes usar nuestra API gratuita para consultar CNPJ o puedes adquirir uno de nuestros planes comerciales.

Para empezar, vamos a instalar el paquete:

Utilizando YARN:

yarn add consultar-cnpj

Utilizando NPM:

npm i consultar-cnpj --save

Utilización

El CNPJ.ws posee una API Pública y una Comercial, para utilizar la API Pública no necesitas un token, pero solo puedes hacer hasta 3 consultas por minuto. Si estás utilizando la API Comercial debes pasar el token como segundo parámetro en la consulta para utilizar sus beneficios. Puedes ver más detalles de los planes comerciales en nuestra página principal.

const consultarCNPJ = require("consultar-cnpj");

async function getCNPJ() {
  const token = "INFORME O SEU TOKEN DE ACESSO";

  try {
    // O Token é opcional
    const empresa = await consultarCNPJ("40154884000153", token);
    console.log(empresa);
  } catch (e) {
    console.log(e);
  }
}

Retorno

Abajo el JSON retornado por la API:

{
  "cnpj_raiz": "40154884",
  "razao_social": "STARLINK BRAZIL SERVICOS DE INTERNET LTDA.",
  "capital_social": "800000.00",
  "responsavel_federativo": "",
  "atualizado_em": "2021-07-20T08:21:13.130Z",
  "porte": {
    "id": "05",
    "descricao": "Demais"
  },
  "natureza_juridica": {
    "id": "2062",
    "descricao": "Sociedade Empresária Limitada"
  },
  "qualificacao_do_responsavel": {
    "id": 5,
    "descricao": "Administrador "
  },
  "socios": [
    {
      "cpf_cnpj_socio": "***966178**",
      "nome": "VITOR JAMES URNER",
      "tipo": "Pessoa Física",
      "data_entrada": "2020-12-18",
      "cpf_representante_legal": "***000000**",
      "nome_representante": null,
      "faixa_etaria": "71 a 80 anos",
      "atualizado_em": "2021-07-21T06:13:26.688Z",
      "pais_id": "1058",
      "qualificacao_socio": {
        "id": 5,
        "descricao": "Administrador "
      },
      "qualificacao_representante": null
    },
    {
      "cpf_cnpj_socio": "39523686000130",
      "nome": "STARLINK BRAZIL HOLDING LTDA.",
      "tipo": "Pessoa Jurídica",
      "data_entrada": "2020-12-18",
      "cpf_representante_legal": "***966178**",
      "nome_representante": "VITOR JAMES URNER",
      "faixa_etaria": "Não se aplica",
      "atualizado_em": "2021-07-21T06:13:26.688Z",
      "pais_id": "1058",
      "qualificacao_socio": {
        "id": 22,
        "descricao": "Sócio"
      },
      "qualificacao_representante": {
        "id": 5,
        "descricao": "Administrador "
      }
    }
  ],
  "simples": null,
  "estabelecimento": {
    "cnpj": "40154884000153",
    "atividades_secundarias": [
      {
        "id": "6190699",
        "secao": "J",
        "divisao": "61",
        "grupo": "61.9",
        "classe": "61.90-6",
        "subclasse": "6190-6/99",
        "descricao": "Outras atividades de telecomunicações não especificadas anteriormente"
      },
      {
        "id": "6462000",
        "secao": "K",
        "divisao": "64",
        "grupo": "64.6",
        "classe": "64.62-0",
        "subclasse": "6462-0/00",
        "descricao": "Holdings de instituições não financeiras"
      },
      {
        "id": "7739099",
        "secao": "N",
        "divisao": "77",
        "grupo": "77.3",
        "classe": "77.39-0",
        "subclasse": "7739-0/99",
        "descricao": "Aluguel de outras máquinas e equipamentos comerciais e industriais não especificados anteriormente, sem operador"
      }
    ],
    "cnpj_raiz": "40154884",
    "cnpj_ordem": "0001",
    "cnpj_digito_verificador": "53",
    "tipo": "Matriz",
    "nome_fantasia": null,
    "situacao_cadastral": "Ativa",
    "data_situacao_cadastral": "2020-12-18",
    "data_inicio_atividade": "2020-12-18",
    "nome_cidade_exterior": null,
    "tipo_logradouro": "ALAMEDA",
    "logradouro": "SANTOS",
    "numero": "74",
    "complemento": "ANDAR 7                   CONJ  72                  SALA  10",
    "bairro": "CERQUEIRA CESAR",
    "cep": "01418000",
    "ddd1": "11",
    "telefone1": "30229503",
    "ddd2": null,
    "telefone2": null,
    "ddd_fax": null,
    "fax": null,
    "email": "[e-mail]",
    "situacao_especial": null,
    "data_situacao_especial": null,
    "atividade_principal": {
      "id": "6130200",
      "secao": "J",
      "divisao": "61",
      "grupo": "61.3",
      "classe": "61.30-2",
      "subclasse": "6130-2/00",
      "descricao": "Telecomunicações por satélite"
    },
    "pais": {
      "id": "1058",
      "iso2": "BR",
      "iso3": "BRA",
      "nome": "Brasil",
      "comex_id": "105"
    },
    "estado": {
      "id": 26,
      "nome": "São Paulo",
      "sigla": "SP",
      "ibge_id": 35
    },
    "cidade": {
      "id": 3832,
      "nome": "São Paulo",
      "ibge_id": 3550308,
      "siafi_id": "7107"
    },
    "motivo_situacao_cadastral": null,
    "inscricoes_estaduais": [
      {
        "inscricao_estadual": "130287771116",
        "ativo": true,
        "atualizado_em": "2021-08-25T16:59:58.589Z",
        "estado": {
          "id": 26,
          "nome": "São Paulo",
          "sigla": "SP",
          "ibge_id": 35
        }
      }
    ]
  }
}

Conclusión

Utilizando la API de CNPJ.ws obtienes los datos de las empresas brasileñas de forma simple y fácil, echa un vistazo a nuestra documentación.

Para saber más sobre nuestros planes y formas de pago accede a CNPJ.ws.

Cualquier duda, estamos aquí para apoyarte, envía un correo electrónico a [e-mail]!