Skip to main content
Workflows view used for auto-fulfillment

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
A warehouse might accept all four; a downtown showroom might only accept in-store pickup for Booking and Purchase.

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 salesChannelAdmin and salesChannelOnline.

Lifecycle

What triggers auto-fulfillment

Auto-fulfillment runs when an Order is created and at least one Service Location has:
  1. orderFulfillmentEnabled = true
  2. A rule for the line item’s purchase type with at least one delivery method enabled
  3. Available Stock Items matching the line item’s product and variant
If multiple locations qualify, the system picks the first match based on the location ordering. If no location qualifies, the line item is created with no Stock Item assigned and shows as Unfulfilled until a staff member assigns one.

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, or localDeliveryEnabled on 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

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.
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.
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.
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.
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.
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 on service-locations in the API.

API: Service Locations

Open the endpoint in the API reference.

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.