Book a journal entry

books_record_entry · Changes data · Markdown

Books a journal entry of two or more balancing lines, for whatever the other tools do not cover.

$0.01 a call

From your agent’s balance. A call that fails costs nothing.

Book the 15,000 euro bank loan that landed in our account on October 1.

Your agent callsbooks_record_entry$0.01 a call

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments

{
  "date": "2026-10-01",
  "memo": "Bank loan for the new forklift",
  "reference": "Loan 4471-02",
  "lines": [
    {
      "account": "1010",
      "debit": "15000.00"
    },
    {
      "account": "2300",
      "credit": "15000.00"
    }
  ]
}

What comes back

{
  "entry": {
    "entry": 3,
    "date": "2026-10-01",
    "memo": "Bank loan for the new forklift",
    "reference": "Loan 4471-02",
    "party": null,
    "source": "manual",
    "total": "15000.00",
    "currency": "EUR",
    "rate": null,
    "lines": [
      {
        "account": "1010",
        "account_name": "Bank",
        "debit": "15000.00",
        "credit": null,
        "description": null,
        "tax": null
      },
      {
        "account": "2300",
        "account_name": "Loans",
        "debit": null,
        "credit": "15000.00",
        "description": null,
        "tax": null
      }
    ],
    "reverses": null,
    "reversed_by": null,
    "receipt_file_id": null,
    "recorded_at": "2026-10-15T14:29:47+00:00",
    "recorded_by": "key 4101 (Pip)"
  }
}

Use it when

Opening balances, a loan, depreciation, owner's drawings, a transfer between accounts, a correction.

For a cost the business paid, use books_record_expense.
For an invoice to a customer, use invoices_create.

What it does

Book an entry: two or more lines, each a debit or a credit on an account, which must balance. For anything the other tools don't cover: opening balances, a loan, depreciation, owner's drawings, moving money between accounts, a correction. Entries are never edited; undo one with books_reverse_entry. Lines can carry a tax so the tax report counts them.

What comes back

The entry booked: its number, date, memo, reference, party, source and lines. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`date`Required	string	YYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$.
`memo`	string	Up to 500 characters.
`reference`	string	Up to 120 characters.
`party`	string	Who paid or was paid. Up to 200 characters.
`lines`Required	array of objects	2 to 200 items.
`lines[].account`Required	string	An account code from the chart, e.g. "6600". 1 to 20 characters.
`lines[].debit`	number or string	A positive amount. Up to 24 characters.
`lines[].credit`	number or string	A positive amount. Up to 24 characters.
`lines[].description`	string	Up to 300 characters.
`lines[].tax`	string	A tax by name (books_get lists them), e.g. "VAT 19%". Up to 60 characters.
`lines[].tracking`	object	Tracking options by category, e.g. {"Department": "Service"} (books_list_tracking).
`currency`	string	When it is not the base currency, e.g. "USD". The rate is then rate, a standing rate, or the European Central Bank's for the date. Matches ^[A-Za-z]{3}$.
`rate`	number or string	One unit of currency in the base currency, e.g. "0.9241". Default: a standing rate, else the European Central Bank's reference rate for the date. Up to 24 characters.
`receipt_file_id`	string	A file_id from the file store. Exactly 36 characters.

The call

Over MCP, call books_record_entry on https://api.conecto.chat/mcp/books. Over REST:

Terminal

curl -X POST https://api.conecto.chat/v1/tools/books_record_entry \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-10-01","memo":"Bank loan for the new forklift","reference":"Loan 4471-02","lines":[{"account":"1010","debit":"15000.00"},{"account":"2300","credit":"15000.00"}]}'

When it refuses

A refused call costs nothing and says what to do next.

Code	When	What to do
`no_books`409	The business keeps no books yet.	Set them up with books_setup (base currency, start date).
`not_found`404	No account, tax, entry or file of the books has that code, name or id.	Check the codes with books_list_accounts and the taxes with books_get.
`archived`409	The account or tax is archived.	Use another one, or un-archive it with books_save_accounts.
`unbalanced`400	The debits and credits do not add up to the same amount.	Make the lines balance.
`before_start`409	The date is before the books start.	Use a later date.
`period_locked`409	The books are locked for that date.	Use a later date, or unlock with books_lock.
`no_rate`409	There is no exchange rate for the currency on that day.	Pass rate, or set a standing rate with books_setup rates.
`rates_loading`503	The day's exchange rates are still loading.	Try again in a few minutes, or pass rate.
`invalid_input`400	A line has no amount, both a debit and a credit, or the entry has fewer than two lines.	Give each line a debit or a credit, and at least two lines.

More Bookkeeping tools

All 33 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md

Book a journal entry

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Bookkeeping tools

Give this to your agent.