📈

【Shopify.dev和訳】Admin API/GraphQL ref/Shipping & fulfillment③

2021/10/02に公開約48,900字

この記事について

この記事は、Admin APIs/GraphQL reference/Shipping and fulfillmentの記事を和訳したものです。

記事内で使用する画像は、公式ドキュメント内の画像を引用して使用させていただいております。

Shopify アプリのご紹介

Shopify アプリである、「商品ページ発売予告アプリ | リテリア Coming Soon」は、商品ページを買えない状態のまま、発売日時の予告をすることができるアプリです。Shopify で Coming Soon 機能を実現することができます。

https://apps.shopify.com/shopify-application-314?locale=ja&from=daniel

Shopify アプリである、「らくらく日本語フォント設定|リテリア Font Picker」は、ノーコードで日本語フォントを使用できるアプリです。日本語フォントを導入することでブランドを演出することができます。

https://apps.shopify.com/font-picker-1?locale=ja&from=daniel

Shipping and fulfillment APIs (OBJECTS 後半)

FulfillmentEvent

ある時期のフルフィルメントを表すイベントです。

フィールド | Fields

happenedAt (DateTime!)
このフルフィルメントイベントが発生した時間。

id (ID!)
グローバルに一意な識別子。

status (FulfillmentEventStatus!)
このフルフィルメントイベントのステータス。

FulfillmentEvent を返す型 | Types that return FulfillmentEvent

実装 | Implements

複数の FulfillmentEvents をページングするための自動生成される型。

フィールド | Fields

edges ([FulfillmentEventEdge!]!)
エッジのリスト。

pageInfo (PageInfo!)
ページネーションを助けるための情報。

ページネーションの際に 1 つの FulfillmentEvent とカーソルを保持する自動生成タイプ。

フィールド | Fields

cursor (String!)
ページネーションで使用するためのカーソルです。

node (FulfillmentEvent!)
FulfillmentEventEdge の末尾の項目。

FulfillmentEventEdge を返す型 | Types that return FulfillmentEventEdge

サンプル | Samples

Query 1
# フルフィルメントイベントのIDを取得
{
  fulfillment(id: "gid://shopify/Fulfillment/1099547770902") {
    events(first:10) {
      edges {
        node {
          id
        }
      }
    }
  }
}
Response 1
{
  "data": {
    "fulfillment": null
  },
  "extensions": {
    "cost": {
      "requestedQueryCost": 13,
      "actualQueryCost": 1,
      "throttleStatus": {
        "maximumAvailable": 1000,
        "currentlyAvailable": 967,
        "restoreRate": 50
      }
    }
  }
}
Query 2
# フルフィルメントイベントのステータス取得
{
  fulfillment(id: "gid://shopify/Fulfillment/1099547770902") {
    events(first:10) {
      edges {
        node {
          id
          status
        }
      }
    }
  }
}
Response 2
{
  "data": {
    "fulfillment": null
  },
  "extensions": {
    "cost": {
      "requestedQueryCost": 13,
      "actualQueryCost": 1,
      "throttleStatus": {
        "maximumAvailable": 1000,
        "currentlyAvailable": 999,
        "restoreRate": 50
      }
    }
  }
}
Query 3
# フルフィルメントイベントが発生した時刻を取得する
{
  fulfillment(id: "gid://shopify/Fulfillment/1099547770902") {
    events(first:10) {
      edges {
        node {
          id
          status
          happenedAt
        }
      }
    }
  }
}
Response 3
{
  "data": {
    "fulfillment": null
  },
  "extensions": {
    "cost": {
      "requestedQueryCost": 13,
      "actualQueryCost": 1,
      "throttleStatus": {
        "maximumAvailable": 1000,
        "currentlyAvailable": 999,
        "restoreRate": 50
      }
    }
  }
}

FulfillmentHold

フルフィルメントオーダーに現在適用されている保留状態です。

フィールド | Fields

  • reason (FulfillmentHoldReason!)
    フルフィルメントを保留状態にしている理由です。

  • reasonNotes (String)
    保留状態の理由に関する追加情報。

FulfillmentHold を返す型 | Types that return FulfillmentHold

FulfillmentLineItem

フルフィルメントに含まれるオーダーのラインアイテムを表します。

フィールド | Fields

discountedTotalSet (MoneyBag!)
割引適用後の合計金額をショップ通貨とプレセント通貨で表したもの。

id (ID!)
グローバルに一意な識別子。

lineItem (LineItem!)
関連する注文のラインアイテム。

originalTotalSet (MoneyBag!)
ストア通貨と表示されている通貨での割引適用前の合計金額。

quantity (Int)
フルフィルメントのラインアイテムの数。

FulfillmentLineItem を返す型 | Types that return FulfillmentLineItem

実装 | Implements

非推奨フィールド | Deprecated fields

  • discountedTotal (Money!) deprecated
    割引適用後の合計金額です。
  • originalTotal (Money!) deprecated
    割引を適用する前の合計金額です。

複数の FulfillmentLineItems をページングするための自動生成される型です。

フィールド | Fields

edges ([FulfillmentLineItemEdge!]!)
エッジのリストです。

pageInfo (PageInfo!)
ページネーションを補助する情報。

ページネーションの際に 1 つの FulfillmentLineItem とカーソルを保持する自動生成タイプ。

フィールド | Fields

cursor (String!)
ページネーションで使用するためのカーソルです。

node (FulfillmentLineItem!)
FulfillmentLineItemEdge の末尾のアイテム。

FulfillmentLineItem を返す型 | Types that return FulfillmentLineItem

サンプル | Samples

Query 1
# フルフィルメントラインアイテムのIDを取得
{
  fulfillment(id: "gid://shopify/Fulfillment/1114431586326") {
    fulfillmentLineItems(first:10) {
      edges {
        node {
          lineItem {
            id
          }
        }
      }
    }
  }
}
Response 1
{
  "data": {
    "fulfillment": {
      "fulfillmentLineItems": {
        "edges": [
          {
            "node": {
              "lineItem": {
                "id": "gid://shopify/LineItem/2941902258198"
              }
            }
          }
        ]
      }
    }
  },
  "extensions": {
    "cost": {
      "requestedQueryCost": 23,
      "actualQueryCost": 5,
      "throttleStatus": {
        "maximumAvailable": 1000,
        "currentlyAvailable": 948,
        "restoreRate": 50
      }
    }
  }
}
Query 2
# フルフィルメントのラインアイテム数の取得
{
  fulfillment(id: "gid://shopify/Fulfillment/1114431586326") {
    fulfillmentLineItems(first:10) {
      edges {
        node {
          lineItem {
            id
            quantity
          }
        }
      }
    }
  }
}

Response 2
{
  "data": {
    "fulfillment": {
      "fulfillmentLineItems": {
        "edges": [
          {
            "node": {
              "lineItem": {
                "id": "gid://shopify/LineItem/2941902258198",
                "quantity": 1
              }
            }
          }
        ]
      }
    }
  },
  "extensions": {
    "cost": {
      "requestedQueryCost": 23,
      "actualQueryCost": 5,
      "throttleStatus": {
        "maximumAvailable": 1000,
        "currentlyAvailable": 995,
        "restoreRate": 50
      }
    }
  }
}
Query 3
# フルフィルメントラインアイテムの割引価格情報の取得
{
  fulfillment(id: "gid://shopify/Fulfillment/1114431586326") {
    fulfillmentLineItems(first:10) {
      edges {
        node {
          id
          discountedTotalSet {
            shopMoney {
              amount
              currencyCode
            }
            presentmentMoney {
              amount
              currencyCode
            }
          }
          lineItem {
            id
          }
          originalTotalSet {
            shopMoney {
              amount
              currencyCode
            }
            presentmentMoney {
              amount
              currencyCode
            }
          }
          quantity
        }
      }
    }
  }
}

Response 3
{
  "data": {
    "fulfillment": {
      "fulfillmentLineItems": {
        "edges": [
          {
            "node": {
              "id": "gid://shopify/FulfillmentLineItem/2187873026070",
              "discountedTotalSet": {
                "shopMoney": {
                  "amount": "9314.0",
                  "currencyCode": "CAD"
                },
                "presentmentMoney": {
                  "amount": "9314.0",
                  "currencyCode": "CAD"
                }
              },
              "lineItem": {
                "id": "gid://shopify/LineItem/2941902258198"
              },
              "originalTotalSet": {
                "shopMoney": {
                  "amount": "9314.0",
                  "currencyCode": "CAD"
                },
                "presentmentMoney": {
                  "amount": "9314.0",
                  "currencyCode": "CAD"
                }
              },
              "quantity": 1
            }
          }
        ]
      }
    }
  },
  "extensions": {
    "cost": {
      "requestedQueryCost": 43,
      "actualQueryCost": 7,
      "throttleStatus": {
        "maximumAvailable": 1000,
        "currentlyAvailable": 993,
        "restoreRate": 50
      }
    }
  }
}

FulfillmentOrder

接続先 | Connections

fulfillments (FulfillmentConnection!)
フルフィルメント注文のフルフィルメントのリストです。

Argument Description
after (String) 指定されたカーソルの後にある要素を返します。
before (String) 指定されたカーソルの前にある要素を返します。
first (Int) リストの最初から n 個目の要素までを返します。
last (Int) リストの最後から n 個目の要素までを返します。
reverse (Boolean) 対象となるリストの順序を逆にします。
デフォルト値 : false

lineItems (FulfillmentOrderLineItemConnection!)
フルフィルメントオーダーのラインアイテムのリストです。

Argument Description
after (String) 指定されたカーソルの後にある要素を返します。
before (String) 指定されたカーソルの前にある要素を返します。
first (Int) リストの最初から n 個目の要素までを返します。
last (Int) リストの最後から n 個目の要素までを返します。
reverse (Boolean) 対象となるリストの順序を逆にします。
デフォルト値 : false

locationsForMove (FulfillmentOrderLocationForMoveConnection!)
フルフィルメントオーダーが移動できる可能性のあるロケーションのリスト。

Argument Description
after (String) 指定されたカーソルの後にある要素を返します。
before (String) 指定されたカーソルの前にある要素を返します。
first (Int) リストの最初から n 個目の要素までを返します。
last (Int) リストの最後から n 個目の要素までを返します。
reverse (Boolean) 対象となるリストの順序を逆にします。
デフォルト値 : false

merchantRequests (FulfilmentOrderMerchantRequestConnection!)
マーチャントがこのフルフィルメントオーダーのためにフルフィルメントサービスに送ったリクエストのリストです。

Argument Description
after (String) 指定されたカーソルの後にある要素を返します。
before (String) 指定されたカーソルの前にある要素を返します。
first (Int) リストの最初から n 個目の要素までを返します。
kind (FulfillmentOrderMerchantRequestKind) マーチャントが送信したリクエストの種類です。
last (Int) リストの最後から n 個目の要素までを返します。
reverse (Boolean) 対象となるリストの順序を逆にします。
デフォルト値 : false

フィールド | Fields

assignedLocation (FulfillmentOrderAssignedLocation!)
フルフィルメントオーダーの割り当てロケーション。これはフルフィルメントを実行すると予想される場所です。

deliveryMethod (DeliveryMethod)
このフルフィルメントオーダーの配送方法。

destination (FulfillmentOrderDestination)
アイテムを送るべき宛先です。

fulfillAt (DateTime)
フルフィルメントオーダーがフルフィルメント可能になる日付と時間。

id (ID!)
グローバルに一意な識別子。

internationalDuties (FulfillmentOrderInternationalDuties)
このフルフィルメントオーダーの関税配送方法。

order (Order!)
フルフィルメントオーダーに関連するオーダー。

requestStatus (FulfillmentOrderRequestStatus!)
フルフィルメントオーダーのリクエストステータスです。

status (FulfillmentOrderStatus!)
フルフィルメントオーダーのステータス。

supportedActions ([FulfillmentOrderSupportedAction!]!)
このフルフィルメントオーダーに対して実行可能なアクション。

FulfillmentOrder を返す型 | Types that return FulfillmentOrder

FulfillmentOrder のミューテーション | Mutations for FulfillmentOrder

fulfillmentOrderAcceptCancellationRequest
フルフィルメントオーダーのためにフルフィルメントサービスに送信されたキャンセルリクエストを受け入れる。

fulfillmentOrderAcceptFulfillmentRequest
フルフィルメントオーダーのためにフルフィルメントサービスに送信されたフルフィルメントリクエストを受理する。

fulfillmentOrderCancel
フルフィルメント注文をキャンセルしたとマークします。

fulfillmentOrderClose
フルフィルメント サービスが残りのアイテムを出荷することができず、フルフィルメント オーダーをクローズすることを示す、進行中のフルフィルメント オーダーを不完全としてマークします。

fulfillmentOrderMove
フルフィルメント注文を新しい場所に移動する。

fulfillmentOrderOpen
予定されているフルフィルメントオーダーをオープンとしてマークします。

fulfillmentOrderRejectCancellationRequest
フルフィルメントオーダーのためにフルフィルメントサービスに送られたキャンセル要求を拒否する。

fulfillmentOrderRejectFulfillmentRequest
フルフィルメントオーダーのためにフルフィルメントサービスに送られたフルフィルメントリクエストを拒否する。

fulfillmentOrderReschedule
スケジュールされたフルフィルメントオーダーを再スケジュールします。

fulfillmentOrderSubmitCancellationRequest
フルフィルメントオーダーのフルフィルメントサービスにキャンセル要求を送信します。

fulfillmentOrderSubmitFulfillmentRequest
フルフィルメントオーダーのフルフィルメントサービスにフルフィルメントリクエストを送信します。

実装 | Implements

複数の FulfillmentOrders をページングするための自動生成される型です。

フィールド | Fields

edges ([FulfillmentOrderEdge!]!)
エッジのリスト。

pageInfo (PageInfo!)
ページネーションを補助するための情報。

ページネーションの際に 1 つの FulfillmentOrder とカーソルを保持する自動生成される型。

フィールド | Fields

cursor (String!)
ページネーションで使用するためのカーソルです。

node (FulfillmentOrder!)
FulfillmentOrderEdge の末尾の項目。

FulfillmentOrder を返す型 | Types that return FulfillmentOrder

サンプル | Samples

Query 1
# 最初の10件のフルフィルメントオーダーを獲得
{
  shop {
    fulfillmentOrders(first:10) {
      edges {
        node {
          id
        }
      }
    }
  }
}

Response 1
{
  "data": {
    "shop": {
      "fulfillmentOrders": {
        "edges": [
          {
            "node": {
              "id": "gid://shopify/FulfillmentOrder/5018595655702"
            }
          },
          {
            "node": {
              "id": "gid://shopify/FulfillmentOrder/5018596212758"
            }
          },
          {
            "node": {
              "id": "gid://shopify/FulfillmentOrder/5020238807062"
            }
          },
          {
            "node": {
              "id": "gid://shopify/FulfillmentOrder/5020238839830"
            }
          },
          {
            "node": {
              "id": "gid://shopify/FulfillmentOrder/5020238872598"
            }
          },
          {
            "node": {
              "id": "gid://shopify/FulfillmentOrder/5020238905366"
            }
          },
          {
            "node": {
              "id": "gid://shopify/FulfillmentOrder/5021076324374"
            }
          }
        ]
      }
    }
  },
  "extensions": {
    "cost": {
      "requestedQueryCost": 13,
      "actualQueryCost": 10,
      "throttleStatus": {
        "maximumAvailable": 1000,
        "currentlyAvailable": 990,
        "restoreRate": 50
      }
    }
  }
}
Query 2
# フルフィルメントオーダーに関連するオーダーの取得
{
  fulfillmentOrder(id: "gid://shopify/FulfillmentOrder/323409412118") {
    order {
      id
    }
  }
}

Response 2
{
  "data": {
    "fulfillmentOrder": {
      "order": {
        "id": "gid://shopify/Order/1248358563862"
      }
    }
  },
  "extensions": {
    "cost": {
      "requestedQueryCost": 2,
      "actualQueryCost": 2,
      "throttleStatus": {
        "maximumAvailable": 1000,
        "currentlyAvailable": 998,
        "restoreRate": 50
      }
    }
  }
}
Query 3
# フルフィルメントオーダーのステータス取得
{
  fulfillmentOrder(id: "gid://shopify/FulfillmentOrder/323409412118") {
    status
  }
}

Response 3
{
  "data": {
    "fulfillmentOrder": {
      "status": "CLOSED"
    }
  },
  "extensions": {
    "cost": {
      "requestedQueryCost": 1,
      "actualQueryCost": 1,
      "throttleStatus": {
        "maximumAvailable": 1000,
        "currentlyAvailable": 999,
        "restoreRate": 50
      }
    }
  }
}
Query 4
# フルフィルメント時に商品を配送する宛先を取得します。
{
  order(id: "gid://shopify/Order/1248358563862") {
    fulfillmentOrders(first: 10) {
      edges {
        node {
          id
          status
          destination {
            address1
            address2
            city
            company
            countryCode
            province
            zip
            firstName
            lastName
            phone
          }
        }
      }
    }
  }
}

Response 4
{
  "data": {
    "order": {
      "fulfillmentOrders": {
        "edges": [
          {
            "node": {
              "id": "gid://shopify/FulfillmentOrder/323409412118",
              "status": "CLOSED",
              "destination": {
                "address1": "123 Fake Street",
                "address2": "111",
                "city": "Vancouver",
                "company": "Shopify",
                "countryCode": "CA",
                "province": "British Columbia",
                "zip": "V6Z0A3",
                "firstName": "John",
                "lastName": "Doe",
                "phone": "16045555555"
              }
            }
          }
        ]
      }
    }
  },
  "extensions": {
    "cost": {
      "requestedQueryCost": 23,
      "actualQueryCost": 5,
      "throttleStatus": {
        "maximumAvailable": 1000,
        "currentlyAvailable": 854,
        "restoreRate": 50
      }
    }
  }
}

FulfillmentOrderAssignedLocation

フルフィルメントオーダーが作成された場所のスナップショットである、フルフィルメントオーダーの割り当てられた場所を表します。

割り当てられたロケーションは、フルフィルメントを実行することが予想される。

フィールド | Fields

address1 (String)
ロケーションの住所の 1 行目です。

address2 (String)
ロケーションの住所の 2 行目。

city (String)
ローケーションの都市名。

countryCode (CountryCode!)
ロケーションの 2 文字の国コード。

location (Location)
フルフィルメントオーダーが作成された場所です。

フルフィルメントオーダーが閉じられた後にロケーションが更新された場合、FulfillmentOrderAssignedLocation と異なる可能性があります。

name (String!)
ロケーションの名前です。

phone (String)
ロケーションの電話番号。

province (String)
ロケーションの都道府県。

zip (String)
ロケーションの郵便番号。

FulfillmentOrderAssignedLocation を返す型 | Types that return FulfillmentOrderAssignedLocation

FulfillmentOrderDestination

フルフィルメント時に商品を配送する宛先を表します。

フィールド | Fields

address1 (String)
宛先のアドレスの 1 行目。

address2 (String)
目的地の住所の 2 行目。

city (String)
送信先の都市名

company (String)
目的地の会社名

countryCode (CountryCode)
目的地の 2 文字の国コード。

email (String)
送信先のお客様の E メールです。

firstName (String)
目的地での顧客のファーストネーム。

id (ID!)
グローバルに一意な識別子。

lastName (String)
目的地での顧客のラストネームです。

phone (String)
目的地での顧客の電話番号。

province (String)
目的地の都道府県。

zip (String)
目的地の郵便番号

FulfillmentOrderDestination を返す型 | Types that return FulfillmentOrderDestination

実装 | Implements

サンプル | Samples

Query 1
# フルフィルメントオーダーの宛先IDを取得
{
  order(id: "gid://shopify/Order/1248358563862") {
    fulfillmentOrders(first: 10) {
      edges {
        node {
          id
          destination {
            id
          }
        }
      }
    }
  }
}
Response 1
{
  "data": {
    "order": {
      "fulfillmentOrders": {
        "edges": [
          {
            "node": {
              "id": "gid://shopify/FulfillmentOrder/323409412118",
              "destination": {
                "id": "gid://shopify/FulfillmentOrderDestination/1741217562646"
              }
            }
          }
        ]
      }
    }
  },
  "extensions": {
    "cost": {
      "requestedQueryCost": 23,
      "actualQueryCost": 5,
      "throttleStatus": {
        "maximumAvailable": 1000,
        "currentlyAvailable": 995,
        "restoreRate": 50
      }
    }
  }
}
Query 2
# フルフィルメント時に商品を配送する宛先を取得します。
{
  order(id: "gid://shopify/Order/1248358563862") {
    fulfillmentOrders(first: 10) {
      edges {
        node {
          id
          destination {
            address1
            address2
            city
            company
            countryCode
            province
            zip
            firstName
            lastName
            phone
          }
        }
      }
    }
  }
}
Response 2
{
  "data": {
    "order": {
      "fulfillmentOrders": {
        "edges": [
          {
            "node": {
              "id": "gid://shopify/FulfillmentOrder/323409412118",
              "destination": {
                "address1": "123 Fake Street",
                "address2": "111",
                "city": "Vancouver",
                "company": "Shopify",
                "countryCode": "CA",
                "province": "British Columbia",
                "zip": "V6Z0A3",
                "firstName": "John",
                "lastName": "Doe",
                "phone": "16045555555"
              }
            }
          }
        ]
      }
    }
  },
  "extensions": {
    "cost": {
      "requestedQueryCost": 23,
      "actualQueryCost": 5,
      "throttleStatus": {
        "maximumAvailable": 1000,
        "currentlyAvailable": 995,
        "restoreRate": 50
      }
    }
  }
}

FulfillmentOrderInternationalDuties

フルフィルメントオーダーに関連する国際的な業務。

フィールド | Fields

incoterm (String!)
関税の支払い方法です。

FulfillmentOrderInternationalDuties を返す型 | Types that return FulfillmentOrderInternationalDuties

FulfillmentOrderLineItem

フルフィルメントオーダーに属するラインアイテムを表します。

フィールド | Fields

id (ID!)
グローバルに一意な識別子です。

lineItem (LineItem!)
関連する注文のラインアイテムです。

remainingQuantity (Int!)
フルフィルメント可能な残りのユニットの数。

totalQuantity (Int!)
フルフィルメントされるべきユニットの合計数。

FulfillmentOrderLineItem を返す型 | Types that return FulfillmentOrderLineItem

実装 | Implements

複数の FulfillmentOrderLineItems をページングするための自動生成される型。

フィールド | Fields

edges ([FulfillmentOrderLineItemEdge!]!)
エッジのリストです。

pageInfo (PageInfo!)
ページネーションを補助するための情報。

ページネーションの際に、1 つの FulfillmentOrderLineItem とカーソルを保持する自動生成タイプです。

フィールド | Fields

cursor (String!)
ページネーションで使用するためのカーソルです。

node (FulfillmentOrderLineItem!)
FulfillmentOrderLineItemEdge の末尾のアイテム。

FulfillmentOrderLineItemEdge を返す型 | Types that return FulfillmentOrderLineItemEdge

サンプル | Samples

Query 1
# フルフィルメントオーダーのラインアイテムIDの取得
{
  order(id: "gid://shopify/Order/1248358563862") {
    fulfillmentOrders(first: 10) {
      edges {
        node {
          id
          lineItems(first: 10) {
            edges {
              node {
                id
              }
            }
          }
        }
      }
    }
  }
}

Response 1
{
  "data": {
    "order": {
      "fulfillmentOrders": {
        "edges": [
          {
            "node": {
              "id": "gid://shopify/FulfillmentOrder/323409412118",
              "lineItems": {
                "edges": [
                  {
                    "node": {
                      "id": "gid://shopify/FulfillmentOrderLineItem/512149848086"
                    }
                  }
                ]
              }
            }
          }
        ]
      }
    }
  },
  "extensions": {
    "cost": {
      "requestedQueryCost": 133,
      "actualQueryCost": 7,
      "throttleStatus": {
        "maximumAvailable": 1000,
        "currentlyAvailable": 993,
        "restoreRate": 50
      }
    }
  }
}
Query 2
# フルフィルメントオーダーに属するラインアイテムの取得
{
  order(id: "gid://shopify/Order/1248358563862") {
    fulfillmentOrders(first: 10) {
      edges {
        node {
          id
          lineItems(first: 10) {
            edges {
              node {
                id
                totalQuantity
                remainingQuantity
                lineItem {
                  variant {
                    id
                    displayName
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
Response 2
{
  "data": {
    "order": {
      "fulfillmentOrders": {
        "edges": [
          {
            "node": {
              "id": "gid://shopify/FulfillmentOrder/323409412118",
              "lineItems": {
                "edges": [
                  {
                    "node": {
                      "id": "gid://shopify/FulfillmentOrderLineItem/512149848086",
                      "totalQuantity": 1,
                      "remainingQuantity": 0,
                      "lineItem": {
                        "variant": {
                          "id": "gid://shopify/ProductVariant/19523143303190",
                          "displayName": "Ancient Paper Shirt - Default Title"
                        }
                      }
                    }
                  }
                ]
              }
            }
          }
        ]
      }
    }
  },
  "extensions": {
    "cost": {
      "requestedQueryCost": 333,
      "actualQueryCost": 9,
      "throttleStatus": {
        "maximumAvailable": 1000,
        "currentlyAvailable": 991,
        "restoreRate": 50
      }
    }
  }
}

FulfillmentOrderLocationForMove

フルフィルメントオーダーが移動する可能性のある場所。

フィールド | Fields

location (Location!)
フルフィルメントオーダーの新しい割り当てロケーションとして考慮されるロケーション。

message (String)
フルフィルメントオーダー、またはそのラインアイテムの一部がロケーションに移動できない理由を示す人間が読める文字列。

movable (Boolean!)
フルフィルメントオーダーがその場所に移動できるかどうか。

FulfillmentOrderLocationForMove を返す型 | Types that return FulfillmentOrderLocationForMove

複数の FulfillmentOrderLocationForMove をページングするための自動生成される型。

フィールド | Fields

edges ([FulfillmentOrderLocationForMoveEdge!]!)
エッジのリスト。

pageInfo (PageInfo!)
ページネーションを補助するための情報。

複数の FulfillmentOrderLocationForMove をページングするための自動生成される型。

フィールド | Fields

cursor (String!)
ページネーションで使用するためのカーソルです。

node (FulfillmentOrderLocationForMove!)
FulfillmentOrderLocationForMoveEdge の末尾の項目。

FulfillmentOrderLocationForMoveEdge を返す型 | Types that return FulfillmentOrderLocationForMoveEdge

FulfillmentOrderMerchantRequest

マーチャントがフルフィルメントサービスに行うフルフィルメントオーダーのリクエストを表します。

フィールド | Fields

id (ID!)
グローバルに一意な識別子です。

kind (FulfillmentOrderMerchantRequestKind!)
リクエストの種類。

message (String)
マーチャントがリクエストに含めたオプションのメッセージ。

requestOptions (JSON)
マーチャントが要求した追加オプションです。

これらはリクエストの kind に依存します。

例えば、FULFILLMENT_REQUESTの場合、1 つのオプションはnotify_customerで、これはマーチャントがフルフィルメント時に顧客に通知するつもりがあるかどうかを示します。

フルフィルメントサービスは、FulfillmentCreateV2を呼び出す際にnotifyCustomerを設定することができます。

responseData (JSON)
フルフィルメントサービスからのレスポンス。

sentAt (DateTime!)
リクエストが行われたタイムスタンプ。

FulfillmentOrderMerchantRequest を返す型 | Types that return FulfillmentOrderMerchantRequest

実装 | Implements

複数の FulfillmentOrderMerchantRequests をページングするために自動生成される型。

フィールド | Fields

edges ([FulfillmentOrderMerchantRequestEdge!]!)
エッジのリストです。

pageInfo (PageInfo!)
ページネーションを補助するための情報。

ページネーション時に 1 つの FulfillmentOrderMerchantRequest とカーソルを保持する自動生成される型です。

フィールド | Fields

cursor (String!)
ページネーションで使用するカーソルです。

node (FulfillmentOrderMerchantRequest!)
FulfillmentOrderMerchantRequestEdge の末尾の項目。

FulfillmentOrderMerchantRequestEdge を返す型 | Types that return FulfillmentOrderMerchantRequestEdge

サンプル | Samples

Query 1
# フルフィルメントオーダーに関連する最初の10件のマーチャントリクエストを取得する
{
  fulfillmentOrder(id: "gid://shopify/FulfillmentOrder/323409412118") {
    merchantRequests(first:10) {
      edges {
        node {
          id
          kind
          message
          requestOptions
          responseData
          sentAt
        }
      }
    }
  }
}
Response 1
{
  "data": {
    "fulfillmentOrder": {
      "merchantRequests": {
        "edges": []
      }
    }
  },
  "extensions": {
    "cost": {
      "requestedQueryCost": 13,
      "actualQueryCost": 3,
      "throttleStatus": {
        "maximumAvailable": 1000,
        "currentlyAvailable": 997,
        "restoreRate": 50
      }
    }
  }
}

FulfillmentOrderSupportedAction

フルフィルメントオーダーがサポートするメソッドの 1 つを表します。

フィールド | Fields

action (FulfillmentOrderAction!)
アクションの値です。

externalUrl (URL)
Shopify の外でフルフィルメントプロセスを開始するために使用する外部 URL。

FulfillmentOrderSupportedAction を返す型 | Types that return FulfillmentOrderSupportedAction

FulfillmentOriginAddress

フルフィルメントが発生したアドレスを表します。

フィールド | Fields

address1 (String)
フルフィルメントする場所の住所。

address2 (String)
住所の 2 行目。通常は、アパート、スイート、またはユニットの番号です。

city (String)
フルフィルメント施設がある都市。

countryCode (String!)
フルフィルメントの所在地の国。

provinceCode (String)
フルフィルメントの所在地の都道府県。

zip (String)
フルフィルメントの所在地の郵便番号。

FulfillmentOriginAddress を返す型 | Types that return FulfillmentOriginAddress

FulfillmentService

フルフィルメントサービスを表します。

フルフィルメントサービスとは、ストアオーナーに代わって注文の準備や発送を行うサードパーティのサービスです。

フィールド | Fields

callbackUrl (URL)
フルフィルメントサービスがリクエスト用に登録したコールバック URL です。

fulfillmentOrdersOptIn (Boolean!)
フルフィルメントサービスがフルフィルメントオーダーベースのリクエストを選択しているかどうか。

handle (String!)
このフルフィルメントサービスの人間が読める一意の識別子。

id (ID!)
フルフィルメント・サービスの ID。

inventoryManagement (Boolean!)
フルフィルメントサービスが製品在庫を追跡し、Shopify に更新情報を提供するかどうか。

location (Location)
フルフィルメントサービスに関連するロケーション。

productBased (Boolean!)
フルフィルメントサービスがローカル配送をサポートするかどうか。

serviceName (String!)
マーチャントから見たフルフィルメントサービスの名前。

shippingMethods ([ShippingMethod!]!)
フルフィルメント・サービス・プロバイダに関連する配送方法。

type (FulfillmentServiceType!)
フルフィルメントサービスに関連するタイプ。

FulfillmentService を返す型 | Types that return FulfillmentService

FulfillmentService のミューテーション | Mutations for FulfillmentService

fulfillmentServiceCreate
フルフィルメントサービスを作成します。

fulfillmentServiceDelete
フルフィルメントサービスを削除します。

fulfillmentServiceUpdate
フルフィルメントサービスを更新します。

FulfillmentTrackingInfo

フルフィルメントのトラッキング情報を表します。

フィールド | Fields

company (String)
追跡会社の名前です。

number (String)
フルフィルメントのトラッキング番号。

url (URL)
フルフィルメントをトラッキングするための URL。

FulfillmentTrackingInfo を返す型 | Types that return FulfillmentTrackingInfo

FulfillmentTrackingInfo のミューテーション | Mutations for FulfillmentTrackingInfo

fulfillmentTrackingInfoUpdateV2

フルフィルメントのトラッキング情報を更新します。

ShippingMethod

フルフィルメントのトラッキング情報を表します。

フィールド | Fields

code (String!)
料金に関連する固有のコード。例:expedited_mail

label (String!)
お客様がチェックアウト時に表示される、料金の説明です。例:Includes tracking and insurance

ShippingMethod を返す型 | Types that return ShippingMethod

ShippingRate

注文時に適用される配送料。

フィールド | Fields

handle (String!)
この配送料金の人間が読める一意の識別子。

price (MoneyV2!)
この配送レートの価格。

title (String!)
この配送料金のタイトル。

ShippingRate を返す型 | Types that return ShippingRate

Shopify アプリのご紹介

Shopify アプリである、「商品ページ発売予告アプリ | リテリア Coming Soon」は、商品ページを買えない状態のまま、発売日時の予告をすることができるアプリです。Shopify で Coming Soon 機能を実現することができます。

https://apps.shopify.com/shopify-application-314?locale=ja&from=daniel

Shopify アプリである、「らくらく日本語フォント設定|リテリア Font Picker」は、ノーコードで日本語フォントを使用できるアプリです。日本語フォントを導入することでブランドを演出することができます。

https://apps.shopify.com/font-picker-1?locale=ja&from=daniel

Discussion

ログインするとコメントできます