Sammelabstimmung für mehrere Banktransaktionen anlegen

Erzeugt eine Sammelabstimmung für mehrere Banktransaktionen gegen mehrere offene Debitoren- oder Kreditorenposten. Alle Banktransaktionen müssen vom selben Bankkonto stammen und dieselbe Richtung haben. Die Gruppe darf über Allocations, FX-Effekte und explizite Ausgleichszeilen ausgeglichen werden.

POST /v1/bank-match-groups

Authorization

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

Request Body

bank_transaction_ids uuid[] erforderlich Mindestens eine offene Banktransaktion desselben Bankkontos

allocations array erforderlich Aufteilungen auf offene Posten

adjustments array optional Explizite Gegenzeilen für Gebühren, Skonto, Write-offs oder sonstige Restdifferenzen

Allocation

intent_id uuid erforderlich Intent des offenen Postens

candidate_kind string erforderlich "open_receivable" oder "open_liability"

open_item_account string erforderlich Konto des offenen Postens

allocated_bank_amount number erforderlich Tatsächlich zugewiesener Bankbetrag in Bankwährung

settled_document_amount number | null optional Auszugleichender Belegbetrag in Dokumentwährung; für Fremdwährungs-Offenposten erforderlich, für gleiche Währung optional zur Trennung von Bankbetrag und EUR-Ausbuchung

Ausgleichszeile

account_number string erforderlich Gegenkonto der Ausgleichszeile

posting_side string erforderlich "debit" oder "credit"

amount number erforderlich Betrag der Ausgleichszeile in EUR

description string | null optional Freitext für die Gegenzeile

Antworten

201

Erfolgreich

400

INVALID_INPUT Pflichtfelder fehlen oder Werte entsprechen nicht dem erwarteten Format.

404

NOT_FOUND Die angeforderte Ressource wurde nicht gefunden.

400

BANK_TX_MIXED_BANK_ACCOUNTS

400

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

400

MIXED_SETTLEMENT_CURRENCY

400

GROUP_NOT_BALANCED

400

SETTLEMENT_EXCEEDS_OPEN_AMOUNT

400

SETTLED_DOCUMENT_AMOUNT_REQUIRED

422

UNSUPPORTED_SETTLEMENT_CURRENCY

400

TARGET_KIND_UNSUPPORTED

404

ADJUSTMENT_ACCOUNT_NOT_FOUND

POST /v1/bank-match-groups

cURL

-cmd">curl --request -method">POST -punct">\
  --url 'https://api.ledgerlou.de/v1/bank-match-groups' -punct">\
  --header 'Authorization: Bearer ll_your_key' -punct">\
  --header 'Content-Type: application/json' -punct">\
  --data '{
  "bank_transaction_ids": [
    "a1b2c3d4-...",
    "c3d4e5f6-..."
  ],
  "allocations": [
    {
      "intent_id": "b2c3d4e5-...",
      "candidate_kind": "open_receivable",
      "open_item_account": "1200",
      "allocated_bank_amount": 119
    },
    {
      "intent_id": "d4e5f6a7-...",
      "candidate_kind": "open_receivable",
      "open_item_account": "1200",
      "allocated_bank_amount": 228,
      "settled_document_amount": 238
    }
  ],
  "adjustments": [
    {
      "account_number": "6990",
      "posting_side": "debit",
      "amount": 10,
      "description": "Kleinbetragsdifferenz"
    }
  ]
}'

201 Response

JSON

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