カゴだけMakeShop機能についてMakeShopで構築したショップ以外のサイトからでも商品をカートに入れることができる機能です。
外部ページから直接買い物カゴに商品を入れることができるので商品詳細ページにたどり着けなかったお客様へもスムーズに決済までご案内できます。
- カゴだけMakeShop利用イメージ
- 前提条件／利用対象・方法
- 主な機能（対応・未対応機能）
- HTML記述例（ボタン画像）
- 商品データ記述例（利用パターン別）
- リクエストURL・パラメータ様式
- エラーメッセージ
- 運営ノウハウ集
カゴだけMakeShop利用イメージ
簡単なHTML記述で外部ページから直接買い物カゴに商品を入れることができます。
ご利用例
- 外部の商品紹介ページやLP（ランディングページ）で購入させたい
- 外部のWordPressやブログの記事で購入させたい
- MakeShopの独自ページで購入させたい
前提条件／利用対象・方法
前提条件
- MakeShopでショップを持っており、登録済みの商品がある
- 初歩的なHTML知識がある
- カゴだけMakeShopを設置可能なページがある
カゴだけMakeShopを設置可能なページの詳細条件は、HTMLの記述が可能であること、フォームタグが動作することになります。
フォームタグにつきましては、一部のブログサービス等で正常に動作しない場合がございますので、あらかじめご了承ください。
利用対象・方法
- 対象：全プラン（プレミアムショッププラン、MakeShopエンタープライズ）
- ご利用料金：無料
- 利用申請：不要
主な機能（対応・未対応機能）
対応機能
- 複数の商品（最大50種）の同時カゴ入れ
- オプション／オプショングループ ※併用不可
- 定期購入商品 ※要オプション契約
- 予約販売商品 ※要オプション契約
- 会員専用※1（ショップ／カテゴリ／商品※2）
※1ショップ会員様がログイン状態であることが前提となります。
未ログインの場合、エラーメッセージが表示され、商品はカゴに入りません。
※2要オプション契約
要オプション契約の機能に関しましては、下記ページをご参照ください。
未対応機能
- 名入れ商品
- 商品詳細画面（商品説明文）、商品カテゴリー画面への設置
- 【独自デザイン（スマホ）】>【スマホ基本設定】「スマートフォンショップの設定」が「最適化しない」の時
HTML記述例（ボタン画像）
ボタン画像の場合
■ソース例
|
1 2 3 4 |
<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> |
クリエイターモードご利用で「オプショングループ商品」の記述の場合
以下のように accept-charset="EUC-JP" を追記してください。
|
1 |
<form action="ショップURL/api/basket/add.html" method="post"> |
↓
|
1 |
<form action="ショップURL/api/basket/add.html" method="post" accept-charset="EUC-JP"> |
商品データ説明
商品データ記述例（利用パターン別）
リクエストURL・パラメータ様式
1.リクエストURL
|
1 |
http://【ショップURL（独自ドメイン可）】/api/basket/add.html |
2.リクエスト・レスポンス様式
リクエスト： HTTP POST方式、文字コード=EUC-JP
レスポンス：なし（遷移先でエラーメッセージがブラウザ標準ダイアログ表示されます）
3.リクエストパラメータ
| パラメータ名 | リクエスト概要 | 内容 | 備考 |
|---|---|---|---|
| brand_info | 商品1件 （商品データ） |
コード区分,商品コード,数量,定期購入フラグ,オプション１コード,オプション２コード,オプショングループ選択値 | カンマはすべて必須 （必須でない項目は値なし入力） |
| 複数商品の同時登録 （ダブルパイプ”||”連結） |
複数商品を同時に買い物カゴ登録する場合は、上記「商品データ」をダブルパイプ”||”連結しbrand_infoに設定する。 （例）コード区分,商品コード,数量, …,オプショングループ選択値||コード区分,商品コード,数量,…,オプショングルー プ選択値||コード区分,商品コード,数量,…,オプショングループ選択値 |
※同時登録は１リクエスト最大50件まで |
商品データ詳細
| 項目名 | 必須 | 説明 | 値の範囲 | 備考 |
|---|---|---|---|---|
| 商品コード種別 | ○ | 商品コード種別を指定します。 | 1 = システム商品コード 2 = 独自商品コード |
|
| 商品コード | ○ | MakeShopに登録済みのコード区分に該当する商品コードを指定します。 | システム商品コード：12桁の数字 独自商品コード：文字列 |
MakeShopに登録済み商品の商品コードと完全一致した場合に処理対象となります。 同じ独自商品コードがショップ内に複数ある場合は最初に照合された商品レコードが処理されます。 |
| 数量 | ○ | 指定した商品を買い物カゴに入れる数量を指定します。 | 1以上の整数 | 同じ商品が買い物カゴに既に存在した場合、注文数は追加されます。 |
| 定期購入フラグ | ‐ | 定期購入商品か通常商品かを指定します。 | Y = 定期購入商品 N = 通常商品 |
定期購入オプションを未使用の場合は「N」を指定します。 |
| オプション１ | ‐ | 選択された値を設定します。 （オプション項目に登録順の値） |
なし、もしくは1以上の整数 | オプション項目値は 【商品管理】>【CSV一括登録】>【オプション一括修正】 でダウンロードできるCSVの「オプション１ID」「 オプション２ID 」で確認できます。 |
| オプション２ | ‐ | 選択された値を設定します。 （オプション項目に登録順の値） |
なし、もしくは1以上の整数 | |
| オプショングループ選択値 | ‐ | "項目名|金額設定値" の様式で 選択された値をカンマ区切りで設定します。 |
なし、もしくは"項目名|金額設定値" | ※文字コード=EUC-JPであること 項目名 ＝オプショングループ設定に登録済み 「アイテム名」 金額設定値＝オプショングループ設定に登録済み金額値もしくは料率値 （例）金額値100円⇒100 料率-5%⇒-5% |
エラーメッセージ
入力内容にエラーがあった場合、買い物カゴ画面を表示する際にエラーメッセージが表示されます。
（ブラウザ標準ダイアログで表示されます）
メッセージ一覧
下記に加え、複数商品を登録時にエラー発生時は「購入可能な商品のみカートに入ります。」と追加表示がされます。
| チェック内容 | エラーメッセージ |
|---|---|
| 配送サイクルが異なる定期購入商品が混在する場合 | お届けサイクルが違う定期購入商品が含まれています。 |
| アクセス権限（会員専用かどうか）がない商品 | アクセス権限のない商品が含まれています。 |
| オプションあり商品の場合、オプション選択内容が未入力 | オプションが指定されていないため購入できない商品が含まれています。 |
| 同時入力は最大50個まで | 一度に登録できる商品は50商品までです。 |
| 予約できない商品の場合 | 予約できない商品が含まれています。 |
| 予約商品と通常商品（定期購入も対象）の 「同時注文」＝不可の場合 |
予約商品と通常商品は同時注文できません。 |
| 既に通常商品としてカゴに入っているのに、 同じ商品を定期購入としてカゴに入れようとした場合 |
同じ商品について通常商品と定期購入商品を同時に購入することはできません。 |
| 既に定期購入としてカゴに入っているのに、 同じ商品を通常商品としてカゴに入れようとした場合 |
同じ商品について通常商品と定期購入商品を同時に購入することはできません。 |
| 在庫数 | 在庫数が不足しているため購入できない商品が含まれています。 |
| 定期購入できない商品の場合 | 定期購入できない商品が含まれています。 |
| 最大注文限度数より数量が大きい | 最大注文限度数を上回っているため購入できない商品が含まれています。 |
| 最少注文限度数より数量が小さい | 最小注文限度数を下回っているため購入できない商品が含まれています。 |
| 非表示設定された商品 （参考：非表示カテゴリーの表示あり商品はOK） |
販売されていない商品が含まれています。 |
| 定期購入フラグ「N」のときに、実際の商品が定期購入商品だった場合 | 通常購入できない商品が含まれています。 |