BC.CREDITS | Velixo

Overview

The BC.CREDITS function lets you retrieve the total credit amount of transactions affecting specified GL accounts between two dates.

This function requires the Velixo for Business Central extension to be installed in your Business Central environment.

Business Central creates year-end closing entries when you close a fiscal year. These entries are excluded from the result by default. Set IncludeClosingEntries to TRUE to include them, for example to report on the closing activity itself, or to calculate retained earnings the way the Business Central UI does.

Syntax

=BC.CREDITS(
    ConnectionName, 
    Account, 
    AccountCategory, 
    AccountSubcategory, 
    FromDate, 
    ToDate, 
    Dimensions,
    UseReportingCurrency,
    IncludeClosingEntries
)

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.
`Account`	Optional if `AccountCategory` or `AccountSubcategory` is specified	The code of the general ledger account, a spill range, or a cell range containing account codes. For example, `10100`, `A1:A10`, or `A1#` Supports Velixo range expressions for specifying multiple values.
`AccountCategory`	Optional if `Account` or `AccountSubcategory` is specified	One or more account category names, visible in the Business Central Chart of Accounts. The following values are accepted: `Assets`, `Liabilities`, `Equity`, `Income`, `Cost of Goods Sold`, `Expense` Supports Velixo range expressions for specifying multiple values.
`AccountSubcategory`	Optional if `Account` or `AccountCategory` is specified	One or more account subcategory names. Use the BC.EXPANDACCOUNTSUBCATEGORYRANGE function to retrieve available subaccount names. Supports Velixo range expressions for specifying multiple values.
`FromDate`	Required	The inclusive start date in YYYY-MM-DD format (or a reference to a cell in a valid Excel date format)
`ToDate`	Required	The inclusive end date in YYYY-MM-DD format (or a reference to a cell in a valid Excel date format)
`Dimensions`	Optional	A two-column Excel range where the first column contains the name of a dimension and the second column contains a semicolon-separated list of values for that dimension You can specify dimension values using ranges, wildcards, and other techniques. See the Using Dimensions article for more details.
`UseReportingCurrency`	Optional	When a reporting currency is configured for your organization, set this argument to `TRUE` to return the results using the configured currency. Accepted values: `TRUE` or `FALSE` Default value: `FALSE`
`IncludeClosingEntries`	Optional	If `TRUE`, the year-end closing entries are included in the calculation. If `FALSE`, closing entries are removed from the returned amount. Accepted values: `TRUE` or `FALSE` Default value: `FALSE` Specifying this argument requires the Velixo for Business Central extension version 2026.7 or later. This applies to `FALSE` as well as `TRUE`. Omitting the argument, or pointing it at an empty cell, does not require the update.

Example

=BC.CREDITS(
    "BC",
    ,
    "assets",
    ,
    "2023-12-31",
    "2023-12-31"
)

Description:

Returns the total of the credits applied to all accounts in the category Assets during December 2023, within the connection named BC.

Excel worksheet showing BC.CREDITS returning total credits for all asset accounts during December 2023 in Business Central