Order Modification and Cancellation by the Buyer
In this article, suppliers can learn more about how to consult and be notified when a buyer makes any modifications or cancellations to an order or order items.
The buyer can modify or cancel both unconfirmed and already confirmed orders:
- Order Modification: When a buyer modifies an order after supplier acceptance, a new order with a new
OrderId
is generated. The supplier will be notified via webhook. - Order Cancellation: This is an exceptional situation that the buyer should avoid, and the supplier will also be notified via webhook.
The supplier can consult the following endpoints of the Supplier Orders API, which include the isChanged
, WasChanged
, isCanceled
, or canceled
fields to check if an order has been altered or canceled:
GET
Get ordersGET
Get an order based on the order IdGET
Get a list of order items based on the order Id
Order Statuses
Orders can have the following statuses:
- Refused
- Canceled
- Confirmed
- WaitingResponse
- Unread
- PartiallyConfirmed
❗️ Attention
Regardless of the order status, the item of the order cannot be canceled or refused if there is already a delivery or partial/total receipt.
Notification via Webhooks
When the buyer makes a modification or cancellation to an order or order items, the supplier can be notified via Webhooks.
Currently, the supplier is notified in three situations:
- Order Received (
order.received
): Orders created within the E-Procurement Web portal. - Order Updated (
order.updated
): Orders modified within the E-Procurement Web portal. - Order Canceled (
order.canceled
): Orders canceled within the E-Procurement Web portal.
For more information, see Webhooks.