3月 05, 2026

FulfillmentOrderの移動と保留操作が、特定のラインアイテムを受け入れるようになりました

3月 05, 2026

特定のラインアイテムに対応したFulfillmentOrderの移動と保留操作

技術的な課題の定義と現状分析

これまで、ShopifyのAPIでは、FulfillmentOrderの保留と移動操作が全てのラインアイテムに一律に適用される設計でした。これは、特定のラインアイテムだけを保留にしたい、または在庫がある他の場所に移動したいという柔軟な運用を阻害していました。そこで、2023-04バージョンのAPIから、指定したラインアイテムだけを保留にしたり、別の場所に移動させるためのパラメーターが追加されました。

具体的な技術的ソリューションの提案

この更新により、GraphQLとRESTの両方でFulfillmentOrderの保留と移動操作がfulfillment_order_line_itemsパラメーターをサポートするようになりました。これにより、特定のラインアイテムだけを対象に、保留や他の場所への移動を行うことが可能になります。

実装手順とコード例

以下に、FulfillmentOrderの保留と移動操作で新たに追加されたパラメーターの利用例を示します。

GraphQL

mutation {
  fulfillmentOrderMove(id: "gid://shopify/FulfillmentOrder/1", fulfillment_order_line_items: ["gid://shopify/FulfillmentOrderLineItem/1", "gid://shopify/FulfillmentOrderLineItem/2"]) {
    fulfillmentOrder {
      ...
    }
    userErrors {
      ...
    }
  }
}

REST

POST /admin/api/2023-04/fulfillment_orders/1/move.json
{
  "fulfillment_order_line_items": ["gid://shopify/FulfillmentOrderLineItem/1", "gid://shopify/FulfillmentOrderLineItem/2"]
}