Create booking intent

Creates and posts a new booking intent in the journal. An intent can consist of a simple or multi-line split booking; all ledger lines share the same `intent_id`. Debit and credit totals must balance. Append-only, GoBD-compliant.

post_booking

Authorization

Authorization string header required API key in the format ll_.... Pass as a Bearer token in the OAuth flow.

Scopes

journal:write

Parameters

description string required Booking description, e.g. 'AR invoice RE-2024-001'

booking_date string required Booking date in YYYY-MM-DD format

lines array required General-ledger booking lines (SOURCE lines only). At least 2 lines. Total debit = total credit. When using tax_code: provide GROSS amounts, tax account lines are generated automatically.

lines[].tax_code string optional Tax code from list_tax_codes. When set, LedgerLou generates the tax account lines automatically — do not add manual tax account lines.

intent_category string optional Category, e.g. 'outgoing_invoice', 'incoming_invoice', 'payment'

skip_duplicate_check boolean optional Skip duplicate detection (default: false)

document_id string (uuid) optional Optional document ID (from email inbox or REST upload). Links the booking to the document.

Response

200

Success

MCP post_booking

JSON

{
  "tool": "post_booking",
  "params": {
    "description": "<string>",
    "booking_date": "<string>",
    "lines": [
      {
        "account_number": "<string>",
        "account_name": "<string>",
        "debit": 1,
        "credit": 1,
        "tax_code": "<string>"
      }
    ]
  }
}

200 Response

JSON

{
  "status": "<string>",
  "intent_id": "<string>",
  "event_count": 1,
  "description": "<string>",
  "booking_date": "<string>",
  "total": 1
}