Carrier Service を作っても 「一般配送プロファイル」に自動追加されなくなる
原題: Carrier services will no longer be automatically added to the default shipping profile
- Shipping
- Fulfillment
- Carrier Service
- Admin API
- GraphQL
- REST API
- 破壊的変更
- 廃止予定
- Checkout
- 2026-10
図解 : Carrier Service は既定の配送プロファイルに自動追加されなくなる(2026-10 破壊的変更) Admin API / 破壊的変更 (2026-10) Carrier Service を作っても 「一般配送プロファイル」に自動追加されなくなる GraphQL Admin API 2026-10 以降、carrierServiceCreate(および REST の carrier_services.json)で配送業者サービスを作成しても、Shopify が既定の General 配送プロファイルへ自動で載せなくなる。追加操作をしないと、加盟店のチェックアウトに送料が出ない。 このページの構成 30秒で理解 : 何が変わるのか 仕組み図解 : 旧挙動 vs 新挙動 影響を受ける API 旧 vs 新の比較 対応方法(2択) 移行の進め方(3ステップ) 技術者が押さえるべき5つのポイント 業務に活かせる3つのユースケース 提案で使える1行サマリ 1 30秒で理解 : 何が変わるのか これまで API で配送業者サービス(Carrier Service)を作ると、Shopify が自動で「一般(General)配送プロファイル」の対象配送ゾーンに載せ、加盟店のチェックアウトに送料が出ていた。 2026-10 以降は「サービスの登録」までしかやらない。 プロファイルへの追加は自分でやる必要がある。 これまで(旧バージョン) API で作成 → Shopify が自動で一般プロファイルの適格ゾーンに追加 → 加盟店の checkout に送料が即表示。 2026-10 以降 API で作成 → 登録されるだけ。プロファイル/ゾーンへの追加は無し。追加操作をしないと送料が checkout に出ない。 2 仕組み図解 : 旧挙動 vs 新挙動 この追加操作を入れないと、 新しく作った配送業者サービスの送料が加盟店のチェックアウトに一切表示されない 。アプリが「作成=即使える」前提で動いている場合は要改修。 3 影響を受ける API 破壊的変更 GraphQL Admin API carrierServiceCreate ミューテーション。 対象は API バージョン 2026-10 以降 。 破壊的変更 REST Admin API POST /admin/api/{version}/carrier_services.json 。 同じく 2026-10 以降で自動追加が無くなる。 今サポートされている より古い API バージョンは、当該バージョンがサンセットされるまで従来の自動追加挙動を維持する 。つまりバージョンを上げるまでは急に壊れないが、上げた瞬間に挙動が変わる。 4 旧 vs 新の比較 項目 旧バージョン(自動追加あり) 2026-10 以降 作成時の挙動 サービス登録 + 一般プロファイルへ自動追加 変更 サービス登録のみ 配送ゾーンへの反映 適格ゾーンに自動反映 自動反映なし(自分で追加) checkout への送料表示 作成後すぐ表示 プロファイルに追加するまで 出ない アプリ側の追加実装 不要 必要 手動誘導 or API 実装 5 対応方法(2択) 推奨 ① 加盟店に手動追加を促す Shopify 管理画面で、加盟店自身が該当の運送業者計算レート(carrier-calculated rate)を適切な配送プロファイルに手動で追加する。アプリはその手順を案内する。 自動化 ② API でプログラム追加 配送プロファイル API(shipping profile APIs)を使って、運送業者計算レートを適切な配送プロファイルにプログラムから追加する。 いずれの場合も「Carrier Service を作成した後に、そのレートが配送プロファイルに追加されていること」を必ず担保するのがゴール。 6 移行の進め方(3ステップ) 1 依存箇所を棚卸し 「作成=即レート表示」を前提にしたコード/導線を洗い出す。 2 プロファイル追加を実装/導線化 手動追加の案内、または配送プロファイル API での自動追加を組み込む。 3 2026-10 で検証 API を 2026-10 に上げ、checkout に実際に送料が出るか確認してから本番反映。 7 技術者が押さえるべき5つのポイント 1. トリガーは API バージョン 壊れるのは 2026-10 以降を叩いたとき。古いバージョンはサンセットまで従来挙動なので、 バージョンアップと同時に挙動が切り替わる 点に注意。 2. GraphQL / REST 両方が対象 carrierServiceCreate と POST .../carrier_services.json の両経路で同じ変更。どちらを使っていても影響を受ける。 3. 「登録」と「レート提供」が分離 Create はサービスを登録するだけ。レートを加盟店に提供する(=プロファイル追加)のは別ステップという設計に変わる。 4. 配送プロファイル API を使う 自動化するなら shipping profile API 経由で carrier-calculated rate を適切なプロファイルに追加する。REST/GraphQL の具体的なフィールド構成は公式ドキュメントで確認。 5. 推奨は「加盟店に手動追加を促す」導線 Shopify の推奨は、アプリが加盟店を管理画面での手動追加へ誘導する方式。API 自動追加も可能だが、まず 導線設計(案内 UI / オンボーディング手順) を整えるのが確実。 8 業務に活かせる3つのユースケース USE CASE 1 配送アプリ/運送業者連携アプリの回帰改修 課題 自社の配送レートアプリが carrierServiceCreate で「作成すればすぐ checkout に出る」前提。2026-10 に上げると送料が出ず、加盟店から「送料が消えた」問い合わせが来る。 打ち手 作成後にプロファイル追加ステップ(手動案内 or shipping profile API)を組み込み、2026-10 で回帰テスト。 効果 バージョンアップ時の送料欠落インシデントを未然に防止。サポート問い合わせ削減。 技術メモ 古い API バージョンはサンセットまで従来挙動。切替タイミングをフィーチャーフラグで管理すると安全。 USE CASE 2 加盟店オンボーディングに「レート有効化」手順を組み込む 課題 導入代行やパートナー案件で、配送業者サービスを API で仕込むが、加盟店側では設定完了に見えて実は送料が出ていない、という取りこぼしが起きる。 打ち手 推奨方式に沿い、オンボーディング手順に「該当レートを配送プロファイルに追加」チェック項目を明示。管理画面への導線・スクリーンショットを用意。 効果 初期設定の抜け漏れゼロ化。ローンチ後の「送料が表示されない」トラブルを回避。 技術メモ 手動誘導が Shopify 推奨。加盟店が触る前提なら、追加先プロファイル名を案内文に明記すると迷いにくい。 USE CASE 3 プロファイル追加を API 自動化して複数店舗に一括展開 課題 多店舗・多ブランドを管理するアプリで、配送業者サービスを店舗ごとに手動でプロファイル追加させると運用が重い。 打ち手 配送プロファイル API を使い、carrier-calculated rate を対象プロファイルへプログラムで追加する処理を作成フローに組み込む。 効果 店舗横断で「作成→レート提供」を自動化し、設定作業を撤廃。展開スピードと一貫性を確保。 技術メモ どのプロファイル/ゾーンに載せるかはアプリ側で判定が必要。追加先の設計(既定 or 用途別プロファイル)を先に決めておく。 9 提案で使える1行サマリ 「2026-10 以降、Carrier Service を API で作っても一般配送プロファイルに自動追加されなくなる。 “作成=即送料表示”は終わり。作成後にプロファイルへレートを追加する一手が必須。 推奨は加盟店への手動追加の案内、自動化するなら配送プロファイル API を使う。」 source : shopify.dev / changelog / carrier-services-will-no-longer-be-automatically-added-to-the-default-shipping-profile