makeshopで構築したショップ以外のサイトからでも商品をカートに入れることができる機能です。
外部ページから直接買い物カゴに商品を入れることができるので商品詳細ページにたどり着けなかったお客様へもスムーズに決済までご案内できます。
カゴだけmakeshop利用イメージ
かんたんなHTML入力で外部ページから直接買い物カゴに商品を入れることができます。
ご利用例
- 外部の商品紹介ページやLP（ランディングページ）で購入させたい
- 外部のWordPress（ワードプレス）やブログの記事で購入させたい
- makeshopの独自ページで購入させたい
前提条件／利用対象・方法
前提条件
- makeshopでショップを持っており、登録済みの商品がある
- 初歩的なHTML知識がある
- カゴだけmakeshopを設置可能なページがある
カゴだけmakeshopを設置可能なページの詳細条件
・HTMLの入力が可能であること
・フォームタグが動作すること
フォームタグにつきましては、一部のブログサービス等で正常に動作しない場合がございます。
あらかじめご了承ください。利用対象・方法
- 対象：全プラン（プレミアムプラン、makeshopエンタープライズ）
- ご利用料金：無料
- 利用申請：不要
主な機能（対応・未対応機能）
対応機能
- 複数の商品（最大50種）の同時カゴ入れ
- バリエーション／カスタムセレクト（条件分岐は対象外）／オプショングループ
※バリエーションとオプショングループ、カスタムセレクトとオプショングループは併用不可 - 定期購入商品 ※要オプション契約
- 予約販売商品 ※要オプション契約
- 会員専用※1（ショップ／カテゴリ／商品※2）
※1：ショップ会員様がログイン状態であることが前提となります。
未ログインの場合、エラーメッセージが表示され、商品はカゴに入りません。
※2：要オプション契約
要オプション契約の機能に関しましては、下記ページをご参照ください。
・定期購入オプションについて
・予約販売機能について
・【会員制・卸売りに特化】BtoBオプションについて
未対応機能
- 名入れ商品
- 商品詳細画面（商品説明文）、商品カテゴリー画面への設置
- ショップデザイン / テンプレート選択・編集 / スマホ基本設定 「スマートフォンショップの設定」が「最適化しない」の時
- 条件分岐を利用したカスタムセレクト
HTML入力例（ボタン画像）
ボタン画像の場合
■ソース例
※SSL適用中の場合、1行目のショップURLはhttpsで記述してください。
<form action="https://【ショップ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" を追記してください。
<form action="ショップURL/api/basket/add.html" method="post">↓
<form action="ショップURL/api/basket/add.html" method="post" accept-charset="EUC-JP">商品データ説明
brand_info パラメータには、カンマ区切りで以下の値を順番に指定します。
＜記述例＞
1,000000000024,1,N,1,1,A|100（もしくは）CS000041:3|
[1] 1 コード区分 |
[2] 000000000024 商品コード |
[3] 1 数量 |
[4] N 定期購入フラグ |
[5] 1 オプション１ID |
[6] 1 オプション２ID |
[7] A|100 オプション もしくは CS000041:3 カスタム |
| 位置 | 項目名 | 必須 | 説明 |
|---|---|---|---|
| [1] | コード区分 | ○ |
0 ＝ 独自商品コード、1 ＝ システム商品コード |
| [2] | 商品コード | ○ | コード区分で指定した種類に対応する商品コード |
| [3] | 数量 | ○ | カートに入れる数量（整数） |
| [4] | 定期購入フラグ | ○ |
Y ＝ 定期購入商品、N ＝ 普通商品 |
| [5] | バリエーション オプション１ID |
— | バリエーションのオプション１IDの値（未使用の場合は空欄） |
| [6] | バリエーション オプション2ID |
— | バリエーションのオプション２IDのの値（未使用の場合は空欄） |
| [7] | オプショングループ | — | オプショングループの値（未使用の場合は空欄） ※オプショングループとカスタムセレクトの併用はできません。 |
| [7] | カスタムセレクト | ※ |
カスタムセレクトID:値 の形式で指定。複数ある場合はカンマ区切りで追加。※オプショングループとカスタムセレクトの併用はできません。 ※ 商品にカスタムセレクトが必須設定されている場合は指定必須 |
カスタムセレクトは
brand_info の末尾（[7]以降）に カスタムセレクトID:値 の形式で追記します。条件分岐を設定しているカスタムセレクトが1つでも含まれる商品は、カゴだけmakeshopでは対応していません。
商品データ入力例（利用パターン別）
| 商品1品を1個 |
"1,000000001234,1" 「1」はシステム商品コードの場合のコード区分、「000000001234」は商品コード、「1」は数量1個 |
| 商品2品を1個 |
"1,000000001234,2" 「1」はシステム商品コードの場合のコード区分、「000000001234」は商品コード、「2」は数量2個 |
| 商品2品 |
"1,000000001234,1||1,000000005678,1" 「||」（ダブルパイプ）で商品データを連結※50個まで連結可 |
| オプション1あり商品 |
"1,000000001234,1,N,2" 「N」は普通商品、「2」はバリエーションのオプション１で選択肢2つ目の指定 |
| オプション1・2あり商品 |
"1,000000001234,1,N,2,2" 「2」はバリエーションのオプション１、オプション2ともに選択肢2つ目の指定 |
| オプショングループありの商品 |
"1,000000001234,1,N,,,A|100" 「A|100」はオプショングループの[アイテム名]|[金額値] ※文字コードはEUC-JP |
| 独自商品コード/定期購入 |
"2,mycode1234,1,Y" 「2」は独自商品コードの場合のコード区分、「mycode1234」は商品コード、「Y」は定期購入商品の場合のコード区分 |
| カスタムセレクトあり商品（ドロップダウン・カード・ラジオ） |
"1,0000000001234,1,N,,,CS000001:3" 「CS000001:3」は[カスタムセレクトID]:[選択肢ID] |
| カスタムセレクトあり商品（数値入力タイプ） |
"1,0000000001234,1,N,,,CS000002:50.5" 「CS000002:50.5」は[カスタムセレクトID]:[入力する数値] |
| カスタムセレクトあり商品（複数） |
"1,000000001234,1,N,,,CS000003:1,CS000004:2,CS000005:3" カスタムセレクトを複数指定する場合は、カンマ区切りで並べます |
リクエストURL・パラメータ様式
1.リクエストURL
https://【ショップURL（独自ドメイン可）】/api/basket/add.html※【ドメイン認証SSL（有料）】適用中の場合、ショップURLはhttpsで記述してください。
2.リクエスト・レスポンス様式
リクエスト： HTTP POST方式、文字コード=EUC-JP
レスポンス：なし（遷移先でエラーメッセージがブラウザ標準ダイアログ表示されます）
3.リクエストパラメータ
| パラメータ名 | リクエスト概要 | 内容 | 備考 |
|---|---|---|---|
| brand_info | 商品1件 （商品データ） |
コード区分,商品コード,数量,定期購入フラグ,オプション１コード,オプション２コード,オプショングループ選択値 | カンマはすべて必須 （必須でない項目は値なし入力） |
| 複数商品の同時登録 （ダブルパイプ"||"連結） |
複数商品を同時に買い物カゴ登録する場合は、上記「商品データ」をダブルパイプ"||"連結しbrand_infoに設定する。 （例）コード区分,商品コード,数量, …,オプショングループ選択値||コード区分,商品コード,数量,…,オプショングループ選択値||コード区分,商品コード,数量,…,オプショングループ選択値 |
※同時登録は１リクエスト最大50件まで |
商品データ詳細
| 項目名 | 必須 | 説明 | 値の範囲 | 備考 |
|---|---|---|---|---|
| 商品コード種別 | ○ | 商品コード種別を指定します。 | 1 = システム商品コード 2 = 独自商品コード |
|
| 商品コード | ○ | makeshopに登録済みのコード区分に該当する商品コードを指定します。 | システム商品コード：12桁の数字 独自商品コード：文字列 |
makeshopに登録済み商品の商品コードと完全一致した場合に処理対象となります。 同じ独自商品コードがショップ内に複数ある場合は最初に照合された商品レコードが処理されます。 |
| 数量 | ○ | 指定した商品を買い物カゴに入れる数量を指定します。 | 1以上の整数 | 同じ商品が買い物カゴに既に存在した場合、注文数は追加されます。 |
| 定期購入フラグ | ‐ | 定期購入商品か通常商品かを指定します。 | Y = 定期購入商品 N = 通常商品 |
定期購入オプションを未使用の場合は「N」を指定します。 |
| オプション１ | ‐ | 選択された値を設定します。 （オプション項目に登録順の値） |
なし、もしくは1以上の整数 | バリエーション（旧：オプション）項目値は 商品管理 / 商品一覧 / アップロード・ダウンロード / オプション一括修正 でダウンロードできるCSVの「オプション１ID」「 オプション２ID 」で確認できます。 |
| オプション２ | ‐ | 選択された値を設定します。 （オプション項目に登録順の値） |
なし、もしくは1以上の整数 | |
| オプショングループ選択値 | ‐ | "項目名|金額設定値" の様式で 選択された値をカンマ区切りで設定します。 |
なし、もしくは"項目名|金額設定値" |
※文字コード=EUC-JPであること ※バリエーション／カスタムセレクトとの併用不可 |
| カスタムセレクト指定 | ‐ |
"カスタムセレクトID:値"
|
・選択タイプ（ドロップダウン・カード・ラジオ）の場合、値は「選択肢ID」を指定 ・数値入力タイプの場合、値は「入力する数値」を指定 ・複数カスタムセレクトを指定する場合は、カンマ区切りで並べる |
・「条件分岐」を設定しているカスタムセレクトが1つでも含まれる商品は、買い物かごに入れることができません。 ※オプショングループとの併用不可 |
カスタムセレクトID・数値の確認方法
1. カスタムセレクトID の確認
方法1：管理画面からの確認
（1）管理画面：商品管理 / 機能・設定 / カスタムセレクト一覧 を開く
（2）対象のカスタムセレクトをクリック
（3）カスタムセレクト編集画面の基本情報項目内の『カスタムセレクトID』を確認
方法2：管理画面のURLから確認
管理画面：商品管理 / 機能・設定 / カスタムセレクト一覧/カスタムセレクト編集 のURL含まれる数字部分が ID です。
（例）
https://console.makeshop.jp/products/settings/custom-selects/CS000005?shopId=○○
2. 選択肢ID の確認（選択タイプのカスタムセレクトのみ）
選択タイプ（ドロップダウン・カード・ラジオボタン）の場合、各選択肢にはIDが振られています。
※数値入力タイプのカスタムセレクトにはこの手順は不要です（値を直接入力します）
（1）商品管理 / 機能・設定 / カスタムセレクト一覧 を開く
（2）対象のカスタムセレクトをクリック
（3）カスタムセレクト編集画面の右下「その他の操作」より「項目IDの確認」をクリック
（4）項目IDの確認画面よりIDを確認
エラーメッセージ
入力内容にエラーがあった場合、買い物カゴ画面を表示する際にエラーメッセージが表示されます。
（ブラウザ標準ダイアログで表示されます）
メッセージ一覧
下記に加え、複数商品を登録時にエラー発生時は「購入可能な商品のみカートに入ります。」と追加表示がされます。
| チェック内容 | エラーメッセージ |
|---|---|
| 配送サイクルが異なる定期購入商品が混在する場合 | お届けサイクルが違う定期購入商品が含まれています。 |
| アクセス権限（会員専用かどうか）がない商品 | アクセス権限のない商品が含まれています。 |
| バリエーション（旧：オプション）あり商品の場合、選択内容が未入力 | オプションが指定されていないため購入できない商品が含まれています。 |
| 同時入力は最大50個まで | 一度に登録できる商品は50商品までです。 |
| 予約できない商品の場合 | 予約できない商品が含まれています。 |
| 予約商品と通常商品（定期購入も対象）の 「同時注文」＝不可の場合 |
予約商品と通常商品は同時注文できません。 |
| 既に通常商品としてカゴに入っているのに、 同じ商品を定期購入としてカゴに入れようとした場合 |
同じ商品について通常商品と定期購入商品を同時に購入することはできません。 |
| 既に定期購入としてカゴに入っているのに、 同じ商品を通常商品としてカゴに入れようとした場合 |
同じ商品について通常商品と定期購入商品を同時に購入することはできません。 |
| 在庫数 | 在庫数が不足しているため購入できない商品が含まれています。 |
| 定期購入できない商品の場合 | 定期購入できない商品が含まれています。 |
| 最大注文限度数より数量が大きい | 最大注文限度数を上回っているため購入できない商品が含まれています。 |
| 最少注文限度数より数量が小さい | 最小注文限度数を下回っているため購入できない商品が含まれています。 |
| 非表示設定された商品 （参考：非表示カテゴリーの表示あり商品はOK） |
販売されていない商品が含まれています。 |
| 定期購入フラグ「N」のときに、実際の商品が定期購入商品だった場合 | 通常購入できない商品が含まれています。 |
| カスタムセレクトを設定している商品に対して、brand_info にカスタムセレクト情報が含まれていない | カスタムセレクトが指定されていないため購入できない商品が含まれています。 |
| 条件分岐ありのカスタムセレクトを持つ商品が含まれている | 対象外の商品が含まれています。 |
カスタムセレクトID:値 の形式以外が指定された |
カスタムセレクトの書式が正しくありません。 |
| 存在しないカスタムセレクトIDが指定された | カスタムセレクトが見つかりません。 |
| 指定したCSがその商品に紐づいていない | {カスタムセレクト名}はこの商品に設定されていません。 |
| 数値入力型に数値以外、または選択型に整数以外が指定された | {カスタムセレクト名}の入力値に誤りがあります。 |
| 選択型で存在しない選択肢IDが指定された | {カスタムセレクト名}の入力値が見つかりません。 |
よくある質問（FAQ）
Q.外部サイト（https）でカゴだけmakeshopを利用し、カゴに入れるボタンをクリックすると、下記のようなブラウザの警告メッセージが画面上に表示されます。（例：Google Chrome）
※makeshopのショップページはSSL化されていない状態
「送信しようとしている情報は保護されません
このフォームは安全ではない接続を使用して送信されているため、情報が他人に読み取られる可能性があります。」A.makeshopのページがSSL化されていないhttpページの場合、httpsから始まるSSLページから非SSLのページへ移動してフォームタグを動作させることになるため、ブラウザの警告画面が表示されることがあります。
makeshopのページを独自ドメイン適用とし、【ドメイン認証SSL（有料）】へお申し込み・適用いただくことがおすすめです。