Add a line item to an invoice

Adds a line item to an existing draft invoice. The item will be added last in the list of line items on the invoice.

NOTE: The invoice must be in draft status.

Scope: invoices:write

Path Params
uuid
required

Unique identifier of the company

uuid
required

Unique identifier of the invoice

Body Params

Post the necessary fields for the API to add a line item to an invoice.

int64 | null

Should not be set for new items

itemRef
object | null

Identifier of an existing salesItem to use as a template. unitPrice and quantity can be overridden on this line item; description, productType, unitType, customUnitType, taxRate, bookkeepingAccountNumber (and unitPrice when not set) come from the referenced item.

string
required
string
enum
required
Allowed:
string
enum
required
Allowed:
string
enum
Defaults to unspecified

When set to custom, customUnitType is required; otherwise customUnitType must be omitted or null.

string | null

Custom sales unit text. Required when unitType is custom; must be omitted or null otherwise.

double
required
Defaults to 1
double
required

Unit price excluding VAT. Accepts and returns up to 4 decimals.

double
required
int32 | null

Use the bookkeepingAccountNumber field in the line items to specify a valid bookkeeping account. Omit or set to null to use automatic account selection on an invoice. On credit notes connected to an original invoice, the account is copied from the original invoice line item, and omitting it or setting it to null on update keeps the current account.

discount
object | null

Line item discount applied to this line. Can be either a percentage of the line total or a fixed amount in the invoice currency. Omit or set to null when the line has no discount.

taxReduction
object | null

Tax reduction categorization for this line item. When the invoice has a taxReduction, each service line item should specify its job type. The type must match the invoice-level taxReduction type.

string | null
enum

The reverse charge type applied to this line item. Omit or set to null when reverse charge does not apply.

  • construction: Applies construction reverse charge. Only valid for service line items and cannot be combined with tax reduction.
Allowed:
projectRef
object | null

Reference to a project.
Preview: This field is in preview and may change or be removed before general availability. Read the full preview policy

costCenterRef
object | null

Reference to a cost center tag value. Should be a valid dimension 1 tag value.
Preview: This field is in preview and may change or be removed before general availability. Read the full preview policy

Responses

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