Bstia Docs
Daily Operations

Order Lifecycle & Statuses

Understand the order status workflow from pending to delivered, including cancellations and returns.

Status Workflow

Orders follow this lifecycle:

pending → processing → ready_for_shipment → shipped → delivered

                          cancelled / returned_full / returned_to_agent / partially_delivered

Orders list

Status Descriptions

StatusDescription
PendingOrder just created, awaiting processing
ProcessingOrder is being prepared
Ready for ShipmentPacked and waiting for pickup
ShippedHanded to delivery agent
DeliveredSuccessfully received by customer
CancelledOrder cancelled before delivery
Returned (Full)Entire order returned by customer
Returned to AgentDelivery failed, returned to agent
Partially DeliveredOnly some items delivered

Updating Order Status

Open the Order

Click on any order row in Orders to view its details.

Change Status

Use the status dropdown to select the next status. Only valid transitions are available.

Save Changes

Changes are saved immediately. Status change is logged in the activity feed.

Stock impact

  • Cancelled and Returned orders restore stock automatically
  • Partially Delivered requires manual stock adjustment for undelivered items

Profit tracking

Profit is calculated as totalPrice - totalCost at the order level. This is locked when the order is created and doesn't change with status updates.

Required Access
Roles:owneradminmember
Permission:order:edit