Accounts payablePayables

Create a payable

Add a new payable by providing the amount, currency, vendor name, and other details. You can provide the base64_encoded contents of the original invoice file in the field base64_encoded_file.

You can use this endpoint to bypass the Monite OCR service and provide the data directly (for example, if you already have the data in place).

A newly created payable has the the draft status.

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.
base64_encoded_filestringOptional

Base64-encoded contents of the original issued payable. The file is provided for reference purposes as the original source of the data.

Any file formats are allowed. The most common formats are PDF, PNG, JPEG, TIFF.

counterpart_address_idstringOptionalformat: "uuid"
The ID of counterpart address object stored in counterparts service
counterpart_bank_account_idstringOptionalformat: "uuid"
The ID of counterpart bank account object stored in counterparts service
counterpart_idstringOptionalformat: "uuid"
The ID of the counterpart object that represents the vendor or supplier.
counterpart_vat_id_idstringOptionalformat: "uuid"
The ID of counterpart VAT ID object stored in counterparts service
currencyenumOptional

The currency code of the currency used in the payable.

descriptionstringOptional<=255 characters
An arbitrary description of this payable.
discountintegerOptional

The value of the additional discount that will be applied to the total amount. in minor units. For example, $12.50 is represented as 1250.

document_idstringOptional
A unique invoice number assigned by the invoice issuer for payment tracking purposes.
due_datestringOptionalformat: "date"

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.

file_namestringOptional<=512 characters
The original file name.
issued_atstringOptionalformat: "date"

The date when the payable was issued, in the YYYY-MM-DD format.

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_idstringOptionalformat: "uuid"
The ID of a project
purchase_order_idstringOptionalformat: "uuid"
The identifier of the purchase order to which this payable belongs.
senderstringOptionalformat: "email"
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.

tag_idslist of stringsOptional

A list of IDs 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.

Response

Successful Response
idstringformat: "uuid"
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.

credit_noteslist of objects
The list of linked credit notes of the payable.
entity_idstringformat: "uuid"
The ID of the entity to which the payable was issued.
payable_originenum

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

Allowed values:
source_of_payable_dataenum

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.

Allowed values:
statusenum

The status of the payable.

amount_dueinteger or null

How much is left to be paid on the invoice (in minor units).

amount_paidinteger or null

How much was paid on the invoice (in minor units).

amount_to_payinteger or null

How much is left to be paid on the invoice (in minor units) with discounts from payment terms.

approval_policy_idstring or nullformat: "uuid"
Id of existing approval policy that applies to this payable, if any. A policy is applied if the payable matches the policy trigger conditions.
counterpartobject or null

Object representing de-normalized counterpart data. Filled at the moment of invoice submitting for approval or payment.

counterpart_address_idstring or nullformat: "uuid"
The ID of counterpart address object stored in counterparts service
counterpart_bank_account_idstring or nullformat: "uuid"
The ID of counterpart bank account object stored in counterparts service
counterpart_idstring or nullformat: "uuid"
The ID of the counterpart object that represents the vendor or supplier.
counterpart_raw_dataobject or null
Object representing counterpart data which was extracted by OCR. Used for informational purposes.
counterpart_vat_id_idstring or nullformat: "uuid"
The ID of counterpart VAT ID object stored in counterparts service
created_by_role_idstring or nullformat: "uuid"

The ID of the role that the entity user who created this payable had at that time. If the payable was created using a partner access token, the value is null.

currencyenum or null

The currency code of the currency used in the payable.

currency_exchangeobject or null
descriptionstring or null
An arbitrary description of this payable.
discountinteger or null

The value of the additional discount that will be applied to the total amount. in minor units. For example, $12.50 is represented as 1250.

document_idstring or null

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_datestring or nullformat: "date"

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.

fileobject or null
The original file from which this payable was created.
file_idstring or nullformat: "uuid"
File id to retrieve file info from file saver.
issued_atstring or nullformat: "date"

The date when the payable was issued, in the YYYY-MM-DD format.

marked_as_paid_by_entity_user_idstring or nullformat: "uuid"
The ID of the entity user who marked this document as paid.
marked_as_paid_with_commentstring or null
An arbitrary comment that describes how and when this payable was paid.
ocr_request_idstring or nullformat: "uuid"
Id of OCR request to match asynchronous result of processing payable.
ocr_statusenum or null
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.
Allowed values:
other_extracted_dataobject or null
Data extracted from the uploaded payable by OCR.
paid_atdatetime or null
The date by which the payable was paid
partner_metadatamap from strings to any or null
Metadata for partner needs
payment_termsobject or null

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

project_idstring or nullformat: "uuid"
Project ID of a payable.
purchase_order_idstring or nullformat: "uuid"
The identifier of the purchase order to which this payable belongs.
senderstring or nullformat: "email"
The email address from which the invoice was sent to the entity.
subtotalinteger or null

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

suggested_payment_termobject or null

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 objects or null

A list of user-defined tags (labels) assigned to this payable. Tags can be used to trigger a specific approval policy for this payable.

taxinteger or null

Registered tax percentage applied for a service price in minor units, e.g. 200 means 2%, 1050 means 10.5%.

tax_amountinteger or null

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

total_amountinteger or null

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

total_amount_with_credit_notesinteger or null

The total price of the payable in minor units, excluding all issued credit notes.

was_created_by_user_idstring or nullformat: "uuid"

Errors