# Canceling Orders

If you have created an order and want to cancel it, there are different ways to achieve that. The correct method to be used depends on the current state the order is in as well as the cancelation policies of the Supplier. Below you will find an overview.

# Cancelation Methods and when to use them

Criteria	How to cancel the order?
Order has not been placed yet	If the order has not been placed yet and is still in `draft` state, you can simply delete the order.
Order has been placed Order state is any of: `placed` `transfer_failed`	In case the order has been placed but is either still in `placed` or in `transfer_failed` state and thus not yet received by the Supplier, you can use the `Cancel By Consumer` method described below.
Order has been placed Order state is none of: `placed` `transfer_failed`	In case the order has been placed and is already transferred to the Supplier, the only way to cancel the order is to request a cancelation as described below. Requesting a cancelation is only possible in certain states depending on the cancelation policies of the supplier.

# Cancel By Consumer

If your Order has been placed, but not yet transferred to the Supplier, you can cancel the order by sending a PATCH order request with the state_event: "cancel_by_consumer".

Canceling the order this way will prevent a transmission of the order to the Supplier and you can consider the order as completely canceled.

# Example

The following request will cancel the order with the id: ffc75c94-aa79-450a-becc-2e398c079d93

PATCH /orders/ffc75c94-aa79-450a-becc-2e398c079d93

Body:
{
  "order": {
    "state_event": "cancel_by_consumer"
  }
}

# Request Cancelation

If your Order has been placed and has already been transferred to the Supplier, you can not directly cancel the order anymore, but rather have to request a cancelation of the order from the Supplier. This method is only possible according to the cancelation policies of the Supplier described here: Cancelation Policies (opens new window)

If the supplier accepts your request for order cancelation, the order will be moved into the canceled_by_supplier state. Otherwise it will move further throughout the regular states.

# Example Request

The following request will request a cancelation of the order with the id: ffc75c94-aa79-450a-becc-2e398c079d93

PATCH /orders/ffc75c94-aa79-450a-becc-2e398c079d93

Body:
{
  "order": {
    "state_event": "request_cancelation"
  }
}

# FAQ

# What happens if my cancelation request will be denied?

In case the Supplier does not accept your request for cancelation of the order you will see the order move further throughout the states as soon as it gets further processed by the Supplier.

If you are still want to cancel the order in such cases, you will need to directly contact the Supplier.

# What can I do if I can't cancel the order due to the suppliers cancelation policies?

If the regular way of requesting a cancelation is prevented by the cancelation policy of the Supplier, your best chance will be to directly contact the Supplier.

# How do I know if a cancelation request was accepted?

Please have a look into the tracking order changes section that can be found here: Tracking Order Changes

Procurement (Consumers)

Reference