Ir al contenido principal
Todas las coleccionesTreasuryPrevisionesFórmula
Cómo dominar la sintaxis de fórmulas en Agicap Tesorería 💡
Cómo dominar la sintaxis de fórmulas en Agicap Tesorería 💡

Las fórmulas en Agicap te permiten crear previsiones dinámicas e indicadores clave personalizados (KPIs) para mejorar tu planificación de tesorería.

Actualizado hace más de 2 semanas

Conceptos Importantes a Conocer

  • Una Fórmula por Categoría: Solo puedes tener una fórmula por categoría.

  • Período de Aplicación: El período de una fórmula comienza desde el período actual (desfase 0) hasta desfases futuros. Todos los valores de previsión dentro de este rango se actualizarán.

  • Aplicabilidad: Una fórmula se establece para todos los desfases, escenarios y cuentas bancarias.

  • Combinación de Fórmulas: Para aplicar fórmulas distintas a escenarios, bancos o períodos específicos, combina fórmulas con KPIs manuales.

Evitando Errores de Sintaxis

  • Usa coma , en lugar de punto . para números decimales. Por ejemplo, escribe 1,5 en lugar de 1.5.

  • Usa punto y coma ; en lugar de coma , en funciones como IF o MAX. Ejemplo: IF(condición; valor_si_verdadero; valor_si_falso).

  • Siempre cierra paréntesis ) y asegúrate de que todos los argumentos estén asignados en las funciones. Por ejemplo, incluye la parte else en una función IF.

  • Limita el Anidamiento: Evita anidar demasiados campos dentro de una fórmula, ya que el anidamiento excesivo no es compatible.

Entendiendo la Sintaxis de Fórmulas

Fórmulas Clásicas

La sintaxis básica para las fórmulas es:

keyword
   (   
object
   ,   
offset  
)

  • Palabras Clave: Especifica lo que deseas calcular.

  • Objetos: La categoría o KPI que estás referenciando.

  • Desfases: Valor numérico que indica el período de tiempo relativo al actual.

Palabras Clave y Sus Usos

  • value: Devuelve el valor escrito en la celda correspondiente en el Plan de Tesorería (incluye operaciones liquidadas, esperadas y restantes).

  • paid: Suma de todas las operaciones liquidadas (color más oscuro en el gráfico de tesorería). Es igual a 0 para desfases positivos.

  • expected: Suma de todas las operaciones esperadas (tono medio). Es igual a 0 para desfases negativos.

  • objectives: Valor de la previsión correspondiente solamente.

  • remaining: Cantidad restante para completar la previsión correspondiente (color más claro).

  • EndBalance: Devuelve el saldo final del período dado para la entidad o cuenta bancaria.

  • CurrentBalanceOfAccount(bankaccount): Saldo de efectivo de hoy para la cuenta seleccionada (valor dinámico, depende de hoy, no del desfase).

Objetos

Los objetos pueden ser una categoría o un indicador clave (KPI). Selecciónalos desde los menús sobre el área de texto de la fórmula. Puedes acceder a cualquier categoría o KPI (manual o basado en una fórmula) ya creado.

Desfases

Los desfases determinan el período de tiempo:

  • 0: Período de tiempo actual.

  • Entero Positivo: Períodos futuros (por ejemplo, +1 para el próximo mes).

  • Entero Negativo: Períodos pasados (por ejemplo, -1 para el mes anterior).

Los desfases dependen de la fecha actual. Si hoy es enero, el desfase 0 se refiere a enero. En febrero, el desfase 0 se refiere a febrero.

Usando Herramientas Matemáticas

Símbolos Matemáticos

  • +: Suma

  • -: Resta

  • *: Multiplicación

  • /: División

Nota: Usa comas para decimales (0,1 para 10%). Agicap no muestra decimales en el Plan de Tesorería, así que multiplica porcentajes por *100 si es necesario.

Funciones Matemáticas

  • IF(condición; valor_si_verdadero; valor_si_falso): Devuelve valor_si_verdadero si se cumple la condición, de lo contrario valor_si_falso.

    • Símbolos Lógicos: <, >, <=, >=, =

    • Ejemplo: IF(value(categoryA; -1) > 0; value(categoryA; -1) * 1,2; 0)

  • MAX(valor1; valor2; ...): Devuelve el valor máximo entre los argumentos.

    • Ejemplo: MAX(1000; value(categoryA; 0))

    • Consejo: Usa MAX(tu_fórmula; 0) para evitar valores de previsión negativos.

  • MIN(valor1; valor2; ...): Devuelve el valor mínimo.

  • AND y OR: Usados dentro de funciones IF para verificar múltiples condiciones.

    • Sintaxis: condición1 AND condición2

    • Ejemplo: IF(value(categoryA; 0) > 0 AND value(categoryB; 0) > 0; 1000; 0)

  • AVERAGE(valor1; valor2; ...): Calcula el promedio de los argumentos.

    • Ejemplo: AVERAGE(value(categoryA; -1); value(categoryA; -2))

  • Funciones adicionales como LOG, EXP, FLOOR, CEILING, etc., se comportan de manera similar a las funciones de Excel.

Fórmulas Avanzadas

Palabras Clave Especiales

CurrentBalanceOfAccount(bankaccount)

  • Recupera el saldo de efectivo de hoy para una cuenta específica.

  • Útil para ratios de rendimiento como el runway actual o ratios de liquidez.

  • Ejemplo: Calcular saldo de efectivo ajustado.

EndBalance(offset)

  • Devuelve el saldo final para el desfase especificado para la entidad o cuenta bancaria.

  • Ejemplo: EndBalance(0) devuelve el saldo final del período actual.

EndBalanceOfAccount(account; offset)

  • Devuelve el saldo final para una cuenta bancaria específica en un desfase dado.

  • Ejemplo: EndBalanceOfAccount(Account1; 0)

Fórmulas de Gestión de Proyectos

Si usas la función Gestión de Tesorería de Proyectos, puedes referenciar operaciones esperadas atribuidas a un proyecto específico:

  • ExpectedOfProject(category; project; offset): Recupera operaciones esperadas dentro de un proyecto.

  • IgnoredExpOfProject(category; project; offset): Recupera operaciones esperadas ignoradas dentro de un proyecto.

Nota: El selector de proyectos en fórmulas debe estar habilitado desde el Backoffice.

Ejemplos de Fórmulas Complejas

Aumentar un valor en un 10% cada mes

value(categoryA; -1) * 1,1

Establecer previsiones de proveedores al 40% de las ventas de clientes

value(total_clients; 0) * 0,4

Calcular la variación mes a mes

((value(categoryA; 0) - value(categoryA; -1)) / value(categoryA; -1)) * 100

Calcular el porcentaje de facturación de clientes en las ventas totales

(value(clientX; 0) / value(total_sales; 0)) * 100

Manejar casos sin valores pasados usando lógica condicional

IF(value(category; -1) = 0; (value(category; -1) + 1000) * 1,2; value(category; -1) * 1,2)

Consejos

  • Revisa dos veces la Sintaxis: Asegúrate de que todos los paréntesis estén cerrados y los argumentos estén correctamente asignados.

  • Previene Previsiones Negativas: Envuelve fórmulas con MAX(tu_fórmula; 0) para evitar valores de previsión negativos.

  • Mantente Actualizado: Agicap puede renombrar fórmulas; consulta la documentación más reciente para actualizaciones.

  • Usa Proyectos Sabiamente: Cuando uses fórmulas relacionadas con proyectos, asegúrate de que el selector de proyectos esté habilitado.

Preguntas y Respuestas

¿Cómo puedo referenciar el saldo de efectivo actual en una fórmula?

Usa CurrentBalanceOfAccount(bankaccount) para recuperar el saldo de efectivo de hoy de una cuenta específica. Recuerda, este valor es dinámico y depende de la fecha actual.

¿Puedo crear fórmulas que varíen por escenario o cuenta bancaria?

Las fórmulas se aplican a todos los escenarios y cuentas bancarias. Para tener fórmulas diferentes para escenarios o cuentas específicas, combina fórmulas con KPIs manuales.

¿Cómo funcionan los desfases en las fórmulas?

Los desfases indican el período de tiempo relativo al actual:

  • 0: Período actual

  • Enteros positivos: Períodos futuros (por ejemplo, +1 para el próximo mes)

  • Enteros negativos: Períodos pasados (por ejemplo, -1 para el mes anterior)

Ten en cuenta que los desfases se basan en la fecha actual.

¿Qué debo hacer si encuentro un error de sintaxis?

Los errores de sintaxis comunes incluyen:

  • Usar un punto . en lugar de una coma , para decimales.

  • Olvidar cerrar paréntesis.

  • No asignar todos los argumentos en funciones. Revisa tu fórmula para corregir estos errores.

¡Ahora estás listo para aprovechar todo el poder de las fórmulas en Agicap para mejorar tu planificación de tesorería! ✅

¿Ha quedado contestada tu pregunta?