GraphQl FulfillmentCreateV2 returning Order doesn't exist

Retired Boards Appdev Fulfillment Api

Topic summary

GraphQL fulfillmentCreateV2 was returning “Order doesn’t exist” when attempting to fulfill an order with multiple tracking numbers, even after releasing an on-hold status.

Context:

  • Mutation: fulfillmentCreateV2(FulfillmentV2Input) with lineItemsByFulfillmentOrder, notifyCustomer, originAddress, and trackingInfo arrays (company, numbers, urls).
  • IDs used should be FulfillmentOrder and FulfillmentOrderLineItem IDs (not the Order ID). GraphQL requires fulfillment to target the FulfillmentOrder object rather than the parent Order.
  • An image (screenshot) showed the error message.

Resolution:

  • The error occurred because the Order ID was used instead of the FulfillmentOrder ID.
  • After switching to the correct FulfillmentOrderID, the fulfillment succeeded.

Outcome:

  • Issue fixed; no further open questions.
  • Key takeaway: Use FulfillmentOrderID for fulfillmentCreateV2, not the Order ID, especially when providing tracking numbers and line items by fulfillment order.
Summarized with AI on January 21. AI used: gpt-5.
1

Hey Team

hope you are doing well!

i’m trying to fulfill an Order in Shopify with multi Tracking Numbers but it returning

khaoulaLysi_0-1692018082645.png
khaoulaLysi_0-1692018082645.png1449×768 107 KB

The Order actually is On Hold but when i release the fulfillment and run it again it still shows same error

Mutation :

mutation fulfillmentCreateV2($fulfillment: FulfillmentV2Input!) { fulfillmentCreateV2(fulfillment: $fulfillment) { fulfillment { id status trackingInfo { company number url } } userErrors { field message } } }

Variables

{
“fulfillment”: {
“lineItemsByFulfillmentOrder”: [
{
“fulfillmentOrderId”: “gid://shopify/FulfillmentOrder/5431752130834”,
“fulfillmentOrderLineItems”: [
{
“id”: “gid://shopify/FulfillmentOrderLineItem/14156771164434”,
“quantity”: 1
},
{
“id”: “gid://shopify/FulfillmentOrderLineItem/14156771197202”,
“quantity”: 1
}
]
}
],
“notifyCustomer”: true,
“originAddress”: {
“address1”: “Test”,
“address2”: “”,
“city”: “Test”,
“countryCode”: “US”,
“provinceCode”: “Test”,
“zip”: “Test”
},
“trackingInfo”: {
“company”: “UPS”,
“numbers”: [
“1ZXXXXXXXXXXXXXXXX”
],
“urls”: [
“https://www.ups.com/track?loc=en_US&requester=ST&trackNums=1ZXXXXXXXXXXXXXXXX/trackdetails”
]
}
}
}

This Order is Exist in Shopify

Thanks

2

The Issue is fixed i was using Order ID instead of fullfillmentOrderID