Fulfillment Orders
Fulfillment Orders represent groups of line items from an order that are assigned to a specific location for fulfillment. They enable split-shipment workflows and multi-location fulfillment.
Key Concepts
Fulfillment Order Lifecycle
- Created : When an order is created, fulfillment orders are generated automatically or based on your specifications
- Pending : Items are awaiting fulfillment at the assigned location
- Fulfilled : Items have been picked, packed, and are ready for shipping
- Shipped : Shipments have been created and items are in transit
- Completed : All items have been delivered
Operations
Fulfill
Mark items as fulfilled and ready for shipping. This operation:
- Updates line item statuses to fulfilled
- Optionally creates a draft shipment automatically
- Triggers inventory updates
Unfulfill
Reverse a fulfillment when items cannot be shipped. This allows:
- Correcting fulfillment errors
- Handling out-of-stock situations discovered after fulfillment
- Reallocating items to different locations
Split
Divide a fulfillment order when items need to ship from different sources:
- Create a new fulfillment order with selected line items
- Assign to a different location if needed
- Maintain order integrity across splits
Merge
Combine fulfillment orders when consolidation makes sense:
- Reduce shipping costs by combining shipments
- Improve customer experience with fewer deliveries
- Optimize fulfillment operations
Ship
Create shipments for fulfilled items:
- Specify carrier account and parcel details
- Include delivery preferences
- Generate shipping labels through the Carriyo Shipping API
Cancel
Cancel specific line items within a fulfillment order:
- Provide cancellation reason
- Automatically updates inventory
- Triggers order status recalculation
Location Management
Fulfillment orders are tied to locations. You can:
- Update the assigned location before fulfillment
- Move items between locations using split and merge operations
- Track inventory across all fulfillment locations