LedgerLou Docs is optimized for desktop.

Please open this page on a device with a wider screen.

LedgerLou Docs
Bank

Create group reconciliation for multiple bank transactions

Creates a group reconciliation for multiple bank transactions against multiple open receivable or payable items. All bank transactions must come from the same bank account and have the same direction. The group may be balanced via allocations, FX effects and explicit adjustment lines.

POST /v1/bank-match-groups
Authorization
Authorization string header required API key in the format ll_.... Pass as a Bearer token.
Request Body
bank_transaction_ids uuid[] required At least one open bank transaction from the same bank account
allocations array required Allocations to open items
adjustments array optional Explicit counter lines for fees, cash discounts, write-offs or other residual differences
Allocation
intent_id uuid required Intent of the open item
candidate_kind string required "open_receivable" or "open_liability"
open_item_account string required Account of the open item
allocated_bank_amount number required Actually allocated bank amount in bank currency
settled_document_amount number | null optional Document amount to settle in document currency; required for foreign-currency open items, optional for same-currency cases to separate bank amount from EUR write-off
Adjustment line
account_number string required Contra account of the adjustment line
posting_side string required "debit" or "credit"
amount number required Amount of the adjustment line in EUR
description string | null optional Free text for the counter line
Responses
201
Success
400
INVALID_INPUT Required fields are missing or values do not match the expected format.
404
NOT_FOUND The requested resource was not found.
400
BANK_TX_MIXED_BANK_ACCOUNTS
400
DIRECTION_MISMATCH The debit/credit direction of the transaction does not match the booking.
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>"
}