
Orders
Definition
The Order Lifecycle describes the journey of an Order from creation through fulfillment, completion, and post-order activity. Every order moves through three independent dimensions, Order Status, Payment State and Fulfillment State, and the combination of all three determines what you can do with the order at any given moment.Where do I use it?
- Filtering and grouping orders in the Orders table
- Triggering Workflows when an order enters a specific status
- Deciding whether an order can still be edited, cancelled, or refunded
- Reporting on revenue, fulfillment performance, and orders in progress
- Driving API integrations that need to react to order state changes
Order Status, Payment, and Fulfillment
Orders are tracked along three independent dimensions in the admin:- Order Status: overall progress of the order (Open / In progress / Completed)
- Payment State: how much of the order is paid (Paid / Partially paid / Unpaid)
- Fulfillment State: physical fulfillment of line items (Unfulfilled / Partially fulfilled / Fulfilled / Partially returned / Returned)
Key Properties
Order Status
The user-facing status shown on every order:
These four are the platform’s and cannot be renamed or added to. What your staff see is the state you have named inside a status, and a fresh account starts with one state per status carrying these names.
Empty a status of its states and orders walk past it, so an account with no Open state creates its orders in progress.
Payment State
Payment progress is tracked separately from order status. At the order level the chip reads one of three values:
In the API this is
paymentStatus, with values PAID, PARTIALLY_PAID and UNPAID. The individual Payments and Invoices behind the order carry finer-grained states, such as pending, succeeded, partially refunded, refunded, cancelled and expired. See Payments for how payment progress is represented.
Fulfillment State
The fulfillment chip on an order summarises how far its items have got. Every item state belongs to one of four fulfillment groups, and the chip reads the groups alone, never a state’s name. So the chip means the same thing whatever states your account defines.
The order is as far along as its least-advanced item, and “partially” says the rest have moved past it. Returns do move the chip forward: hand three items over and take one back and the order reads Partially returned, not Fulfilled.
Items in a Removed state are not on the line at all, so an order holding only removed items reads like an empty one.
The four groups, and the states you put inside them, are set under Fulfillment lifecycle.
Relationships
- Order Status is one of four fixed statuses. The named state your staff see inside it is defined per account.
- Payment State is derived from the linked Payments and Transactions and tracked on each line item.
- Fulfillment State is aggregated from the fulfillment group of each item, and from nothing else.
- A Workflow can be configured to fire on transitions of any of the three dimensions. See Auto-Fulfillment.
Lifecycle
Moving an order between states
Set under Order lifecycle how your account moves orders. With a menu, the state chip lists every state. With a button, one click moves the order to the state you named for its current state, and only roles holding the Move orders to any state switch get the menu beside it. Checks and automations run the same either way.Status transitions
- Open → In progress
- In progress → Completed
- Open → Completed
When: the customer collects, or the booked period starts.What happens, with the automation a new account starts with:
- Every item moves to Handed Out, except items already further along and items in a state that skips automations
- The fulfillment chip reads Fulfilled once every item is out
- Nothing is charged. Payment is tracked apart from status
Cancellation behaviour at each stage
Cancel an order in one of two ways: mark its items excluded and close it, which keeps it on the record with the items struck through, or archive it, which also takes it out of the Orders table. See Cancel an order for the first. There is no separate cancel action and no cancelled status. Archiving closes an open order without moving any of its items, releases what the order still holds from now on, and revokes its live checkout links. Archive an open order as it stands. Completing it first moves its sale items to Handed Out, and an archived order keeps a handed-out sale unit out of stock as sold. Neither route touches the money. Nothing refunds automatically, and no cancellation policy computes what to give back. How much else applies depends on how far the order has got:
Archive an order walks the archive, and Unarchive an order what unarchiving does not restore.
Edit rules at each stage
Edit permissions also depend on the staff member’s role. See Users & Roles.
A worked example: a three-day equipment booking
A customer books 3 items for three days from Friday: a mountain bike, a helmet and a lock. They pay 30% online at checkout, and the rest is collected on pickup.
Thursday is the row worth reading twice. Preparing the helmet and the lock moves those two items, but every item on the order is still at your premises, so the order’s own chip does not move. The chip tracks the least-advanced item.
FAQs
Can an order be Completed while still having an unpaid balance?
Can an order be Completed while still having an unpaid balance?
Yes. Order Status and Payment State are independent, so a staff member can complete an order after writing a balance off. Set the Order is unpaid check to Warn or Block under Order lifecycle if you want that move questioned or refused.
What happened to the Ready state?
What happened to the Ready state?
Ready was a fixed platform value that conflated a staff milestone with the order’s rollup, and it is gone from the chip. Build it yourself instead: add an item state for prepared goods, add an order state named Ready inside Open, and point an automation from one at the other. See Order lifecycle.
Does the chip move as items come back?
Does the chip move as items come back?
Yes. Once nothing is left at your premises, returning items one at a time moves the order to Partially returned, and the last one moves it to Returned. The chip only ever moves forward.
Does TWICE Commerce flag a late return?
Does TWICE Commerce flag a late return?
Yes, on the order itself. An item that was handed out and is past its return date carries an Overdue chip on its line, and the banner under the order’s header counts the late items until they come back, such as 1 item is overdue. An item that never went out is not counted.The Orders table has no overdue column and nothing sends a notification, so keep a saved view of late orders: see Find overdue orders.
Can I reopen a completed order?
Can I reopen a completed order?
Yes. Choose Open or In progress from the status chip, and the order is editable again. Reopening is a backward move, so none of your checks or automations fire on it: items keep their state, cancelled checkout links stay cancelled and scheduled payment collections stay stopped.Unarchive an archived order first. Unarchiving leaves it closed, so reopen it afterwards. Reopen an order walks through it.
Can I move an order without moving its items?
Can I move an order without moving its items?
Yes. Untick the line under Item automations in the move dialog, and those items stay where they are. A new account offers the tick by default, because Confirmation level under Order lifecycle starts at Confirm and allow skipping. Change Order state automations there when a move is wrong for every order rather than for this one.
Why does Create Order do nothing?
Why does Create Order do nothing?
No location is selected in the location selector in the top-left corner, so the order has nowhere to be created: select one and click again. A role without Create and edit orders, or one whose UI visibility hides the Create order action, has no button at all.
Why does Add stay greyed out when I add a listing to an order?
Why does Add stay greyed out when I add a listing to an order?
Add in the Add Line Item panel stays greyed out until every field highlighted in yellow is filled, such as Purchase option or End, and every variant is chosen.An empty Purchase option means the listing has no booking price for the line’s dates: change the dates, or add one on the listing’s Pricing tab. When the panel says the dates are not available, see Availability.
How do I find every order currently in progress?
How do I find every order currently in progress?
Filter the Orders table on Stage and tick In progress. Stage holds the fixed statuses, and State beside it holds the state names your account defines. In the API the status behind In progress is
active. See the Orders API.Developer Reference
Orders are exposed asorders in the API.
API: Orders
Open the endpoint in the API reference.
Related articles
Payments
Payment hierarchy, transactions, and refunds.
Order Types
Rentals, sales, subscriptions, and buybacks.
Stock Item State
How orders commit and release stock items.
Auto-Fulfillment
Automatic stock-item assignment on incoming orders.