Cancel Order
An order can be cancelled for any reasons. It can be cancelled either as a complete order if it is not needed by the customer or a position or line item.
More information can be found in our Link
Path
POST /businesses/{businessCode}/customers/{customerNumber}/orders/{orderReference}/cancellations
Request Parameters
businessCode
required
string
The business in the context of which this request is to be executed, e.g. 1000
customerNumber
required
string
The customer in the context of which this request is to be executed, e.g. TFI2021072801
orderReference
required
string
The order in the context of which this request is to be executed, e.g. TFI2021072801_03
X-Request-ID
string
The unique ID of this particular request/transaction. Subsequent requests with the same request ID might get ignored.
Request Body
application/json
object
cancellationDate
required
string
yyyy-MM-dd
Format(yyyy-MM-dd)
Date the cancellation has been saved
Date the cancellation has been saved
cancellationReason
required
string
Enum:
- OUT_OF_STOCK
- CUSTOMER_CANCELLATION
- NO_PAYMENT
- CUSTOMER_SERVICE
Reason for the cancellation:
* OUT_OF_STOCK = Out of stock
* CUSTOMER_CANCELLATION = Customer cancellation
* NO_PAYMENT = No payment
* CUSTOMER_SERVICE = Customer service
invoiceReference
string
Max length: 30
maxLength(30)
Invoice number of referenced invoice
Invoice number of referenced invoice
array
The items that are to be cancelled
Responses
Request Example
{
"items": [
{
"orderItemReference": 3
}
],
"bankDetails": {
"bic": "GENODEM1MSC",
"iban": "DE51100100501234567890",
"accountOwner": "Max Mustermann"
},
"cancellationDate": "2018-03-21",
"invoiceReference": "IDE12345678901",
"cancellationReason": "OUT_OF_STOCK"
}
Response Example
{
"internalRequestId": "23c9579b-baaf-468f-a529-f876226e183c"
}