Consultando por la Raíz del CNPJ
Cómo consultar todos los establecimientos de una empresa por la raíz del CNPJ (los 8 primeros dígitos) en la API Comercial de CNPJ.ws.
En la API comercial también puedes hacer una consulta utilizando la raíz del CNPJ, que son los 8 primeros dígitos del CNPJ y que, en este caso, devolverá todos los CNPJs de la empresa en cuestión. En este endpoint, debes enviar el header x_api_token con el token que te fue enviado por correo electrónico.
También puedes pasar el token como un parámetro en la URL, ejemplo:
https://comercial.cnpj.ws/cnpj-raiz/27865757?token=SEU_TOKEN
Método: GET
Endpoint: https://comercial.cnpj.ws/cnpj-raiz/RAIZ_DO_CNPJ
Ejemplo de Solicitud
Token de API (Bearer). Ex.: Authorization: Bearer <seu_token>
In: header
Path Parameters
^\d{8}$Query Parameters
Header Parameters
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/cnpj-raiz/string"{ "data": [ "string" ], "paginacao": { "limite": 0, "pagina": 0, "paginas": 0 }, "ordenacao": [ "string" ], "filtros_disponiveis": [ "string" ], "filtros_aplicados": { "nome_fantasia": "string", "pais_id": "string", "estado_id": "string", "cidade_id": "string", "atividade_principal_id": "string", "tipo": "string" }}{ "status": 0, "titulo": "string", "detalhes": "string", "validacao": [ "string" ], "statusCode": 0, "message": "string", "error": "string"}{ "status": 0, "titulo": "string", "detalhes": "string", "validacao": [ "string" ], "statusCode": 0, "message": "string", "error": "string"}yarn add consultar-cnpjconst consultarCNPJ = require("consultar-cnpj");
async function getRaiz() {
const token = "INFORME O SEU TOKEN DE ACESSO";
const data = await consultarCNPJ.raiz("27865757", token);
console.log(data);
}Paginación
En caso de que la empresa tenga más de 20 filiales, la API dividirá la respuesta en páginas. Puedes verificar esto en el JSON de retorno de la API, en la propiedad "paginacion", que muestra la página actual, el total de páginas y el total de filiales:
{
"paginacao": {
"limite": 20,
"pagina": 1,
"paginas": 5,
"total": 87
}
}Para buscar una página específica basta con informar el número de la página en la solicitud:
curl -X GET https://comercial.cnpj.ws/cnpj-raiz/27865757?page=2 -H "x_api_token: SEU_TOKEN"Ejemplo de Retorno
A continuación, un ejemplo del JSON retornado al buscar por la raíz del CNPJ 27865757:
{
"data": [
"27865757002148",
"27865757002229",
"27865757002300",
"27865757002490",
"27865757002571",
"27865757002652",
"27865757002733",
"27865757002814",
"27865757002903",
"27865757003039",
"27865757003110",
"27865757003209",
"27865757003381",
"27865757003462",
"27865757003543",
"27865757003624",
"27865757003705",
"27865757003896",
"27865757003977",
"27865757004000"
],
"paginacao": {
"limite": 20,
"pagina": 2,
"paginas": 5,
"total": 87
},
"ordenacao": [],
"filtros_disponiveis": ["nome_fantasia", "pais_id", "estado_id", "cidade_id"],
"filtros_aplicados": {}
}