Matriz e filial

Uma rede com trezentas lojas é uma empresa e trezentos e um estabelecimentos: a matriz e trezentas filiais, cada uma com o próprio CNPJ de 14 caracteres. Quem consulta por CNPJ recebe o estabelecimento; quem quer a empresa inteira agrupa pela raiz. Confundir os dois níveis é a fonte mais comum de contagem errada em base de clientes e em análise de mercado.

O que é da empresa e o que é do estabelecimento

• Da empresa (mesma para matriz e filiais): razão social, natureza jurídica, porte, capital social, quadro societário, opção pelo Simples e pelo MEI. Vêm da raiz de oito dígitos.
• Do estabelecimento (cada CNPJ tem o seu): nome fantasia, situação cadastral e seu motivo, data de início de atividade, endereço, CNAE principal e secundários, contatos. Uma filial pode estar baixada com a matriz ativa, e ter CNAE diferente do da matriz.

A ordem 0001 é a matriz na imensa maioria dos casos, mas a regra é o campo, não a convenção: se a matriz muda de endereço para o de uma filial, a Receita pode trocar o tipo sem trocar a ordem. Use matriz_filial.codigo.

Como a API devolve

"cnpj": "00000000000191",
"raiz_cnpj": "00000000",
"matriz_filial": { "codigo": "1", "descricao": "Matriz" }

Perfil basic. raiz_cnpj é a chave para agrupar estabelecimentos da mesma empresa. A busca de empresas devolve estabelecimentos; para contar empresas numa análise por CNAE ou por UF, filtre por matriz_filial=MATRIZ (conforme o plano) ou agrupe os resultados pela raiz do lado do cliente.

Como usar

• Cadastro de cliente: guarde o CNPJ do estabelecimento que fatura (pode ser uma filial) e a raiz para consolidar a conta; a nota fiscal sai contra o estabelecimento.
• Prospecção: fale uma vez com cada empresa, deduplicando os resultados da busca pela raiz e priorizando o estabelecimento com matriz_filial.codigo igual a 1; abra as filiais depois, quando a conta estiver aberta e a compra for por unidade.
• Análise de mercado: conte empresas pela raiz e pontos de venda pelo estabelecimento; os dois números são úteis e nunca são o mesmo.
• Monitoramento: a situação cadastral é por estabelecimento; uma carteira de filiais precisa reconsultar cada CNPJ, não só a matriz.

Campo completo em Campos da resposta; o formato do número está em dígito verificador do CNPJ.