商品・在庫の管理

AnyGift タグ挿入型では、AnyGift 側で商品・在庫を管理します。このページでは、商品の登録・更新・削除と在庫の管理方法を説明します。

商品の登録方法

商品の登録には4つの方法があります。ストアの規模や運用スタイルに合わせて選択してください。

方法	向いているケース
管理画面から手動登録	商品数が少ない・不定期に商品を追加する
CSV 一括インポート	大量の商品を一度に登録したい
ECカートと自動同期	makeshop / futureshop / ebisumart / ecforce を利用中
OMS と自動同期	ネクストエンジンを利用中

管理画面からの手動登録

管理画面の左メニューから「商品管理」を開く
右上の「商品を登録する」をクリック
「商品タイプ」で作成する商品のタイプを選ぶ
「商品情報」に商品ID・商品名・商品説明を入力
「商品画像URL」に画像のURLを入力（入力するとプレビューが表示されます）
「商品ページURL」に、あなたのECサイトの商品ページURLを入力
右側の「eギフト」をONにし、「在庫数」と「商品価格」を入力
右下の「保存」をクリック。「商品管理」の一覧に追加されます

登録前に確認しておきたいこと

商品IDは登録後に変更できません: 商品IDを入力できるのは新しく登録するときだけです。登録後の詳細画面では表示のみになります。商品IDを変えたいときは、正しい商品IDで商品を登録し直し、古い商品を削除してください。商品IDは、商品ページのタグに入れる商品コードと同じ値にする必要があるため、登録前にタグ側の値と照らし合わせておくと安心です
商品価格は50円以上にしてください: 管理画面では0円から入力できますが、50円未満のバリエーション（SKU）が1つでもある商品は、商品ページにeギフトボタンが表示されません（決済の仕組み上、50円未満は決済できないためです）。ラッピング用の商品と、決済をスキップする設定の商品は対象外です
商品説明は受取者も見ます: 商品説明はeギフトの受取画面にも表示されます。例えば「期間限定20%OFF」のような価格やキャンペーンの情報を書くと、贈られた方に購入金額が伝わってしまうことがあるため、商品そのものの説明だけを書くのがおすすめです

サイズや色違いなどのバリエーションがある商品は、次の手順で「商品バリエーション（SKU）情報」から登録してください。

バリエーション（SKU）を登録する

例えば、同じTシャツでもサイズ M と L を別々に在庫管理したい場合は、サイズごとにバリエーション（SKU）を登録します。商品の作成画面でも、登録済みの商品の詳細画面でも同じ手順です。

「商品バリエーション（SKU）情報」の「バリエーション（SKU）情報を登録する」をクリック
右側に開く「バリエーションを作成する」で、「SKU ID」と「SKU名」を入力（SKU名はeギフトの購入時（タグ連携時のみ）と受取時に表示されます）
同じ画面で「商品価格」と「在庫数」を入力
「バリエーションを保存」をクリック。表に1行追加されます。バリエーションが複数あるときは、手順1〜4を繰り返します
右下の「保存」をクリック。商品一覧の「在庫数」列に「2バリエーション」のようにSKUの数が表示されます
価格と在庫数はSKUごと: SKUを登録すると、商品全体の「在庫数」「商品価格」の入力欄はなくなり、SKUごとの値を使います。変えるときは表の「編集」から開きます
OMSをご利用の場合: 「SKU ID」は、OMS上のSKU ID（商品コード）と合わせる必要があります。OMS側の商品コードを別に入れたいときは「OMS SKU ID」に入力します（空欄の場合、表には SKU ID が表示されます）
SKU画像URL: SKUごとの画像を1枚登録できます。登録しない場合は商品画像が表示されます
金券型eギフト: 在庫数の入力は不要です（ギフトコードは「ギフトコード設定」から登録します）
バリエーション選択型eギフト: 全バリエーションを同じ価格にしてください
表のゴミ箱アイコンで、SKUを削除できます
購入画面での並び順: eギフトの購入画面では、バリエーションは「SKU ID」の文字の並び順（辞書順）で表示されます。登録した順や任意の順に並べ替える機能はありません。表示順をそろえたいときは、例えば TSHIRT-01-S、TSHIRT-02-M、TSHIRT-03-L のように、並べたい順になるSKU IDを付けてください（10 は 2 より前に並ぶため、数字は桁をそろえると確実です）

eギフト対象フラグ: この設定が有効な商品のみ、ECサイトのギフトボタンから購入できます。フラグが無効の商品はギフト購入対象外となります。

CSV 一括インポート

複数の商品を一括登録・更新する場合は CSV インポートを使います。以下の手順に従ってください。

手順1：カートの商品管理ページからCSVをエクスポート

あなたのストアの商品管理から直接CSVファイルをダウンロードし、eギフト対象商品の情報が記載されたファイルをご用意ください。

バリエーションがある商品の場合は、バリエーションCSVファイルもご共有ください

バリエーションとは？ 商品に対してサイズ（S,M,L）や色（赤,青,緑）などのことを指します。

手順2：商品登録用CSVに情報を転記

商品CSVファイルを下記フォーマットのeギフト商品登録CSVに整形し、転記してください。

⬇️以下のGoogle Sheetsをコピーしてご使用ください： eギフト商品登録テンプレート

手順3：登録に必要な不足情報を埋める

手順2が完了したのち、以下の不足情報があればご記載をお願いします：

商品画像
在庫数

商品別のeギフト送料はCSVでは登録できません。インポート後に管理画面から設定してください（送料の詳細はこちら）。

各列の説明

インポートでは1行目（見出し行）を読み飛ばし、2行目以降を列の順番どおりに読み込みます。見出しの名前は見ていないため、列の順番を入れ替えたり、列を足したり減らしたりすると、別の項目として登録されてしまいます。管理画面の商品データのエクスポートで出力したCSVは同じ12列・同じ順番なので、これをひな形にすると安全です。

順番	列名	説明	必須・任意	空欄のとき
1	商品ID	ストアで内部的に管理している任意のIDです。商品ページにて動的に取得できる値にしてください。また、商品ページにてAnyGiftタグに設定する際の`productId`と同一になるようにしてください	必須	エラー
2	商品名	商品名です。実際にオンラインストアで販売している商品名と同様にしてください	必須	エラー
3	商品説明	商品の説明文です。設定されている場合は、eギフト受取ページに商品の説明文を表示します。CSVのセル内で改行（Alt+Enter等）を行った場合、その改行が反映された状態で登録されます	任意	説明なし
4	商品画像URL	eギフト受取ページなどで商品の画像を表示する際に使います。必ずリンクから直接取得できる画像URLをご記入ください（例：`https://img07.shop-pro.jp/PA01460/417/product/155774417.jpg`）。複数の画像はカンマ（`,`）で区切って1つのセルに書きます	任意	画像なし
5	商品バリエーション(SKU)ID	内部的にSKUのIDがあるかと思いますが、もし無い場合は商品IDと同じでも構いません	必須	エラー
6	商品バリエーション(OMSSKU)ID	OMSと連携する場合に使う、OMS上の商品コードです。SKU IDとOMSの商品コードが違う場合に入力します	任意	SKU IDと同じ値
7	商品バリエーション(SKU)名	バリエーション名です。バリエーションの有無に関わらず必須です。バリエーションがない商品には「default」と記載してください	必須	エラー
8	商品バリエーション(SKU)画像URL	SKUに固有の画像で、こちらが優先して表示されます。必ずリンクから直接取得できる画像URLをご記入ください。指定がなければ商品画像が表示されます	任意	SKU画像なし
9	商品価格(税込)	各バリエーションの価格です。オンラインストアで販売している商品の金額をご入力ください	入力してください	0円で登録（エラーにならないため注意）
10	在庫数	AnyGift用の在庫数です	入力してください	0で登録（エラーにならないため注意）
11	商品ページURL	商品の詳細ページURL	任意	URLなし
12	eギフトON/OFF	「ON」と書いた商品がeギフトの対象になります。それ以外（空欄・「OFF」を含む）はeギフトの対象外として登録されます	任意	対象外（OFF）

同じ商品IDの行は、1つの商品のバリエーション（SKU）としてまとめて登録されます。商品名・商品説明・商品画像URL・商品ページURL・eギフトON/OFFのような商品単位の項目は、その商品IDの最初の行の値が使われます。

注意： 商品別送料はCSVでアップロードできません。管理画面から個別に設定してください。

手順4：AnyGift管理画面でCSVをインポート

同じ商品IDの商品は上書きされます（元に戻せません）

CSVの商品IDが登録済みの商品と同じ場合、その商品と、CSVに書いたバリエーション（SKU）はすべての列がCSVの内容で置き換えられます。変えたいセルだけを書き換えるのではなく、全列を上書きする動作です。インポート画面にも「※CSVファイルに記載された商品・商品バリエーション情報はすべての列で置き換えられます。」と表示されます。

空欄のセルも「空」として上書きされます。 例えば価格だけを直すつもりで他の列を空欄にすると、商品説明・画像URL・商品ページURL・SKU画像は空に、在庫数は0に、eギフトはOFFになります（OMSSKU IDはSKU IDと同じ値になります）。一部の値だけを変えたいときも、エクスポートしたCSVを使い、変えない列には今の値を残してください。

更新前の内容に戻す操作はないため、登録済みの商品を含むCSVを使うときは、事前に商品データのエクスポートで今の内容を保存しておくと安心です。なお、CSVに書いていない商品と、CSVに書いていない登録済みのSKUは削除されず、そのまま残ります。

管理画面の「商品管理」を開き、右上の「インポート」をクリックします。
「CSVアップロード」の「CSVを追加」をクリックして、準備したCSVファイルを選びます（ファイルをドロップしても追加できます）。追加したファイル名が表示されます。CSVは UTF-8 で保存したファイルを使ってください。同じ商品IDの行は、1つの商品のバリエーション（SKU）として登録されます。
「実行」をクリックします。「商品を登録中...」と進み具合（件数）が表示されます。処理中に画面を閉じる・再読み込み・ページ移動をすると、そこで処理が中断されるため、完了するまで操作しないでください。
すべての行を登録できると「インポートしました」と表示され、商品一覧に戻ります。追加・更新した商品が一覧にあることを確認してください。エラーのある行があったときは「インポート結果」に成功・失敗の件数と、行番号つきのエラー内容が表示されます。CSVを直して「再アップロード」から、もう一度インポートしてください。

ファイルサイズが1MB以上の場合は分割してアップロードをお願いいたします

CSVで新しく作られた商品の商品タイプは「配送型eギフト・選べるeギフト」です。ほかの商品タイプにするときは、インポート後に商品詳細で変更してください。

ECカートとの自動同期

makeshop・futureshop・ebisumart・ecforce をご利用の場合、ECカート側の商品の追加・変更が AnyGift に自動的に同期されます。

makeshop: 商品が更新されると自動的に AnyGift の商品情報が更新されます
futureshop: 定期的に全商品を同期します
ebisumart・ecforce: 商品同期の設定が有効な場合に、定期的に同期します

自動同期を有効にするには、管理画面の外部連携設定でアプリのインストール・認証を行ってください。カートごとの設定方法は futureshop の連携設定と運用・makeshop の連携設定と運用をご覧ください。

ネクストエンジンとの商品同期

ネクストエンジンをご利用の場合、商品情報をネクストエンジンから同期できます。

管理画面の「外部連携」→「ネクストエンジン」で認証を完了する
「商品を同期する」を実行すると、ネクストエンジンの商品情報が AnyGift に同期されます

同期後、eギフトとして提供したい商品のフラグを個別または一括で更新してください。

商品登録時の文字数制限

商品登録（管理画面）における各項目の入力文字数制限と、制限を超えた場合の対応方法を説明します。

項目	最大文字数	必須	補足
商品コード（商品ID）	255文字	必須	ストア内で一意
商品名	255文字	必須	ギフト受取者に表示される名称
商品説明	1,000文字	任意	空文字での登録可能
SKUコード（バリエーション）	255文字	必須	各バリエーションごとに設定
OMS-SKUコード（バリエーション）	255文字	任意	OMS連携時に使用

制限を超えた場合の対応

管理画面での入力時

登録画面で文字数制限を超えて入力すると、項目の下にエラーメッセージが表示され、「保存」ボタンが無効化されます。

商品名が255文字を超えた場合 → 255文字以内で入力してください
商品説明が1,000文字を超えた場合 → 1000文字以内で入力してください
必須項目が未入力の場合 → 入力されていません

直接API経由での登録時

本ドキュメントの制限は管理画面のフロントエンドバリデーションによるものです。API を直接呼び出した場合、これらの文字数制限は適用されません。ただし、システムの安定性や表示上の理由から、上記の文字数以内での登録を推奨します。

よくある質問

Q: 制限文字数よりも短いのにエラーが出ます

A: 絵文字や特殊文字が含まれている可能性があります。見た目の文字数とプログラム上の文字数が異なる場合があるため、文字数を減らして再試行してください。

Q: 制限を変更することはできますか

A: 現時点では固定値です。変更が必要な場合は開発チームにご相談ください。

eギフトのON・OFFの切り替え

eギフトボタンは、eギフト設定が「ON」の商品にだけ表示されます。商品ごとに切り替えるほか、商品一覧からまとめて切り替えることもできます。

1件ずつ切り替える

AnyGift管理画面の「商品管理」を開き、商品一覧で切り替えたい商品の商品名をクリックします。
画面右側の「eギフト」のスイッチを切り替えます。切り替えた時点で保存され、「eギフト機能をONにしました」（OFFにした場合は「eギフト機能をOFFにしました」）と表示されます。「保存」を押す必要はありません。商品一覧の「eギフト」列にも反映されます。

まとめて切り替える

商品一覧で、切り替えたい商品の商品名の左にあるチェックボックスにチェックを入れます。一覧の上に「〇件を選択中」と表示されます。
「eギフト一括変更」をクリックし、「eギフトをONにする」または「eギフトをOFFにする」を選びます。「操作が完了しました」と表示され、商品一覧の「eギフト」列が切り替わります。

チェックできるのは、表示中のページの商品です（1ページ50件）。ストアのすべての商品をまとめて切り替えるときは、チェックを入れたあとに表示される「ストアの全ての商品を選択する」をクリックしてから「eギフト一括変更」を選びます。確認画面で「実行する」をクリックすると「処理の登録が完了しました」と表示され、処理は時間をかけて進みます。しばらく時間をおいてから、商品一覧で切り替わったことを確認してください。

eギフトボタンが表示されないときの確認順は、よくある質問の「eギフトボタンが表示されない場合」をご覧ください。

在庫の管理

AnyGift タグ挿入型では、各商品バリエーションの在庫数を AnyGift 側で管理します。

在庫の更新方法

方法	説明
管理画面から手動更新	商品詳細ページから在庫数を直接変更
ECカート連携	makeshop / futureshop から在庫を自動同期
ネクストエンジン連携	ネクストエンジンから在庫更新通知を受信して自動更新
CROSS MALL連携	CROSS MALLから定期的にCSVで在庫を更新

在庫切れ時の動作

在庫数が 0 になると、その商品バリエーションはギフト購入対象外となり、ECサイトのギフトボタンから購入できなくなります。

在庫の補充は、管理画面の商品詳細ページから手動で更新するか、連携しているシステムから自動的に同期されます。

通常購入の在庫との関係

AnyGiftの在庫数は、ECサイトで通常購入できる在庫とは別に管理されています。初期状態では、通常購入とeギフトの在庫は連携していません。 通常購入で商品が売れても、何も設定していなければAnyGiftの在庫数は減りません。そのままでは、実際の在庫がないのにeギフトとして売れてしまう（売り越し）おそれがあります。

在庫の持ち方に合わせて、次のどれかを選んでください。

在庫の管理場所	選べる方法
ネクストエンジン・CROSS MALL で在庫を管理している	OMSとAnyGiftを連携して在庫を取り込む（上の「在庫の更新方法」を参照）
在庫連携に対応しているECカートで在庫を管理している	ECカートから在庫を同期する
上のどちらでもない	新たに連携の仕組みを用意する。AnyGift側の対応だけで済む場合と、あなたのシステム側の対応も必要な場合があるため、AnyGift担当窓口にご相談ください
在庫を連携せずに始める	在庫に余裕のある商品だけをeギフトの対象にし、在庫数を定期的に確認・更新する

利用中のECカートで在庫を連携できるかは、導入前にAnyGift担当窓口へご確認ください。

商品タイプの設定

商品を登録するときは、受け取った人がギフトをどう使うかに合わせて「商品タイプ」を選びます。

受け取った人は…	商品タイプ	補足
住所を入力して、商品を届けてもらう	配送型eギフト・選べるeギフト	基本のタイプです
色やサイズを選んでから、商品を届けてもらう	バリエーション選択型eギフト	全バリエーションを同じ価格で設定してください
お店で画面を見せて、商品と引き換える	店舗型eギフト	店頭で利用できるギフトです
ギフトコードを、お店やオンラインで使う	金券型eギフト	ギフトコードは「ギフトコード設定」から登録します。在庫数の入力は不要です

複数の商品から選べる「選べるギフト」は、商品タイプではありません。次の2ステップで作ります。

「商品管理」で、贈り手が購入する親商品を「配送型eギフト・選べるeギフト」で作る
「選べるギフト機能」で、受け取った人が選べる子商品を設定する

詳しくは選べるギフトをご覧ください。

「バリエーション選択型eギフト」が表示されない場合

次の連携をご利用のストアでは、「バリエーション選択型eギフト」は選択肢に表示されません。

ECカート連携: Salesforce Commerce Cloud、makeshop、ebisumart、ecforce
OMS連携: CROSS MALL、LOGILESS

商品タイプは商品の登録・編集時に設定できます。

商品データのエクスポート

商品データは CSV 形式でエクスポートできます。

管理画面の「商品管理」画面を開く
「CSVダウンロード」を実行
バックグラウンドで処理され、完了後にメールでダウンロードリンクが届きます。リンクの有効期限は6時間です（メールに期限の日時が記載されます）。期限を過ぎた場合は、もう一度「CSVダウンロード」を実行してください

エクスポートしたデータを加工して再インポートすることで、一括更新も可能です。

トラブルシューティング

商品登録時のエラー

商品の登録や更新時にエラーが発生した場合、以下の要因が考えられます。

エラーメッセージの内容が信頼できるもの

管理画面に表示されるエラーメッセージは正確です。エラーメッセージに記載されている内容に基づいて対応してください。よくあるメッセージ：

「必須項目が入力されていません」 → 商品名、SKUコード、価格、在庫数など必須項目を確認
「商品コードが重複しています」 → 既に存在する商品コード（SKU）を使用している
「形式が正しくありません」 → 価格は数値のみ、在庫数は整数のみなど形式を確認
「文字コードが無効です」 → UTF-8以外の文字コードが使用されている

UTF-8 以外の文字コードでエラーが発生

CSV ファイルの文字コードが UTF-8 でない場合、インポート時にエラーになります。

CSV ファイルを作成・編集する際は、必ず UTF-8 の文字コードで保存してください。

Excel での対応: 1. CSV ファイルを Excel で編集した場合、デフォルトでは UTF-8 にならないことがあります 2. 「名前を付けて保存」を選択 3. ファイル形式: 「CSV（カンマ区切り）」を選択 4. 文字コード: 「UTF-8」を明示的に選択して保存

別ツールでの対応: - Google Sheets → 「ファイル」→「ダウンロード」→「CSV（UTF-8、カンマ区切り）」を選択 - Numbers / LibreOffice Calc → 保存時に文字コードを UTF-8 に指定

ファイルが重い場合のタイムアウト

大量の商品を一度にインポートしようとした場合、タイムアウトエラーが発生する可能性があります。

解決方法：

分割インポート → 1回のインポートで 1000～5000 件程度に分割して実行
時間帯を選ぶ → システム処理が軽い時間帯（早朝、深夜）に実行
段階的な登録 → 必要な商品から優先的に登録し、残りは後日に分ける

補足: 現在のシステムではタイムアウトが起きにくくなっていますが、極めて大量のデータを扱う場合は上記の対応をお勧めします。

その他のエラー

エラーメッセージが不明確な場合や上記に該当しない場合は、以下を確認してください：

列の順番 → 12列が決まった順番で並んでいるか確認（1行目は見出しとして読み飛ばされます。エクスポートしたCSVと列を見比べると確実です）
空行・余分な行 → ファイルの最後に空行がないか確認
特殊文字 → 商品説明に改行やクォーテーションが含まれていないか確認
ファイルサイズ → ファイルが壊れていないか、別のツールで開いて確認

それでも解決しない場合は、サポートにお問い合わせください。

商品の削除

AnyGift管理画面に登録した商品の削除は、連携方法によって挙動が異なります。

手動連携の場合

管理画面から商品を登録している場合は、以下の方法で削除できます。

方法	可否
商品一覧から1ページずつ一括削除	可能
商品を1件ずつ削除（商品詳細→削除）	可能
全商品削除	可能
CSVでの一括削除	不可（CSVインポートは登録・更新（upsert）のみ対応）

商品一覧から一括削除する手順

AnyGift管理画面の 「商品管理」 を開きます。
商品一覧で、削除する商品の 商品名の横にあるチェックボックス にチェックを入れます。
「eギフト一括変更」 の横にある 「・・・」 をクリックします。
表示されたメニューから 「商品を削除」 をクリックします。
確認画面が表示された場合は、内容を確認して削除を実行します。

一括削除では、現在の商品一覧ページに表示されている商品を、最大50件まで削除できます。50商品を超えて登録されている場合は、現在のページで削除を実行した後、次のページへ移動し、同じ手順を繰り返してください。

手動連携の場合、AnyGift管理画面以外に商品データの同期元がないため、削除した状態が維持されます。

ECカートAPI連携の場合

makeshop・futureshop・ebisumart・ecforce などECカートとAPI連携している場合、1時間ごと（毎時30分ごろ）にカートの商品情報が自動で取り込まれます。そのため、カートに残っている商品を AnyGift管理画面から削除しても、取込のタイミングで再び登録されることがあります。カート側で削除した商品が AnyGift からも消えるかどうかは、カートによって異なります。

カート	カート側で商品を削除したとき
futureshop・ebisumart	1時間ごとの取込で、カートにない商品は AnyGift からも削除されます（選べるギフトの親商品は除きます）
makeshop	makeshop アプリをインストールしている場合、makeshop で商品を削除するとその通知を受けて AnyGift からも削除されます。1時間ごとの取込では削除されません
ecforce	取込では更新された商品だけを読み込むため、AnyGift から自動で削除されることはありません

正しい削除方法:

ECカート側で該当商品を削除する → 上の表のとおり、futureshop・ebisumart・makeshop（アプリ利用時）では AnyGift 側からも削除されます。ecforce の場合や自動で削除されない場合は、カート側で削除したうえで AnyGift管理画面からも削除してください
eギフト設定をOFFにする → AnyGift管理画面には商品情報が残ったままになりますが、その商品のサイト上にはeギフトボタンは表示されません。