Add a line item to a payable

Add a new line item to a specific payable.

The subtotal and total fields of line items are automatically calculated based on the unit_price, quantity, and tax fields, therefore, are read-only and appear only in the response schema. The field ledger_account_id is required only for account integration, otherwise, it is optional.

Related guide: Add line items to a payable

See also:

Manage line items

Collect payables

Path parameters

payable_idstringRequired

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

x-monite-versionstringRequired
x-monite-entity-idstringRequired
The ID of the entity that owns the requested resource.

Request

This endpoint expects an object.
accounting_tax_rate_idstringOptionalformat: "uuid"

ID of the tax rate reference used for accounting integration. May be used to override auto-picked tax rate reference in accounting platform in case of any platform-specific constraints.

descriptionstringOptional
Description of the product.
ledger_account_idstringOptionalformat: "uuid"

ID of the account record used to store bookkeeping entries for balance-sheet and income-statement transactions.

namestringOptional
Name of the product.
quantitydoubleOptional>=0
The quantity of each of the goods, materials, or services listed in the payable.
taxintegerOptional>=0<=10000

VAT rate in percent minor units. Example: 12.5% is 1250.

unitstringOptional
The unit of the product
unit_priceintegerOptional

The unit price of the product, in minor units. For example, $12.50 is represented as 1250.

Response

Successful Response
idstringformat: "uuid"
payable_idstringformat: "uuid"
accounting_tax_rate_idstring or nullformat: "uuid"

ID of the tax rate reference used for accounting integartion. May be used to override auto-picked tax rate reference in accounting platform in case of any platform-specific constraints.

descriptionstring or null
Description of the product.
ledger_account_idstring or nullformat: "uuid"

ID of the account record used to store bookkeeping entries for balance-sheet and income-statement transactions.

namestring or null
Name of the product.
ocr_set_quantity_to_oneboolean or nullDefaults to false

Indicates whether the item’s unit_price and quantity were adjusted by OCR.

quantitydouble or null
The quantity of each of the goods, materials, or services listed in the payable.
subtotalinteger or null

The subtotal (excluding VAT), in minor units.

taxinteger or null

VAT rate in percent minor units. Example: 12.5% is 1250.

tax_amountinteger or null

Tax amount in minor units. For example, $12.50 is represented as 1250.

totalinteger or null
The actual price of the product.
unitstring or null
The unit of the product
unit_priceinteger or null

The unit price of the product, in minor units. For example, $12.50 is represented as 1250.

was_created_by_user_idstring or nullformat: "uuid"
ID of the user who created the tag.

Errors