Cancel an order item
Cancels a specific OrderItem within an Order.
This endpoint can be used to either confirm a cancellation request by the customer, or to cancel an order you yourself are unable to fulfil.
Customer requested cancellations
When retrieving the open order list through the order request you will receive a value <CancelRequest> with every orderitem. Whenever this value is set to True, it means the customer has changed his mind and has cancelled his order. You do not need to ship this orderitem, and we will refund the payment to customer. We do require you to confirm this customer cancellation through this cancellation endpoint, It is possible that a customer only cancels a single item within an order. You need only cancel this one item, and can ship the others.
Please select the corresponding
<ReasonCode>REQUESTED_BY_CUSTOMER</ReasonCode>, when using the cancellation request. A customer cancellation will not count negatively towards your Retailer Performance Score.
Retailer requested cancellations
If you are unable to fulfil the order request, e.g. due to lack of stock, you can cancel the order yourself by using this cancellation request. We will refund payment to the customer.
Keep in mind though that a Retailer requested cancellation does count negatively towards your Retailer Performance Score.
||Required. The article within an order that you wish to cancel. You can find the
||Required. Used to specify when this specific article within an Order was cancelled.
||Required. Used to specify the reason for cancellation. The XSD lists the available cancellation options.|
<Cancellation xmlns="https://plazaapi.bol.com/services/xsd/v2/plazaapi.xsd"> <DateTime>2016-02-12T03:35:22+01:00</DateTime> <ReasonCode>REQUESTED_BY_CUSTOMER</ReasonCode> </Cancellation>
Status: 200 OK <?xml version="1.0" encoding="UTF-8"?> <ns1:ProcessStatus xmlns:ns1="https://plazaapi.bol.com/services/xsd/v2/plazaapi.xsd"> <ns1:id>1</ns1:id> <ns1:sellerId>187216</ns1:sellerId> <ns1:entityId>206605326</ns1:entityId> <ns1:eventType>CANCEL_ORDER</ns1:eventType> <ns1:description>Cancel order item with id 206605326.</ns1:description> <ns1:status>PENDING</ns1:status> <ns1:createTimestamp>2016-02-12T15:35:23.000+01:00</ns1:createTimestamp> <ns1:Links> <ns1:link ns1:method="GET" ns1:href="https://plazaapi.bol.com/services/rest/process-status/v2/1" ns1:rel="self" /> </ns1:Links> </ns1:ProcessStatus>
Note: For more information on the process-status endpoint, please read: process-status-v2.
Download XSD for the orders-v2 endpoint below.