カゴだけMakeShop 利用説明書

更新日

バージョン

対象ページ

概要

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種類へ変更いたしました。

2016/07/22

V1.13

P.5

設置非対応ページにスマートフォンショップの表示方法設定条件を追記

2020/11/06

V1.14

P.6

クリエイターモード（オプショングループ商品の場合）記述例追記

正式リリース

Copyright (c) 2004- 2016, GMO MAKESHOP Co. Ltd. All Rights Reserved.

もくじ

カゴだけMakeShop

１．利用イメージ
２．前提条件／利用対象・方法
３．主な仕様４．HTML記述例（ボタン画像）
５．商品データ記述例（利用パタン別）
６．リクエストURLとパラメータ様式

７．エラーメッセージ

Copyright (c) 2004- 2016, GMO MAKESHOP Co. Ltd. All Rights Reserved.

2１．利用イメージ

カゴだけMakeShop

簡単なHTML記述で外部ページから直接、買い物カゴに商品を入れることができます。
■利用ケース
・外部の商品紹介や特集LP（ランディングページ）で購入させたい
・外部のWordpressやブログの記事で購入させたい
・MakeShopの独自ページで購入させたい

商品ページ

外部WEBページ

MakeShop側

タルト屋BLOG
フルーツたっぷり美味しいタルト発売！

買い物カゴ
通常のカゴ入れタルトを購入する

この部分をHTML記述します

商品が直接にカゴに入る

Copyright (c) 2004- 2016, GMO MAKESHOP Co. Ltd. All Rights Reserved.

3２．前提条件／利用対象・方法

カゴだけMakeShop■前提条件
・MakeShopでショップを持っており、登録済み商品がある。
・初歩的なHTML知識を有する。

・カゴだけMakeShopを設置可能なページ（※）がある。
（※）カゴだけMakeShop設置可能条件
・HTMLが記述可能であること
・フォームタグが動作すること（一部のブログサービスなどで正常に動作しない場合がございます）■利用対象・方法
・対象

プレミアム

・利用料なし・利用申請不要

Copyright (c) 2004- 2016, GMO MAKESHOP Co. Ltd. All Rights Reserved.

4

３．主な仕様

カゴだけMakeShop■対応
・複数の商品（最大50種）の同時カゴ入れ
・オプション／オプショングループ

・定期購入商品※要オプション契約

・予約販売商品※要オプション契約※併用不可

・会員専用※1（ショップ／カテゴリ／商品※2）※1 ただしショップ会員ログイン状態であること。未ログインの場合、エラーメッセージが表示され、商品はカゴに入りません。
※2 要オプション契約■非対応
・名入れ商品・商品詳細画面（商品説明文）、商品カテゴリー画面への設置
・【独自デザイン（スマホ） > スマホ基本設定】「スマートフォンショップの設定」が「最適化しない」のとき

Copyright (c) 2004- 2016, GMO MAKESHOP Co. Ltd. All Rights Reserved.

5

４．HTML記述例（ボタン画像）

カゴだけMakeShop■ボタン画像の場合

太字・赤字箇所は本機能の仕様および対象範囲<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">※ボタン画像を指定※例 button.png

タルトを購入する</form>

ボタン画像はご用意ください※クリエイターモードご利用で「オプショングループ商品」の記述の場合 accept-charset="EUC-JP" を追記してください。
<form action="ショップＵＲＬ/api/basket/add.html" method="post">↓<form action="ショップＵＲＬ/api/basket/add.html" method="post" accept-charset="EUC-JP">■商品データ説明①商品コード種別⑤⑥オプション１・２

1=システム商品コード
2=独自商品コード

省略可（普通商品・オプション等なしの場合）

1,000000001234,1 ,N,1,1,A|100②商品コード③数量④定期購入フラグ
N=普通商品
Y=定期購入商品

Copyright (c) 2004- 2016, GMO MAKESHOP Co. Ltd. All Rights Reserved.

⑦オプショングループ※文字コード=EUC-JP
6

５．商品データ記述例（利用パタン別）

カゴだけMakeShop
数量=1個

1=システム商品コード

商品１品を1個"1,000000001234,1"
数量=2個

商品１品を2個"1,000000001234,2"
ダブルパイプ（||）で商品データを連結

商品２品※50個まで連結可"1,000000001234,1||1,000000005678,1"
商品①

商品②
オプション1で選択肢2つ目を選択

オプション１あり商品"1,000000001234,1,N,2"N=普通商品

オプション１・２両方とも選択肢2つ目を選択

オプション１・２あり商品"1,000000001234,1,N,2,2"
オプショングループの[アイテム名]|[金額値]オプショングループあり商品"1,000000001234,1,N,,,A|100"
2=独自商品コード

独自コード／定期購入※文字コード=EUC-JP※複数選択時はカンマで追加※金額値はマイナス／率指定も可例）…A|100,B|-100,C|10%,D|-10%

Y=定期購入"2,mycode1234,1,Y"
独自商品コード

Copyright (c) 2004- 2016, GMO MAKESHOP Co. Ltd. All Rights Reserved.

7６．リクエストURL・パラメータ様式

カゴだけMakeShop

１．リクエストURL
http://【ショップURL（独自ドメイン可）】/api/basket/add.html
２．リクエスト・レスポンス様式
リクエスト： HTTP POST方式、文字コード＝EUC-JP
レスポンス： なし（遷移先でエラーメッセージがブラウザ標準ダイアログ表示されます）３．リクエストパラメータ
パラメータ名リクエスト概要

内容

備考

brand_info

商品1件（商品データ）

コード区分,商品コード,数量,定期購入フラグ,オプション１コード,オプション２コード,オプショングループ選択値

カンマはすべて必須（必須でない項目は値なし入力）

複数商品の同時登録（ダブルパイプ"||"連結）

複数商品を同時に買い物カゴ登録する場合は、上記「商品データ」をダブルパイプ"||"連結しbrand_infoに設定する。
（例）コード区分,商品コード,数量, …,オプショングループ選択値||コード区分,商品コード,数量,…,オプショングルー
プ選択値||コード区分,商品コード,数量,…,オプショングループ選択値※同時登録は１リクエスト最大50件まで■商品データ詳細
項目名

必須

説明

値の範囲

備考

商品コード種別○

商品コード種別を指定します。

1 = システム商品コード
2 = 独自商品コード

商品コード

○

MakeShopに登録済みのコード区分に該当する商品コードを指定します。

システム商品コード：12桁の数字
独自商品コード：文字列

MakeShopに登録済み商品の商品コードと完全一致した場合に処理対象となります。同じ独自商品コードがショップ内に複数ある場合は最初に照合された商品レコードが処理されます。

数量○

指定した商品を買い物カゴに入れる数量を指定します。

1以上の整数同じ商品が買い物カゴに既に存在した場合、注文数は追加されます。

定期購入フラグ-定期購入商品か通常商品かを指定します。

Y = 定期購入商品
N = 通常商品

定期購入オプションを未使用の場合は「N」を指定します。

オプション１-選択された値を設定します。
（オプション項目に登録順の値）

なし、もしくは1以上の整数

オプション２-選択された値を設定します。
（オプション項目に登録順の値）

なし、もしくは1以上の整数

オプショングループ選択値-"項目名|金額設定値"の様式で選択された値をカンマ区切りで設定します。

なし、もしくは"項目名|金額設定値"

オプション項目値は「商品管理 > CSV一括登録 > オプション一括修正」でダウンロードできるCSVの「オプション１ID」「 オプション２ID 」で確認できます。

※文字コード=EUC-JPであること
項目名＝オプショングループ設定に登録済み「アイテム名」
金額設定値＝オプショングループ設定に登録済み金額値もしくは料率値（例）金額値100円⇒100 料率-5%⇒-5%

Copyright (c) 2004- 2016, GMO MAKESHOP Co. Ltd. All Rights Reserved.

8７．エラーメッセージ

カゴだけMakeShop■表示形式
入力内容にエラーがあった場合、買い物カゴ画面を表示する際にエラーメッセージが表示されます。
（ブラウザ標準ダイアログで表示されます）■メッセージ一覧
下記に加え、複数商品を登録時にエラー発生時は「購入可能な商品のみカートに入ります。」と追加表示されます。
チェック内容エラーメッセージ

同時入力は最大50個まで一度に登録できる商品は50商品までです。

在庫数在庫数が不足しているため購入できない商品が含まれています。

最少注文限度数より数量が小さい

最小注文限度数を下回っているため購入できない商品が含まれています。

最大注文限度数より数量が大きい

最大注文限度数を上回っているため購入できない商品が含まれています。

オプションあり商品の場合、オプション選択内容が未入力

オプションが指定されていないため購入できない商品が含まれています。

アクセス権限（会員専用かどうか）がない商品アクセス権限のない商品が含まれています。

非表示設定された商品（参考：非表示カテゴリーの表示あり商品はOK）販売されていない商品が含まれています。

予約商品と通常商品（定期購入も対象）の「同時注文」＝不可の場合予約商品と通常商品は同時注文できません。

配送サイクルが異なる定期購入商品が混在する場合お届けサイクルが違う定期購入商品が含まれています。

既に通常商品としてカゴに入っているのに、同じ商品を定期購入としてカゴに入れようとした場合同じ商品について通常商品と定期購入商品を同時に購入することはできません。

既に定期購入としてカゴに入っているのに、同じ商品を通常商品としてカゴに入れようとした場合同じ商品について通常商品と定期購入商品を同時に購入することはできません。

予約できない商品の場合予約できない商品が含まれています。

定期購入できない商品の場合定期購入できない商品が含まれています。

定期購入フラグ「N」のときに、実際の商品が定期購入商品だった場合通常購入できない商品が含まれています。

Copyright (c) 2004- 2016, GMO MAKESHOP Co. Ltd. All Rights Reserved.

9