conecto. Get started
Bookkeeping

Book depreciation

books_depreciate · Changes data · Markdown

Books the depreciation of every registered asset through a month's end, one entry a month, like Xero's run depreciation; or undoes it after a date.

$0.01 a call

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

An example

Book this year's depreciation through September.

Your agent callsbooks_depreciate$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
{
  "through": "2026-09-30"
}
What comes back
{
  "through": "2026-09-30",
  "entries": [
    {
      "entry": 3,
      "date": "2026-03-31",
      "total": "500.00",
      "memo": "Depreciation for March 2026: FA-0001"
    },
    {
      "entry": 4,
      "date": "2026-04-30",
      "total": "500.00",
      "memo": "Depreciation for April 2026: FA-0001"
    }
  ],
  "total": "4400.00",
  "assets": [
    {
      "number": "FA-0001",
      "name": "Service van",
      "amount": "3500.00",
      "depreciated_through": "2026-09-30"
    },
    {
      "number": "FA-0002",
      "name": "Combi steamer",
      "amount": "900.00",
      "depreciated_through": "2026-09-30"
    }
  ]
}

Use it when

At each month's end before locking it, after registering an asset bought earlier, or before changing an asset's cost, life or method (undo_after).

What it does

Book the depreciation of every registered asset through a month's end (default: the end of last month), like Xero's run depreciation: one entry per month, dated its last day, from the month after the last one booked, so running it again books nothing twice. Months in a locked period are refused; catch_up: true books them in the first open month instead. undo_after books the opposite of what was booked for the months after that date, for every asset or the one asset names; undo before changing an asset's cost, life or method.

What comes back

through (or undone_after), entries: each entry with its date, total and memo, total, and assets: what each asset got and the month it is depreciated through now. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
throughstringYYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$.
catch_upbooleanDefault: false.
undo_afterstringUndo the months after this date. Matches ^\d{4}-\d{2}-\d{2}$.
assetstringOnly this asset. 1 to 20 characters.

The call

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

Terminal
curl -X POST https://api.conecto.chat/v1/tools/books_depreciate \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"through":"2026-09-30"}'

When it refuses

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

CodeWhenWhat to do
no_books409The business keeps no books yet.Set them up with books_setup (base currency, start date).
invalid_input400through is after the end of this month, or a date is not like 2026-09-30.Use the end of this month or earlier.
not_found404No asset has that number.List them with books_list_assets.
period_locked409Months to book fall in a locked period.Pass catch_up: true to book them in the first open month, or unlock with books_lock.
asset_disposed409The asset named, or one with depreciation after undo_after, was sold or written off.Undo the sale with books_dispose_asset undo first.

More Bookkeeping tools

All 33 tools

Give this to your agent.

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