POST
/
invoices
/
{id}
/
cancel

Authorizations

Authorization
string
headerrequired

Value for the Authorization header parameter.

Path Parameters

id
string
required

Invoice identifier

Body

The body is of type any.

Response

201 - application/json
id
string

The unique identifier of the invoice.

customer
object

The customer of the invoice.

paymentMethod
object

The payment method which should be used to fullfill the payment of the invoice.

referencedInvoice
object

The referenced invoice of the invoice. This could be in case of a reminder, refund etc.

type
enum<string>

The type of the invoice.

Available options:
TYPE_INVOICE,
TYPE_CREDIT,
TYPE_REFUND,
TYPE_REMINDER,
TYPE_CANCEL,
TYPE_DUNNING
currencyCode
string

The currency code of the invoice. If multiple currency codes will be used in the positions, they will be converted to that base currency.

number
string | null

The document id of the invoice. This will be generated, when the invoice will be finalized.

status
enum<string>
Available options:
STATUS_DRAFT,
STATUS_PAID,
STATUS_CANCELLED,
STATUS_REFUNDED,
STATUS_REMINDED,
STATUS_UNPAID,
STATUS_NEW,
STATUS_FINALIZING
creationDate
string
finalizationDate
string | null
dueDate
string | null
lastReminderDate
string | null
lastSentAt
string | null
dunningLevel
integer
dunningStatus
enum<string>
default: none
Available options:
reminder,
dunning,
none
payDate
string | null
invoiceAddress
object

The invoice address of the invoice.

internalNote
string | null

The notice of the invoice.

title
string | null
introduction
string | null
closing
string | null
netAmount
object

The net amount of the invoice.

grossAmount
object
taxAmount
object
discountAmount
object | null

The total net discount amount of the invoice.

file
object
positions
object[]

The positions of the invoice.

applicatedExchangeRates
object[]

The applicated exchange rates of the invoice, fetched from the european central bank.

eInvoiceType
enum<string> | null

The einvoice generated xml file format.

leitwegId
string | null

The leitwegid used for einvoice. This is only set, when the eInvoiceType is not null.

serviceDateFrom
string | null

The earliest service date of all positions.

serviceDateTo
string | null

The latest service date of all positions.

unpaidAmount
object
usageBreakdownUrl
string | null

Public url to view the detailed usage breakdown of this invoice.

cancellationDocument
object | null

The referenced cancellation document.

dunningDisabled
boolean

Dunning is disabled for this invoice.

sourceType
enum<string>

Where the invoice was created from.

Possible values:

  • cart: The invoice was created from a cart.
  • subscription: The invoice was created from a subscription billing run.
  • manual: The invoice was created by a user.
Available options:
manual,
subscription,
cart

Was this page helpful?

Delete invoiceCredit invoice