Sell or write off an asset

books_dispose_asset · Changes data · Markdown

Sells or writes off a fixed asset, like Xero's dispose: depreciation to the day it goes, then its cost, the price and the gain or loss.

$0.01 a call

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

We sold the service van for 33,000 euros on October 12; the money is in the bank.

Your agent callsbooks_dispose_asset$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

{
  "asset": "FA-0001",
  "date": "2026-10-12",
  "price": "33000",
  "paid_to": "1010"
}

What comes back

{
  "asset": {
    "number": "FA-0001",
    "name": "Service van",
    "status": "disposed",
    "purchase_date": "2026-03-14",
    "cost": "36000.00",
    "account": "1500",
    "method": "straight_line",
    "averaging": "full_month",
    "life_months": 60,
    "life_years": "5",
    "rate_percent": null,
    "residual": "6000.00",
    "depreciation_start": "2026-03-14",
    "expense_account": "6950",
    "accumulated_account": "1590",
    "opening_accumulated": null,
    "accumulated": "4000.00",
    "book_value": "32000.00",
    "depreciated_through": "2026-10-31",
    "depreciation_per_month": null,
    "fully_depreciated": false,
    "tracking": null,
    "description": null,
    "serial_number": null,
    "warranty_until": null,
    "disposed_on": "2026-10-12",
    "price": "33000.00",
    "gain_or_loss": "1000.00",
    "disposal_entry": 12
  }
}

Use it when

An asset is sold, scrapped, stolen or given away; or a disposal was booked by mistake (undo).

For invoicing the buyer, with VAT, use invoices_create.

What it does

Take an asset out of the books, sold or written off, like Xero's dispose. Its depreciation is booked through the month it goes first (to the day with actual_days; what was booked for later months is undone), then one entry takes its cost and accumulated depreciation out, books price to paid_to and the difference as a gain or a loss on gain_account (made as 4950 Gains and losses on assets sold when missing). paid_to is the bank account the money went to, or the income account the invoice to the buyer booked it to, which this then clears. A write-off has no price. undo: true brings it back.

What comes back

asset: as books_list_assets shows it, now with disposed_on, price, gain_or_loss and the disposal entry; with undo, the reversal too. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`asset`Required	string	The asset's number, like "FA-0001" (books_list_assets). 1 to 20 characters.
`date`	string	YYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$.
`price`	number or string	What it sold for before tax. Default 0, a write-off. Up to 24 characters.
`paid_to`	string	Where the price went, e.g. "1010". 1 to 20 characters.
`gain_account`	string	An account code from the chart, e.g. "6600". 1 to 20 characters.
`catch_up`	boolean	Default: false.
`undo`	boolean	Bring a sold or written off asset back.

The call

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

Terminal

curl -X POST https://api.conecto.chat/v1/tools/books_dispose_asset \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset":"FA-0001","date":"2026-10-12","price":"33000","paid_to":"1010"}'

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).
`archived`409	The account or tax is archived.	Use another one, or un-archive it with books_save_accounts.
`invalid_input`400	No date; the date is before it was bought or after today; a price has no paid_to, or paid_to is the asset's own account; gain_account is not an income or expense account; or undo for an asset that is not sold.	Fix what the message names.
`not_found`404	No asset has that number, or no account that code.	Check books_list_assets and books_list_accounts.
`period_locked`409	The date, or a month of depreciation before it, falls in a locked period.	Pass catch_up for the months, or unlock with books_lock.
`asset_disposed`409	It was sold or written off already.	Undo that first with undo: true.

More Bookkeeping tools

All 33 tools

Give this to your agent.

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

Sell or write off an asset

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.