Requisitos para Saídas

Todos os arquivos Excel

Zero Erros de Fórmula

• Todo modelo Excel DEVE ser entregue com ZERO erros de fórmula (#REF!, #DIV/0!, #VALUE!, #N/A, #NAME?)

Preservar Modelos Existentes (ao atualizar modelos)

• Estude e CORRESPONDA EXATAMENTE o formato, estilo e convenções existentes ao modificar arquivos
• Nunca imponha formatação padronizada em arquivos com padrões estabelecidos
• As convenções de modelo existentes SEMPRE substituem estas diretrizes

Modelos Financeiros

Padrões de Codificação por Cores

A menos que declarado de outra forma pelo usuário ou pelo modelo existente

Convenções de Cores Padrão da Indústria

• Texto Azul (RGB: 0,0,255): Entradas codificadas manualmente e números que os usuários mudarão para cenários
• Texto Preto (RGB: 0,0,0): TODAS as fórmulas e cálculos
• Texto Verde (RGB: 0,128,0): Links puxando de outras planilhas dentro do mesmo arquivo
• Texto Vermelho (RGB: 255,0,0): Links externos para outros arquivos
• Fundo Amarelo (RGB: 255,255,0): Suposições chave que precisam de atenção ou células que precisam ser atualizadas

Padrões de Formatação de Números

Regras de Formato Obrigatórias

• Anos: Formate como strings de texto (ex: "2024" em vez de "2.024")
• Moeda: Use o formato $#,##0; SEMPRE especifique unidades nos cabeçalhos ("Receita ($mi)")
• Zeros: Use formatação de número para tornar todos os zeros "-", incluindo porcentagens (ex: "$#,##0;($#,##0);-")
• Porcentagens: Padrão para formato 0,0% (uma casa decimal)
• Múltiplos: Formate como 0,0x para múltiplos de avaliação (EV/EBITDA, P/E)
• Números negativos: Use parênteses (123) em vez de menos -123

Regras de Construção de Fórmulas

Posicionamento de Suposições

• Coloque TODAS as suposições (taxas de crescimento, margens, múltiplos, etc.) em células de suposição separadas
• Use referências de célula em vez de valores codificados manualmente em fórmulas
• Exemplo: Use =B5*(1+$B$6) em vez de =B5*1.05

Prevenção de Erros de Fórmula

• Verifique se todas as referências de célula estão corretas
• Verifique erros de um dígito em intervalos
• Garanta fórmulas consistentes em todos os períodos de projeção
• Teste com casos extremos (valores zero, números negativos)
• Verifique se não há referências circulares não intencionais

Requisitos de Documentação para Codificação Manual

• Comente ou em células ao lado (se for o fim da tabela). Formato: "Fonte: [Sistema/Documento], [Data], [Referência Específica], [URL se aplicável]"
• Exemplos:
  • "Fonte: 10-K da Empresa, Ano Fiscal 2024, Página 45, Nota de Receita, [URL do SEC EDGAR]"
  • "Fonte: 10-Q da Empresa, 2º Trimestre de 2025, Anexo 99.1, [URL do SEC EDGAR]"
  • "Fonte: Bloomberg Terminal, 15/08/2025, AAPL US Equity"
  • "Fonte: FactSet, 20/08/2025, Tela de Estimativas de Consenso"

Criação, edição e análise de XLSX

Visão Geral

Um usuário pode pedir para você criar, editar ou analisar o conteúdo de um arquivo .xlsx. Você tem diferentes ferramentas e fluxos de trabalho disponíveis para diferentes tarefas.

Requisitos Importantes

LibreOffice Necessário para Recálculo de Fórmulas: Você pode assumir que o LibreOffice está instalado para recalcular valores de fórmulas usando o script recalc.py. O script configura automaticamente o LibreOffice na primeira execução.

Leitura e Análise de Dados

Análise de dados com pandas

Para análise de dados, visualização e operações básicas, use pandas, que fornece poderosas capacidades de manipulação de dados:

import pandas as pd

# Read Excel
df = pd.read_excel('file.xlsx')  # Default: first sheet
all_sheets = pd.read_excel('file.xlsx', sheet_name=None)  # All sheets as dict

# Analyze
df.head()      # Preview data
df.info()      # Column info
df.describe()  # Statistics

# Write Excel
df.to_excel('output.xlsx', index=False)

Fluxos de Trabalho de Arquivos Excel

CRÍTICO: Use Fórmulas, Não Valores Codificados Manualmente

Sempre use fórmulas do Excel em vez de calcular valores em Python e codificá-los manualmente. Isso garante que a planilha permaneça dinâmica e atualizável.

❌ ERRADO - Codificando Valores Calculados Manualmente

# Bad: Calculating in Python and hardcoding result
total = df['Sales'].sum()
sheet['B10'] = total  # Hardcodes 5000

# Bad: Computing growth rate in Python
growth = (df.iloc[-1]['Revenue'] - df.iloc[0]['Revenue']) / df.iloc[0]['Revenue']
sheet['C5'] = growth  # Hardcodes 0.15

# Bad: Python calculation for average
avg = sum(values) / len(values)
sheet['D20'] = avg  # Hardcodes 42.5

✅ CORRETO - Usando Fórmulas do Excel

# Good: Let Excel calculate the sum
sheet['B10'] = '=SUM(B2:B9)'

# Good: Growth rate as Excel formula
sheet['C5'] = '=(C4-C2)/C2'

# Good: Average using Excel function
sheet['D20'] = '=AVERAGE(D2:D19)'