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 GET /cnpj/:cnpj/estabelecimentos. Você informa o CNPJ completo de qualquer unidade (matriz ou filial) e recebe todos os estabelecimentos que compartilham a mesma raiz, os 8 primeiros dígitos.

// Lista matriz e filiais de um grupo, página por página
const CNPJ_ALVO = '33000167000101'; // qualquer CNPJ do grupo
const HDR = { 'X-API-Key': process.env.CNPJOB_KEY };

async function listarUnidades(cnpj) {
  const unidades = [];
  for (let page = 1; ; page++) {
    const r = await fetch(`https://api.cnpjob.com.br/cnpj/${cnpj}/estabelecimentos?page=${page}&limit=50`, { headers: HDR });
    const data = await r.json();
    unidades.push(...data.estabelecimentos);
    if (data.estabelecimentos.length < data.limit) break; // última página
  }
  return unidades;
}

const unidades = await listarUnidades(CNPJ_ALVO);
const ativas = unidades.filter((u) => u.situacao === 'Ativa');
console.log(`${unidades.length} unidades, ${ativas.length} ativas`);
ativas.forEach((u) => console.log(`${u.cnpj} | ${u.nome_fantasia || 'sem nome fantasia'} | ${u.municipio}/${u.uf}`));

Cada item traz cnpj, nome_fantasia, situacao, municipio, uf, data_abertura, telefone e email. O campo total da resposta conta os itens da página; para o grupo inteiro, percorra as páginas como acima.

Vantagens do Mapeamento

• Análise de Crédito: Entender se o risco de crédito deve ser analisado a nível de unidade ou a nível do grupo econômico inteiro.
• Precificação Dinâmica: Se você cobra por "unidades" no seu SaaS, ao cliente digitar o CNPJ, você já sabe exatamente quantas lojas físicas ou filiais o cliente possui e calcula o orçamento automaticamente.
• Expansão de Clientes Atuais: O cliente assinou sua plataforma na matriz de SP. Ao consultar as filiais, sua equipe descobre que ele tem unidades no RJ e MG que não foram englobadas no contrato inicial, e as aborda ativamente.