CNPJws
Español
Español
  • Visión General
  • Modelos de datos
    • Países
    • Estados
    • Ciudades
    • Naturalezas Jurídicas
    • Tamaños
    • Actividades Económicas
    • Calificaciones Societarias
    • Socios
    • Simples Nacional y MEI
    • Establecimientos
    • Inscripciones Estatales
    • Suframa
    • Regímenes Tributarios
    • Situaciones Cadastrales
    • Mensajes de Error
  • Changelog
  • Referencia de API
    • API - Comercial
      • Consultando CNPJ en la API Comercial
      • Consultando por la Raíz del CNPJ
      • Búsqueda de Empresas
      • Consultando el Consumo de Solicitudes Mensuales
      • Validando Inscripción en Suframa
    • API - Pública
      • Consultando CNPJ en la API Pública
      • Validando Inscripción en Suframa en la API Pública
      • Limitaciones
  • BLOG
    • Qué es el CNPJ
    • Consultar CNPJ con Java
    • Consultar CNPJ Gratuitamente con Excel
    • Consultar CNPJ con PHP
    • Gatillo para consultar CNPJ en Protheus
    • Mantener el registro de clientes y proveedores actualizado
    • Consultar CNPJ con Javascript y Node.JS
    • Consultar CNPJ con ADVPL (Protheus)
    • Proyecto CNPJ.ws
Con tecnología de GitBook
En esta página
  • Instalación
  • Utilización
  • Retorno
  • Conclusión

¿Te fue útil?

  1. BLOG

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

AnteriorMantener el registro de clientes y proveedores actualizadoSiguienteConsultar CNPJ con ADVPL (Protheus)

Última actualización hace 4 meses

¿Te fue útil?

¡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 .

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 .

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": "VITOR@URNER.COM.BR",
    "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

Cualquier duda, estamos aquí para apoyarte, envía un correo electrónico a contacto@cnpj.ws!

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 .

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

Github
página principal
documentación
CNPJ.ws