Skip to Content
TillorHandbuch
Ledger opening balances

Import Ledger Opening Balances

Zugriff

Mitglied der Organisation mit dieser Berechtigung:

  • invoicing:manage-opening-balances

Ein API-Schlüssel mit Scopes braucht die Berechtigung auch in seinen Scopes.

POST
/orgs/{organizationId}/ledger-opening-balances/import

Creates opening balances and updates the ones whose reference already exists; rows without a matching customer or repeated in the file are skipped. Refused as a whole (409, INVOICE_LEDGER_BALANCE_EXCEEDED) when a row would take a guarded ledger below zero. With ledgerBalanceOverride, users with invoicing:override-ledger-balance may take a guarded ledger below zero; the motivation and the violations are recorded on the customer's timeline.

Authorization

ApiKeyAuth
headerx-api-key<token>

API key for authentication

Path Parameters

organizationId*string

The ID or slug of the organization

Request Body

application/json
  1. body
rows*array<>
Items1 <= items <= 2000
ledgerBalanceOverride?

Response Body

OK

application/json
  1. response
Example Request
curl -X POST 'https://api.tillor.eu/orgs//ledger-opening-balances/import' \  -H 'Content-Type: application/json' \  -d '{  "rows": [    {      "ledger": -9007199254740991,      "amount": 0,      "asOfDate": "2019-08-24",      "reference": "string",      "customer": "string"    }  ]}'
Example Response
null

Preview Ledger Opening Balance Import POST

Matches each row to a customer (Tillor customer number or id) and an existing opening balance (same ledger and reference), without writing anything. Returns the status per row and the total per ledger.

List Mandate Agreements GET

Lists mandate agreements with pagination, filtering (e.g. `customerId`, `status`) and sorting.