配送業者サービス作成の挙動変更
2026-10で自動プロファイル追加が廃止
carrierServiceCreate / POST carrier_services.json の破壊的変更 — 明示的な設定なしでは配送レートが表示されなくなる
01この変更の概要
GraphQL Admin API 2026-10 以降、carrierServiceCreate（GraphQL）および POST /admin/api/{version}/carrier_services.json（REST）で配送業者サービスを作成しても、ショップの General（デフォルト）shipping profile に自動で追加されなくなります。これまで自動的にチェックアウトで利用可能になっていた挙動が廃止され、開発者が明示的にShipping Profile APIを通じてレートを追加する必要があります。対応しない場合、マーチャントのチェックアウト画面で配送レートが一切表示されなくなるため、早急な対応が求められます。
02Before/After: 挙動の変化を図解
USE CASES03業務で活かせる具体ユースケース
- 課題
- 既存の配送レートアプリが2026-10以降も正常動作するか確認したい
- 打ち手
- アプリが使用しているAPIバージョンを確認し、2026-10以降を利用している場合はcarrierServiceCreate後にShipping Profile APIでレートを明示的に追加するロジックを実装する
- 効果
- マーチャントのチェックアウト画面で配送レートが途切れることなく表示され続ける
- 技術メモ
- 旧バージョン(〜2026-07)はsunsetまで既存動作を維持するため、移行期間に段階的な対応が可能。ただしsunset後は強制適用となるため早期対応を推奨
- 課題
- 新規にShopifyアプリを開発中で、マーチャントの配送設定を最小限の操作で完結させたい
- 打ち手
- carrierServiceCreateでサービス登録後、Shipping Profile APIをプログラムで呼び出して対象プロファイルの適切なShipping Zoneにcarrier-calculated rateを追加する一連のフローをオンボーディングに組み込む
- 効果
- マーチャントが管理画面を操作する手間を省きつつ、チェックアウトでのレート表示を自動化できる
- 技術メモ
- Shipping Profile APIの利用が推奨される自動化手段。詳細はShopify公式のcarrierServiceCreateドキュメントおよびCarrierService RESTリソースを参照
- 課題
- 自社開発のカスタムキャリアサービスをマーチャントに提供しているが、設定方法をサポート担当者に説明しなければならない
- 打ち手
- APIでcarrier serviceを作成した後、マーチャントをShopify管理画面の「配送と配達」設定に誘導し、carrier-calculated rateを対象のShipping Profileに手動で追加するよう案内する手順書を整備する
- 効果
- 技術的なAPI対応が困難な場合でも、管理画面操作でレートを有効化でき、チェックアウトへの影響を回避できる
- 技術メモ
- 元記事では管理画面からの手動追加を「推奨」と明記している。プログラム対応とUI誘導のどちらでも要件を満たせる
04技術者目線のポイント
GraphQL: carrierServiceCreate
REST: POST /admin/api/{version}/carrier_services.json
適用開始: API version 2026-10
2026-07以前のサポート済みAPIバージョンはsunsetまで従来の自動追加動作を維持。ただし各バージョンのsunset後は対応不要。2026-10以降を利用する場合のみ対応が必須。
元記事が「Recommended」と明記。マーチャントをShopify管理画面の配送プロファイル設定に誘導し、carrier-calculated rateを手動で追加させる方法が公式推奨。
プログラムでShipping Profile APIを呼び出し、対象プロファイルのShipping Zoneにcarrier-calculated rateを追加することで自動化も可能。詳細は公式ドキュメントを参照。
| 確認ポイント | 内容 | 対応優先度 |
|---|---|---|
| 使用APIバージョン | 2026-10以降を使用しているか確認 | 高 |
| 自動追加への依存 | carrier service作成後に明示的な設定なしでレートを期待していないか | 高 |
| チェックアウトのテスト | 新しいcarrier service作成後にレートが表示されるかステージングで確認 | 中 |
| マーチャントへの案内 | 既存アプリのユーザーに変更を告知・手順を提供 | 中 |
| ドキュメント確認 | carrierServiceCreate / CarrierService REST 公式ドキュメントの最新情報を確認 | 推奨 |
Source: https://shopify.dev/changelog/carrier-services-will-no-longer-be-automatically-added-to-the-default-shipping-profile | 公開日: 2026年6月26日
※本記事はShopify公式ではなく独立系メディア「compass」による解説です。最終確認は必ず公式ドキュメントをご参照ください。
Share:
orderCreateで複数追跡番号を一括登録する方法
Storefront MCP カートツールが廃止へ｜UCP Cart MCPへ移行