Update an incoming invoice

Updates only the fields sent. Omitting products leaves the existing lines untouched.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

Database ID of the incoming invoice.

Body Params

Partially update an incoming invoice.

products
array of objects
Defaults to null

Invoice lines. Omit the property to leave the stored lines untouched; a supplied array replaces all of them. Every line must name an existing invoice line.

products
integer | null
Defaults to null

Date when the invoice was created as UNIX timestamp.

string | null
Defaults to null

Invoice number.

string | null
Defaults to null

Vendor invoice number. Filling this posts the invoice to the accounting integration, if one is connected.

integer | null
Defaults to null

Invoice date as UNIX timestamp.

integer | null
Defaults to null

Payment due date as UNIX timestamp.

integer | null
Defaults to null

Database ID of the vendor. Cannot be changed once the invoice has a vendor.

string | null
Defaults to null

Taxable additional fees, in the account default currency. Allocated across the purchase order lines. Not allowed on prepayment invoices. Send this field, fees_taxable_sum_cur, or both. With both, fees_taxable_sum_cur multiplied by the invoice exchange rate must equal this field to five decimal places; otherwise the request is refused with 422.

string | null
Defaults to null

Taxable additional fees, in the invoice currency. Allocated across the purchase order lines. Not allowed on prepayment invoices.

string | null
Defaults to null

Non-taxable additional fees, in the account default currency. Allocated across the purchase order lines. Not allowed on prepayment invoices. Send this field, fees_sum_cur, or both. With both, fees_sum_cur multiplied by the invoice exchange rate must equal this field to five decimal places; otherwise the request is refused with 422.

string | null
Defaults to null

Non-taxable additional fees, in the invoice currency. Allocated across the purchase order lines. Not allowed on prepayment invoices.

string | null
Defaults to null

Tax percentage. Applies only to an invoice without lines. An invoice with lines always uses the VAT rate of its purchase order, and a value sent here is ignored.

string | null
Defaults to null

On a prepayment invoice, the prepayment amount; on an incoming invoice, the prepayment applied from the purchase order's pool. In the account default currency. Send this field, prepayment_sum_cur, or both. With both, prepayment_sum_cur multiplied by the invoice exchange rate must equal this field to five decimal places; otherwise the request is refused with 422.

string | null
Defaults to null

On a prepayment invoice, the prepayment amount. On an incoming invoice, the prepayment applied from the purchase order's pool.

integer | null
Defaults to null

Database ID of the purchase order. Cannot be changed.

integer | null
enum
Defaults to null

Invoice type. Cannot be changed.

  • 10 - Incoming invoice
  • 20 - Prepayment
  • 30 - Credit invoice
Allowed:
integer | null
Defaults to null

ID of the invoice currency. Cannot be changed.

string | null
Defaults to null

Exchange rate of the invoice currency. Accepted only while the invoice is in a currency other than the account default.

custom_values
array of objects
Defaults to null

Custom field values for the invoice. Values that are missing in the array will be left unchanged.

custom_values
files
array of objects
Defaults to null

Files to add or update. A file that is not listed is left unchanged; an empty array changes nothing.

files
Responses

401

Unauthorized

404

Not found

429

Too many requests

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json