Locked Orders
There are use-cases where not every order should be fulfilled as soon as possible. In some cases it might me necessary to do some manual checks on an order, e.g. customer verification or fraud detect
Last updated
Was this helpful?
There are use-cases where not every order should be fulfilled as soon as possible. In some cases it might me necessary to do some manual checks on an order, e.g. customer verification or fraud detect
Last updated
Was this helpful?
This is where a "locked" order comes in plance. Locked orders are routed to a facility but do not result in a pickjob until they are unlocked. The unlocking can be done manually via the backoffice or via API.
Here's an example on how to create a Click-and-Collect order:
Some details on the example:
A locked order has the same details and properties as a order that should be fulfilled the standard way.
The status
is LOCKED
which means, that there are no further operational entities, e.g. pick jobs are created.
In the optional statusReasons
, you can set a reason per status you set the order in.
To unlock an order, call the orders action UNLOCK
:
The OrderCreatedWebHookEvent
has all the details about the order:
As you can see here, the status
is LOCKED
, so, evaluating the status field you can subscribe on the creation of locked orders.
The is an ORDER_UNLOCKED
event you can subscribed to to receive notifications, when an order is manually unlocked and ready for fulfillment.
The OrderUnlockedWebHookEvent
also contains all the details about the order:
The status
(previously LOCKED
) is now OPEN
.
If you have subscribed to ORDER_CREATED
webhook events as described in the , your service will be notified when a new order has been created. You can evaluate the information from this event, e.g. to start other business processes.
Full specification of the orders endpoint in our
Specification of the unlock endpoint: