Admin API / 破壊的変更 (2026-10)

Carrier Service を作っても
「一般配送プロファイル」に自動追加されなくなる

GraphQL Admin API 2026-10 以降、carrierServiceCreate(および REST の carrier_services.json)で配送業者サービスを作成しても、Shopify が既定の General 配送プロファイルへ自動で載せなくなる。追加操作をしないと、加盟店のチェックアウトに送料が出ない。

このページの構成
  1. 30秒で理解 : 何が変わるのか
  2. 仕組み図解 : 旧挙動 vs 新挙動
  3. 影響を受ける API
  4. 旧 vs 新の比較
  5. 対応方法(2択)
  6. 移行の進め方(3ステップ)
  7. 技術者が押さえるべき5つのポイント
  8. 業務に活かせる3つのユースケース
  9. 提案で使える1行サマリ

130秒で理解 : 何が変わるのか

これまで API で配送業者サービス(Carrier Service)を作ると、Shopify が自動で「一般(General)配送プロファイル」の対象配送ゾーンに載せ、加盟店のチェックアウトに送料が出ていた。
2026-10 以降は「サービスの登録」までしかやらない。 プロファイルへの追加は自分でやる必要がある。

これまで(旧バージョン)

API で作成 → Shopify が自動で一般プロファイルの適格ゾーンに追加 → 加盟店の checkout に送料が即表示。

2026-10 以降

API で作成 → 登録されるだけ。プロファイル/ゾーンへの追加は無し。追加操作をしないと送料が checkout に出ない。

2仕組み図解 : 旧挙動 vs 新挙動

旧バージョン(サンセットまで継続) carrierService Create 自動で一般 プロファイルに追加 checkout に 送料が表示 2026-10 以降 carrierService Create サービス登録 だけ完了 自動追加なし ★ 手動 or API で プロファイルに追加 この一手が必須に checkout に 送料が表示
この追加操作を入れないと、新しく作った配送業者サービスの送料が加盟店のチェックアウトに一切表示されない。アプリが「作成=即使える」前提で動いている場合は要改修。

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つのポイント

2026-10

1. トリガーは API バージョン

壊れるのは 2026-10 以降を叩いたとき。古いバージョンはサンセットまで従来挙動なので、バージョンアップと同時に挙動が切り替わる点に注意。

2. GraphQL / REST 両方が対象

carrierServiceCreatePOST .../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 推奨。加盟店が触る前提なら、追加先プロファイル名を案内文に明記すると迷いにくい。
国内 海外 Profile
USE CASE 3

プロファイル追加を API 自動化して複数店舗に一括展開

課題
多店舗・多ブランドを管理するアプリで、配送業者サービスを店舗ごとに手動でプロファイル追加させると運用が重い。
打ち手
配送プロファイル API を使い、carrier-calculated rate を対象プロファイルへプログラムで追加する処理を作成フローに組み込む。
効果
店舗横断で「作成→レート提供」を自動化し、設定作業を撤廃。展開スピードと一貫性を確保。
技術メモ
どのプロファイル/ゾーンに載せるかはアプリ側で判定が必要。追加先の設計(既定 or 用途別プロファイル)を先に決めておく。

9提案で使える1行サマリ

「2026-10 以降、Carrier Service を API で作っても一般配送プロファイルに自動追加されなくなる。
“作成=即送料表示”は終わり。作成後にプロファイルへレートを追加する一手が必須。
推奨は加盟店への手動追加の案内、自動化するなら配送プロファイル API を使う。」