Integração de Sistemas

Mapeamento de Filiais e Matrizes: Descobrindo o Porte Real das Empresas

Muitas vezes, analisar apenas o CNPJ de faturamento (a Matriz) esconde o tamanho real da operação de um cliente. Uma rede de supermercados, por exemplo, pode ter 1 matriz administrativa e 500 filiais espalhadas pelo Brasil.

Como Encontrar Filiais?

Com o Plano Pro, o cnpjob expõe o endpoint de /estabelecimentos. Sabendo o CNPJ base (os 8 primeiros dígitos) de qualquer matriz ou filial, nós agrupamos todos os estabelecimentos vinculados àquele grupo empresarial para você.

// Busca todas as filiais e a matriz de um CNPJ Base
const CNPJ_ALVO = '33000167000101'; // Você pode usar qualquer CNPJ do grupo

fetch(`https://api.cnpjob.com.br/api/cnpj/${CNPJ_ALVO}/estabelecimentos`, {
  headers: { 'X-API-Key': 'sua_api_key' }
})
.then(res => res.json())
.then(data => {
  console.log(`Este grupo empresarial possui ${data.total} unidades ativas.`);
  data.estabelecimentos.forEach(filial => {
    console.log(`Unidade: ${filial.nome_fantasia || 'Sem nome'} | CNPJ: ${filial.cnpj} | Estado: ${filial.endereco.uf}`);
  });
});

Vantagens do Mapeamento