Concetti Importanti da Conoscere

Una Formula per Categoria: Puoi avere solo una formula per categoria.
Periodo di Applicazione: Il periodo di una formula inizia dal periodo corrente (offset 0) fino ai futuri offset. Tutti i valori previsionali all'interno di questo intervallo verranno aggiornati.
Applicabilità: Una formula è impostata per tutti gli offset, scenari e conti correnti.
Combinazione di Formule: Per applicare formule distinte per scenari specifici, banche o periodi, combina le formule con KPI manuali.

Evitare Errori di Sintassi

Usa il punto . invece della virgola , per i numeri decimali. Ad esempio, scrivi 1.5 invece di 1,5.
Usa la virgola , invece del punto e virgola ; in funzioni come IF o MAX. Esempio: IF(condizione, valore_se_vero, valore_se_falso).
Chiudi sempre le parentesi ) e assicurati che tutti gli argomenti siano assegnati nelle funzioni. Ad esempio, includi la parte else in una funzione IF.
Limita il Nesting: Evita di annidare troppi campi all'interno di una formula, poiché un eccessivo annidamento non è supportato.

Comprendere la Sintassi delle Formule

Formule Classiche

La sintassi di base per le formule è:

keyword   (    object    ,    offset   )

Parole Chiave: Specificano cosa vuoi calcolare.
Oggetti: La categoria o KPI a cui ti riferisci.
Offset: Valore numerico che indica il periodo di tempo relativo a quello corrente.

Parole Chiave e i Loro Usi

value: Restituisce il valore scritto nella cella corrispondente nel Piano di Tesoreria (include transazioni pagate, previste e rimanenti).
paid: Somma di tutte le transazioni pagate (colore più scuro sul grafico di tesoreria). È uguale a 0 per gli offset positivi.
expected: Somma di tutte le transazioni previste (tono medio di colore). È uguale a 0 per gli offset negativi.
objectives: Valore della previsione corrispondente solo.
remaining: Importo rimanente per completare la previsione corrispondente (colore più chiaro).
EndBalance: Restituisce il saldo finale del periodo dato per l'entità o il conto corrente.
CurrentBalanceOfAccount(bankaccount): Saldo di cassa di oggi per il conto selezionato (valore dinamico, dipende da oggi, non dall'offset).

Oggetti

Gli oggetti possono essere una categoria o un indicatore chiave (KPI). Selezionali dai menu sopra l'area di testo della formula. Puoi accedere a qualsiasi categoria o KPI (manuale o basato su una formula) già creato.

Offset

Gli offset determinano il periodo di tempo:

0: Periodo di tempo corrente.
Intero Positivo: Periodi futuri (es. +1 per il mese successivo).
Intero Negativo: Periodi passati (es. -1 per il mese precedente).

Gli offset dipendono dalla data corrente. Se oggi è gennaio, l'offset 0 si riferisce a gennaio. A febbraio, l'offset 0 si riferisce a febbraio.

Utilizzo degli Strumenti Matematici

Simboli Matematici

+: Addizione
-: Sottrazione
*: Moltiplicazione
/: Divisione

Note: Usa le virgole per i decimali (0,1 per il 10%). Agicap non visualizza i decimali nel Piano di Tesoreria, quindi moltiplica le percentuali per *100 se necessario.

Funzioni Matematiche

IF(condizione, valore_se_vero, valore_se_falso): Restituisce valore_se_vero se la condizione è soddisfatta, altrimenti valore_se_falso.
- Simboli Logici: <, >, <=, >=, =
- Esempio: IF(value(categoryA, -1) > 0, value(categoryA, -1) * 1.2, 0)
MAX(valore1, valore2, ...): Restituisce il valore massimo tra gli argomenti.
- Esempio: MAX(1000, value(categoryA, 0))
- Suggerimento: Usa MAX(your_formula, 0) per prevenire valori previsionali negativi.
MIN(valore1, valore2, ...): Restituisce il valore minimo.
AND e OR: Usati all'interno delle funzioni IF per verificare più condizioni.
- Sintassi: condizione1 AND condizione2
- Esempio: IF(value(categoryA, 0) > 0 AND value(categoryB, 0) > 0, 1000, 0)
AVERAGE(valore1, valore2, ...): Calcola la media degli argomenti.
- Esempio: AVERAGE(value(categoryA, -1), value(categoryA, -2))
Funzioni aggiuntive come LOG, EXP, FLOOR, CEILING, ecc., si comportano in modo simile alle funzioni di Excel.

Formule Avanzate

Parole Chiave Speciali

CurrentBalanceOfAccount(bankaccount)

Recupera il saldo di cassa di oggi per un conto specifico.
Utile per rapporti di performance come runway corrente o rapporti di liquidità.
Esempio: Calcolare il saldo di cassa rettificato.

EndBalance(offset)

Restituisce il saldo finale per l'offset specificato per l'entità o il conto corrente.
Esempio: EndBalance(0) restituisce il saldo finale del periodo corrente.

EndBalanceOfAccount(account; offset)

Restituisce il saldo finale per un conto corrente specifico a un dato offset.
Esempio: EndBalanceOfAccount(Account1, 0)

Formule di Gestione Progetti

Se utilizzi la funzione Gestione del Cashflow di Progetto, puoi fare riferimento a transazioni previste attribuite a un progetto specifico:

ExpectedOfProject(category, project, offset): Recupera le transazioni previste all'interno di un progetto.
IgnoredExpOfProject(category, project, offset): Recupera le transazioni previste ignorate all'interno di un progetto.

Note: Il selettore di progetti nelle formule dovrebbe essere abilitato dal Backoffice.

Esempi di Formule Complesse

Aumenta un valore del 10% ogni mese

value(categoryA, -1) * 1,1

Imposta le previsioni dei fornitori al 40% delle vendite ai clienti

value(total_clients, 0) * 0,4

Calcola la variazione mese su mese

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

Calcola la percentuale di fatturato dei clienti nelle vendite totali

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

Gestisci i casi senza valori passati usando la logica condizionale

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

Suggerimenti

Controlla Doppio la Sintassi: Assicurati che tutte le parentesi siano chiuse e gli argomenti siano correttamente assegnati.
Previeni Previsioni Negative: Avvolgi le formule con MAX(your_formula; 0) per evitare valori previsionali negativi.
Rimani Aggiornato: Agicap potrebbe rinominare le formule; fai riferimento alla documentazione più recente per gli aggiornamenti.
Usa i Progetti con Saggezza: Quando utilizzi formule relative ai progetti, assicurati che il selettore di progetti sia abilitato.

Domande e Risposte

Come posso fare riferimento al saldo di cassa corrente in una formula?

Usa CurrentBalanceOfAccount(bankaccount) per recuperare il saldo di cassa di oggi di un conto specifico. Ricorda, questo valore è dinamico e dipende dalla data corrente.

Posso creare formule che variano per scenario o conto corrente?

Le formule si applicano a tutti gli scenari e conti correnti. Per avere formule diverse per scenari o conti specifici, combina le formule con KPI manuali.

Come funzionano gli offset nelle formule?

Gli offset indicano il periodo di tempo relativo a quello corrente:

0: Periodo corrente
Interi positivi: Periodi futuri (es. +1 per il mese successivo)
Interi negativi: Periodi passati (es. -1 per il mese precedente)

Tieni presente che gli offset si basano sulla data corrente.

Cosa devo fare se incontro un errore di sintassi?

Gli errori di sintassi comuni includono:

Uso della virgola , invece del punto . per i decimali.
Uso del punto e virgola ; invece che della virgola , per separare gli argomenti delle formule.
Dimenticare di chiudere le parentesi.
Non assegnare tutti gli argomenti nelle funzioni. Rivedi la tua formula per correggere questi errori.

Ora sei pronto per sfruttare al massimo il potere delle formule in Agicap per migliorare la tua pianificazione della tesoreria! ✅