Create Ledger Opening Balance
Access
Member of the organization with this permission:
invoicing:manage-opening-balances
An API key with scopes also needs the permission among its scopes.
Adds an opening balance on a ledger for a customer. A negative amount that takes a guarded ledger below zero is refused (409, INVOICE_LEDGER_BALANCE_EXCEEDED); a reference the customer already has on that ledger is refused (409, LEDGER_OPENING_BALANCE_REFERENCE_EXISTS). 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.
ApiKeyAuthx-api-key<token>API key for authentication
organizationId*stringThe ID or slug of the organization
customerId*stringapplication/json- body
ledger*integer-9007199254740991 <= value <= 9007199254740991amount*numberasOfDate*stringdatereference*string1 <= length <= 120note?|nullledgerBalanceOverride?OK
application/json- response
curl -X POST 'https://api.tillor.eu/orgs//customers/string/ledger-opening-balances' \ -H 'Content-Type: application/json' \ -d '{ "ledger": -9007199254740991, "amount": 0, "asOfDate": "2019-08-24", "reference": "string"}'nullList Ledger Opening Balances GET
Lists the customer's opening balances from before Tillor, by ledger and date. They count in the customer's ledger balances.
Update Ledger Opening Balance PATCH
Changes an opening balance. Lowering it below what the customer's guarded ledger still holds is refused (409, `INVOICE_LEDGER_BALANCE_EXCEEDED`). 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.