Order modification

Introduction

The order modification feature allows users to adjust both original order details and process flows, enhancing flexibility and responsiveness in order handling.

Original order modification

Action	Description	Conditions	Effect
Edit line items	Cancel items or adjust quantities to correct errors or reflect stock / customer needs.	All associated operational entities are in the "open" state Order line item is not attached to an custom service or bundled with another item in the order The feature is activated via the order modification configuration in the REST API The necessary permission ORDER_LINEITEM_WRITE is set	Re-route
Edit or add preferred date	Add or change delivery/handover date	All associated operational entities are in the "open" state The feature is activated via the order modification configuration in the REST API The necessary permission ORDER_WRITE is set	Re-route
Edit custom attributes	Add or change attributes to tailor orders, e.g., new routing criteria	All associated operational entities are in the "open" state The necessary permission ORDER_CUSTOM_ATTRIBUTES_WRITE is set	Re-route
Edit customer address	Correct address errors; new shipping label may be required	The necessary permission ORDER_CONSUMER_WRITE is set	If a shipping label has already been generated, it becomes obsolete and must be recreated.

Impact of original order modifications

A re-route results in the release of the inventory reservation. Consequently, it is possible for an order to become unroutable if the inventory is reserved for another order during the re-route process.

Process modification

Action	Description	Conditions
Cancel order	Cancels all entities of an order.	All pick jobs are open No items have been picked No shipping labels requested The necessary permission ORDER_CANCEL is set
Force cancel order	Sets all entities to canceled regardless of processing status. Releases reserved stock. If items are already picked, manual steps are required to return items to storage and align physical inventory with system records.	Must be enabled via REST API The necessary permission ORDER_FORCE_CANCEL is set
Carrier change	Changes the carrier for the picking task. A new label must be generated.	Ship‑from‑store orders only Handover job is open The necessary permission SHIPMENT_WRITE is set
Assign order	Assigns the order to a new facility and creates a new pick job there. Deletes existing pick jobs.	Ship‑from‑store orders only All pick jobs are open No items have been picked No labels have been requested The necessary permission PROCESS_WRITE is set
Reroute order	Performs new routing, if current routing is not optimal. Deletes existing pick jobs.	All pick jobs are open No items have been picked No labels have been requested The necessary permission PROCESS_REROUTE and is set
Reroute unroutable order	Evaluates order again against routing rules to find an optimal path. Can be executed in bulk to process multiple unroutable orders simultaneously.	Order or articles within the order are not routable The necessary permission ROUTING_WRITE is set
Task reroute	Enables manual rerouting of tasks. Blacklists the facility previously processing the order (if activated in the settings).	Pick job is open The necessary permission ROUTING_WRITE is set

Order modification events

Order modifications trigger specific events that enable tracking changes or integrating with other systems. See the complete list of available events.