Delivery record structure
A delivery record is created when you assign a delivery partner to an order. It contains the following fields:Delivery stages
Each entry in thestages array represents a transition in the delivery lifecycle and contains:
Stage values
The
current_stage field always reflects the most recent stage in the stages array.
The delivery detail view shows the full stage history in chronological order, so you can see exactly when each transition occurred and which partner was responsible.
Pickup points
Pickup points record the intermediate handoff locations where a partner collects the parcel. EachPickupPoint contains:
Assigning a delivery partner
To assign a delivery partner to an order, you create a new delivery record. The following fields are required:1
Open the order detail view
Navigate to Orders and click the order you want to assign a delivery partner to. The order must be in a status that allows fulfillment (for example,
confirmed).2
Open the delivery section
Scroll to the Delivery section of the order detail view. If no delivery has been assigned yet, you will see an option to assign a partner.
3
Select a delivery partner
Choose the delivery partner from the available list. The system creates a delivery record with the initial stage set to
assigned.4
Confirm the assignment
Submit the form. The delivery record is created and
current_stage is set to assigned.Adding a delivery stage
As the delivery progresses, you can record each stage transition. The following fields are required:1
Open the delivery detail
From the order detail view, open the delivery record. You can also access deliveries directly from the Deliveries section of the dashboard.
2
Add a new stage
Use the Add Stage action and select the appropriate
stage value. The new stage is appended to the stages array and current_stage is updated automatically.