ORDER-350 - Delete one or more lines from a commercial order

Deletes one or more lines from a commercial order.

⚠️ Deletion is only permitted if all related logistic orders are in DRAFT_ORDER status.
A commercial order does not carry a status itself — the validation state is inherited from its logistic orders.

If all lines from a logistic order are deleted, the logistic order itself is also deleted along with its associated data.

This endpoint can be used by users other than the creator of the order, provided they belong to the same customer account and have the ORDER_UPDATE_LINES_ON_ALL_ACCOUNT permission enabled.

Permissions: Requires a valid API key and client type.

Multistore Support: Optional store view context header allows routing in multistore 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.
Business IDs or EXTERNAL_IDs are not supported for this path.

Body Params

List of offer price IDs to delete from the order.

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

Line(s) successfully deleted.

If some lines could not be deleted (e.g. invalid status, missing permissions), they are not deleted and included in a warning block in the response body.

⚠️ Although 204 typically implies no content, this implementation may include a warning payload for partial deletions.

400

The order is not in a deletable status or the request is malformed.

401

Unauthorized – user is not allowed to delete lines for this order.

403

Forbidden – user lacks the required role permission.

404

Order or store/account not found.

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