Chart of Accounts

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 and subGroup. 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.

FieldTypeDescription
idstringIdentifier for the account, unique for the business.
nominalCode stringReference given to each nominal account for a business. It ensures money is allocated to the correct account.
name
sortable, filterable
stringName of the account as specified by the business.
fullyQualifiedName
sortable, filterable
stringFully 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
stringThe 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 stringDescription of the account as specified by the business.
section
sortable, filterable
stringRailz normalized account classification.
subSection
sortable, filterable
stringRailz normalized account classification.
group
sortable, filterable
stringRailz normalized account classification.
subGroup
sortable, filterable
stringRailz normalized account classification.
classification
sortable, filterable
stringThe original classification of an account from the accounting service provider, e.g. Asset.
type
sortable, filterable
stringThe original type of an account from the accounting service provider, e.g. Fixed Asset.
subtype
sortable, filterable
stringThe original subtype of an account from the accounting service provider, e.g. Furniture And Fixtures
currencyRef Reference TypesCurrency 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
booleanConfirms whether the account is a sub account or not.
isActive
sortable, filterable
booleanConfirms whether the account is an active account or not.
parentRefReference TypesParent account.
subsidiaryRefsReference TypesThe 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 the id as a value instead of nesting it within.