How do I book a document into the ledger with SparkAgent?

How SparkAgent books an expense, a purchase on credit or an instalment into your account's general ledger, using SparkReceipt's bookkeeping guidance.

AL
Written by Antti LaitinenUpdated Nov 16, 2026

If your account keeps its books in SparkReceipt's general ledger (Ledger in the web app's sidebar), you can ask SparkAgent to book a document into it. Open the document and ask, for example, "Help me book this order into our ledger". SparkAgent reads the document, looks up the bookkeeping guidance, explains how it would book it, makes the changes and then checks the result in the ledger.

These steps are only offered on accounts with the general ledger. Without it, SparkAgent works as described in How to use SparkAgent. Ledger shows in the sidebar only to owners, admins and Accountants, so a member doesn't see it even when the general ledger is on. The general ledger is turned on per account: if an owner, admin or Accountant doesn't see Ledger in the sidebar, contact support through the in-app chat.

What posts to the ledger

  • Only an Expense or an Income posts to the ledger. A document filed as an Other document posts nothing. If you ask SparkAgent to book one, it tells you so and offers to switch it to an Expense or an Income.
  • Each line posts to the ledger account of its Category. Reclaimable VAT on an Expense posts to VAT receivable.
  • The other side of the entry depends on how the document was paid. A paid document posts to the account of its payment method. An unpaid one posts to accounts payable or receivable until its payments clear it. An Expense you paid personally posts to reimbursements payable.
  • A payment method of the kind Credit card gets an account on the liability side of the balance sheet, unless it is linked to a Procountor, Netvisor or Xero payment account that books to an account of its own. That makes it the right payment method for a purchase on credit, such as a hire purchase: the debt sits on that account until it is paid.

Bookkeeping guidance by country

Before SparkAgent picks a Category, a ledger account or a treatment, it reads the same bookkeeping guidance SparkReceipt's receipt review uses. The guidance tells it how to choose between similar kinds of cost, what to book when a fact is missing, and what to ask you.

There is detailed guidance for Finland, the United Kingdom, the United States, Canada and Australia. An account in Åland reads the Finnish guidance, since Finnish bookkeeping and VAT law applies there. Åland is outside the EU VAT area, though: goods bought from mainland Finland or another EU country cross a tax border, so the Finnish guidance on EU acquisitions and intra-EU trade doesn't apply to them. SparkAgent tells you so when a document is such a purchase. For an account in another country, SparkAgent tells you no guidance covers your country, answers from general bookkeeping principles and suggests confirming the booking with your accountant.

Example: a phone bought on a hire purchase in Finland

This example follows the Finnish guidance, for a business that reclaims VAT when it gets the purchase invoice (not on the cash basis). A business buys a phone on a 12-month interest-free hire purchase. The purchase document shows the full price and all of the VAT, and each monthly invoice carries one instalment with no VAT.

  1. On the purchase document, SparkAgent books the full price as an Expense on the Category for short-lived IT devices (a phone that costs at most 1 200 euros without VAT, within 3 600 euros of such small purchases a year, or that it expects to use for at most three years), with the whole VAT deducted. A business on cash-basis VAT, one that is not VAT registered, or one in a country with other rules books the VAT differently. Check that booking with your accountant. SparkAgent sees the hire purchase in the document's description, so it doesn't need to ask how you paid. It creates a payment method of the kind Credit card named after the plan (for example "Elisa laiteosamaksu"), or uses the one you already have, and marks the document paid with it. The debt for the full amount then sits on its own liability, not among your supplier invoices in accounts payable. SparkAgent proposes the payment method and the document changes together before it makes them.
  2. On each monthly invoice, ask "Book this month's instalment". SparkAgent finds the plan's payment method and the debt on its liability, so it doesn't ask whether the phone was booked. The instalment repays the debt, so SparkAgent posts that line to the liability instead of to a cost. The instalment carries no VAT, since the purchase document already carried all of it. If the instalment line has a VAT amount, SparkAgent proposes removing it. The rest of the invoice, such as the phone subscription, stays on its own Category.
  3. SparkAgent shows the liability's balance before and after, and how much the instalment took off the debt. The ledger posts the change within about a minute of applying it, so a balance you open right away may still show the old figure for a moment.

Posting a line to a balance-sheet account

A line that repays a debt, such as a loan or hire purchase instalment, can post to a balance-sheet account instead of its Category's account. SparkAgent checks the purchase document before it touches the line's VAT. When the purchase document carried the full price and all of the VAT, as on a hire purchase, an instalment carries none. When such a line has a VAT amount, SparkAgent proposes removing it and moving the whole amount onto the line, which keeps the document total the same and keeps the VAT from being deducted twice. When the purchase document or contract carried no VAT, as on most leases, each rental invoice charges its own VAT, which a VAT-registered business can reclaim, so that VAT stays on the line. Where the VAT was charged decides it, whatever the plan is called. SparkAgent posts the line to the balance-sheet account as a ledger change set, which you see under Change sets in the Ledger. It shows you what the change does to the ledger before it applies it, and you can undo an applied change set for 90 days. Removing the VAT is a separate edit of the line, which SparkAgent proposes alongside: undoing the change set doesn't bring the VAT back.

Owners, admins and Accountants can make changes to the ledger and read its balances. If your role can't, SparkAgent explains the booking and tells you who can make it.

A whole month at once

For a whole month, an owner, admin or Accountant can have SparkAgent ask the AI bookkeeper to go through the books, on accounts where the AI bookkeeper is turned on. The AI bookkeeper works in the background, and its proposals arrive later as change sets named "AI bookkeeper" followed by the month. For a single document, SparkAgent reads the guidance and books it itself.

Publishing stays your call

Booking a document into the ledger doesn't publish it to your accounting software. SparkAgent only publishes when you ask it to.

In other AI tools

If you connect an AI tool to SparkReceipt, it can read the same bookkeeping guidance with the Read your data permission, on accounts with the general ledger.