Skip to Content
TillorManual
Ledger opening balances

Import Ledger Opening Balances

Access

Member of the organization with this permission:

  • invoicing:manage-opening-balances

An API key with scopes also needs the permission among its 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.