Transaktion einer Buchung zuordnen

Ordnet eine Banktransaktion einem bestehenden Journal-Intent zu und markiert sie als abgestimmt. Die Verknüpfung erfolgt immer auf Intent-Ebene, nicht auf Ebene einzelner Buchungszeilen. Für Fremdwährungs-Posten wird gegen den EUR-Buchungswert abgestimmt; aktuell wird dabei immer der vollständige offene Belegbetrag geschlossen und die Differenz als realisierter FX-Gewinn/-Verlust gebucht.

POST /v1/bank-transactions/:id/reconcile

Authorization

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

Request Body

intent_id uuid erforderlich Buchungs-Intent

candidate_kind string erforderlich "bank_booking", "open_receivable" oder "open_liability"

open_item_account string bedingt Erforderlich bei open_receivable / open_liability

Antworten

200

Erfolgreich

400

INVALID_INPUT Pflichtfelder fehlen oder Werte entsprechen nicht dem erwarteten Format.

404

NOT_FOUND Die angeforderte Ressource wurde nicht gefunden.

404

TARGET_NOT_FOUND Das Buchungsziel (Intent) existiert nicht oder gehört nicht zu diesem Tenant.

400

DIRECTION_MISMATCH Soll/Haben-Richtung der Transaktion stimmt nicht mit der Buchung überein.

400

SETTLEMENT_EXCEEDS_OPEN_AMOUNT

422

UNSUPPORTED_SETTLEMENT_CURRENCY

409

TARGET_AMBIGUOUS Mehrere passende Buchungen gefunden – Intent-ID explizit angeben.

POST /v1/bank-transactions/:id/reconcile

cURL

-cmd">curl --request -method">POST -punct">\
  --url 'https://api.ledgerlou.de/v1/bank-transactions/:id/reconcile' -punct">\
  --header 'Authorization: Bearer ll_your_key' -punct">\
  --header 'Content-Type: application/json' -punct">\
  --data '{
  "intent_id": "b2c3d4e5-...",
  "candidate_kind": "open_liability",
  "open_item_account": "3300"
}'

200 Response

JSON

{
  "ok": true,
  "mode": "<string>",
  "intent_id": "<string>"
}