ACCOUNTENDINGBALANCE

Overview

The ACCOUNTENDINGBALANCE function calculates the ending balance of one or more general ledger account(s) as of a specific period - some organizations refer to this as the PeriodEndingBalance or PeriodClosingBalance for an account.

Syntax

CODE

=ACCOUNTENDINGBALANCE(
    ConnectionName, 
    Ledger, 
    AccountClass, 
    Account, 
    Subaccount, 
    Branch, 
    AsOf, 
    IncludeUnposted, 
    UseMasterFinancialCalendar
)

Arguments

The ACCOUNTENDINGBALANCE function uses the following arguments (see our article on Filtering Velixo Functions and using Excel arrays and cell ranges as arguments):

Argument	Required / Optional	Description
`ConnectionName`	Optional	Provide one of the following values: Connection name as defined in Connection Manager. Velixo range expression defining a set of connection names. An array of settings as described in the Multiple connections per formula article. We recommend using the VX.SETTINGS function to construct the array. OR Omit the argument to return results for all compatible connections with default aggregation settings.
`Ledger`	Required	Ledger ID. Leverage the ACU.EXPANDLEDGERRANGE function to obtain available values. Supports Velixo filtering techniques.
`AccountClass`	Optional, though required if `Account` is empty	Account class ID. Leverage the EXPANDACCOUNTCLASSRANGE function to obtain available values. Supports Velixo filtering techniques.
`Account`	Optional, though required if `AccountClass` is empty	General ledger account code(s). Leverage the EXPANDACCOUNTRANGE function to obtain available values. Supports Velixo filtering techniques.
`Subaccount`	Optional	Subaccount code(s). Leverage the EXPANDSUBACCOUNTRANGE function to obtain available values. Supports Velixo filtering techniques.
`Branch`	Optional	Branch ID(s). Leverage the EXPANDBRANCHRANGE function to obtain available values. Supports Velixo filtering techniques.
`AsOf`	Required	The financial period, in MM-YYYY format or a reference to a cell containing a date in a valid Excel format
`IncludeUnposted`	Optional	1 - Include posted transactions only (default) 2 - Include Unposted transactions onl 3 - Include Posted and Unposted transactions Transactions with a status of "On Hold" are excluded. When Unposted transactions are included, the following two statuses are included: Balanced, Unposted If a document is still in the AR module (e.g., Invoice), the corresponding GL batch has not yet been created, thus the balance for that document will not be reflected.
`UseMasterFinancialCalendar`	Optional	Use Acumatica's Master Financial Calendar instead of the financial calendar defined within the specific tenant associated with the connection being accessed (this can be useful for consolidation reports). Possible values: `TRUE` `FALSE` (default)

Examples

Given this data:

Example 1

CODE

=ACCOUNTENDINGBALANCE(
    "Demo", 
    "ACTUAL", 
    , 
    "10200",
    ,
    , 
    "01-2019"
)

Description: Calculates the ending balance of posted transactions to General Ledger account #10200 (as noted in cell B6) for the 7th period of the year 2019 (as noted in cell G1).

Result: 45,042,790

Example 2

CODE

=ACCOUNTENDINGBALANCE(
    "Demo", 
    "ACTUAL", 
    , 
    "10700",
    ,
    , 
    $D$4, 
    3
)

Description: Calculates the ending balance of the combined posted and unposted (as noted by the last argument: 3) transactions to General Ledger account #10700 (as noted in cell B8) as of January 15, 2019 (as noted in cell D4).

Result: 4,421,510