Add a line item to a payable

POST
/payables/:payable_id/line_items

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

Auth
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_idstringOptional

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_idstringOptional

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

idstring
payable_idstring
accounting_tax_rate_idstringOptional

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.

descriptionstringOptional

Description of the product.

ledger_account_idstringOptional

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

namestringOptional

Name of the product.

quantitydoubleOptional

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

subtotalintegerOptional

The subtotal (excluding VAT), in minor units.

taxintegerOptional

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

tax_amountintegerOptional

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

totalintegerOptional

The actual price of the product.

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.

was_created_by_user_idstringOptional

ID of the user who created the tag.

Errors