API Reference

Create an invoice

post
https://api.bokio.se/v1/companies//invoices

Creates an new draft invoice for the company.

Scope: invoices:write

Path Params
uuid
required

Unique identifier of the company

Body Params

Post the necessary fields for the API to create a new invoice.

string
enum
Defaults to invoice

The type of the invoice can be invoice or cashInvoice. Can only be set to invoice when creating a new invoice and will default to invoice if not set.

Allowed:
customerRef
object
contactDetailRef
object | null
string | null

The order number associated with the invoice.

string | null

The project reference associated with the invoice.

string | null

The buyer reference associated with the invoice.

string | null

The contract reference associated with the invoice.

string
Defaults to SEK

ISO 4217 currency code

double
Defaults to 1
date
required
date

The due date for the invoice. Optional — when omitted, it is automatically calculated using the fallback chain: customer payment terms → company payment terms → 30 days from the invoice date.

date-time | null

The date when the credit note was published (null for draft)

lineItems
array
required
lineItems*
deliveryAddress
metadata
object

Metadata fields for the invoice as string key-value pairs. These fields can be used for filtering.All metadata keys must start with a letter or underscore and contain only alphanumeric characters and underscores.

Responses

Updated about 1 month ago

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 month ago