Buchungs-Intent erstellen

Erstellt und verbucht einen neuen Buchungs-Intent im Journal. Ein Intent kann aus einer einfachen oder mehrzeiligen Split-Buchung bestehen; alle Ledger-Zeilen teilen sich dieselbe `intent_id`. Soll und Haben müssen insgesamt ausgeglichen sein. Append-only, GoBD-konform.

post_booking

Authorization

Authorization string header erforderlich API-Key im Format ll_.... Übergabe als Bearer Token im OAuth-Flow.

Scopes

journal:write

Parameter

description string erforderlich Buchungstext, z. B. 'Ausgangsrechnung RE-2024-001'

booking_date string erforderlich Buchungsdatum im Format YYYY-MM-DD

lines array erforderlich Sachkonten-Buchungszeilen (NUR Quellzeilen). Mindestens 2 Zeilen. Soll gesamt = Haben gesamt. Bei Verwendung von tax_code: BRUTTO-Beträge angeben, Steuerkontenzeilen werden automatisch generiert.

lines[].tax_code string optional Steuerschlüssel aus list_tax_codes. Wenn gesetzt, erzeugt LedgerLou die Steuerkontenzeilen automatisch — keine manuellen Steuerkontenzeilen hinzufügen.

intent_category string optional Kategorie, z. B. 'outgoing_invoice', 'incoming_invoice', 'payment'

skip_duplicate_check boolean optional Duplikatprüfung überspringen (default: false)

document_id string (uuid) optional Optionale Dokument-ID (aus E-Mail-Eingang oder REST-Upload). Verknüpft die Buchung mit dem Beleg.

Antwort

200

Erfolgreich

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
}