Invoices

Change a draft invoice

Only draft invoices can be changed. When items are sent they replace all existing items. PUT is accepted as well.

patch/invoices/{id}

Request

  • Base URL: https://www.billingengine.com/api/v1
  • URL: https://www.billingengine.com/api/v1/invoices/{id}
  • Auth: HTTP bearer

Request body

customer_idinteger

Required when creating an invoice.

datestring date
due_daysinteger
opening_textstring
closing_textstring
service_period_start_datestring date
service_period_end_datestring date
prices_include_taxboolean

true for gross prices, false for net prices. If it differs from the account setting, the request is refused with 422.

Response

The changed invoice.

idinteger
numberstring
datestring date
due_datestring date nullable
delivery_status'draft' | 'sent' | 'downloaded'
payment_status'open' | 'paid' | 'defaulted' | 'cancelled' | 'cancellation'
overdueboolean
cancelledboolean
cancellationboolean

True for a cancellation invoice (credit note) of another invoice.

currencystring
prices_include_taxboolean
net_amountnumber
tax_amountnumber
gross_amountnumber
open_amountnumber
original_invoice_numberstring nullable
languagestring
vat_treatment'standard' | 'exempt' | 'reverse_charge' | 'intra_community' | 'export_outside_eu' | 'zero_rated' | 'outside_scope'
service_period_start_datestring date nullable
service_period_end_datestring date nullable
opening_textstring nullable
closing_textstring nullable

Example response

{
  "currency": "EUR",
  "language": "de"
}

Changes

No recorded changes to this operation across all 1 revision of this API.