invoices

Create an invoice payment

Creates a new payment record for the specified invoice. Use the bookkeepingAccountNumber field to specify an accounting account other than the default account (1930).

Scope: invoices:write

post/companies/{companyId}/invoices/{invoiceId}/payments

Request

  • Base URL
    https://api.bokio.se/v1
  • URL
    https://api.bokio.se/v1/companies/{companyId}/invoices/{invoiceId}/payments
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: /authorize
      Client credentials
      Token URL: /token scopes: invoices:write

Request body

idstring uuid
invoiceIdstring uuid
datestring date required
sumBaseCurrencynumber double required

The amount of the payment in the base currency. Currently the base currency is always SEK.

bookkeepingAccountNumberinteger required

The bookkeeping number of the payment account. The value must match a chart of accounts account number that has a payment account details.

Example request

{
  "id": "b529df79-eb7f-5ef0-a8dc-c2b71f953554",
  "invoiceId": "a419cf69-db6f-4de9-992c-b1a60942a443",
  "date": "2024-10-15",
  "sumBaseCurrency": 200,
  "bookkeepingAccountNumber": 1930,
  "journalEntryRef": {
    "id": "55c899c5-82b2-4a09-899e-9dc03342b5dc"
  }
}

Response

Payment created successfully

idstring uuid
invoiceIdstring uuid
datestring date required
sumBaseCurrencynumber double required

The amount of the payment in the base currency. Currently the base currency is always SEK.

bookkeepingAccountNumberinteger required

The bookkeeping number of the payment account. The value must match a chart of accounts account number that has a payment account details.

Example response

{
  "id": "b529df79-eb7f-5ef0-a8dc-c2b71f953554",
  "invoiceId": "a419cf69-db6f-4de9-992c-b1a60942a443",
  "date": "2024-10-15",
  "sumBaseCurrency": 200,
  "bookkeepingAccountNumber": 1930,
  "journalEntryRef": {
    "id": "55c899c5-82b2-4a09-899e-9dc03342b5dc"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.