Shopify API 2026-10で配送・在庫・注文の確認が必要に

ShopifyのAPIバージョン2026-10は、2026年10月1日に安定版となりました。このバージョンを採用する店舗では、連携リクエストの成功だけでは、意図した結果を確認できない場合があります。Shopifyによると、配送業者サービスを登録しても、その配送料が一般配送プロファイルに追加されなくなりました。

公式リリースノートには、在庫エラー、注文の税額、フルフィルメントのステータス、メタフィールドによる絞り込みの変更も記載されています。ClickSyrupは、配送業者の料金設定と従来の在庫エラー処理を先に確認し、その後に注文更新と絞り込みクエリをテストすることを勧めます。これは編集部が提案するテストの順序であり、Shopify店舗の障害を実測して順位付けしたものではありません。

配送料と在庫処理から確認する

Shopifyによると、配送業者サービスの作成は、サービスを登録するだけの操作になりました。配送業者が算出する料金をチェックアウトに表示するには、配送プロファイルで設定する必要があります。したがって、保守を担う制作会社は二つの確認を別々に求めるべきです。サービスが存在することの確認と、適切なチェックアウトのテストで想定した料金が表示されることの確認です。

この区別は重要です。作成時のレスポンスだけを確認していると、設定の欠落を見逃す可能性があります。このバージョンが既存の料金を削除する、あるいはすべての店舗に同じ影響を及ぼすとは考えないでください。文書に記載された変更は、配送業者サービスを作成したときの動作に関するものです。

在庫については、Shopifyが在庫数量の調整、移動、手持ち数量の設定を行うミューテーションとユーザーエラーの列挙型から、ITEM_NOT_STOCKED_AT_LOCATIONを削除しました。同社は、この特定のエラーを処理するアプリ側のロジックを削除するよう案内しています。

連携部分で、この識別子と完全に一致する箇所を検索してください。警告や復旧処理を起動する分岐も対象です。そのうえで、残る正常系と異常系の処理を見直します。このエラーが一つなくなることは前提を更新する理由にはなりますが、在庫更新が通知なく失敗するようになった証拠ではありません。すべての在庫エラーを無視してよいという意味でもありません。

注文変更には最新の合計額と新しいステータスへの対応が必要

Shopifyによると、未フルフィルメントの注文で配送先住所を変更すると、新しい配送先に応じて税額が再計算されるようになりました。更新後はtaxLinesとtotalTaxSetを再取得し、それに伴う支払いまたは返金の差額を照合してください。住所変更と金額の確認を、一つの運用作業として扱う必要があります。

店舗運営者が確認すべきなのは、連携機能が顧客やスタッフに結果を表示する前に、更新後の金額を読み込んでいるかどうかです。住所が保存されたことだけを成功の合図にせず、保守担当者に適切なテスト注文で一連の流れを実演してもらいましょう。

Shopifyは、注文にフルフィルメントの必要な数量が残っていない場合、Order.displayFulfillmentStatusがUNFULFILLEDの代わりにFULFILLMENT_NOT_REQUIREDを返すこともあると説明しています。ステータスを網羅的に割り当てるコードは、新しい値に対応する必要があります。他のステータスと同じ意味だと決めつけず、表示方法と処理の振り分けを確認してください。

メタフィールドの絞り込みで無効な前提が表面化する

Shopifyによると、絞り込み用に設定されていないメタフィールドを使うクエリは、その条件を黙って無視するのではなく、エラーを返すようになりました。対象のメタフィールド定義が、絞り込みとクエリ内の比較演算子に対応しているかを確認してください。

この変更は、無効なクエリを見えやすくします。有効な条件と無効な条件の両方をテストし、想定した結果の代わりにエラーが生じたとき、アプリがどう表示するかを確認しましょう。この動作を、新たに生じた通知のない障害と表現すべきではありません。

バージョンを採用する前に、配送、在庫、注文、絞り込みの四つの分野について、確認した結果を保守担当者に記録してもらってください。ダウンロード商品やアクセス権を販売する店舗には、Shopifyでのデジタル商品の提供ガイドも関連する読み物になります。有用な引き継ぎ資料には、その結果を生んだAPIレスポンスとともに、顧客と運営担当者に何が見えるのかを示す必要があります。