ネクストエンジン連携ガイド
AnyGift タグ挿入型とネクストエンジンを連携するための設定・運用ガイドです。通常の配送型eギフトと選べるギフトでは、受注を作成するタイミングが異なります。
注文・在庫が連携する仕組み
AnyGiftは、ネクストエンジンのAPIを使って受注を作成・更新します。通常の配送型eギフトでは、購入時に在庫確保用の受注を作り、受取後にその受注の配送先を更新します。
| 場面 | 通常の配送型eギフト | 選べるギフト |
|---|---|---|
| 購入確定時 | 配送先が「入力待ち」の受注を作成し、在庫を確保する | 配送用受注は作成せず、子商品の在庫もネクストエンジンで確保しない |
| 商品選択・住所入力の完了時 | 購入時の受注を検索し、受取者住所・配送希望日時などを更新する | 選択された子商品と受取者住所を含む受注を新規作成する |
| 受取後の出荷 | 確認項目・在庫・配送条件を確認して出荷する | 同様に出荷する。時間帯指定がある場合は、受注作成後の別処理で反映する |
購入時の「入力待ち」受注は出荷しないでください。 受取後も、住所が反映され、必要な確認が済んだ受注を出荷対象にします。
在庫数の通知は、ネクストエンジンからAnyGiftへの別経路です。受注連携の設定に加え、在庫連携用の接続設定と商品コードの紐づけを確認してください。
導入前に準備すること
| 準備する情報・作業 | 担当・確認先 |
|---|---|
| ネクストエンジンのアカウントと設定権限 | ストア |
| AnyGiftのアカウントと対象ストア | ストア・AnyGift担当窓口 |
| 対象商品・バリエーションと商品コード | ストア。ネクストエンジンの商品と照合 |
| AnyGift用店舗の番号 | ネクストエンジンで店舗を作成後、AnyGift担当窓口へ共有 |
| 在庫更新用URL・ストアアカウント・認証キー | 在庫連携を行う場合、AnyGift担当窓口から案内 |
| 支払方法・規定の発送方法・配送日時指定の利用有無 | ストア・AnyGift担当窓口 |
店舗番号と在庫連携のストアアカウントは、別の設定項目です。案内された値を対象店舗に設定し、開発・本番の接続先を取り違えないようにしてください。
設定手順
以下はタグ版の設定手順です。画面名は利用中のネクストエンジンのマニュアルでも確認してください。
1. AnyGiftアプリをインストールして連携する
担当：ストア（事前準備はAnyGift担当窓口と確認）
- ネクストエンジンのアプリ一覧から、AnyGiftアプリをインストールします。
- アプリ一覧でAnyGiftのアイコンを開きます。
- AnyGiftのログイン画面が表示された場合は、案内されたアカウントでログインします。
- AnyGift管理画面に「ネクストエンジンとの連携に成功しました」と表示されることを確認します。
エラーの場合は、対象のAnyGiftストア・ネクストエンジンアカウントが正しいかと、表示されたエラーを確認してください。解決しない場合は、その情報を担当窓口へ共有します。
2. ネクストエンジンにAnyGift用の店舗を作成する
担当：ストア・AnyGift担当窓口
ネクストエンジンのメイン機能から「設定 → 基本 → 店舗」を開き、「店舗の追加画面を開く」から登録します。
| 設定項目 | 設定内容 |
|---|---|
| 店舗名称 | AnyGift |
| 店舗略記 | AG |
| 出店モール | その他（汎用） |
| 規定の発送方法 | ストアの運用に合う発送方法 |
| 税区分 | 税込 |
| 税計算順序 | 商品計で税計算 |
作成後、一覧の店舗名の左にある店舗番号をAnyGift担当窓口へ共有してください。担当窓口が受注一括登録パターンなどの連携設定を行います。店舗を作成しただけで注文連携が完了したと判断せず、設定完了を確認します。
3. 受取前の誤出荷を防ぐ確認待ち設定を行う
担当：ストア
「設定 → 受注 → 受注確認内容」でAnyGift用の店舗を指定し、次を設定して保存します。
| 確認項目 | 設定 | 目的 |
|---|---|---|
| 11：送り先の郵便番号と住所があってません。 | チェックを外す | 購入時の仮の配送先による確認待ちを避ける |
| 14：住所の番地を確認してください。 | チェックを外す | 同上 |
| 56：同梱可能受注が存在します。 | チェックを外す | eギフトの受注を通常注文と分けて扱う |
| 22：ギフトです。 | チェックを入れる | 受取前の受注を確認待ちで止める |
他の確認項目はストアの運用に合わせて設定してください。住所関連のチェックを外す場合も、「ギフトです。」を使って受取前の受注が止まることをテストします。
通常の配送型では、受取時の住所更新で、確認項目がない場合または「ギフトです。」だけの場合に確認済みの更新を行います。他の確認項目が残っている受注は、自動で確認済みにはしません。 内容を確認して、ネクストエンジン上で対応してください。
4. 在庫連携の接続情報と対象商品を登録する
担当：ストア・AnyGift担当窓口。在庫連携を行う場合に実施
- AnyGift担当窓口から案内された在庫更新用URL・ストアアカウント・認証キーを、対象店舗へ設定します。
- AnyGiftに商品を登録し、SKUとネクストエンジンの商品コードの紐づけを確認します。
- ネクストエンジンの汎用店舗用モール商品CSVテンプレートに対象商品コードを記入し、「モール商品一括登録」で登録します。
- 代表商品の在庫を送信し、AnyGift管理画面で対象SKUの数量が更新されることを確認します。
商品追加時にも、商品登録・紐づけ・在庫連携対象への登録が必要です。通知の成功表示だけでなく、AnyGift側の実際の在庫数を照合してください。
ebisumartを利用する場合、この在庫連携設定は対象外です。EC側の在庫管理経路を担当窓口と確認してください。割合在庫機能を使う場合は、ネクストエンジンの在庫数とAnyGiftへ通知する在庫数が一致しないことがあるため、配分設定も確認します。
5. 支払方法・発送方法・配送日時を確認する
担当：ストア・AnyGift担当窓口
受注作成時に送られる支払方法に合わせて、「支払発送変換」を確認します。
| AnyGiftが送る名称 | 確認すること |
|---|---|
クレジットカード |
対応する支払方法へ変換できること |
Amazonペイメント |
Amazon Payを使う場合、支払方法 Amazon Pay への変換を登録すること |
その他 |
この値を使う連携構成では、対象の支払方法を担当窓口と確認すること |
発送方法は、ネクストエンジンの規定値・変換設定を確認してください。配送希望日時を利用する場合は、受取テストで希望日・時間帯まで反映されることを確認します。選べるギフトの時間帯は、受注作成後の別処理で反映されるため、受注の作成直後だけで判断しないでください。
6. 送り状の依頼主をストア名にする
担当：ストア
AnyGiftは、ネクストエンジンの受注の購入者（受注者）欄に、実際の購入者の氏名・住所ではなく「AnyGift 運営」の名義（AnyGift担当窓口が別の名義を設定している場合はその名義）を送ります。
ただし、送り状の依頼主に購入者欄を使う設定のままだと、送り状に「AnyGift 運営」と印字されます。受取者がどのストアから届いたかわかるよう、AnyGift用店舗の受注は、送り状・帳票の依頼主をストア名（会社名）にしてください。 設定後、テスト注文で送り状を出力し、依頼主の欄を確認します。
購入者欄に送る名義を「AnyGift 運営」以外にしたい場合は、AnyGift担当窓口にご相談ください。詳しくは送り状の依頼主はストア名にするをご覧ください。
7. 購入・受取・在庫のテストを行う
担当：ストア・AnyGift担当窓口
| テスト | 確認すること |
|---|---|
| 通常の配送型の購入 | 「入力待ち」の受注が1件作成され、在庫が引き当てられる。受取前に出荷されない |
| 通常の配送型の受取 | 購入時の受注の住所が更新される。確認待ちの理由と、出荷対象へ進める状態かを確認 |
| 選べるギフト | 購入時には配送用受注がなく、商品選択・住所入力後に子商品の受注が作成される |
| 配送日時指定 | 希望日・時間帯・発送方法が対象受注に反映される |
| 在庫通知 | SKUごとにネクストエンジンからAnyGiftへの在庫更新を確認 |
テスト結果と設定内容を担当窓口へ共有してから本番運用を開始してください。
実際に連携する内容の例
以下は実装の送信項目に架空の値を当てはめた抜粋です。ネクストエンジンの画面表示や、手動アップロード用CSVの完成版ではありません。
通常の配送型：購入時の受注作成と受取後の更新
「紅茶セットを2個購入した」例です。AnyGift注文IDを 12345678-1234-4234-8234-123456789abc（架空）とします。
| 項目 | 購入時に作成する受注 | 受取後の更新 |
|---|---|---|
| 店舗伝票番号 | 12345678-1234-4234-8234-123456789ab |
同じ番号の受注を検索して更新 |
| 商品コード・数量 | TEA-001、2個 |
商品の受注を作り直さず、既存受注の配送先などを更新 |
| 発送郵便番号 | 000-0000 |
受取者が入力した郵便番号（ハイフンを除去） |
| 発送先住所 | 入力待ち |
例：東京都○○区サンプル町1-2-3（架空） |
| 発送先名 | 入力待ち |
例：山田 花子 |
| ギフトフラグ | 1 |
ギフトフラグを消す処理ではなく、確認済みフラグを条件に応じて更新 |
| 支払方法 | 例：クレジットカード |
ネクストエンジン側の設定・変換結果を確認 |
タグ型の店舗伝票番号には、AnyGift注文ID（UUID）の先頭35文字を使います。通常の配送型・選べるギフトともに同じルールで、AnyGift独自の連番や接頭辞は付けません。
店舗伝票番号は、ネクストエンジンが自動で付与する「伝票番号」とは別の項目です。受取後の更新対象を検索する際は、店舗伝票番号の先頭35文字を使います。受注が見つからない場合は、両方の番号を混同していないか確認してください。
選べるギフト：受取完了時に子商品の受注を作成
「選べるギフト」を購入し、受取者が紅茶セットを選んだ場合、購入時は配送用受注を作りません。商品選択と住所入力が完了した後、発送する子商品の情報で作成します。
店舗伝票番号：23456789-2345-4345-8345-23456789abc
（架空のAnyGift注文ID 23456789-2345-4345-8345-23456789abcd の先頭35文字）
商品名：紅茶セット
商品コード：TEA-001
受注数量：1
発送先名：山田 花子
発送先住所：東京都○○区サンプル町1-2-3（架空）
最初から受取者の住所を含む受注を作成します。選べるギフトの親商品の行を出荷する例ではありません。配送時間帯の指定がある場合は、後続処理の反映も確認してください。
キャンセル・受取期限切れの場合
AnyGift側でキャンセルしても、ネクストエンジンの受注取消・在庫引当解除・倉庫への出荷停止は自動では行われません。 通常の配送型と選べるギフトのどちらも、ネクストエンジン側の受注状況を確認してください。
- 対象の店舗伝票番号で受注を探し、処理状態・出荷状況を確認します。
- 作成済みの受注はネクストエンジン側でも取消し、出荷指示済みの場合は倉庫への停止・取消も進めます。
- 在庫引当の解除結果とAnyGiftの在庫、両システムの注文状態を照合します。必要な返金の処理結果も別途確認します。
選べるギフトが未受取の場合は配送用受注がないため、存在しない受注を探し続けず、受取状況も確認します。
受取期限切れでAnyGift注文を自動キャンセルするかはストア設定によりますが、期限切れ処理からもネクストエンジンの受注取消・在庫引当解除は行いません。「入力待ち」の受注をそのまま出荷せず、期限切れ注文の扱いを運用担当者間で確認してください。
うまく連携できないとき
AnyGiftへ問い合わせる前に、ネクストエンジン側の受注・取り込み結果・エラー・確認待ち理由を確認してください。 この連携では注文メールの受信ではなく、APIでの受注作成・更新結果を調べます。
| 症状 | まず確認すること |
|---|---|
| 購入しても受注がない | 通常の配送型か、未受取の選べるギフトか。対象店舗・店舗伝票番号で検索し、受注取り込み結果とエラー、受注一括登録パターンを確認 |
| 商品コードが見つからない | ネクストエンジンの商品マスタと、AnyGiftのOMS連携用SKUの紐づけ。バリエーション有無も確認 |
| 受取後も住所が「入力待ち」 | AnyGiftの受取完了日時、対象受注の店舗伝票番号、ネクストエンジン側の更新エラーを確認 |
| 住所は更新されたが確認待ちのまま | 「ギフトです。」以外の確認理由が残っていないか。残る場合はその内容に対応 |
| 発送方法・支払方法で取り込みエラー | 規定の発送方法と「支払発送変換」の登録値を確認 |
| 希望時間帯が反映されない | AnyGiftでの指定、ネクストエンジンの配送方法と時間帯。選べるギフトでは受注作成後の時間帯反映結果も確認 |
| 在庫が一致しない | 在庫通知の対象商品・送信結果、接続先・ストアアカウントの組み合わせ、割合在庫設定とAnyGift側の数量を照合 |
| キャンセル後も受注や在庫引当が残る | ネクストエンジン側の取消を実施したか。AnyGift側のキャンセルだけでは自動解除されません |
受取画面の完了や在庫通知の成功表示だけで、受注・在庫の反映完了と判断しないでください。対象受注と実際の在庫数も確認します。受注の重複を防ぐため、再登録・再取り込みの前に、既存受注がないか照合してください。
受注の作成は非同期処理です。公式の受注伝票アップロードAPIでも、受付後に登録結果を確認する仕様になっています。受付成功だけで取り込み完了とは判断せず、ネクストエンジン側の取り込み結果と対象受注を確認してください。
確認しても解決しない場合は、次をAnyGift担当窓口へ共有してください。
- ストア名、AnyGift注文ID、ネクストエンジンの店舗伝票番号と伝票番号
- 購入・受取・キャンセルの日時と、通常の配送型／選べるギフトの区別
- ネクストエンジン側の取り込み・更新エラー、確認待ち理由、確認した画面
- 対象SKUと、在庫通知・在庫数の確認結果
- 期待した動作と実際の動作
ebisumartを利用する場合の補足
- Amazon Payを使う場合は、手順5の
Amazonペイメントの変換設定を確認してください。 - ebisumartのクーポン・割引は、ネクストエンジンに送る受注の
その他費用に値引き分を反映します。商品単価そのものの値引きと取り違えないよう、商品計・送料・その他費用・合計を照合してください。