Skip to main content
The Accounts Data Model represents a record in an accounting system that tracks the financial activities of a specific asset, liability, equity, revenue, or expense. These records increase and decrease as transactions occur throughout the accounting period. The aggregation of each Account object is often referred to as the Chart of Accounts.
  • Unified account properties: Essential account details like name, description, currency, and current balance are standardized across different accounting platforms
  • Hierarchical structure: Accounts can be linked to parent accounts using the parent_account_id, enabling the representation of complex account structures and relationships
  • Categorisation and status: The model supports account categorisation with main categories (asset, liability, equity, revenue, or expense) and subcategories, as well as tracking account status for better organisation and reporting

Attributes

Accounts Attributes

PropertyTypeDescription
rootfi_idintegerUnique identifier assigned by Commenda for this account
rootfi_created_atstringTimestamp when this record was created in Commenda’s system (ISO 8601)
rootfi_updated_atstringTimestamp when this record was last updated in Commenda’s system (ISO 8601)
rootfi_integration_typeenum
platform_idstringUnique identifier for this account in the source accounting platform
nominal_codestringThe nominal code of the account
namestringThe name of the account
descriptionstringThe description of the account
currency_idenumISO 4217 currency code
current_balancedoubleThe current balance of the account
statusenumThe status of the account
categoryenumThe category of the account
sub_categorystringThe sub category of the account
parent_account_idstringThe parent account ID of the account
updated_atstringThe date and time the account was last updated

Status Enum Values

ValueDescription
ACTIVEAccount is active and in use
ARCHIVEDAccount has been archived
UNKNOWNStatus cannot be determined from the platform

Category Enum Values

ValueDescription
ASSETAccount represents an asset (e.g., cash, inventory, property)
EXPENSEAccount represents an expense
LIABILITYAccount represents a liability (e.g., loans, accounts payable)
EQUITYAccount represents equity (e.g., retained earnings, capital)
INCOMEAccount represents income or revenue
BANKAccount represents a bank account
UNKNOWNCategory cannot be determined from the platform

Properties Supported

Fields accepted when creating or updating a record:
PropertyTypeDescription
platform_idstringUnique identifier for this account in the source accounting platform
nominal_codestringThe nominal code of the account
namestringThe name of the account
descriptionstringThe description of the account
currency_idenumISO 4217 currency code
current_balancedoubleThe current balance of the account
statusenumThe status of the account
categoryenumThe category of the account
sub_categorystringThe sub category of the account
parent_account_idstringThe parent account ID of the account
updated_atstringThe date and time the account was last updated