Balanços.AI

Retrato financeiro completo de uma empresa em uma chamada — comece por aqui. chave = slug ou CNPJ. Combina a ficha cadastral, TODOS os balanços e DREs disponíveis (valores em reais, um exercício por ano), o crescimento de ativo total e o índice de publicações com links. Para ler o conteúdo de uma publicação específica, siga com texto_documento(id). Inclua o link da empresa ao apresentar — a página no balancos.ai tem tudo navegável. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Balanços patrimoniais (BP) de uma empresa, por exercício. chave = slug ou CNPJ. Sem ano, retorna todos os exercícios disponíveis (mais recente primeiro); com ano, só aquele exercício. Valores SEMPRE em reais (a escala publicada é só proveniência). Um exercício por ano fiscal — o vencedor entre as fontes llm (extraído do PDF) e xbrl (arquivo estruturado; vence em conflito). Cada linha traz o link do documento de origem no balancos.ai. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Busca empresas brasileiras por nome ou CNPJ nos dados do balancos.ai. Use quando o usuário citar uma empresa pelo nome — a busca cobre a razão social e aceita CNPJ com ou sem pontuação. Retorna até 20 empresas com CNPJ, slug e link da página no balancos.ai. Com o slug (ou CNPJ) em mãos, aprofunde com analisar_empresa. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Publicações legais de uma empresa (índice, mais recentes primeiro). chave = slug ou CNPJ. Retorna até 100 documentos com tipo, data de publicação, ano de referência e link da página do documento no balancos.ai (onde o PDF pode ser lido). Para ler o CONTEÚDO de um documento aqui na conversa, use texto_documento com o id retornado. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Demonstrações de resultado (DRE) de uma empresa, por exercício. chave = slug ou CNPJ. Sem ano, retorna todos os exercícios disponíveis (mais recente primeiro); com ano, só aquele. Traz receita bruta/líquida, custo, lucro bruto/operacional/líquido — sempre em reais — com o link do documento de origem no balancos.ai. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Ficha cadastral e panorama de dados de uma empresa. chave aceita o slug (retornado por buscar_empresas) ou o CNPJ (14 dígitos, com ou sem pontuação). Retorna cadastro (razão social, CNAE, natureza jurídica, situação, capital social, UF/município), setor, quantidade de publicações e os ANOS com balanço e com DRE disponíveis — use esses anos para chamar balancos_empresa/dres_empresa. Para o retrato completo em uma chamada, prefira analisar_empresa. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Ranking de empresas por métrica financeira, com filtros opcionais. metrica: "ativo" (maiores por ativo total), "receita", "lucro" (lucro líquido) ou "crescimento" (variação % do ATIVO TOTAL ano-a-ano — não é crescimento de receita). uf = sigla (SP, RS...); setor = trecho do nome do setor (ex: "energia", "saúde"); limite até 50 (padrão 20). Cada linha traz o exercício de referência e o link da empresa no balancos.ai — exercícios podem variar entre empresas. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.

Texto integral de uma publicação, para ler aqui na conversa. documento_id é o id retornado por documentos_empresa ou analisar_empresa. Retorna o texto extraído do documento (até 50 mil caracteres — se maior, vem truncado e sinalizado). Nem todo documento tem texto extraído; nesse caso a resposta indica e o documento pode ser lido no link da página. A consulta gera logs operacionais e, quando habilitado, histórico privado de uso autenticado com argumentos e IP, sujeito à retenção operacional de 90 dias. A ferramenta não oferece exclusão ou sobrescrita de dados financeiros.