GraphQL Admin API 2026-10 以降、carrierServiceCreate(および REST の carrier_services.json)で配送業者サービスを作成しても、Shopify が既定の General 配送プロファイルへ自動で載せなくなる。追加操作をしないと、加盟店のチェックアウトに送料が出ない。
API で作成 → Shopify が自動で一般プロファイルの適格ゾーンに追加 → 加盟店の checkout に送料が即表示。
API で作成 → 登録されるだけ。プロファイル/ゾーンへの追加は無し。追加操作をしないと送料が checkout に出ない。
carrierServiceCreate ミューテーション。
対象は API バージョン 2026-10 以降。
POST /admin/api/{version}/carrier_services.json。
同じく 2026-10 以降で自動追加が無くなる。
| 項目 | 旧バージョン(自動追加あり) | 2026-10 以降 |
|---|---|---|
| 作成時の挙動 | サービス登録 + 一般プロファイルへ自動追加 | 変更 サービス登録のみ |
| 配送ゾーンへの反映 | 適格ゾーンに自動反映 | 自動反映なし(自分で追加) |
| checkout への送料表示 | 作成後すぐ表示 | プロファイルに追加するまで出ない |
| アプリ側の追加実装 | 不要 | 必要 手動誘導 or API 実装 |
Shopify 管理画面で、加盟店自身が該当の運送業者計算レート(carrier-calculated rate)を適切な配送プロファイルに手動で追加する。アプリはその手順を案内する。
配送プロファイル API(shipping profile APIs)を使って、運送業者計算レートを適切な配送プロファイルにプログラムから追加する。
「作成=即レート表示」を前提にしたコード/導線を洗い出す。
手動追加の案内、または配送プロファイル API での自動追加を組み込む。
API を 2026-10 に上げ、checkout に実際に送料が出るか確認してから本番反映。
壊れるのは 2026-10 以降を叩いたとき。古いバージョンはサンセットまで従来挙動なので、バージョンアップと同時に挙動が切り替わる点に注意。
carrierServiceCreate と POST .../carrier_services.json の両経路で同じ変更。どちらを使っていても影響を受ける。
Create はサービスを登録するだけ。レートを加盟店に提供する(=プロファイル追加)のは別ステップという設計に変わる。
自動化するなら shipping profile API 経由で carrier-calculated rate を適切なプロファイルに追加する。REST/GraphQL の具体的なフィールド構成は公式ドキュメントで確認。
Shopify の推奨は、アプリが加盟店を管理画面での手動追加へ誘導する方式。API 自動追加も可能だが、まず導線設計(案内 UI / オンボーディング手順)を整えるのが確実。