在庫出荷Webhookに在庫移転IDが追加

11月 05, 2026

INVENTORY

在庫出荷Webhookに在庫移転IDが追加

inventory_transfer_id フィールドの追加で、出荷と移転レコードの紐付けが自動化

このアップデートは Webhookを使って在庫出荷を管理するすべての開発者 に影響します。2026-10 APIバージョン へ移行すると、inventory_shipments 系8種類のWebhookペイロードに inventory_transfer_id フィールドが自動的に含まれるようになります。これにより、出荷レコードと在庫移転レコードを手動でマージする処理が不要になります。

1変更内容の図解：Before / After

2対象Webhookトピック一覧

Webhookトピック	概要	変更
`inventory_shipments/create`	出荷作成時	追加
`inventory_shipments/delete`	出荷削除時	追加
`inventory_shipments/add_items`	アイテム追加時	追加
`inventory_shipments/remove_items`	アイテム除外時	追加
`inventory_shipments/update_item_quantities`	数量更新時	追加
`inventory_shipments/mark_in_transit`	輸送中マーク時	追加
`inventory_shipments/receive_items`	アイテム受取時	追加
`inventory_shipments/update_tracking`	追跡情報更新時	追加

3業務に活かせる具体ユースケース

課題: 複数倉庫間の在庫移転を管理するWMSを構築しており、出荷イベントが発生するたびにどの移転オーダーに紐付くかを別APIで問い合わせる処理が重くなっていた。
打ち手: 2026-10へ更新後は inventory_shipments/create のペイロードに含まれる inventory_transfer_id を直接参照し、移転レコードとの紐付けをその場で行う。
効果: 追加のGraphQL/REST呼び出しが不要になり、処理レイテンシとAPIコール数を削減できる。
技術メモ: inventory_transfer_id が null の場合は移転に紐付かない単独出荷として扱う実装が必要。

課題: 3PLとの連携システムで、在庫が「輸送中」になったタイミングで移転IDをログに記録し監査証跡を残す必要があるが、現状はイベント後に別途データを取得していた。
打ち手: inventory_shipments/mark_in_transit のペイロードから直接 inventory_transfer_id を取得し、タイムスタンプとともに監査ログDBへ書き込む。
効果: イベント駆動でリアルタイムに正確な監査証跡を記録できる。後処理バッチが不要になる。
技術メモ: Webhookの配信保証（at-least-once）を考慮し、inventory_transfer_id + タイムスタンプで冪等性を担保すること。

課題: EC運営ダッシュボードで「移転ごとの受取進捗」を表示したいが、receive_items イベントと移転IDの紐付けが取れず、UI表示に遅延が生じていた。
打ち手: inventory_shipments/receive_items のペイロードに追加された inventory_transfer_id を使い、ダッシュボードのリアルタイム進捗ビューを即時更新する。
効果: 在庫受取の完了状況を移転オーダー単位でリアルタイムに把握でき、オペレーション効率が向上する。
技術メモ: 記載なし。公式ドキュメントで受取ペイロードの全フィールド構造を確認すること。