conecto. Get started
Bookkeeping

Export the books

books_export · Changes data · Markdown

A CSV of the journal or the accounts, a DATEV Buchungsstapel for a German tax adviser or a French FEC, with a download link.

$0.001 a call

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

An example

Send the accountant every booking from the third quarter as a spreadsheet.

Your agent callsbooks_export$0.001 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
{
  "what": "journal",
  "from": "2026-07-01",
  "to": "2026-09-30"
}
What comes back
{
  "file": {
    "file_id": "df3b41fb-d7d0-4e0e-ab5a-959972a5151d",
    "name": "Journal 2026-07-01 to 2026-09-30.csv",
    "content_type": "text/csv",
    "size": "165 bytes",
    "size_bytes": 165,
    "sha256": "9359c5ab3e74b239b9e4e5ddf256327deb01c497b09aed8751c4419600997670",
    "created_at": "2026-10-14T08:00:00+00:00",
    "download_url": "https://cncto.co/d/df3b41fb-d7d0-4e0e-ab5a-959972a5151d?t=eyJmIjoiZGYzYjQxZmItZDdkMC00ZTBlLWFiNWEtOTU5OTcyYTUxNTFkIiwiZXhwIjoxNzkyMTYwOTg4fQ:1xHMSq:o_Jq7-a3PItEKIT5us8S4Wk2K7jZ_6dcxLRcj_xw4Dc",
    "link_expires_in_hours": 24
  },
  "rows": 0
}

Use it when

An accountant or another program needs the books, a German tax adviser wants them in DATEV, or a French tax audit asks for the FEC.

What it does

A file in the file store, with a download link: journal (a CSV of every line of every entry from-to, for an accountant or another program), accounts (the chart with balances on to) or datev (a DATEV Buchungsstapel for a German tax adviser: one fiscal year, from-to, default the year so far; needs the datev settings once) or fec (the French Fichier des Écritures Comptables for a tax audit: the fiscal year that holds to, every entry; needs the fec settings once). Conecto files no tax returns: for UK VAT (Making Tax Digital) the journal CSV is the digital link into bridging software.

What comes back

The CSV file with its file_id and download link, and how many rows. The journal has each line's date, entry, account, debit and credit, tax, currency and rate, when the entry was recorded and the entry a reversal undoes. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
whatRequiredstringOne of: journal,accounts,datev,fec.
fromstringYYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$.
tostringYYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$.
datevobjectFor what: datev, kept for the next export. adviser (Beraternummer) and client (Mandantennummer) from the tax adviser; chart "03" (SKR03) or "04" (SKR04); account_length (4 to 8, default 4); accounts: each account code used to its DATEV number, like {"4000": "8400", "1010": "1200"} (same_numbers: true when the chart already uses them); tax_keys: a tax's BU-Schlüssel when it isn't German VAT at 19 or 7 percent.
datev.adviserinteger1,001 to 9,999,999.
datev.clientinteger1 to 99,999.
datev.chartstringOne of: 03,04.
datev.account_lengthinteger4 to 8.
datev.accountsobject
datev.same_numbersboolean
datev.tax_keysobject
fecobjectFor what: fec, kept for the next export. siren (9 digits; read from a French VAT ID when left out); accounts: each account code used to its plan comptable général number, like {"4000": "706000", "1010": "512000"} (same_numbers: true when the chart already uses them).
fec.sirenstringUp to 14 characters.
fec.accountsobject
fec.same_numbersboolean

The call

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

Terminal
curl -X POST https://api.conecto.chat/v1/tools/books_export \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"what":"journal","from":"2026-07-01","to":"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_input400A date is not a date like 2026-10-01, or from is after to.Fix the date.
storage_full409The file store has no room for the CSV.Delete files with files_delete, or add room with files_add_storage.
invalid_input400For datev or fec: the adviser's numbers or the SIREN are missing, an account used has no DATEV or plan comptable général number, a tax has no key, the period crosses a fiscal year, or the books are not in euros.Give what the message names in datev (it is kept), or export each fiscal year on its own.

More Bookkeeping tools

All 33 tools

Give this to your agent.

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