v1

latestOpenAPI 3.0.02026-07-141525155.4 KB
External Seller

Marketplace order cancellation

This request may be sent from VTEX to the external seller in case of order cancelation. For that, the seller will need to implement the Marketplace order cancellation endpoint. Whenever this request is received by the seler, the order should be canceled and the fulfillment flow should not proceed.

For the seller to:

  • Evaluate a cancellation request: it is possible to send an empty body as a response to the cancellation request, meaning that the seller is evaluating whether to proceed with the cancellation or not.

  • Confirm the cancellation request: it is possible to confirm the order cancellation by the marketplace by responding to the call with a body including only one information: the marketplaceOrderId, which identifies the order in the marketplace. The seller should use this ID to trigger the cancellation of the corresponding order. The seller should then respond with the same marketplaceOrderId and also with the orderId, which identifies the order in the seller, the date and time of the notification receipt, and a protocol code that confirms the receipt of the request (which may have the value null).

  • Refuse a cancellation request: it is possible to to send the Invoice, meaning that the cancellation has been denied, and the flow continues to the Order Invoicing step, and the ones that follow it.

This call should be made twice: once for the Evaluate cancellation request scenario, and a second time to Confirm cancellation or Refuse cancellation.

post/{fulfillmentEndpoint}/pvt/orders/{orderId}/cancel

Path parameters

fulfillmentEndpointstring required
Example:marketplaceexample.externalseller.com

This is the fulfillment endpoint registered for each specific external seller in the seller management section of VTEX's admin panel.

orderIdstring required

ID of the order being fulfilled

Headers

Acceptstring required
Example:application/json

HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand.

Content-Typestring required
Example:application/json

Describes the type of the content being sent.

Request body

marketplaceOrderIdstring required

Identifies the order. The seller should use this ID to trigger the cancellation of the corresponding order.

Response

OK