Skip to content

Fulfillment Orders

Fulfillment orders model how Shopify splits an order into fulfillable groups per location and delivery method — the modern API for fulfillment apps.

Source

Key objects

ObjectRole
OrderParent order with one or more fulfillment orders
FulfillmentOrderLine items fulfilled from one location / delivery method
FulfillmentOrderLineItemQuantities to fulfill per FO
FulfillmentShipment record (tracking, items)
FulfillmentService3PL / print-on-demand service with its own Location

Lifecycle (fulfillment service app)

  1. Merchant or app submits a fulfillment request for an FO
  2. Service accepts or rejects the request
  3. Service creates fulfillments with tracking
  4. Cancellation requests can flow both directions via dedicated webhooks

Webhooks (selection)

  • fulfillment_orders/fulfillment_request_submitted
  • fulfillment_orders/fulfillment_request_accepted / _rejected
  • fulfillment_orders/cancelled
  • fulfillment_orders/order_routing_complete

Split carts

Orders may include multiple delivery methods (ship + pickup). Iterate all fulfillment orders — never assume a single method per order.

Curated technical notes — open source on GitHub