The Account Object
Accounts are the categories a business uses to record and classify accounting transactions. From the Accounts endpoint, you can retrieve a list of all accounts for a specified business.
Account Normalization
Railz normalizes all chart of accounts using 4 subclassifications:
section
,subSection
,group
andsubGroup
. See account normalization for more details and a list of all classifications.
Filtering Bank Accounts
Use the isBankAccount to filter the business' accounts to show only bank accounts.
Field | Type | Description |
---|---|---|
id | string | Identifier for the account, unique for the business. |
nominalCode | string | Reference given to each nominal account for a business. It ensures money is allocated to the correct account. |
name sortable, filterable | string | Name of the account as specified by the business. |
fullyQualifiedName sortable, filterable | string | Fully qualified name of the account. The fully qualified name prepends the topmost parent, followed by each subaccount separated by colons and takes the form of Parent:Account1:SubAccount1:SubAccount2. |
depth sortable, filterable | string | The hierarchical level of the account in the Accounts list. The highest level accounts are level 1, the lowest is n. This is an example showing account hierarchy: Assets - Level 1 Current Assets - Level 2 Bank Accounts - Level 3 National Bank Account 1 - Level 4" |
description | string | Description of the account as specified by the business. |
section sortable, filterable | string | Railz normalized account classification. |
subSection sortable, filterable | string | Railz normalized account classification. |
group sortable, filterable | string | Railz normalized account classification. |
subGroup sortable, filterable | string | Railz normalized account classification. |
classification sortable, filterable | string | The original classification of an account from the accounting service provider, e.g. Asset. |
type sortable, filterable | string | The original type of an account from the accounting service provider, e.g. Fixed Asset. |
subtype sortable, filterable | string | The original subtype of an account from the accounting service provider, e.g. Furniture And Fixtures |
currencyRef | Reference Types | Currency of the account. |
currentBalance sortable, filterable | decimal | Current balance in the account. |
isBankAccount sortable, filterable | boolean | Confirms whether the account is a bank account or not. |
isSubAccount sortable, filterable | boolean | Confirms whether the account is a sub account or not. |
isActive sortable, filterable | boolean | Confirms whether the account is an active account or not. |
parentRef | Reference Types | Parent account. |
subsidiaryRefs | Reference Types | The subsidiaries that has access to this account. |
sourceModifiedDate sortable, filterable | string See Date | Date the record was last changed in the accounting service provider. |
The Account Reference Object
Data types that reference an account, for example, bill and invoice line items, use an accountRef that includes the id
and name
of the linked account.
Using Account Reference in Push
For convenience, when pushing data
accountRef
can be used alone with theid
as a value instead of nesting it within.