Track loans, produce amortization schedules, split principal and interest
The Long-term debt worksheet builds each loan's amortization schedule from its parameters (amount, rate, payment, frequency), automatically splits the long-term and current portions, isolates interest paid, and prepares the adjusting entry. It also calculates year-end accrued interest, and handles merchant cash advances (MCA/Vault) and early payoffs.
The worksheet at a glance
Three tabs:
- Summary: one row per loan, with the opening balance, principal repayments, interest paid, monthly payments, closing balance, worksheet balance and difference, accrued interest, and the long-term and current portions. The Next years button adds the repayments for the next 5 fiscal years.
- Schedule: the full amortization table for the selected loan, payment by payment.
- Adjusting entry: interest paid (+ accrued interest if enabled), as a full entry or by adjusting the difference with what is already in the books.
At the top: Export Excel (one .xlsx tab per loan with its full schedule) and Print (PDF for the reviewer).
Enable the worksheet and click New loan
Enable it from Worksheets (Ledger suggests it when a long-term debt account is non-zero). Then, on the Summary tab, click New loan.
Fill in the loan parameters
The “New long-term loan” dialog takes the terms of the contract:
- Account no.: the trial balance account of the loan. The Loan description follows it.
- Lender, Loan type: text.
- Loan date: the disbursement date. The first payment lands one period later (loan on Dec 2, first payment Jan 2), or on that date if Payment at the beginning of the period is checked (step 3). The Maturity date is calculated automatically.
- Original amount, Annual interest rate (%), Total number of payments, Periodic payment: each has a Calculate button.
- Payments per year: 12 (monthly) by default.
Fill in three of the four (amount, rate, number of payments, periodic payment), then click Calculate next to the missing one: Ledger finds it and shows “✓ Calculated from the other fields.” under it. The maturity date is calculated too. If the values can't be solved, Ledger says so.
Edge cases: lease, demand loan, moratorium, early payoff
- Payment at the beginning of the period (checkbox at the bottom of the dialog): for a capital lease, or a loan whose first payment is made at signing. The first payment falls on the loan date and goes entirely to principal, then one payment per period.
- Residual value: the amount paid at the end of the term (balloon, lease purchase option). Ledger adds it to the last payment, which clears the loan at maturity; with payment at the beginning of the period, it is paid at the end of the term, one period after the last payment. In the fiscal year it falls due, it moves to the current portion. Leave it empty for a loan that fully amortizes. Note: a payment already entered is never recalculated. If it already repays the whole loan, the residual value changes nothing, and Ledger says so in orange under the field: then click Calculate next to the periodic payment.
- Demand loan (checkbox at the bottom of the dialog): for a loan the lender can call at any time. The whole closing balance goes to the current portion (summary, note to the financial statements, balance sheet), as ASPE provides for debt payable on demand. The schedule and the next five years' repayments stay those of the contract, and the loan's row shows “On demand” in the summary.
- Moratorium (collapsed block under the checkboxes): two independent periods, each from … to … (payment dates). Interest-free: no interest, the whole payment goes to principal, so the loan is repaid faster; a moratorium where the bank receives only principal is one. Principal-free: the client pays interest only, and the term is extended by as much (the maturity date moves back). Both at once: no payment during the period.
- Early payoff date (buyout): only if the loan was refinanced or bought out before term. The schedule stops at that date, interest stops after, and Ledger shows “Payoff balance at this date: $X” under the field.
The Calculate button takes the beginning-of-period payment and the residual value into account. The Collateral / notes field keeps any text you want with the loan (for example, the security given).
Enable accrued interest if needed
Checkbox Calculate accrued interest at year-end, at the bottom of the loan dialog. Ledger then calculates the interest accrued from the last payment to the fiscal year-end, prorated by days, and adds it to the adjusting entry (DR Interest / CR Accrued liabilities). For example, a mortgage paid on the 1st of each month has 30 days of accrued interest on December 31.
Choose the Accrued liabilities payable account, which appears under the checkbox. The Interest expense account, higher in the dialog, can stay empty: Ledger detects it (group 808). The calculated amount shows in the summary's Accrued interest column.
Read the Summary and spot differences
The opening balance comes from last year's trial balance (the account's prior-year closing balance in the worksheet, split among the loans when several share the account: see the FAQ). The worksheet balance is the trial balance, including adjusting entries. A green checkmark in Worksheet difference means the schedule's closing balance matches the worksheet balance: the loan is reconciled.
An amber amount means there's a difference. The most common case: the bookkeeping recorded each payment in full against the loan. The difference then equals the year's interest, and the adjusting entry (step 7) corrects it. Otherwise, see “Why doesn't my loan balance exactly with the TB?” below.
Next years button, at the top right of the summary: it adds the principal repayments for the next five fiscal years, then the subsequent years (principal and interest), for the note to the financial statements. Hide next years removes them.
This button only affects the worksheet screen. To remove the next five years' principal repayments from the note to the financial statements (some clients prefer not to show them): in the financial statements' Notes & schedules tab, in the preview, click Hide the next five years, under the table of the Long-term debt note. Once hidden, a box that does not print takes their place in the preview, with Show to bring them back. The choice applies to this file and carries over to the next year's roll-forward. In a review engagement, a warning (not printed) reminds you that ASPE (Section 3856) requires these repayments.
Consult and verify the schedule
On the Schedule tab, pick the loan. Ledger shows the amortization table payment by payment: No., Date, Opening balance, Payment, Principal, Interest, Cumulative interest, Ending balance. At the top: periodic payment, periodic rate, total interest paid, total amount paid.
Everything adds up to the cent. On each row, opening balance − principal = ending balance, and principal + interest = payment; the last payment is the amount actually paid, often a little less than the periodic payment. The summary follows: opening balance − principal repayments = closing balance, interest paid = payments of the year − principal repayments, and the repayments of the next five fiscal years (Next years button) add up to the closing balance.
Use Export Excel at the top for a .xlsx file with one tab per loan.
Submit the adjusting entry
On the Adjusting entry tab, choose the mode at the top:
- Adjust the difference to the books (recommended, selected by default when the loan accounts already have a book balance). Each loan account is brought to the schedule's closing balance; the difference goes to the loan's interest expense. Everything already in the books, bookkeeping and other adjusting entries alike, is taken into account: there is nothing left to reverse by hand. The Accounts affected table shows, for each account, the book balance, the adjustment (debit or credit) and the balance after the entry.
- Full entry. Calculated from the schedule, assuming the bookkeeping charged each full payment to the loan: the year's interest paid is reclassified from the loan to interest expense.
In both modes, accrued interest (if enabled on the loan) is added as is: DR Interest / CR Accrued liabilities. The Proposed entry card lists the lines to post, with a ✓ Balanced badge. Click Submit to adjusting entries: the worksheet confirms “Entry #14 prepared in adjusting entries.”
Once the entry is submitted, a blue banner at the top of the tab says so (“Entry already prepared by this worksheet”, with its number). If the books already agree with the worksheet, the worksheet says so and there is nothing to submit. If you submit again, Ledger offers to replace the existing entry (it keeps its number and receives the full difference) or to keep both (the 2nd entry then contains only the remaining difference).
Special case: merchant cash advances (MCA/Vault)
MCAs aren't traditional loans: no stated nominal rate, repayment tied to a percentage of sales or fixed instalments. Model them like this:
- Original amount: the net received by the client (not the notional). If Vault advances $50,000 and takes $500 in origination fees, enter $49,500.
- Residual value: leave it empty. This field is for a lease balloon; an advance is repaid in full.
- Total number of payments and Periodic payment: per Vault's agreement.
- Annual interest rate: leave it empty and click Calculate next to it: Ledger finds the implicit rate (often high, 30 to 60%).
- If the client buys out early, set the Early payoff date: Ledger shows the payoff balance at that date.
Our article Long-term debt at year-end explains the amortization schedule, the current portion and accrued interest, with a worked example.
Frequently asked questions
Can I link several loans to the same TB account?
Yes. Ledger then splits the account's opening balance (its prior-year balance) among its loans, in proportion to each loan's contractual balance at the start of the year; a loan taken out during the year gets none of it. The worksheet balance and the difference show once for the account, with the note “Shared account”: the difference compares the total of its loans with the account balance. If the books drift from the contracts, that drift is split in proportion too. To follow it loan by loan, give each loan its own account instead (for example, 2710 for the mortgage and 2720 for the truck).
A loan changes rate mid-life: how do I handle it?
Represent it as two loans: the first with an early payoff date at the refinance date, the second with the same date as its loan date and the new rate. The first loan's payoff balance becomes the second loan's original amount.
A loan had a moratorium or payment holiday: how do I represent it?
Use the Moratorium block of the loan dialog (step 3): interest-free, principal-free, or both at once. Only one case stays apart: a deferral where interest keeps running and is added to the balance. Represent it as two loans, as for a rate change. The first gets an early payoff date at the start of the deferral. The second gets the end of the deferral as its loan date (its first payment falls one period later) and, as its original amount, the first loan's payoff balance plus the interest added to the balance. That interest is in no schedule: record it with an adjusting entry.
The adjusting entry was submitted, I want to change it
Don't delete it. Change the loan parameters, then click Submit to adjusting entries again. Ledger offers Replace to update the existing entry without changing its number.
Can I attach a document (loan agreement) to the loan?
Open the loan in edit mode: a Documents attached to this loan panel appears at the bottom. Drag and drop or click to upload. Documents stay with the loan and follow it year over year.
Why doesn't my loan balance exactly with the TB?
The most common cause: the bookkeeping recorded each payment in full against the loan. The difference then equals the year's interest, and the adjusting entry corrects it: once submitted, the difference disappears. Other causes: (a) an extra payment outside the schedule (the schedule doesn't know it: represent the rest as a new loan, as for a rate change); (b) the loan date entered doesn't exactly match the disbursement; (c) the actual rate differs from the rate on the contract (leave the rate empty and click Calculate to find the real one).