KYRIBA.GETCASHBALANCE

Overview

Returns account cash balance.

Syntax

KYRIBA.GETCASHBALANCE(accounts; [fields]; [startDate]; [endDate]; [dateType]; [actual]; [confirmedForecasts]; [estimatedForecasts]; [intraday])

Note❗ The list separator (e.g., comma or semicolon) may differ depending on your Region settings.

Parameter Required/Optional Description Details
Accounts ✅   Required One or a range of account codes.
Fields 🟨  Optional Specify fields to return.
If omitted or equal to empty space, default fields are returned.
Default fields: Account code; Bank balance amount; Currency code; Balance date.
Enter “EXCEL” or “EXCELH” to return all the existing fields horizontally.
Enter “EXCELV” to return all the existing fields vertically.
Enter “JSON” to return the API response body.
Start date 🟨  Optional Specify the date of the first cash balance to return.
If omitted, the date is today.
When passing a date as text to the custom function, make sure to either use the “YYYY-MM-DD” date format (e.g. "2024-01-31") or the DATEVALUE function to ensure Excel recognizes it correctly, such as DATEVALUE("23/12/2025").
End date 🟨  Optional Specify the date of the last cash balance to return.
If omitted, the date is today.
When passing a date as text to the custom function, make sure to either use the “YYYY-MM-DD” date format (e.g. "2024-01-31") or the DATEVALUE function to ensure Excel recognizes it correctly, such as DATEVALUE("23/12/2025").
Date type 🟨  Optional Specify date type: TRANSACTION or VALUE.
If omitted, the type is TRANSACTION.
Actual 🟨  Optional Include cash flows with status Actual in the balance. 1 or TRUE to include.
0 or FALSE to exclude.
If omitted, the value is TRUE.
Confirmed forecasts 🟨  Optional Include cash flows with status Confirmed forecast in the balance. 1 or TRUE to include.
0 or FALSE to exclude.
If omitted, the value is TRUE.
Estimated forecasts 🟨  Optional Include cash flows with status Estimated forecast in the balance. 1 or TRUE to include.
0 or FALSE to exclude.
If omitted, the value is TRUE.
Intraday 🟨  Optional Include cash flows with status Intraday in the balance. 1 or TRUE to include.
0 or FALSE to exclude.
If omitted, the value is TRUE.


Examples

1. Cash balance of the account ORS_ACC01 for today that only includes cash flows of status Actual. Default fields are returned.

Formula:

=KYRIBA.GETCASHBALANCE("ORS_ACC01";;;;;TRUE;FALSE;FALSE;FALSE)

Result:

2. Cash balance of the account ORS_ACC01 for the period from yesterday until today. It includes cash flows of all the statuses. All the fields are returned horizontally.

Formula:

=KYRIBA.GETCASHBALANCE("ORS_ACC01";"EXCELH";TODAY()-1;)

Result: