Busca dados cadastrais de uma empresa brasileira pelo CNPJ.

QUANDO USAR:

• Voce tem um CNPJ especifico e precisa dos dados cadastrais

• Precisa validar se um CNPJ existe e esta ativo

• Quer saber razao social, endereco, CNAE, porte de uma empresa

RETORNA:

• cnpj, razao_social, nome_fantasia

• endereco completo (logradouro, municipio, uf, cep)

• cnae_principal, data_abertura, capital_social

• situacao_cadastral, porte_empresa

EXEMPLO: { "cnpj": "00000000000191" } (Banco do Brasil)

Retorna dados COMPLETOS de uma empresa: cadastro + socios + regime tributario.

QUANDO USAR:

• Precisa de informacoes detalhadas para due diligence

• Quer saber quem sao os socios e suas participacoes

• Precisa verificar se empresa e Simples Nacional ou MEI

RETORNA:

• Todos os dados de buscar_empresa +

• Lista de socios com nome, cpf/cnpj, qualificacao

• Regime tributario: simples_nacional, mei

Lista todas as filiais de uma empresa (mesmo CNPJ base).

QUANDO USAR:

• Quer mapear a presenca geografica de uma empresa

• Precisa saber quantas unidades uma empresa tem

RETORNA:

• Lista de todas filiais com cnpj completo, endereco, situacao

Lista o quadro societario completo de uma empresa.

QUANDO USAR:

• Quer identificar quem sao os donos/socios

• Precisa do CPF/CNPJ dos socios para outras buscas

RETORNA:

• Lista de socios com: nome, cpf_cnpj, qualificacao, data_entrada

Verifica regime tributario: Simples Nacional ou MEI.

QUANDO USAR:

• Precisa saber se empresa pode emitir NF simplificada

• Quer filtrar empresas por regime

RETORNA:

• simples_nacional: true/false

• mei: true/false

• datas de opcao/exclusao

Busca empresas pelo NOME (razao social ou nome fantasia).

QUANDO USAR:

• Sabe o nome mas nao o CNPJ

• Quer encontrar todas as unidades de uma rede

PARAMETROS:

• nome: Termo de busca (minimo 3 caracteres)

• uf: Filtrar por estado (opcional)

• limite: Quantidade maxima (padrao: 50)

Lista empresas de um SETOR especifico (por CNAE).

QUANDO USAR:

• Quer todas empresas de uma atividade economica

• Prospeccao por vertical/segmento

CNAES COMUNS:

• 4711302: Supermercados

• 5611201: Restaurantes

• 2222600: Embalagens plasticas

• 4751201: Comercio de informatica

Busca empresas por NOME DE SOCIO.

QUANDO USAR:

• Quer encontrar todas empresas de um empresario

• Precisa mapear portfolio de um investidor

PARAMETROS:

• nome: Nome do socio (minimo 3 caracteres)

• uf: Filtrar por estado (opcional)

• limite: Quantidade maxima (padrao: 50)

Busca empresas por CEP.

QUANDO USAR:

• Quer empresas em uma regiao especifica

• Prospeccao geografica localizada

PARAMETROS:

• cep: CEP de 8 digitos

• cnae: Filtrar por CNAE (opcional)

• situacao: Filtrar por situacao cadastral (padrao: 02=ativas)

• limite: Quantidade maxima (padrao: 50)

Busca com MULTIPLOS FILTROS combinados.

QUANDO USAR:

• Precisa de filtros que outras ferramentas nao oferecem

• Query complexa combinando varios criterios

FILTROS DISPONIVEIS:

• cnae, uf, municipio, porte

• capital_min/capital_max

• situacao, limite

Compara empresa com a MEDIA DO SETOR.

QUANDO USAR:

• Quer saber se empresa esta acima ou abaixo da media

• Analise comparativa de porte/capital

RETORNA:

• Dados da empresa

• Estatisticas do setor (media, mediana, total)

• Posicao relativa no ranking

Encontra empresas SIMILARES usando scoring multi-dimensional.

QUANDO USAR:

• Tem um cliente bom e quer encontrar mais parecidos (lookalike)

• Quer expandir carteira com empresas do mesmo perfil

ALGORITMO DE SIMILARIDADE:

• Mesmo CNAE (atividade economica)

• Mesmo porte (capital social similar)

• Mesma regiao

RANKING das maiores empresas de um setor.

QUANDO USAR:

• Quer identificar os lideres de mercado

• Account-Based Marketing (ABM)

ORDENACAO:

• capital: Por capital social (padrao)

• filiais: Por quantidade de unidades

Retorna QUANTIDADE de empresas por estado brasileiro.

QUANDO USAR:

• Analise de mercado por regiao

• Priorizando estados para expansao

RETORNA:

• Lista de UFs com quantidade de empresas ativas

• Ordenado por quantidade (maior primeiro)

Retorna SETORES com mais empresas (ranking de CNAEs).

QUANDO USAR:

• Identificando mercados maiores

• Analise de oportunidade por vertical

PARAMETROS:

• limite: Top N CNAEs (padrao: 20)

Consulta MULTIPLOS CNPJs de uma vez (lote).

QUANDO USAR:

• Tem uma lista de CNPJs para enriquecer

• Importando dados de planilha/CRM

LIMITES:

• Maximo 100 CNPJs por requisicao