利 用 説 明 書 更 新 日 バージョン 対 象 ページ 概 要 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 種 類 へ 変 更 いたしました Copyright (c) 2004-2016, GMO MAKESHOP Co. Ltd. All Rights Reserved.
もくじ 1. 利 用 イメージ 2. 前 提 条 件 / 利 用 対 象 方 法 3. 主 な 仕 様 4.HTML 記 述 例 (ボタン 画 像 ) 5. 商 品 データ 記 述 例 ( 利 用 パタン 別 ) 6.リクエストURLとパラメータ 様 式 7.エラーメッセージ Copyright (c) 2004-2016, GMO MAKESHOP Co. Ltd. All Rights Reserved. 2
１ 利用イメージ 簡単なHTML記述で外部ページから直接 買い物カゴに商品を入れることができます 利用ケース 外部の商品紹介や特集LP ランディングページ で購入させたい 外部のWordpressやブログの記事で購入させたい MakeShopの独自ページで購入させたい 商品ページ 外部WEBページ MakeShop側 タルト屋BLOG フルーツたっぷり美味しいタルト発売 買い物カゴ 通常のカゴ入れ タルトを購入する この部分を HTML記述します 商品が直接にカゴに入る Copyright (c) 2004-2016, GMO MAKESHOP Co. Ltd. All Rights Reserved. 3
2. 前 提 条 件 / 利 用 対 象 方 法 前 提 条 件 MakeShopでショップを 持 っており 登 録 済 み 商 品 がある 初 歩 的 なHTML 知 識 を 有 する を 設 置 可 能 なページ( )がある ( ) 設 置 可 能 条 件 HTMLが 記 述 可 能 であること フォームタグが 動 作 すること( 一 部 のブログサービスなどで 正 常 に 動 作 しない 場 合 がございます) 利 用 対 象 方 法 対 象 プレミアム 利 用 料 なし 利 用 申 請 不 要 Copyright (c) 2004-2016, GMO MAKESHOP Co. Ltd. All Rights Reserved. 4
3. 主 な 仕 様 対 応 複 数 の 商 品 ( 最 大 50 種 )の 同 時 カゴ 入 れ オプション/オプショングループ 併 用 不 可 定 期 購 入 商 品 要 オプション 契 約 予 約 販 売 商 品 要 オプション 契 約 会 員 専 用 1 (ショップ/カテゴリ/ 商 品 2 ) 1 ただしショップ 会 員 ログイン 状 態 であること 未 ログインの 場 合 エラーメッセージが 表 示 され 商 品 はカゴに 入 りません 2 要 オプション 契 約 非 対 応 名 入 れ 商 品 商 品 詳 細 画 面 ( 商 品 説 明 文 ) 商 品 カテゴリー 画 面 への 設 置 Copyright (c) 2004-2016, GMO MAKESHOP Co. Ltd. All Rights Reserved. 5
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> ボタン 画 像 を 指 定 例 button.png タルトを 購 入 する ボタン 画 像 はご 用 意 ください 商 品 データ 説 明 1 商 品 コード 種 別 1=システム 商 品 コード 2= 独 自 商 品 コード 省 略 可 ( 普 通 商 品 オプション 等 なしの 場 合 ) 56オプション1 2 1,000000001234,1,N,1,1,A 100 2 商 品 コード 3 数 量 4 定 期 購 入 フラグ N= 普 通 商 品 Y= 定 期 購 入 商 品 7オプショングループ 文 字 コード=EUC-JP Copyright (c) 2004-2016, GMO MAKESHOP Co. Ltd. All Rights Reserved. 6
5. 商 品 データ 記 述 例 ( 利 用 パタン 別 ) 1=システム 商 品 コード 商 品 1 品 を1 個 "1,000000001234,1" 数 量 =1 個 数 量 =2 個 商 品 1 品 を2 個 "1,000000001234,2" ダブルパイプ( )で 商 品 データを 連 結 50 個 まで 連 結 可 商 品 2 品 "1,000000001234,1 1,000000005678,1" 商 品 1 商 品 2 オプション1で 選 択 肢 2つ 目 を 選 択 オプション1あり 商 品 "1,000000001234,1,N,2" N= 普 通 商 品 オプション1 2 両 方 とも 選 択 肢 2つ 目 を 選 択 オプション1 2あり 商 品 "1,000000001234,1,N,2,2" オプショングループあり 商 品 独 自 コード/ 定 期 購 入 "1,000000001234,1,N,,,A 100" 2= 独 自 商 品 コード "2,mycode1234,1,Y" 独 自 商 品 コード Y= 定 期 購 入 オプショングループの[アイテム 名 ] [ 金 額 値 ] 文 字 コード=EUC-JP 複 数 選 択 時 はカンマで 追 加 金 額 値 はマイナス/ 率 指 定 も 可 例 ) A 100,B -100,C 10%,D -10% Copyright (c) 2004-2016, GMO MAKESHOP Co. Ltd. All Rights Reserved. 7
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 - 選 択 された 値 を 設 定 します (オプション 項 目 に 登 録 順 の 値 ) オプション2 - 選 択 された 値 を 設 定 します (オプション 項 目 に 登 録 順 の 値 ) オプショングループ 選 択 値 - " 項 目 名 金 額 設 定 値 "の 様 式 で 選 択 された 値 をカンマ 区 切 りで 設 定 します なし もしくは1 以 上 の 整 数 なし もしくは1 以 上 の 整 数 なし もしくは" 項 目 名 金 額 設 定 値 " オプション 項 目 値 は 商 品 管 理 > CSV 一 括 登 録 > オプション 一 括 修 正 でダウ ンロードできるCSVの オプション1ID オプション2ID で 確 認 できます 商 品 管 理 > 商 品 の 設 定 > 商 品 の 登 録 / 修 正 よりオプションの 値 を 削 除 し 保 存 した 場 合 画 面 上 の 並 び 順 とIDは 異 なる 場 合 があります 文 字 コード=EUC-JPであること 項 目 名 =オプショングループ 設 定 に 登 録 済 み アイテム 名 金 額 設 定 値 =オプショングループ 設 定 に 登 録 済 み 金 額 値 もしくは 料 率 値 ( 例 ) 金 額 値 100 円 100 料 率 -5% -5% Copyright (c) 2004-2016, GMO MAKESHOP Co. Ltd. All Rights Reserved. 8
7.エラーメッセージ 表 示 形 式 入 力 内 容 にエラーがあった 場 合 買 い 物 カゴ 画 面 を 表 示 する 際 にエラーメッセージが 表 示 されます (ブラウザ 標 準 ダイアログで 表 示 されます) メッセージ 一 覧 下 記 に 加 え 複 数 商 品 を 登 録 時 にエラー 発 生 時 は 購 入 可 能 な 商 品 のみカートに 入 ります と 追 加 表 示 されます チェック 内 容 同 時 入 力 は 最 大 50 個 まで 在 庫 数 最 少 注 文 限 度 数 より 数 量 が 小 さい 最 大 注 文 限 度 数 より 数 量 が 大 きい オプションあり 商 品 の 場 合 オプション 選 択 内 容 が 未 入 力 アクセス 権 限 ( 会 員 専 用 かどうか)がない 商 品 非 表 示 設 定 された 商 品 ( 参 考 : 非 表 示 カテゴリーの 表 示 あり 商 品 はOK) 予 約 商 品 と 通 常 商 品 ( 定 期 購 入 も 対 象 )の 同 時 注 文 = 不 可 の 場 合 配 送 サイクルが 異 なる 定 期 購 入 商 品 が 混 在 する 場 合 既 に 通 常 商 品 としてカゴに 入 っているのに 同 じ 商 品 を 定 期 購 入 としてカゴに 入 れようとした 場 合 既 に 定 期 購 入 としてカゴに 入 っているのに 同 じ 商 品 を 通 常 商 品 としてカゴに 入 れようとした 場 合 予 約 できない 商 品 の 場 合 定 期 購 入 できない 商 品 の 場 合 定 期 購 入 フラグ N のときに 実 際 の 商 品 が 定 期 購 入 商 品 だった 場 合 エラーメッセージ 一 度 に 登 録 できる 商 品 は50 商 品 までです 在 庫 数 が 不 足 しているため 購 入 できない 商 品 が 含 まれています 最 小 注 文 限 度 数 を 下 回 っているため 購 入 できない 商 品 が 含 まれています 最 大 注 文 限 度 数 を 上 回 っているため 購 入 できない 商 品 が 含 まれています オプションが 指 定 されていないため 購 入 できない 商 品 が 含 まれています アクセス 権 限 のない 商 品 が 含 まれています 販 売 されていない 商 品 が 含 まれています 予 約 商 品 と 通 常 商 品 は 同 時 注 文 できません お 届 けサイクルが 違 う 定 期 購 入 商 品 が 含 まれています 同 じ 商 品 について 通 常 商 品 と 定 期 購 入 商 品 を 同 時 に 購 入 することはできません 同 じ 商 品 について 通 常 商 品 と 定 期 購 入 商 品 を 同 時 に 購 入 することはできません 予 約 できない 商 品 が 含 まれています 定 期 購 入 できない 商 品 が 含 まれています 通 常 購 入 できない 商 品 が 含 まれています Copyright (c) 2004-2016, GMO MAKESHOP Co. Ltd. All Rights Reserved. 9