Create

POST

Request

This endpoint expects an object.
Invoice Creation with Entity Requestobject
OR
Invoice Creation with Entity Group Requestobject

Response

This endpoint returns an object.
approvalPolicylist of objects
approverslist of objects
createdAtdatetime
hasDocumentsboolean

True if the invoice has documents attached.

hasSourceEmailboolean

True if the invoice was created by an incoming email.

idstring
metadatamap from strings to strings

Metadata associated with this invoice.

paymentDestinationConfirmedboolean

True if the payment destination has been confirmed by the vendor. False if the payment destination has been set (for example, a check to an address) but has not been confirmed by the vendor.

statusenum
updatedAtdatetime
amountdoubleOptional

Total amount of invoice in major units

batchPaymentbooleanOptional

If true, this invoice will be paid as a batch payment. Batches are automatically determined by Mercoa based on the payment source, destination, and scheduled payment date.

commentslist of objectsOptional
creatorEntityIdstringOptional

The ID of the entity who created this invoice.

creatorUserobjectOptional

Entity user who created this invoice.

currencyenumOptional

Currency code for the amount. Defaults to USD.

deductionDatedatetimeOptional

Initial date when funds are scheduled to be deducted from payer’s account. The actual deduction date may differ from this date, and will be reflected in the processedAt field.

dueDatedatetimeOptional

Due date of invoice.

failureTypeenumOptional
Allowed values: SOURCE_PAYMENT_ERRORDESTINATION_PAYMENT_ERRORREJECTED_HIGH_RISKINSUFFICIENT_FUNDSPROCESSING_ERROR

If the invoice failed to be paid, this field will be populated with the type of failure.

feesobjectOptional

Fees associated with this invoice.

foreignIdstringOptional

The ID used to identify this invoice in your system. This ID must be unique within each creatorEntity in your system, e.g. two invoices with the same creatorEntity may not have the same foreign ID.

invoiceDatedatetimeOptional

Date the invoice was issued.

invoiceNumberstringOptional
lineItemslist of objectsOptional
nextDeductionDatedatetimeOptional

For invoice templates, this is the date when the next recurring payment will be scheduled.

noteToSelfstringOptional
payerobjectOptional
payerIdstringOptional
paymentDestinationobjectOptional
paymentDestinationIdstringOptional
paymentDestinationOptionsobjectOptional
paymentScheduleobjectOptional

If this is a recurring invoice, this will be the payment schedule for the invoice. If not provided, this will be a one-time invoice.

paymentSourceobjectOptional
paymentSourceIdstringOptional
processedAtdatetimeOptional

Date when the invoice payment was processed.

serviceEndDatedatetimeOptional
serviceStartDatedatetimeOptional
settlementDatedatetimeOptional

Date of funds settlement.

shippingAmountdoubleOptional

Shipping amount for this invoice.

taxAmountdoubleOptional

Tax amount for this invoice.

transactionslist of objectsOptional

Transactions associated with this invoice.

vendorobjectOptional
vendorCreditIdslist of stringsOptional

The IDs of the vendor credits that are currently applied to this invoice.

vendorIdstringOptional