Fulfillment order split

A fulfillment order is an assignment of line items to a fulfillment location. The Fulfillment order split trigger starts a workflow when a fulfillment order is split by you or by a third-party app. Workflows using this trigger operate on the original fulfillment order as well as the resulting fulfillment orders from the split.

Note

The Fulfillment order split trigger doesn't include the specific line items that were affected by the split. You can access the line items on each resulting fulfillment order using a For each action.

The replacement fulfillment order is only created when the original fulfillment order cannot be split, such as when some items have already been fulfilled.

Data provided by the Fulfillment order split trigger

The following data is provided to workflows that start with the Fulfillment order split trigger.

Data that is provided to workflows with the Fulfillment order split trigger.

Data	Description
fulfillment order	The original fulfillment order that was split. Allows accessing data on the GraphQL Admin API Fulfillment Order object
remaining fulfillment order	The remaining fulfillment order as a result of the split. Allows accessing data on the GraphQL Admin API Fulfillment Order object
replacement fulfillment order	The replacement fulfillment order if the original fulfillment order couldn't be split. This field is optional and might be null. Allows accessing data on the GraphQL Admin API Fulfillment Order object

Actions

This trigger provides fulfillment orders, which lets you use any action that requires a fulfillment order, including:

• Change fulfillment order location.
• Hold fulfillment order.
• Mark fulfillment order as fulfilled.
• Release fulfillment hold.
• Submit fulfillment request.

Because fulfillment orders also link to an order, the trigger can also be used with actions that require orders, such as:

• Add order line item
• Add order tags
• Archive order
• Cancel order
• Capture payment
• Hold fulfillment order
• Mark order as paid

Fulfillment orders also contain lists of data such as line items. You can loop through these lists and perform actions on each item by using a For each action. For example, you can loop through the line items to check inventory availability.

Testing the trigger

To test an active workflow that starts with this trigger, you can:

• Split a fulfillment order in the Shopify admin by selecting any order and using the split functionality.
• To test workflows that handle replacement fulfillment orders, first partially fulfill some items in a fulfillment order, then split the remaining unfulfilled items. Following these steps will generate a replacement fulfillment order as the original fulfillment order cannot be split.
• Contact your third-party order management app to have them split a fulfillment order using the fulfillmentOrderSplit mutation.

API details

The Fulfillment order split trigger allows actions to be taken with the FulfillmentOrderSplitResult GraphQL API object. This trigger corresponds to the fulfillment_orders/split webhook.

Related triggers

For other fulfillment order workflows, you might also consider:

• Fulfillment order merged - starts when a fulfillment order is merged.
• Fulfillment order ready to fulfill - starts when a fulfillment order is ready to be fulfilled.
• Order fulfilled - starts when all line items in an order are fulfilled.