
Workflows
Definition
Auto-fulfillment automatically assigns an available Stock Item to each incoming order line at the moment the order is created. When enabled on a Service Location, the system picks a Stock Item from that location’s inventory without requiring a staff member to choose one manually. Auto-fulfillment is what makes high-volume online channels viable — every booking that comes in already has stock attached and is ready to be prepared.Where do I use it?
- High-volume online stores where manual stock selection is impractical
- Self-service and unstaffed pickup points
- Multi-location operations where a default location should claim orders first
- Workflows that depend on Stock Item assignment existing at order creation
- Reducing the time between order creation and a fulfillable order in the queue
Key Properties
Auto-fulfillment is configured per Service Location under Settings → Locations → [Location] → Fulfillment. The configuration has three layers:Delivery methods per rule
Each fulfillment or return rule can enable one or more delivery methods:Per-purchase-type rules
When Use specific rules is enabled, separate rule sets exist for each purchase type:- Booking (
booking) — for rental orders - Purchase (
sale) — for sale orders - Subscription — for recurring orders
- Buyback — for buyback orders
Relationships
- Service Location → owns the fulfillment and return configuration.
- Stock Items → the inventory pool auto-assign draws from. Only items at the matching location and matching the Listing’s variant are eligible.
- Order Items → on creation, each item is paired with one or more Stock Items.
- Item states → decide whether staff see the unit TWICE picked. See Fulfillment lifecycle.
- Workflows → can react to fulfillment events (assignment, pickup, return) — see Workflows.
- Channels → a Service Location can be restricted to certain sales channels via
salesChannelAdminandsalesChannelOnline.
Lifecycle
What triggers auto-fulfillment
Auto-fulfillment runs when an Order is created and at least one Service Location has:orderFulfillmentEnabled = true- A rule for the line item’s purchase type with at least one delivery method enabled
- Available Stock Items matching the line item’s product and variant
Step-by-step
1
Order arrives
A customer checks out online, or an Order is created via the API or admin.
2
Eligible locations enumerated
TWICE finds Service Locations with
orderFulfillmentEnabled and the relevant channel flag (salesChannelOnline, etc.) set.3
Rules matched
For each line item, the system reads the rule matching the line’s
purchaseType. The line proceeds only if at least one delivery method is enabled on that rule.4
Auto-assign picks a Stock Item
TWICE picks an available Stock Item from the location’s inventory that matches the line item’s product and variant for the requested rental period.
5
Order saved
The Stock Item is attached to the line item in whichever item state your New item automations rule names for an auto-assigned unit. Out of the box that is Pre-assigned: assigned, but still replaceable by the switching logic. The order-level rollup stays Unfulfilled until the items are handed over.
Key behaviours
- Auto-assign always runs. There is no switch that stops TWICE picking a unit. What a merchant controls is whether staff see the pick: turn on Hide the assigned unit on a Preparing state and the item reads as unassigned until someone binds a unit by hand. Set it under Settings → Orders → Fulfillment lifecycle.
- Staff can always assign by hand. Whatever the state says about hiding the unit or locking auto-switch, a Preparing item stays assignable from the order.
- A listing line takes its units from the listing’s rules. In admin, the Fulfillment card of Add Line Item shows those rules for a new listing line and offers no unit to pick. Pick units by hand from the Stock Item tab of the Add panel, which puts them on a custom line, or swap the unit on the order afterwards.
- Rules are per purchase type. A location can accept in-store pickup for Bookings but require shipping for Purchases.
- Fulfillment and returns are configured separately. Enabling order fulfillment does not automatically enable returns. A location can ship orders out without accepting in-bound returns at the same time.
- No delivery method = no auto-assign. The system requires at least one of
inStoreEnabled,shippingEnabled, orlocalDeliveryEnabledon the matching rule. A location with no rules configured leaves orders without a delivery method. - No available Stock Item = unfulfilled. Auto-assign never overbooks. If the pool is empty for the requested period, the line stays unfulfilled and a staff member must intervene.
Channel-specific behaviour
Service Locations carry per-channel flags. Auto-fulfillment respects these:
A location that only has
salesChannelOnline = true never auto-fulfills admin-created orders.
Assigning a unit by hand
Put a unit on a line from the line’s stock item panel, under Change stock item. The list holds every stock item at the order’s pickup location over the line’s whole period, and rates each one twice.
The line’s own unit comes first, marked Current. Where the item’s state hides the unit, that row reads Assign instead, so you can confirm the unit TWICE picked. The rest follow by rule match, then availability, then name. Search by code or name, or scan a unit’s code to pick its row.
Availability is the only hard limit. A Committed unit cannot be picked. A Pre-assigned one can: saving moves the hold on it to another unit, and the save is refused if that hold has nowhere to go.
Rule matching is advice. Assign a No match unit when you know it is equivalent, and fix the listing’s rules once you override the same rule again and again.
Nothing changes until you click Save. Saving holds the new unit for the line’s period and frees the old one. The item moves to the state your rule for staff-assigned units names, Assigned on a new account. The menu at the top of the panel sets this one item’s state on its own.
Scanning a unit onto an order
Scan a unit’s code with its order open, and the order puts the unit on a line waiting for one: a line in a preparing state that staff have not given a unit yet. The unit has to be a Full match for that line. A partial match is never assigned by scan, so assign one by hand.
Where several lines fit, the customer card picked on the Summary tab wins, then a line you ticked, then a line staff have started on, then a line whose picked unit shares the scanned unit’s SKU, then the earliest pickup.
FAQs
What happens when I enable auto-assign with no fulfillment rules?
What happens when I enable auto-assign with no fulfillment rules?
Orders are created without a delivery method and remain Unfulfilled. Always configure at least one delivery method (in-store, shipping, or local delivery) on the rule for each purchase type you support at that location.
Can different locations auto-fulfill the same order?
Can different locations auto-fulfill the same order?
A single Order Item is assigned to one Stock Item at one location. Different line items in the same Order can be fulfilled from different locations. The selection is per-line, not per-order.
Why didn't my order get an auto-assignment?
Why didn't my order get an auto-assignment?
Common causes: the matching purchase type has no rule, all delivery methods on the rule are disabled, the location’s channel flag does not match the order’s channel, or no Stock Items are available for the requested period. An item that looks unassigned but is not may also be sitting in a state with Hide the assigned unit on.
Can I auto-fulfill returns the same way?
Can I auto-fulfill returns the same way?
Returns use the Order returns section with the same structure (per-purchase-type rules and per-method switches). There is no separate auto-assign for returns — when an item comes back, it’s matched to the existing Order Item rather than picked from inventory.
Does auto-fulfillment respect the cancellation policy?
Does auto-fulfillment respect the cancellation policy?
Auto-fulfillment runs before cancellation policies become relevant. If an order is cancelled later, the assigned Stock Item is released back to inventory regardless of how it was originally assigned.
Why is Change stock item empty, or full of No match?
Why is Change stock item empty, or full of No match?
The list holds every stock item at the order’s pickup location over the line’s period. Empty means no unit is there for that period. Every row reading No match means the listing’s rules match nothing there, so fix the rules on the listing, not the order. See Control what stock a listing draws from.
Developer Reference
Auto-fulfillment rules live onservice-locations in the API.
API: Service Locations
Open the endpoint in the API reference.
Related articles
Order Lifecycle
How orders move through statuses from creation to completion.
Order Types
Rental, sale, subscription, and buyback orders.
Stock Item State
How Stock Items move when assigned and released.
Service Locations
Where fulfillment rules live.