Mark a payable as partially paid

POST
/payables/:payable_id/mark_as_partially_paid

Mark a payable as partially paid.

If the payable is partially paid, its status is moved to partially_paid. The value of the amount_paid field must be the sum of all payments made, not only the last one.

Notes:

  • This endpoint can be used for payables in the waiting_to_be_paid status.
  • The amount_paid must be greater than 0 and less than the total payable amount specified by the amount field.
  • You can use this endpoint multiple times for the same payable to reflect multiple partial payments, always setting the sum of all payments made.
  • To use this endpoint with an entity user token, this entity user must have a role that includes the pay permission for payables.
  • The amount_to_pay field is automatically calculated based on the amount_due less the percentage described in the payment_terms.discount value.

Related guide: Mark a payable as partially paid

See also:

Payables lifecycle

Payables status transitions

Mark a payable as paid

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.
amount_paidintegerRequired
How much was paid on the invoice (in minor units).

Response

This endpoint returns an object.
idstring
A unique ID assigned to this payable.
created_atdatetime

UTC date and time when this payable was created. Timestamps follow the ISO 8601 format.

updated_atdatetime

UTC date and time when this payable was last updated. Timestamps follow the ISO 8601 format.

entity_idstring
The ID of the entity to which the payable was issued.
payable_origin"upload" or "email"
Allowed values: uploademail

Specifies how this payable was created in Monite: upload - created via an API call, email - sent via email to the entity’s mailbox.

source_of_payable_data"ocr" or "user_specified"
Allowed values: ocruser_specified

Specifies how the property values of this payable were provided: ocr - Monite OCR service extracted the values from the provided PDF or image file, user_specified - values were added or updated via an API call.

statusenum

The status of the payable.

amount_dueintegerOptional
How much is left to be paid on the invoice (in minor units).
amount_paidintegerOptional
How much was paid on the invoice (in minor units).
amount_to_payintegerOptional
How much is left to be paid on the invoice (in minor units) with discounts from payment terms.
approval_policy_idstringOptional
Id of existing approval policy that applies to this payable, if any. A policy is applied if the payable matches the policy trigger conditions.
counterpartobjectOptional
Object representing de-normalized counterpart data. Filled at the moment of invoice submitting for approval or payment.
counterpart_address_idstringOptional
The ID of counterpart address object stored in counterparts service
counterpart_bank_account_idstringOptional
The ID of counterpart bank account object stored in counterparts service
counterpart_idstringOptional
The ID of the counterpart object that represents the vendor or supplier.
counterpart_raw_dataobjectOptional
Object representing counterpart data which was extracted by OCR. Used for informational purposes.
counterpart_vat_id_idstringOptional
The ID of counterpart VAT ID object stored in counterparts service
currencyenumOptional

The currency code of the currency used in the payable.

currency_exchangeobjectOptional
descriptionstringOptional
An arbitrary description of this payable.
document_idstringOptional

A unique invoice number assigned by the invoice issuer for payment tracking purposes. This is different from id which is an internal ID created automatically by Monite.

due_datestringOptional
The date by which the payable must be paid, in the YYYY-MM-DD format. If the payable specifies payment terms with early payment discounts, this is the final payment date.
fileobjectOptional
The original file from which this payable was created.
file_idstringOptional
File id to retrieve file info from file saver.
issued_atstringOptional
The date when the payable was issued, in the YYYY-MM-DD format.
marked_as_paid_by_entity_user_idstringOptional
The ID of the entity user who marked this document as paid.
marked_as_paid_with_commentstringOptional
An arbitrary comment that describes how and when this payable was paid.
ocr_request_idstringOptional
Id of OCR request to match asynchronous result of processing payable.
ocr_statusenumOptional
Allowed values: processingerrorsuccess
The status of the data recognition process using OCR. The 'processing' status means that the data recognition is in progress and the user needs to wait for the data enrichment. The 'error' status indicates that some error occurred on the OCR side and the user can fill in the data manually. The 'success' status means the data recognition has been successfully completed, after which the user can check the data if desired and enrich or correct it.
other_extracted_dataobjectOptional
Data extracted from the uploaded payable by OCR.
paid_atdatetimeOptional
The date by which the payable was paid
partner_metadatamap from strings to anyOptional
Metadata for partner needs
payment_termsobjectOptional

The number of days to pay with potential discount for options shorter than due_date

project_idstringOptional
Project ID of a payable.
purchase_order_idstringOptional
The identifier of the purchase order to which this payable belongs.
senderstringOptional
The email address from which the invoice was sent to the entity.
subtotalintegerOptional

The subtotal amount to be paid, in minor units. For example, $12.50 is represented as 1250.

suggested_payment_termobjectOptional

The suggested date and corresponding discount in which payable could be paid. The date is in the YYYY-MM-DD format. The discount is calculated as X * (10^-4) - for example, 100 is 1%, 25 is 0,25%, 10000 is 100 %. Date varies depending on the payment terms and may even be equal to the due date with discount 0.

tagslist of objectsOptional
A list of user-defined tags (labels) assigned to this payable. Tags can be used to trigger a specific approval policy for this payable.
taxintegerOptional
Registered tax percentage applied for a service price in minor units, e.g. 200 means 2%, 1050 means 10.5%.
tax_amountintegerOptional

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

total_amountintegerOptional

The total amount to be paid, in minor units. For example, $12.50 is represented as 1250.

was_created_by_user_idstringOptional

Errors