What's your biggest current challenge? Have your say in Community Polls along the right column.
Our Partner & Developer boards on the community are moving to a brand new home: the .dev community forums! While you can still access past discussions here, for all your future app and storefront building questions, head over to the new forums.

What are the possible values of the Liquid object "order.fulfillment_status"?

What are the possible values of the Liquid object "order.fulfillment_status"?

rangelfinal
Visitor
2 0 0

What are the possible values of "order.fulfillment_status"? The documentation doesn't include it.

By trial and error I know "unfulfilled" and "fulfilled" are possible, but is there others?

Replies 8 (8)

Propero
Shopify Partner
897 101 159

@rangelfinal 

"fulfillment_status": "partial"

The order's status in terms of fulfilled line items. Valid values:

  • fulfilled: Every line item in the order has been fulfilled.
  • null: None of the line items in the order have been fulfilled.
  • partial: At least one line item in the order has been fulfilled.
  • restocked: Every line item in the order has been restocked and the order canceled.

 

- Was my reply helpful? Click Like or Click Accept as Solution
To hire: email us at shopify@propero.in
checkout our app https://apps.shopify.com/picamaze
rangelfinal
Visitor
2 0 0

@Propero 

I'm currently getting the value "unfulfilled" as the fulfillment_status of one of my test orders. Did it replace null on the valid values list?

Propero
Shopify Partner
897 101 159

https://shopify.dev/docs/admin-api/rest/reference/orders/order

Please check above

 

- Was my reply helpful? Click Like or Click Accept as Solution
To hire: email us at shopify@propero.in
checkout our app https://apps.shopify.com/picamaze
traycho
Visitor
2 0 0

@Propero How the values correspondent to this documentation ? - 

The fulfillment status of an order

  • Fulfilled
  • Unfulfilled
  • Partially fulfilled
  • Scheduled
  • On hold


  • fulfilled: Every line item in the order has been fulfilled.
  • null: None of the line items in the order have been fulfilled.
  • partial: At least one line item in the order has been fulfilled.
  • restocked: Every line item in the order has been restocked and the order canceled.
Propero
Shopify Partner
897 101 159

@traycho,

In my view the confusion is arising from "Scheduled" and "On-Hold" right? Which will map to unfulfilled 

- Was my reply helpful? Click Like or Click Accept as Solution
To hire: email us at shopify@propero.in
checkout our app https://apps.shopify.com/picamaze
traycho
Visitor
2 0 0

@Propero 

Using https://shopify.dev/docs/admin-api/rest/reference/orders/order#fulfillment-status-property-2021-07 I see only possible values are 

  • fulfilled: Every line item in the order has been fulfilled.
  • null: None of the line items in the order have been fulfilled.
  • partial: At least one line item in the order has been fulfilled.
  • restocked: Every line item in the order has been restocked and the order canceled.

Once I see displayed 'On Hold' or 'Scheduled' fulfilment status in Shopify Admin I am not sure what will be fulfilment_status value coming in the json payload
How we distinguish between 'On Hold' and 'Scheduled' as I don't see any mappings for them ?

 

Propero
Shopify Partner
897 101 159

Please look at latest 

https://shopify.dev/docs/admin-api/graphql/reference/orders/orderdisplayfulfillmentstatus 

try and print value for different status

- Was my reply helpful? Click Like or Click Accept as Solution
To hire: email us at shopify@propero.in
checkout our app https://apps.shopify.com/picamaze
Thomas47
Shopify Partner
58 0 12

From the changelog:
When a customer places an order that qualifies for a post-purchase offer, any line items on an order will have a fulfillable_quantity of 0 while Shopify waits to see if there will be more items added to the order. The order fulfillment_status will be on_hold, and FulfillmentOrders in version ≥2021-07 will have a status of ON_HOLD. API versions before 2021-07 will return no FulfillmentOrders.