create fulfillment return 404 not found

Topic summary

Issue: Creating a fulfillment via REST POST /admin/api/2023-10/fulfillments.json returns {“errors”:“Not Found”}.

Context:

  • Fulfillment order GET shows id 6124944097477, status open, request_status unsubmitted, supported_actions include create_fulfillment and hold.
  • Payload uses line_items_by_fulfillment_order with the above fulfillment_order_id and tracking_info {number, company: “YunExpress”}.
  • App claims correct access scopes and verified fulfillment_order_id.
  • X-Request-ID provided: 2ff891af-eadc-446b-89e8-c2372771a71a.

Details shared:

  • Endpoint version: 2023-10.
  • Response body only shows “Not Found”; no HTTP status code or headers posted.

Follow-ups requested by respondent:

  • Check reply headers and exact HTTP status code for more diagnostic info.
  • Confirm whether “YunExpress” is a Shopify-recognized carrier or if a tracking URL is required.

Status and open questions:

  • Root cause not identified; thread is unresolved.
  • Next steps: provide full response headers/status, verify carrier handling, and double-check the exact POST endpoint formatting/version used.
Summarized with AI on January 11. AI used: gpt-5.

GET https://myshopify_url/admin/api/2023-10/fulfillment_orders/6124944097477.json

{
“fulfillment_order”: {
“id”: 6124944097477,
“shop_id”: 63541575877,
“order_id”: 5104843817157,
“assigned_location_id”: 69142380741,
“request_status”: “unsubmitted”,
“status”: “open”,
“supported_actions”: [
“create_fulfillment”,
“hold”
],
“destination”: {…},
“line_items”: [
{
“id”: 12850108203205,
“shop_id”: 63541575877,
“fulfillment_order_id”: 6124944097477,
“quantity”: 1,
“line_item_id”: 12632312545477,
“inventory_item_id”: 44683462148293,
“fulfillable_quantity”: 1,
“variant_id”: 42590695620805
}
],
“international_duties”: null,
“fulfill_at”: “2023-12-07T16:00:00+09:00”,
“fulfill_by”: null,
“fulfillment_holds”: ,
“created_at”: “2023-12-07T16:23:32+09:00”,
“updated_at”: “2023-12-07T16:23:32+09:00”,
“delivery_method”: {
“id”: 666907640005,
“method_type”: “shipping”,
“min_delivery_date_time”: null,
“max_delivery_date_time”: null
},
“assigned_location”: {…},
“merchant_requests”:
}
}

POST https://myshopify_url/admin/api/2023-10/fulfillments.json

request :

{“fulfillment”:{“line_items_by_fulfillment_order”:[{“fulfillment_order_id”:6124944097477}],“tracking_info”:{“number”:“YT0000000000000000”,“company”:“YunExpress”}}}

response :

{“errors”: “Not Found”}

I attempted to create a fulfillment using the REST API, providing the correct fulfillment_order_id, and ensuring that all relevant access scopes are checked. However, I’m consistently receiving a “not found” error, despite confirming the accuracy of the fulfillment_order_id and having the necessary access scopes.

I’ve been trying to identify the cause of this “not found” error but haven’t been able to pinpoint the issue.

When calling /admin/api/2023-10/fulfillments.json,

I’ll include the X-Request-ID for reference.

X-Request-ID : 2ff891af-eadc-446b-89e8-c2372771a71a

i don’t see an error - what to the reply headers say? they have any more info? what http code?

is “YunExpress” handled by shopify or does it need a url as well?