Replace an incoming invoice

Replaces the invoice. Omitted fields are cleared, and the products array replaces all existing lines.

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

Replace the editable fields of an incoming invoice. The products array replaces all existing lines.

products
array of objects
required

Invoice lines. The array replaces all existing lines; every line must name an existing invoice line.

products*
integer
required

Date when the invoice was created as UNIX timestamp.

string
required

Invoice number.

string | null

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

integer | null

Invoice date as UNIX timestamp.

integer | null

Payment due date as UNIX timestamp.

integer | null

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

string | null

Taxable additional fees, in the account default currency. Allocated across the purchase order lines. Not allowed on prepayment invoices. Send the amount in this field, in fees_taxable_sum_cur, or in both; null in both clears it. 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

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

string | null

Non-taxable additional fees, in the account default currency. Allocated across the purchase order lines. Not allowed on prepayment invoices. Send the amount in this field, in fees_sum_cur, or in both; null in both clears it. 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

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

string | 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

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. Required when type is 20 (Prepayment), unless prepayment_sum_cur is sent. Send the amount in this field, in prepayment_sum_cur, or in both; null in both clears it. 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

On a prepayment invoice, the prepayment amount. On an incoming invoice, the prepayment applied from the purchase order's pool. Required when type is 20 (Prepayment), unless prepayment_sum_base is sent.

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

custom_values
files
array of objects
Defaults to null

Files of the invoice. The array replaces the current collection: a file that is not listed is removed. Omit the property to leave the files unchanged.

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