Ledger accounts
Learn how Monite handles ledger accounts from your accounting system.
A general ledger (GL) account is a component of an accounting system that is used to record and categorize a company’s financial transactions. Some examples of common ledger accounts are:
- Expenses: office supplies, utilities, salaries, taxes, and so on,
- Income: sales and revenue, dividends, and so on,
- Assets: cash, inventory, and so on,
- Liabilities: accounts payable, debt, and so on.
Within an accounting system, each line item on an invoice is assigned a ledger account in order to properly categorize various expenses and income sources. In Monite, the ledger_account_id
field of products and payable line items is used to assign ledger accounts to business objects.
Products and payables pulled from the accounting system have the ledger_account_id
pre-filled. However, when new products and payables are created in Monite, the user must manually specify the ledger_account_id
for those objects. This is required for Monite to be able to push invoices (both payables and receivables) to the accounting system.
The typical flow is as follows:
- After connecting an entity to an accounting system, wait until the initial data pull is completed.
- Call
GET /ledger_accounts
to get a list of an entity’s general ledgers pulled from the accounting system. - If an entity uses Accounts Payable:
- Get the line items of all payables and check if the line items have
ledger_account_id
. - If any line item is missing a value for
ledger_account_id
, prompt the user to assign the appropriate ledger account.
- Get the line items of all payables and check if the line items have
- If an entity uses Accounts Receivable:
- Get all products and check if they have
ledger_account_id
. - If any product is missing a value for
ledger_account_id
, prompt the user to assign the appropriate ledger account.
- Get all products and check if they have
Get ledger accounts
Ledger accounts cannot be created in Monite and can only be pulled from an accounting system.
After connecting to an accounting system, Monite automatically retrieves a list of ledger accounts from there. Once the initial data synchronization has completed, you can call GET /ledger_accounts
to get an entity’s ledger accounts that exist in the accounting system:
Below is an example of ledger account details. Note down the IDs of the ledger accounts - these are the possible values of the ledger_account_id
field in products and payable line items.
Assign ledger accounts to products and payable line items
Before payables can be pushed to an accounting system, each line item in all payables must have the ledger_account_id
specified. Similarly, before Account Receivable invoices can be pushed to accounting, all products listed on invoices must have the ledger_account_id
specified.
To specify an associated ledger account for a payable line item or a product, PATCH this object and provide the value for ledger_account_id
. For example: