Fulfillment - admin-graphql - OBJECT

Version: 2024-10

Description:

Represents a fulfillment. In Shopify, a fulfillment represents a shipment of one or more items in an order. When an order has been completely fulfilled, it means that all the items that are included in the order have been sent to the customer. There can be more than one fulfillment for an order.

Access Scopes

`read_orders` access scope, `read_marketplace_orders` access scope, `read_assigned_fulfillment_orders` access scope, `read_merchant_managed_fulfillment_orders` access scope, `read_third_party_fulfillment_orders` access scope or `read_marketplace_fulfillment_orders` access scope.

Fields

• createdAt: DateTime! - The date and time when the fulfillment was created.
• deliveredAt: DateTime - The date that this fulfillment was delivered.
• displayStatus: FulfillmentDisplayStatus - Human readable display status for this fulfillment.
• estimatedDeliveryAt: DateTime - The estimated date that this fulfillment will arrive.
• id: ID! - A globally-unique ID.
• inTransitAt: DateTime - The date and time when the fulfillment went into transit.
• legacyResourceId: UnsignedInt64! - The ID of the corresponding resource in the REST Admin API.
• location: Location - The location that the fulfillment was processed at.
• name: String! - Human readable reference identifier for this fulfillment.
• order: Order! - The order for which the fulfillment was created.
• originAddress: FulfillmentOriginAddress - The address at which the fulfillment occurred. This field is intended for tax purposes, as a full address is required for tax providers to accurately calculate taxes. Typically this is the address of the warehouse or fulfillment center. To retrieve a fulfillment location's address, use the `assignedLocation` field on the [`FulfillmentOrder`](/docs/api/admin-graphql/latest/objects/FulfillmentOrder) object instead.
• requiresShipping: Boolean! - Whether any of the line items in the fulfillment require shipping.
• service: FulfillmentService - Fulfillment service associated with the fulfillment.
• status: FulfillmentStatus! - The status of the fulfillment.
• totalQuantity: Int! - Sum of all line item quantities for the fulfillment.
• trackingInfo: FulfillmentTrackingInfo! - Tracking information associated with the fulfillment, such as the tracking company, tracking number, and tracking URL.
• updatedAt: DateTime! - The date and time when the fulfillment was last modified.

Connections

• events: FulfillmentEventConnection!
• fulfillmentLineItems: FulfillmentLineItemConnection!
• fulfillmentOrders: FulfillmentOrderConnection!

Related queries

• fulfillment Returns a Fulfillment resource by ID.

Related mutations

• fulfillmentCancel Cancels a fulfillment.
• fulfillmentCreate Creates a fulfillment for one or many fulfillment orders. The fulfillment orders are associated with the same order and are assigned to the same location.
• fulfillmentCreateV2 Creates a fulfillment for one or many fulfillment orders. The fulfillment orders are associated with the same order and are assigned to the same location.
• fulfillmentTrackingInfoUpdate Updates tracking information for a fulfillment.
• fulfillmentTrackingInfoUpdateV2 Updates tracking information for a fulfillment.

Related Unions

Examples

• Receive a single Fulfillment

          Curl example: "curl -X POST \\\nhttps://your-development-store.myshopify.com/admin/api/2024-10/graphql.json \\\n-H 'Content-Type: application/json' \\\n-H 'X-Shopify-Access-Token: {access_token}' \\\n-d '{\n\"query\": \"query FulfillmentShow($id: ID!) { fulfillment(id: $id) { fulfillmentLineItems(first: 10) { edges { node { id lineItem { title variant { id } } quantity originalTotalSet { shopMoney { amount currencyCode } } } } } status estimatedDeliveryAt location { id legacyResourceId } service { handle } trackingInfo(first: 10) { company number url } originAddress { address1 address2 city countryCode provinceCode zip } } }\",\n \"variables\": {\n    \"id\": \"gid://shopify/Fulfillment/237894043\"\n  }\n}'\n"
          Node example: "const client = new shopify.clients.Graphql({session});\nconst data = await client.query({\n  data: {\n    \"query\": `query FulfillmentShow($id: ID!) {\n      fulfillment(id: $id) {\n        fulfillmentLineItems(first: 10) {\n          edges {\n            node {\n              id\n              lineItem {\n                title\n                variant {\n                  id\n                }\n              }\n              quantity\n              originalTotalSet {\n                shopMoney {\n                  amount\n                  currencyCode\n                }\n              }\n            }\n          }\n        }\n        status\n        estimatedDeliveryAt\n        location {\n          id\n          legacyResourceId\n        }\n        service {\n          handle\n        }\n        trackingInfo(first: 10) {\n          company\n          number\n          url\n        }\n        originAddress {\n          address1\n          address2\n          city\n          countryCode\n          provinceCode\n          zip\n        }\n      }\n    }`,\n    \"variables\": {\n      \"id\": \"gid://shopify/Fulfillment/237894043\"\n    },\n  },\n});\n"
          Ruby example: "session = ShopifyAPI::Auth::Session.new(\n  shop: \"your-development-store.myshopify.com\",\n  access_token: access_token\n)\nclient = ShopifyAPI::Clients::Graphql::Admin.new(\n  session: session\n)\n\nquery = <<~QUERY\n  query FulfillmentShow($id: ID!) {\n    fulfillment(id: $id) {\n      fulfillmentLineItems(first: 10) {\n        edges {\n          node {\n            id\n            lineItem {\n              title\n              variant {\n                id\n              }\n            }\n            quantity\n            originalTotalSet {\n              shopMoney {\n                amount\n                currencyCode\n              }\n            }\n          }\n        }\n      }\n      status\n      estimatedDeliveryAt\n      location {\n        id\n        legacyResourceId\n      }\n      service {\n        handle\n      }\n      trackingInfo(first: 10) {\n        company\n        number\n        url\n      }\n      originAddress {\n        address1\n        address2\n        city\n        countryCode\n        provinceCode\n        zip\n      }\n    }\n  }\nQUERY\n\nvariables = {\n  \"id\": \"gid://shopify/Fulfillment/237894043\"\n}\n\nresponse = client.query(query: query, variables: variables)\n"
          PHP example: "use Shopify\\Clients\\Graphql;\n\n$client = new Graphql(\"your-development-store.myshopify.com\", $accessToken);\n$query = <<<QUERY\n  query FulfillmentShow($id: ID!) {\n    fulfillment(id: $id) {\n      fulfillmentLineItems(first: 10) {\n        edges {\n          node {\n            id\n            lineItem {\n              title\n              variant {\n                id\n              }\n            }\n            quantity\n            originalTotalSet {\n              shopMoney {\n                amount\n                currencyCode\n              }\n            }\n          }\n        }\n      }\n      status\n      estimatedDeliveryAt\n      location {\n        id\n        legacyResourceId\n      }\n      service {\n        handle\n      }\n      trackingInfo(first: 10) {\n        company\n        number\n        url\n      }\n      originAddress {\n        address1\n        address2\n        city\n        countryCode\n        provinceCode\n        zip\n      }\n    }\n  }\nQUERY;\n\n$variables = [\n  \"id\" => \"gid://shopify/Fulfillment/237894043\",\n];\n\n$response = $client->query([\"query\" => $query, \"variables\" => $variables]);\n"
          Remix example: "const { admin } = await authenticate.admin(request);\n\nconst response = await admin.graphql(\n  `#graphql\n  query FulfillmentShow($id: ID!) {\n    fulfillment(id: $id) {\n      fulfillmentLineItems(first: 10) {\n        edges {\n          node {\n            id\n            lineItem {\n              title\n              variant {\n                id\n              }\n            }\n            quantity\n            originalTotalSet {\n              shopMoney {\n                amount\n                currencyCode\n              }\n            }\n          }\n        }\n      }\n      status\n      estimatedDeliveryAt\n      location {\n        id\n        legacyResourceId\n      }\n      service {\n        handle\n      }\n      trackingInfo(first: 10) {\n        company\n        number\n        url\n      }\n      originAddress {\n        address1\n        address2\n        city\n        countryCode\n        provinceCode\n        zip\n      }\n    }\n  }`,\n  {\n    variables: {\n      \"id\": \"gid://shopify/Fulfillment/237894043\"\n    },\n  },\n);\n\nconst data = await response.json();\n"
          Graphql query: "query FulfillmentShow($id: ID!) {\n  fulfillment(id: $id) {\n    fulfillmentLineItems(first: 10) {\n      edges {\n        node {\n          id\n          lineItem {\n            title\n            variant {\n              id\n            }\n          }\n          quantity\n          originalTotalSet {\n            shopMoney {\n              amount\n              currencyCode\n            }\n          }\n        }\n      }\n    }\n    status\n    estimatedDeliveryAt\n    location {\n      id\n      legacyResourceId\n    }\n    service {\n      handle\n    }\n    trackingInfo(first: 10) {\n      company\n      number\n      url\n    }\n    originAddress {\n      address1\n      address2\n      city\n      countryCode\n      provinceCode\n      zip\n    }\n  }\n}"
        

  input: {
    "id": "gid://shopify/Fulfillment/237894043"
  }

  response: {
    "data": {
      "fulfillment": {
        "fulfillmentLineItems": {
          "edges": [
            {
              "node": {
                "id": "gid://shopify/FulfillmentLineItem/761422146",
                "lineItem": {
                  "title": "Draft",
                  "variant": {
                    "id": "gid://shopify/ProductVariant/43729076"
                  }
                },
                "quantity": 2,
                "originalTotalSet": {
                  "shopMoney": {
                    "amount": "20.0",
                    "currencyCode": "USD"
                  }
                }
              }
            }
          ]
        },
        "status": "SUCCESS",
        "estimatedDeliveryAt": null,
        "location": {
          "id": "gid://shopify/Location/124656943",
          "legacyResourceId": "124656943"
        },
        "service": {
          "handle": "manual"
        },
        "trackingInfo": [
          {
            "company": "UPS",
            "number": "1Z1234512345123456",
            "url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z1234512345123456"
          }
        ],
        "originAddress": {
          "address1": "150 Elgin St",
          "address2": null,
          "city": "Ottawa",
          "countryCode": "CA",
          "provinceCode": "ON",
          "zip": "K2P 1L4"
        }
      }
    }
  }

  Retrieves a list of fulfillment events for a specific fulfillment

          Curl example: "curl -X POST \\\nhttps://your-development-store.myshopify.com/admin/api/2024-10/graphql.json \\\n-H 'Content-Type: application/json' \\\n-H 'X-Shopify-Access-Token: {access_token}' \\\n-d '{\n\"query\": \"query FulfillmentEventList($id: ID!) { fulfillment(id: $id) { events(first: 10) { edges { node { happenedAt status } } } } }\",\n \"variables\": {\n    \"id\": \"gid://shopify/Fulfillment/237894043\"\n  }\n}'\n"
          Node example: "const client = new shopify.clients.Graphql({session});\nconst data = await client.query({\n  data: {\n    \"query\": `query FulfillmentEventList($id: ID!) {\n      fulfillment(id: $id) {\n        events(first: 10) {\n          edges {\n            node {\n              happenedAt\n              status\n            }\n          }\n        }\n      }\n    }`,\n    \"variables\": {\n      \"id\": \"gid://shopify/Fulfillment/237894043\"\n    },\n  },\n});\n"
          Ruby example: "session = ShopifyAPI::Auth::Session.new(\n  shop: \"your-development-store.myshopify.com\",\n  access_token: access_token\n)\nclient = ShopifyAPI::Clients::Graphql::Admin.new(\n  session: session\n)\n\nquery = <<~QUERY\n  query FulfillmentEventList($id: ID!) {\n    fulfillment(id: $id) {\n      events(first: 10) {\n        edges {\n          node {\n            happenedAt\n            status\n          }\n        }\n      }\n    }\n  }\nQUERY\n\nvariables = {\n  \"id\": \"gid://shopify/Fulfillment/237894043\"\n}\n\nresponse = client.query(query: query, variables: variables)\n"
          PHP example: "use Shopify\\Clients\\Graphql;\n\n$client = new Graphql(\"your-development-store.myshopify.com\", $accessToken);\n$query = <<<QUERY\n  query FulfillmentEventList($id: ID!) {\n    fulfillment(id: $id) {\n      events(first: 10) {\n        edges {\n          node {\n            happenedAt\n            status\n          }\n        }\n      }\n    }\n  }\nQUERY;\n\n$variables = [\n  \"id\" => \"gid://shopify/Fulfillment/237894043\",\n];\n\n$response = $client->query([\"query\" => $query, \"variables\" => $variables]);\n"
          Remix example: "const { admin } = await authenticate.admin(request);\n\nconst response = await admin.graphql(\n  `#graphql\n  query FulfillmentEventList($id: ID!) {\n    fulfillment(id: $id) {\n      events(first: 10) {\n        edges {\n          node {\n            happenedAt\n            status\n          }\n        }\n      }\n    }\n  }`,\n  {\n    variables: {\n      \"id\": \"gid://shopify/Fulfillment/237894043\"\n    },\n  },\n);\n\nconst data = await response.json();\n"
          Graphql query: "query FulfillmentEventList($id: ID!) {\n  fulfillment(id: $id) {\n    events(first: 10) {\n      edges {\n        node {\n          happenedAt\n          status\n        }\n      }\n    }\n  }\n}"
        

  input: {
    "id": "gid://shopify/Fulfillment/237894043"
  }

  response: {
    "data": {
      "fulfillment": {
        "events": {
          "edges": [
            {
              "node": {
                "happenedAt": "2016-05-02T11:00:00Z",
                "status": "LABEL_PURCHASED"
              }
            },
            {
              "node": {
                "happenedAt": "2016-05-03T11:00:00Z",
                "status": "OUT_FOR_DELIVERY"
              }
            }
          ]
        }
      }
    }
  }