A line item is a component of an invoice which represents an individual entry that details a specific good or service provided by the seller to the buyer.
To find out more about managing invoices and line items, visit our Help documentation: Creating and Managing Invoices.
Following diagram shows line items in our data hierarchy:
In an old workflow, adding tax data to a line item requires two values: tax_name and tax_value. For example, if you wanted to add a VAT 15%, you would send tax_name: ‘VAT’ and tax_value: 15.
In a new workflow (available for customers on our BETA program for now), you should send tax_rate_id instead, which points to a Tax rate object. So, in order to set VAT 15% to your line item, you would first need to have a tax rate object with those values and then send its ID to the desired line item.
The total line amount (unit price × quantity, minus discount) in the invoice's currency.
The total line amount converted to the organization's default currency.
The total line amount converted to the invoice currency.
The tax portion of this line item's amount in the invoice's currency.
The tax portion of this line item's amount converted to the organization's default currency.
The tax portion of this line item's amount converted to the invoice currency.
The total line amount including tax in the invoice's currency.
The amount with tax converted to the organization's default currency.
The amount with tax converted to the invoice currency.
ID of the company (client) on the invoice this line item belongs to.
ID of the person who created this line item.
The currency of this line item, inherited from the associated invoice.
The organization's default currency for this line item.
The invoice's currency for this line item.
The discount applied to this line item, expressed as a percentage (0–100).
The project expense linked to this line item, if this line item was generated from an expense.
ID of the project expense linked to this line item, or null if not expense-based.
Unique identifier of this line item.
The invoice this line item belongs to.
ID of the invoice this line item belongs to.
The KPD classification code assigned to this line item, used for e-invoicing compliance in Croatia.
ID of the KPD classification code assigned to this line item (used only in Croatia).
The organization this line item belongs to.
The display order of this line item within the invoice.
The quantity of units for this line item; for percentage billing types, expressed as a percentage value.
The budget service linked to this line item, if this line item was generated from a service.
ID of the budget service linked to this line item, or null if not service-based.
The service type categorizing this line item.
ID of the service type categorizing this line item.
The display name of the tax applied to this line item (e.g. VAT).
The tax rate applied to this line item.
ID of the tax rate applied to this line item, or null if tax is not applied.
The computed tax amount for this line item (amount × tax_value).
ID of the unit of measure for this line item (e.g. hour, day, piece).
1
2
3
The price per unit for this line item in the invoice's currency.
The price per unit converted to the organization's default currency.
The price per unit for this line item in the invoice's currency.
ID of the person who last updated this line item.