ACCOUNTBEGINNINGBALANCE

Overview

The ACCOUNTBEGINNINGBALANCE function calculates the beginning or opening balance of one or more general ledger accounts, for a specific period.

Some organizations refer to this as the Period Beginning Balance or Period Opening Balance for an account.

Syntax

CODE

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

Arguments

The ACCOUNTBEGINNINGBALANCE function uses the following arguments

Argument	Required/Optional	Description
`ConnectionName`	Required	The name of the connection, as specified in the Connection Manager
`Ledger`	Required	Ledger to use in the calculation.
`AccountClass`	Optional, though required if `Account` is empty	The account class to use for the calculation.
`Account`	Optional, though required if `AccountClass` is empty	The general ledger account(s) to use for the calculation.
`Subaccount`	Optional	The general ledger subaccounts(s) to include.
`Branch`	Optional	The branch(es) to include.
`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 only 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. Excel for Windows allows the use of quotation marks around this argument. Excel for Mac and Excel Online require that it be unquoted.
`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) This feature requires that your ERP license include Multi-Calendar Support and that our ERP be configured for that feature

(see our articles on Filtering Velixo Functions and using arrays or cell ranges as arguments)

Examples

Based on this data:

Example 1

CODE

=ACCOUNTBEGINNINGBALANCE("Demo", "ACTUAL", , $B6,,, $G$1)

Description: Calculates the beginning balance of posted transactions to General Ledger account # 10200 (as noted in cell B6) as of the beginning of Period 1 for the year 2019 (as noted in cell G1).

Result: 43,925,384

Example 2

CODE

=ACCOUNTBEGINNINGBALANCE("Demo", "ACTUAL", , $B9,,, C$4, 3)

Description: Calculates the beginning balance of combined posted and unposted transactions to General Ledger account #10800 (as noted in cell B9) for as of January 1, 2019 (as noted in cell C4).

Result: 4,454,986

Limitations to filtering by date instead of financial period:

This feature cannot be used with the Net Income account
Drilldown will show transactions for the entire financial period (you will then need to manually filter on the date column)
Balances are calculated based on the total from the nearest financial period, and then adjusted based on the filtered transaction date
Dates cannot be placed directly in the function; they must be cell references
Balances will not reflect transactions within the specified date range but which have been posted to a different financial period.