HomeGuidesAPI ReferenceRelease Notes
Log In
API Reference

ORDER-300 - Delete a commercial order

delete
https://example.com/v2/shop/commercial-orders/

Deletes a commercial order and all associated logistic orders.

This operation is subject to access rights and business rules:

  • The commercial order must have all related logistic orders in DRAFT_ORDER status.
  • The authenticated user must belong to the account linked to the order (checked via customer-account-id header).
  • The user must have the permission flag CHECKOUT_ORDER_DELETE enabled.

⚠️ Only REFERENCE-type IDs are accepted in the commercialOrderId path parameter.

Permissions: Requires a valid API key, client type, and deletion rights.

Multistore Support: Optional store view context header allows routing in multi-store environments.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Unique REFERENCE identifier of the commercial order to delete.
Business IDs or EXTERNAL_IDs are not supported for this path.

Headers
string
enum
required

Specifies the client type making the request.

  • OPERATOR: Platform operator user.

  • ACCOUNT: Customer account user.

  • SUPPLIER: Supplier managing orders.

Allowed:
string
required

API key required for authentication. Must be valid and linked to the requesting user.

string

(Optional) Store ID in multi-store environments.

string

(Optional) Store view ID in multi-store environments.

string

(Optional) Customer account ID in multi-account customer user.

Responses
204

Commercial order and associated logistic orders successfully deleted.

400

Deletion not allowed — order has a non-deletable status.

401

Unauthorized — user lacks permission or account mismatch.

404

Order or store/account not found.

Updated 5 months ago

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here!

Updated 5 months ago