Create a financial account ledger
financial_account_type
. By selecting the financial account type, we
set smart defaults to ensure that the accounting treatment is accurate. For example, setting financial_account_type
to
bank
automatically sets type
to asset
, debit_credit
to debit
, and report_cash_flow
to true
.Map the ledger
ledger_id
of the
financial account ledger and the real-world financial account it represents.We call this mapping, and you will use this mapping for various use cases such as submitting transactions.Set the opening balance
Map financial account ledgers at the beginning
Give descriptive names to ledgers
Make ledgers representing platform controlled financial accounts non-editable
editable
parameter to False
when using the Create Ledger endpoint. This will
prevent the user from editing any line entry that is assigned to the ledger. They will still
be able to categorize the transactions and edit the rest of the journal entry. This feature
ensures that the user does not accidently break the sync between the Teal ledger and the
transactions submitted from the financial account.For example, if you submit a transaction for a $10 expense for “Starbucks” using the
Create Transaction endpoint, Teal will automatically generate a
journal entry with two line entries. One line entry will credit $10 to the bank account ledger,
the other line entry will debit $10 to an expense ledger (depending on your
auto-categorization config). If the bank account ledger
is set to editable
= False, then the user will be able to change the $10 debit to the
expense ledger, but not the $10 credit to the bank account ledger.