eギフト注文時のコマースロボ連携仕様

コマースロボ（COMMERCE ROBO）連携マニュアル > eギフト注文時のコマースロボ連携仕様

eギフトでは、受取者が後から配送先住所を入力するため、通常ギフトとは異なる連携方式となります。

本ページでは、eギフト注文時のコマースロボ連携仕様についてご案内します。

eギフト注文作成時点では、配送先住所は未確定の状態です。

API連携を設定している場合、購入時点でAll in giftが自動的に「未発送」ステータスへ変更し、配送先住所が空欄（またはダミー）の状態のままコマースロボへ即座に取り込まれます。この時点では、住所不備エラーとして「保留」ステータスに留まります。

API連携を設定している場合、受取者がeギフト受取ページで住所入力を完了すると、Shopify注文の配送先住所が更新され、コマースロボ側の配送先住所も更新されます。

API連携を設定していない場合、このタイミングでコマースロボ側に注文が取り込まれます。

コマースロボで出庫完了となった注文は、Shopify上で「発送済み」に更新されます。

購入時点でAll in giftが自動的に「未発送」ステータスへ変更し、即時連携されます。

受取者の住所入力後は、All in giftからコマースロボへAPIで自動更新されます。

eギフト購入
↓
即時「未発送」化しコマースロボへ取り込み（住所は空欄・保留ステータス）
↓
受取者が住所入力
↓
All in giftからコマースロボへAPIで住所を自動更新
↓
処理ロボットの設定により出荷待ちへ自動移行

配送先住所が未確定の間は「保留」となり、コマースロボへ連携されません。受取者が配送先住所の入力を完了し、フルフィルメントステータスが「未発送」に変わった時点で、初めてコマースロボのポーリング取得対象になります。

eギフト購入
↓
配送先住所が空欄のため、コマースロボへ取り込まれない
↓
受取者が住所入力
↓
Shopifyのフルフィルメントステータスが「未発送」に変わる
↓
コマースロボのポーリングで取り込み（この時点で住所は確定済み）

コマースロボへは連携されません。コマースロボ側で手動キャンセルを行ってください。

eギフトの有効期限切れにより配送先が購入者に戻る場合、購入者情報がコマースロボへ自動的に連携されます。店舗側での追加対応は不要です。

各OMS・WMSの対応状況は以下のヘルプページをご確認ください。

→受注管理システム(OMS)・倉庫管理システム(WMS)の連携状況

参考：配送先住所情報のメタフィールド移行

通常の親子注文と同様に子注文のみがコマースロボへ連携されます。

親注文はコマースロボの取り込み対象外となります。

参考：子注文に顧客情報を保持しない親子注文（親子注文方式）

APIキー、エンドポイントを取得します。以下のAPI利用申請フォームより、店舗様ご自身で申請を行ってください。

• コマースロボAPI お申込みフォーム

1. アプリ＞All in gift＞設定＞配送設定＞コマースロボに進む

2. 事前準備で取得した「コマースロボAPIキー」を入力

   • API利用申請後、サポートチームから送付されます。

3. 「コマースロボAPIエンドポイント」を入力

   • こちらの仕様書から該当部分をコピーしてください。

   • 末尾のスラッシュは削除して入力してください。

4. 保存をクリックして完了です。

3-1. 配送方法

1. 設定 > 配送方法に進む

2. 配送方法登録をクリック

3. 配送方法名に「eギフト固定送料」と入力

4. 登録をクリック

5. 手順3-4と同じ要領で「通常配送」を登録をクリックして完了です。

3-2. 変換ロボット

1. ロボット > 変換ロボットに進む

2. 変換ロボット名「出荷指示（API用）」にチェックを入れる

3. 「処理を選択してください」のプルダウンから有効/無効 をクリック

4. 有効になっていることを確認して完了です。

3-3. 処理ロボット (住所不備保留)

eギフトでは購入時、配送先は空欄でコマースロボ側に取り込まれます。

そのため「住所不備の場合は保留ステータスにする」ために、処理ロボットの設定が必要です。

1. ロボット > 処理ロボットに進む

2. 処理ロボット名「住所不備（郵便番号不一致）保留　※都道府県から」にチェックを入れる

3. 「処理を選択してください」のプルダウンから有効/無効 をクリック

4. 有効になっていることを確認して完了です。

3-4. 処理ロボット（出荷待ちへの自動移行）

eギフト注文では、受取者が配送先住所を登録するとコマースロボ側では通常「入荷待ち」ステータスになります。

これを「出荷待ち」ステータスに変更するために、処理ロボットの設定が必要です。

1. ロボット > 処理ロボットに進む

2. 処理ロボット名「エラーが無くなったら出荷待ちへ移動」にチェックを入れる

3. 「処理を選択してください」のプルダウンから有効/無効 をクリック

4. 有効になっていることを確認して完了です。

以上でコマースロボ側の設定は完了です。