Requisitos para las Salidas
Todos los archivos Excel
Cero errores de fórmula
- Cada modelo de Excel DEBE entregarse con CERO errores de fórmula (#REF!, #DIV/0!, #VALOR!, #N/A, #¿NOMBRE?)
Preservar plantillas existentes (al actualizar plantillas)
- Estudiar y COINCIDIR EXACTAMENTE con el formato, estilo y convenciones existentes al modificar archivos
- Nunca imponer formato estandarizado en archivos con patrones establecidos
- Las convenciones de la plantilla existente SIEMPRE anulan estas pautas
Modelos Financieros
Estándares de Codificación de Colores
A menos que el usuario o la plantilla existente indiquen lo contrario
Convenciones de Color Estándar de la Industria
- Texto azul (RGB: 0,0,255): Entradas codificadas manualmente y números que los usuarios cambiarán para escenarios
- Texto negro (RGB: 0,0,0): TODAS las fórmulas y cálculos
- Texto verde (RGB: 0,128,0): Enlaces que extraen datos de otras hojas dentro del mismo libro
- Texto rojo (RGB: 255,0,0): Enlaces externos a otros archivos
- Fondo amarillo (RGB: 255,255,0): Suposiciones clave que necesitan atención o celdas que deben actualizarse
Estándares de Formato de Números
Reglas de Formato Obligatorias
- Años: Formatear como cadenas de texto (ej., "2024" no "2,024")
- Moneda: Usar formato $#,##0; ESPECIFICAR SIEMPRE las unidades en los encabezados ("Ingresos ($mm)")
- Ceros: Usar formato numérico para que todos los ceros aparezcan como "-", incluyendo porcentajes (ej., "$#,##0;($#,##0);-")
- Porcentajes: Por defecto en formato 0.0% (un decimal)
- Múltiplos: Formatear como 0.0x para múltiplos de valoración (EV/EBITDA, P/E)
- Números negativos: Usar paréntesis (123) no signo menos -123
Reglas de Construcción de Fórmulas
Ubicación de Suposiciones
- Colocar TODAS las suposiciones (tasas de crecimiento, márgenes, múltiplos, etc.) en celdas de suposición separadas
- Usar referencias de celda en lugar de valores codificados en las fórmulas
- Ejemplo: Usar =B5*(1+$B$6) en lugar de =B5*1.05
Prevención de Errores en Fórmulas
- Verificar que todas las referencias de celda sean correctas
- Revisar errores de desfase en rangos
- Asegurar fórmulas consistentes en todos los períodos de proyección
- Probar con casos extremos (valores cero, números negativos)
- Verificar que no haya referencias circulares no intencionadas
Requisitos de Documentación para Valores Fijos
- Comentar o escribir al lado de las celdas (si es al final de la tabla). Formato: "Fuente: [Sistema/Documento], [Fecha], [Referencia Específica], [URL si aplica]"
- Ejemplos:
- "Fuente: 10-K de la Compañía, FY2024, Página 45, Nota de Ingresos, [URL de SEC EDGAR]"
- "Fuente: 10-Q de la Compañía, Q2 2025, Anexo 99.1, [URL de SEC EDGAR]"
- "Fuente: Bloomberg Terminal, 15/08/2025, AAPL US Equity"
- "Fuente: FactSet, 20/08/2025, Pantalla de Estimaciones de Consenso"
Creación, edición y análisis de XLSX
Resumen
Un usuario puede pedirte crear, editar o analizar el contenido de un archivo .xlsx. Tienes diferentes herramientas y flujos de trabajo disponibles para diferentes tareas.
Requisitos Importantes
LibreOffice Necesario para Recalcular Fórmulas: Puedes asumir que LibreOffice está instalado para recalcular valores de fórmulas usando el script recalc.py. El script configura automáticamente LibreOffice en la primera ejecución.
Leer y analizar datos
Análisis de datos con pandas
Para análisis de datos, visualización y operaciones básicas, usa pandas, que proporciona capacidades potentes de manipulación de datos:
import pandas as pd
# Leer Excel
df = pd.read_excel('file.xlsx') # Predeterminado: primera hoja
todas_las_hojas = pd.read_excel('file.xlsx', sheet_name=None) # Todas las hojas como diccionario
# Analizar
df.head() # Vista previa de datos
df.info() # Información de columnas
df.describe() # Estadísticas
# Escribir Excel
df.to_excel('output.xlsx', index=False)
Flujo de Trabajo con Archivos Excel
CRÍTICO: Usar Fórmulas, No Valores Fijos
Usa siempre fórmulas de Excel en lugar de calcular valores en Python y fijarlos. Esto asegura que la hoja de cálculo siga siendo dinámica y actualizable.
❌ INCORRECTO - Fijar Valores Calculados
# Mal: Calcular en Python y fijar el resultado
total = df['Ventas'].sum()
hoja['B10'] = total # Fija 5000
# Mal: Calcular tasa de crecimiento en Python
crecimiento = (df.iloc[-1]['Ingresos'] - df.iloc[0]['Ingresos']) / df.iloc[0]['Ingresos']
hoja['C5'] = crecimiento # Fija 0.15
# Mal: Cálculo de promedio en Python
promedio = sum(valores) / len(valores)
hoja['D20'] = promedio # Fija 42.5
✅ CORRECTO - Usar Fórmulas de Excel
# Bien: Deja que Excel calcule la suma
hoja['B10'] = '=SUMA(B2:B9)'
# Bien: Tasa de crecimiento como fórmula de Excel
hoja['C5'] = '=(C4-C2)/C2'
# Bien: Promedio usando función de Excel
hoja['D20'] = '=PROMEDIO(D2:D19)'
Esto aplica a TODOS los cálculos: totales, porcentajes, ratios, diferencias, etc. La hoja de cálculo debe poder recalcular cuando los datos de origen cambien.
Flujo de Trabajo Común
- Elegir herramienta: pandas para datos, openpyxl para fórmulas/formato
- Crear/Cargar: Crear nuevo libro o cargar archivo existente
- Modificar: Añadir/editar datos, fórmulas y formato
- Guardar: Escribir en archivo
- Recalcular fórmulas (OBLIGATORIO SI SE USAN FÓRMULAS): Usar el script recalc.py
python recalc.py output.xlsx - Verificar y corregir cualquier error:
- El script devuelve JSON con detalles del error
- Si
statuseserrors_found, revisaerror_summarypara tipos y ubicaciones específicos - Corrige los errores identificados y recalcula nuevamente
- Errores comunes a corregir:
#REF!: Referencias de celda inválidas#DIV/0!: División por cero#VALOR!: Tipo de dato incorrecto en la fórmula#¿NOMBRE?: Nombre de fórmula no reconocido
Creación de nuevos archivos Excel
# Usando openpyxl para fórmulas y formato
from openpyxl import Workbook
from openpyxl.styles import Font, PatternFill, Alignment
wb = Workbook()
hoja = wb.active
# Añadir datos
hoja['A1'] = 'Hola'
hoja['B1'] = 'Mundo'
hoja.append(['Fila', 'de', 'datos'])
# Añadir fórmula
hoja['B2'] = '=SUMA(A1:A10)'
# Formato
hoja['A1'].font = Font(bold=True, color='FF0000')
hoja['A1'].fill = PatternFill('solid', start_color='FFFF00')
hoja['A1'].alignment = Alignment(horizontal='center')
# Ancho de columna
hoja.column_dimensions['A'].width = 20
wb.save('output.xlsx')
Edición de archivos Excel existentes
# Usando openpyxl para preservar fórmulas y formato
from openpyxl import load_workbook
# Cargar archivo existente
wb = load_workbook('existente.xlsx')
hoja = wb.active # o wb['NombreHoja'] para una hoja específica
# Trabajar con múltiples hojas
for nombre_hoja in wb.sheetnames:
hoja = wb[nombre_hoja]
print(f"Hoja: {nombre_hoja}")
# Modificar celdas
hoja['A1'] = 'Nuevo Valor'
hoja.insert_rows(2) # Insertar fila en posición 2
hoja.delete_cols(3) # Eliminar columna 3
# Añadir nueva hoja
nueva_hoja = wb.create_sheet('NuevaHoja')
nueva_hoja['A1'] = 'Datos'
wb.save('modificado.xlsx')
Recalcular fórmulas
Los archivos Excel creados o modificados por openpyxl contienen fórmulas como cadenas de texto, pero no valores calculados. Usa el script recalc.py proporcionado para recalcular fórmulas:
python recalc.py <archivo_excel> [segundos_tiempo_espera]
Ejemplo:
python recalc.py output.xlsx 30
El script:
- Configura automáticamente la macro de LibreOffice en la primera ejecución
- Recalcula todas las fórmulas en todas las hojas
- Escanea TODAS las celdas en busca de errores de Excel (#REF!, #DIV/0!, etc.)
- Devuelve JSON con ubicaciones y conteos detallados de errores
- Funciona tanto en Linux como en macOS
Lista de Verificación de Fórmulas
Verificaciones rápidas para asegurar que las fórmulas funcionen correctamente:
Verificación Esencial
- Probar 2-3 referencias de muestra: Verificar que tomen los valores correctos antes de construir el modelo completo
- Mapeo de columnas: Confirmar que las columnas de Excel coincidan (ej., columna 64 = BL, no BK)
- Desfase de filas: Recordar que las filas de Excel comienzan en 1 (DataFrame fila 5 = Excel fila 6)
Errores Comunes
- Manejo de NaN: Verificar valores nulos con
pd.notna() - Columnas lejanas a la derecha: Los datos de año fiscal a menudo están en columnas 50+
- Múltiples coincidencias: Buscar todas las ocurrencias, no solo la primera
- División por cero: Verificar denominadores antes de usar
/en fórmulas (#DIV/0!) - Referencias incorrectas: Verificar que todas las referencias de celda apunten a las celdas previstas (#REF!)
- Referencias entre hojas: Usar el formato correcto (Hoja1!A1) para enlazar hojas
Estrategia de Prueba de Fórmulas
- Empezar pequeño: Probar fórmulas en 2-3 celdas antes de aplicarlas ampliamente
- Verificar dependencias: Revisar que todas las celdas referenciadas en las fórmulas existan
- Probar casos extremos: Incluir valores cero, negativos y muy grandes
Interpretación de la Salida de recalc.py
El script devuelve JSON con detalles del error:
{
"status": "success", // o "errors_found"
"total_errors": 0, // Conteo total de errores
"total_formulas": 42, // Número de fórmulas en el archivo
"error_summary": { // Solo presente si se encontraron errores
"#REF!": {
"count": 2,
"locations": ["Hoja1!B5", "Hoja1!C10"]
}
}
}
Mejores Prácticas
Selección de Biblioteca
- pandas: Mejor para análisis de datos, operaciones masivas y exportación simple de datos
- openpyxl: Mejor para formato complejo, fórmulas y características específicas de Excel
Trabajar con openpyxl
- Los índices de celda comienzan en 1 (fila=1, columna=1 se refiere a la celda A1)
- Usar
data_only=Truepara leer valores calculados:load_workbook('file.xlsx', data_only=True) - Advertencia: Si se abre con
data_only=Truey se guarda, las fórmulas se reemplazan con valores y se pierden permanentemente - Para archivos grandes: Usar
read_only=Truepara lectura owrite_only=Truepara escritura - Las fórmulas se preservan pero no se evalúan - usar recalc.py para actualizar valores
Trabajar con pandas
- Especificar tipos de datos para evitar problemas de inferencia:
pd.read_excel('file.xlsx', dtype={'id': str}) - Para archivos grandes, leer columnas específicas:
pd.read_excel('file.xlsx', usecols=['A', 'C', 'E']) - Manejar fechas correctamente:
pd.read_excel('file.xlsx', parse_dates=['columna_fecha'])
Pautas de Estilo de Código
IMPORTANTE: Al generar código Python para operaciones de Excel:
- Escribir código Python mínimo y conciso sin comentarios innecesarios
- Evitar nombres de variables verbosos y operaciones redundantes
- Evitar declaraciones print innecesarias
Para los propios archivos Excel:
- Añadir comentarios a celdas con fórmulas complejas o suposiciones importantes
- Documentar las fuentes de datos para valores fijos
- Incluir notas para cálculos clave y secciones del modelo