fulfillmentOrderReschedule

mutation

Requires write_merchant_managed_fulfillment_orders access scope or write_third_party_fulfillment_orders access scope. Also: The user must have fulfill_and_ship_orders permission.

Reschedules a scheduled fulfillment order.

Updates the value of the fulfillAt field on a scheduled fulfillment order.

The fulfillment order will be marked as ready for fulfillment at this date and time.

Arguments

Anchor to fulfillAtfulfillAt • DateTime!required: A future date and time when the fulfillment order will be marked as ready for fulfillment.
Anchor to idid • ID!required: The ID of the fulfillment order to reschedule.

Was this section helpful?

Anchor to FulfillmentOrderReschedulePayload returnsFulfillmentOrderReschedulePayload returns

Anchor to fulfillmentOrderfulfillmentOrder • FulfillmentOrder: A fulfillment order with the rescheduled line items.

Fulfillment orders may be merged if they have the same fulfillAt datetime.

If the fulfillment order is merged then the resulting fulfillment order will be returned. Otherwise the original fulfillment order will be returned with an updated fulfillAt datetime.
Anchor to userErrorsuserErrors • [FulfillmentOrderRescheduleUserError!]!non-null: The list of errors that occurred from executing the mutation.

Was this section helpful?

Reschedules the fulfill_at time of a scheduled fulfillment order
fulfillmentOrderReschedule reference

Examples

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

mutation fulfillmentOrderReschedule($fulfillAt: DateTime!, $id: ID!) {

fulfillmentOrderReschedule(fulfillAt: $fulfillAt, id: $id) {

fulfillmentOrder {

status

fulfillAt

}

userErrors {

field

message

}

}`,

{

variables: {

"id": "gid://shopify/FulfillmentOrder/564786110",

"fulfillAt": "2024-11-25T18:40:54Z"

);

const data = await response.json();

mutation fulfillmentOrderReschedule($fulfillAt: DateTime!, $id: ID!) {
  fulfillmentOrderReschedule(fulfillAt: $fulfillAt, id: $id) {
    fulfillmentOrder {
      id
      status
      fulfillAt
    }
    userErrors {
      field
      message
    }
  }
}

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation fulfillmentOrderReschedule($fulfillAt: DateTime!, $id: ID!) { fulfillmentOrderReschedule(fulfillAt: $fulfillAt, id: $id) { fulfillmentOrder { id status fulfillAt } userErrors { field message } } }",
 "variables": {
    "id": "gid://shopify/FulfillmentOrder/564786110",
    "fulfillAt": "2024-11-25T18:40:54Z"
  }
}'

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(
  `#graphql
  mutation fulfillmentOrderReschedule($fulfillAt: DateTime!, $id: ID!) {
    fulfillmentOrderReschedule(fulfillAt: $fulfillAt, id: $id) {
      fulfillmentOrder {
        id
        status
        fulfillAt
      }
      userErrors {
        field
        message
      }
    }
  }`,
  {
    variables: {
      "id": "gid://shopify/FulfillmentOrder/564786110",
      "fulfillAt": "2024-11-25T18:40:54Z"
    },
  },
);

const data = await response.json();

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation fulfillmentOrderReschedule($fulfillAt: DateTime!, $id: ID!) {
      fulfillmentOrderReschedule(fulfillAt: $fulfillAt, id: $id) {
        fulfillmentOrder {
          id
          status
          fulfillAt
        }
        userErrors {
          field
          message
        }
      }
    }`,
    "variables": {
      "id": "gid://shopify/FulfillmentOrder/564786110",
      "fulfillAt": "2024-11-25T18:40:54Z"
    },
  },
});

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation fulfillmentOrderReschedule($fulfillAt: DateTime!, $id: ID!) {
    fulfillmentOrderReschedule(fulfillAt: $fulfillAt, id: $id) {
      fulfillmentOrder {
        id
        status
        fulfillAt
      }
      userErrors {
        field
        message
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/FulfillmentOrder/564786110",
  "fulfillAt": "2024-11-25T18:40:54Z"
}

response = client.query(query: query, variables: variables)

Input variables

JSON

{

"id": "gid://shopify/FulfillmentOrder/564786110",

"fulfillAt": "2024-11-25T18:40:54Z"

}

Response

JSON

{

"fulfillmentOrderReschedule": {

"fulfillmentOrder": {

"id": "gid://shopify/FulfillmentOrder/564786110",

"status": "SCHEDULED",

"fulfillAt": "2024-11-25T18:40:54Z"

"userErrors": []

}