Upload
others
View
8
Download
0
Embed Size (px)
Citation preview
Copyright (c) 2004- 2016, GMO MAKESHOP Co. Ltd. All Rights Reserved.
更新日 バージョン 対象ページ 概要
2015/4/16 v1.0 - 正式リリース
2016/4/15 V1.1 P.8 オプション項目値の備考を追記
2016/4/15 V1.11 P.5 設置非対応ページを追記
2016/06/16 V1.12 P5,7,8,9 最大登録数を10種類から50種類へ変更いたしました。
カゴだけMakeShop 利用説明書
Copyright (c) 2004- 2016, GMO MAKESHOP Co. Ltd. All Rights Reserved. 2
もくじ
1.利用イメージ
2.前提条件/利用対象・方法
3.主な仕様
4.HTML記述例(ボタン画像)
5.商品データ記述例(利用パタン別)
6.リクエストURLとパラメータ様式
7.エラーメッセージ
カゴだけMakeShop
Copyright (c) 2004- 2016, GMO MAKESHOP Co. Ltd. All Rights Reserved.
簡単なHTML記述で外部ページから直接、買い物カゴに商品を入れることができます。
3
外部WEBページ
1.利用イメージ
商品ページ
買い物カゴ
フルーツたっぷり美味しいタルト発売!
タルト屋BLOG
タルトを購入する
MakeShop側
通常のカゴ入れ
商品が直接にカゴに入る
■利用ケース
・外部の商品紹介や特集LP(ランディングページ)で購入させたい
・外部のWordpressやブログの記事で購入させたい
・MakeShopの独自ページで購入させたい
この部分を HTML記述します
カゴだけMakeShop
Copyright (c) 2004- 2016, GMO MAKESHOP Co. Ltd. All Rights Reserved. 4
2.前提条件/利用対象・方法
■前提条件
・MakeShopでショップを持っており、登録済み商品がある。
・初歩的なHTML知識を有する。
・カゴだけMakeShopを設置可能なページ(※)がある。
(※)カゴだけMakeShop設置可能条件
・HTMLが記述可能であること
・フォームタグが動作すること(一部のブログサービスなどで正常に動作しない場合がございます)
■利用対象・方法
・対象 プレミアム
・利用料 なし
・利用申請 不要
カゴだけMakeShop
Copyright (c) 2004- 2016, GMO MAKESHOP Co. Ltd. All Rights Reserved.
■対応
・複数の商品(最大50種)の同時カゴ入れ
・オプション/オプショングループ ※併用不可
・定期購入商品 ※要オプション契約
・予約販売商品 ※要オプション契約
・会員専用※1(ショップ/カテゴリ/商品※2) ※1 ただしショップ会員ログイン状態であること。未ログインの場合、エラーメッセージが表示され、商品はカゴに入りません。 ※2 要オプション契約
■非対応
・名入れ商品
・商品詳細画面(商品説明文)、商品カテゴリー画面への設置
5
3.主な仕様 カゴだけMakeShop
Copyright (c) 2004- 2016, GMO MAKESHOP Co. Ltd. All Rights Reserved.
1,000000001234,1 ,N,1,1,A|100
6
4.HTML記述例(ボタン画像)
<form action="http://【ショップURL(独自ドメイン可)】/api/basket/add.html" method="post">
<input type="hidden" name="brand_info" value="1,000000001234,1">
<input type="image" src="button.png" alt="add to cart">
</form>
①商品コード種別 1=システム商品コード 2=独自商品コード
②商品コード ③数量 ④定期購入フラグ N=普通商品 Y=定期購入商品
⑦オプショングループ ※文字コード=EUC-JP
商品データ
■ボタン画像の場合
■商品データ説明
省略可(普通商品・オプション等なしの場合)
⑤⑥オプション1・2
タルトを購入する
※例 button.png ※ボタン画像を指定
ボタン画像はご用意ください
太字・赤字箇所は本機能の仕様および対象範囲
カゴだけMakeShop
Copyright (c) 2004- 2016, GMO MAKESHOP Co. Ltd. All Rights Reserved. 7
5.商品データ記述例(利用パタン別)
商品1品を1個 "1,000000001234,1"
商品1品を2個 "1,000000001234,2"
商品2品 "1,000000001234,1||1,000000005678,1"
オプション1あり商品 "1,000000001234,1,N,2"
オプション1・2あり商品 "1,000000001234,1,N,2,2"
オプショングループあり商品 "1,000000001234,1,N,,,A|100"
独自コード/定期購入 "2,mycode1234,1,Y"
1=システム商品コード 数量=1個
数量=2個
ダブルパイプ(||)で商品データを連結 ※50個まで連結可
商品② 商品①
オプション1で選択肢2つ目を選択
オプション1・2両方とも選択肢2つ目を選択
オプショングループの[アイテム名]|[金額値]
※文字コード=EUC-JP ※複数選択時はカンマで追加 ※金額値はマイナス/率指定も可 例)…A|100,B|-100,C|10%,D|-10%
2=独自商品コード
独自商品コード
Y=定期購入
N=普通商品
カゴだけMakeShop
Copyright (c) 2004- 2016, GMO MAKESHOP Co. Ltd. All Rights Reserved. 8
6.リクエストURL・パラメータ様式
1.リクエストURL
http://【ショップURL(独自ドメイン可)】/api/basket/add.html
2.リクエスト・レスポンス様式
リクエスト: HTTP POST方式、文字コード=EUC-JP
レスポンス: なし(遷移先でエラーメッセージがブラウザ標準ダイアログ表示されます)
3.リクエストパラメータ
■商品データ詳細
パラメータ名 リクエスト概要 内容 備考
brand_info 商品1件(商品データ) コード区分,商品コード,数量,定期購入フラグ,オプション1コード,オプション2コード,オプショングループ選択値 カンマはすべて必須 (必須でない項目は値なし入力)
複数商品の同時登録 (ダブルパイプ"||"連結)
複数商品を同時に買い物カゴ登録する場合は、上記「商品データ」をダブルパイプ"||"連結しbrand_infoに設定する。 (例)コード区分,商品コード,数量, …,オプショングループ選択値||コード区分,商品コード,数量,…,オプショングループ選択値||コード区分,商品コード,数量,…,オプショングループ選択値
※同時登録は1リクエスト最大50件まで
項目名 必須 説明 値の範囲 備考
商品コード種別 ○ 商品コード種別を指定します。 1 = システム商品コード 2 = 独自商品コード
商品コード ○ MakeShopに登録済みのコード区分に該当する商品コードを指定します。
システム商品コード:12桁の数字 独自商品コード:文字列
MakeShopに登録済み商品の商品コードと完全一致した場合に処理対象となります。同じ独自商品コードがショップ内に複数ある場合は最初に照合された商品レコードが処理されます。
数量 ○ 指定した商品を買い物カゴに入れる数量を指定します。
1以上の整数 同じ商品が買い物カゴに既に存在した場合、注文数は追加されます。
定期購入フラグ - 定期購入商品か通常商品かを指定します。 Y = 定期購入商品 N = 通常商品
定期購入オプションを未使用の場合は「N」を指定します。
オプション1 - 選択された値を設定します。 (オプション項目に登録順の値)
なし、もしくは1以上の整数 オプション項目値は「商品管理 > CSV一括登録 > オプション一括修正」でダウンロードできるCSVの「オプション1ID」「 オプション2ID 」で確認できます。 ※「商品管理 > 商品の設定 > 商品の登録/修正」よりオプションの値を削除し保存した場合、画面上の並び順とIDは異なる場合があります。
オプション2 - 選択された値を設定します。 (オプション項目に登録順の値)
なし、もしくは1以上の整数
オプショングループ選択値 - "項目名|金額設定値"の様式で 選択された値をカンマ区切りで設定します。
なし、もしくは"項目名|金額設定値" ※文字コード=EUC-JPであること 項目名 =オプショングループ設定に登録済み「アイテム名」 金額設定値=オプショングループ設定に登録済み金額値もしくは料率値 (例)金額値100円⇒100 料率-5%⇒-5%
カゴだけMakeShop
Copyright (c) 2004- 2016, GMO MAKESHOP Co. Ltd. All Rights Reserved. 9
7.エラーメッセージ
■表示形式
入力内容にエラーがあった場合、買い物カゴ画面を表示する際にエラーメッセージが表示されます。
(ブラウザ標準ダイアログで表示されます)
■メッセージ一覧
下記に加え、複数商品を登録時にエラー発生時は「購入可能な商品のみカートに入ります。」と追加表示されます。
チェック内容 エラーメッセージ
同時入力は最大50個まで 一度に登録できる商品は50商品までです。
在庫数 在庫数が不足しているため購入できない商品が含まれています。
最少注文限度数より数量が小さい 最小注文限度数を下回っているため購入できない商品が含まれています。
最大注文限度数より数量が大きい 最大注文限度数を上回っているため購入できない商品が含まれています。
オプションあり商品の場合、オプション選択内容が未入力 オプションが指定されていないため購入できない商品が含まれています。
アクセス権限(会員専用かどうか)がない商品 アクセス権限のない商品が含まれています。
非表示設定された商品 (参考:非表示カテゴリーの表示あり商品はOK)
販売されていない商品が含まれています。
予約商品と通常商品(定期購入も対象)の「同時注文」=不可の場合 予約商品と通常商品は同時注文できません。
配送サイクルが異なる定期購入商品が混在する場合 お届けサイクルが違う定期購入商品が含まれています。
既に通常商品としてカゴに入っているのに、同じ商品を定期購入としてカゴに入れようとした場合 同じ商品について通常商品と定期購入商品を同時に購入することはできません。
既に定期購入としてカゴに入っているのに、同じ商品を通常商品としてカゴに入れようとした場合 同じ商品について通常商品と定期購入商品を同時に購入することはできません。
予約できない商品の場合 予約できない商品が含まれています。
定期購入できない商品の場合 定期購入できない商品が含まれています。
定期購入フラグ「N」のときに、実際の商品が定期購入商品だった場合 通常購入できない商品が含まれています。
カゴだけMakeShop