Wowma!API:商品を登録(出品)する

Wowma!API:商品を登録(出品)する

Wow!managerに商品を登録するAPI

何度も書いてしまいますが、Wowma!ではAPIは無料。CSV(FTP)は有料オプションです。そこはAPIを利用するしか選択肢はないように感じますが、多少の技術が必要なのも事実ですよね。まずは出品用のAPIから見ていきます。

APIメソッド:registerItemInfo

商品情報を新規登録し、登録結果(ロットナンバー、商品コード)XML文字列を返却する。

REST API / HTTP Method

REST API HTTP Method
https://api.manager.wowma.jp/wmshopapi/registerItemInfo POST

Request

Header
No Key Value Note
1 Authorization Bearer “アプリケーションキー” 認証方式と”APIキー”を設定
2 Content-Type application/xml; charset=utf-8
Body (INPUT)
No 分類 プロパティ名 Element 必須 byte 説明
1 共通 リクエスト request group
2 共通 店舗ID request.shopId long 18 半角数字:18桁
各店舗様へ割り振られた会員番号
3 個別 登録商品 request.registerItem group 商品の登録情報を指定する。
4 個別 商品名 request.registerItem.itemName string 128 全角:64桁
半角:128桁
5 個別 管理用ID request.registerItem.itemManagementId string 128 全角:64桁
半角:128桁
6 個別 管理用商品名 request.registerItem.itemManagementName string 128 全角:64桁
半角:128桁
7 個別 商品コード request.registerItem.itemCode string 256 全角:128桁
半角:256桁
店舗内の商品でユニークな項目
8 個別 販売価格 request.registerItem.itemPrice string 19 半角数字:19桁
半角数字。カンマや\マークの入力不可。
9 個別 販売方法区分 request.registerItem.sellMethodSegment string 1 説明欄の値のみ
販売方法区分を設定する
1:通常販売
2:予約販売
指定がない場合は1:通常販売が適用される
10 個別 発売(入荷)予定日 request.registerItem.releaseDate string 8 説明欄のフォーマットのみ
発売(入荷)予定日を設定するyyyyMMdd
販売方法区分が”2:予約販売”の場合、必須となる。
予約登録日(システム日付)より15日後から1年先までの日付を入力する。
11 個別 税区分 request.registerItem.taxSegment string 1 説明欄の値のみ
1:内税
2:税なし
12 個別 送料設定区分 request.registerItem.postageSegment string 1 説明欄の値のみ
1:送料別
2:送料込み
3:個別送料
13 個別 個別送料 request.registerItem.postage string 19 半角数字:19桁
[送料設定区分]が個別送料の時のみ設定する。
14 個別 (旧)配送方法 request.registerItem.deliverys group 配送方法を指定する。
15 個別 (旧)配送方法ID request.registerItem.deliverys.deliveryId string 1 半角のみ:1桁
[配送方法]がメール便の時、”M”(メール便)をセットする
16 個別 (旧)配送方法順序 request.registerItem.deliverys.deliverySeq string 1 半角数字:1桁
[配送方法ID]にMを入力した場合、固定値”1″をセットする
17 個別 (新)配送方法 request.registerItem.deliveryMethod group (新)配送方法を指定する。
(最大5個)
配送方法には「コンビニ受取」と、「クール便」および「大型宅配便」を同時に設定することはできません。
18 個別 (新)配送方法ID request.registerItem.deliveryMethod.deliveryMethodId string 10 全角:5桁
半角:10桁
配送方法ID(店舗側で設定できる値) (例:TAKUHAI)
19 個別 (新)配送方法順序 request.registerItem.deliveryMethod.deliveryMethodSeq string 1 半角数字:1桁
配送方法IDに紐づく順序(1-5の値)。
数字に抜けがある場合、1から詰めて設定される。
20 個別 掲載開始日時 request.registerItem.publicStartDate string 10 説明欄のフォーマットのみ
日付フォーマット ”yyyyMMddhh”
21 個別 ギフト包装・ギフトメッセージ区分 request.registerItem.giftPackingSegment string 1 1:不可
2:可
※指定がない場合は[1:不可]とする
22 個別 のし区分 request.registerItem.noshiSegment string 1 1:不可
2:可
※指定がない場合は[1:不可]とする
23 個別 最大購入設定区分 request.registerItem.limitedOrderSegment string 1 説明欄の値のみ
1:指定なし
2:指定あり
24 個別 最大購入個数 request.registerItem.limitedOrderCount string 5 半角数字:5桁
[最大購入設定区分]で「指定あり」が選択されている場合のみ設定する。
25 個別 商品説明(共通) request.registerItem.description string 1024 全角:512桁
半角:1024桁
HTML使用可、使用する場合はエスケープすること。エスケープについてはAPI共通仕様参照。
26 個別 SP用商品説明 request.registerItem.descriptionForSP string 10240 全角:5120桁
半角:10240桁
HTML使用可、使用する場合はエスケープすること。エスケープについてはAPI共通仕様参照。
27 個別 PC用商品説明 request.registerItem.descriptionForPC string 10240 全角:5120桁
半角:10240桁
HTML使用可、使用する場合はエスケープすること。エスケープについてはAPI共通仕様参照。
28 個別 商品詳細タイトル request.registerItem.detailTitle string 20 全角:10桁
半角:20桁
29 個別 商品詳細説明 request.registerItem.detailDescription string 640 全角:320桁
半角:640桁
HTML使用可、使用する場合はエスケープすること。エスケープについてはAPI共通仕様参照。
30 個別 スペック request.registerItem.specs group スペック情報
31 個別 スペックタイトル request.registerItem.specs.specTitle string 16 全角:8桁
半角:16桁
32 個別 詳細スペック request.registerItem.specs.detailSpecs group スペック項目と値を指定する。
(最大5個)
33 個別 スペック名 request.registerItem.specs.specTitle.specName string 16 全角:8桁
半角:16桁
34 個別 スペック値 request.registerItem.specs.specTitle.spec string 20 全角:10桁
半角:20桁
35 個別 スペック項目順序 request.registerItem.specs.specTitle.specSeq string 1 半角数字:1桁
36 個別 検索キーワード request.registerItem.searchKeywords group 検索キーワードを指定する。
(最大3個)
37 個別 検索キーワード request.registerItem.searchKeywords.searchKeyword string 20 全角:10桁
半角:20桁
38 個別 検索キーワード順序 request.registerItem.searchKeywords.searchKeywordSeq string 1 半角数字:1桁
39 個別 画像 request.registerItem.images group 画像のURLと名称を指定する。
(最大10個)
40 個別 商品画像URL request.registerItem.images.imageUrl string 128
255
全角:64桁
半角:128桁
半角:255桁
41 個別 商品画像名 request.registerItem.images.imageName string 16 全角:8桁
半角:16桁
42 個別 商品画像順序 request.registerItem.images.imageSeq string 2 半角数字:2桁
43 個別 カテゴリID request.registerItem.categoryId string 20 全角:10桁
半角:20桁
44 個別 検索タグ request.registerItem.tags group タグを指定する。
(最大64個)
45 個別 検索タグID request.registerItem.tags.tagId string 20 全角:10桁
半角:20桁
46 個別 店舗内カテゴリ request.registerItem.shopCategory group 店舗内カテゴリを指定する。
(最大10個)
47 個別 店舗内カテゴリ名(フルパス) request.registerItem.shopCategory.shopCategoryName string 967 1つのカテゴリ:全角半角を問わず60文字以内
区切り文字は「\」「:」とする
半角・全角スペースを区切り文字前後に入れた場合は取り除く
48 個別 店舗内カテゴリ表示順位 request.registerItem.shopCategoryDispSeq string 9 数字のみ(1~999,999,999)
店舗内カテゴリを設定せずに、店舗内カテゴリ表示順位に値を設定することはできません
※店舗内カテゴリの設定がある、且つ該当項目がNULLの場合、100を入れる
49 個別 JANコード request.registerItem.jan string 13 半角数字:13桁
50 個別 ISBNコード request.registerItem.isbn string 13 半角数字:13桁
51 個別 型番 request.registerItem.itemModel string 200 全角:100桁
半角:200桁
52 個別 パスワード制限設定 request.registerItem.limitedPasswd string 100 全角:50桁
半角:100桁
53 個別 パスワード制限ページタイトル request.registerItem.limitedPasswdPageTitle string 200 全角:100桁
半角:200桁
HTML使用可、使用する場合はエスケープすること。エスケープについてはAPI共通仕様参照。
54 個別 パスワード制限ページメッセージ request.registerItem.limitedPasswdPageMessage string 320 全角:160桁
半角:320桁
HTML使用可、使用する場合はエスケープすること。エスケープについてはAPI共通仕様参照。
55 個別 販売ステータス request.registerItem.saleStatus string 1 説明欄の値のみ
1:販売中商品
2:販売終了商品
56 個別 購入オプション request.registerItem.itemOptions group 購入オプションを指定する。
(最大20個)
57 個別 購入オプションタイトル request.registerItem.itemOptions.itemOptionTitle string 256 全角:128桁
半角:256桁
58 個別 購入オプション選択肢 request.registerItem..itemOption string 2000 全角:981桁
半角:1962桁
59 個別 購入オプション順序 request.registerItem..itemOptionSeq string 1 半角数字:1桁
60 個別 購入オプション(手数料型) request.registerItem.itemOptionCommissions group 購入オプション(手数料型)を指定する。
(最大20個)
61 個別 購入オプション(手数料型)タイトル request.registerItem.itemOptionCommissions.itemOptionCommissionTitle string 256
62 個別 購入オプション(手数料型)値 request.registerItem.itemOptionCommissions.itemOptionCommissionVal group 購入オプション(手数料型)の選択肢・価格を指定する。
(最大10個)
63 個別 購入オプション(手数料型)選択肢 request.registerItem.itemOptionCommissions.itemOptionCommissionVal.itemOptionCommission string 200
64 個別 購入オプション(手数料型)価格 request.registerItem.itemOptionCommissions.itemOptionCommissionVal.itemOptionCommissionPrice string 13
65 個別 購入オプション(手数料型)選択肢・価格順序 request.registerItem.itemOptionCommissions.itemOptionCommissionVal.itemOptionCommissionValSeq string 2
66 個別 購入オプション(手数料型)注意事項 request.registerItem.itemOptionCommissions.itemOptionCommissionNote string 2000 改行可能
67 個別 購入オプション(手数料型)順序 request.registerItem.itemOptionCommissions.itemOptionCommissionSeq string 2
68 個別 ポイント倍率 request.registerItem.pointRate string 2 半角数字:2桁
1~20倍を指定可能
69 個別 入荷リクエスト設定 request.registerItem.stockRequestConfig string 1 1:受け付ける
2:受け付けない
※指定がない場合は[1:受け付ける]とする
70 個別 登録在庫 request.registerStock group 通常在庫または選択肢別在庫の登録情報を指定する。
71 個別 在庫区分 request.registerStock.stockSegment string 1 説明欄の値のみ
1:通常在庫
2:選択肢別在庫
72 個別 通常在庫数 request.registerStock.stockCount string 5 半角数字:5桁
登録する在庫数を指定
・数値のみの場合はその値で登録します。(1:通常在庫の場合のみ指定)
・在庫数が0の場合、「販売ステータス」を「販売終了」で登録します。
73 個別 通常在庫発送日ID request.registerStock.stockShippingDayId string 10 全角:5桁
半角:10桁
文字列(登録している発送日ID(店舗側で設定できる値)を指定する。
英数字、ハイフン、アンダースコアのみ可。半角10文字以内。)
74 個別 残在庫表示区分 request.registerStock.displayStockSegment string 1 説明欄の値のみ
1:在庫数を表示しない。
2:在庫数を表示する。
3:指定した在庫数以下の場合表示する。
75 個別 在庫表示閾値 request.registerStock.displayStockThreshold string 5 半角数字:5桁
[残在庫表示区分]が「指定した在庫数以下の場合表示する。」が
選択されている場合のみ設定する。
76 個別 選択肢別在庫横軸項目名 request.registerStock.choicesStockHorizontalItemName string 50 全角:25桁
半角:50桁
(例:カラー)
77 個別 選択肢別在庫横軸 request.registerStock.choicesStockHorizontals group 選択肢別在庫の横軸設定
(最大20個)
78 個別 選択肢別在庫横軸コード request.registerStock.choicesStockHorizontals.choicesStockHorizontalCode string 255 半角のみ:255桁
(例:W)
79 個別 選択肢別在庫横軸名 request.registerStock.choicesStockHorizontals.choicesStockHorizontalName string 100 全角:50桁
半角:100桁
(例:ホワイト)
80 個別 選択肢別在庫横軸順序 request.registerStock.choicesStockHorizontals.choicesStockHorizontalSeq string 2 半角数字:2桁
(例:1)
81 個別 選択肢別在庫縦軸項目名 request.registerStock.choicesStockVerticalItemName string 50 全角:25桁
半角:50桁
(例:サイズ)
82 個別 選択肢別在庫縦軸 request.registerStock.choicesStockVerticals group 選択肢別在庫の縦軸設定
(最大40個)
83 個別 選択肢別在庫縦軸コード request.registerStock.choicesStockVerticals.choicesStockVerticalCode string 255 半角のみ:255桁
(例:S)
84 個別 選択肢別在庫縦軸名 request.registerStock.choicesStockVerticals.choicesStockVerticalName string 100 全角:50桁
半角:100桁
(例:小)
85 個別 選択肢別在庫縦軸順序 request.registerStock.choicesStockVerticals.choicesStockVerticalSeq string 2 (例:1)
86 個別 選択肢別在庫 request.registerStock.choicesStocks group 選択肢別在庫の在庫数の設定
(最大20×40=800個)
87 個別 選択肢別在庫横軸コード request.registerStock.choicesStocks.choicesStockHorizontalCode string 255 半角のみ:255桁
(例:W)
88 個別 選択肢別在庫縦軸コード request.registerStock.choicesStocks.choicesStockVerticalCode string 255 半角のみ:255桁
(例:S)
89 個別 選択肢別在庫数 request.registerStock.choicesStocks.choicesStockCount string 5 半角数字:5桁
登録する在庫数を指定
・数値のみの場合はその値で登録します。(2:選択肢別在庫の場合のみ指定)
・在庫数が0の場合、「販売ステータス」を「販売終了」で登録します。
90 個別 選択肢別在庫発送日ID request.registerStock.choicesStocks.choicesStockShippingDayId string 10 全角:5桁
半角:10桁
文字列(登録している発送日ID(店舗側で設定できる値)を指定する。
英数字、ハイフン、アンダースコアのみ可。半角10文字以内。)
91 個別 選択肢別在庫上説明 request.registerStock.choicesStockUpperDescription string 250 全角:125桁
半角:250桁
HTML使用可、使用する場合はエスケープすること。エスケープについてはAPI共通仕様参照。
92 個別 選択肢別在庫下説明 request.registerStock.choicesStockLowerDescription string 250 全角:125桁
半角:250桁
HTML使用可、使用する場合はエスケープすること。エスケープについてはAPI共通仕様参照。
93 個別 残選択肢別在庫表示区分 request.registerStock.displayChoicesStockSegment string 1 説明欄の値のみ
1:在庫数を表示しない。
2:在庫数を表示する。
3:指定した在庫数以下の場合、「△」を表示。
94 個別 選択肢別在庫表示閾値 request.registerStock.displayChoicesStockThreshold string 5 半角数字:5桁
[残在庫表示区分]が「指定した在庫数以下の場合表示する。」が
選択されている場合のみ設定する。
95 個別 在庫切れメッセージ request.registerStock.displayBackorderMessage string 64 全角:32桁
半角:64桁

Response

Header
No Key Value Note
1 Content-Type application/xml; charset=utf-8 認証方式と”APIキー”を設定
Body (OUTPUT)
No 分類 プロパティ名 Element byte 説明 正常時 異常時
1 共通 レスポンス response group
2 共通 処理結果 response.result group
3 共通 処理結果コード response.result.status string 1 0:成功
1:失敗
4 個別 処理結果詳細 response.registerResult group
5 個別 ロットナンバー response.registerResult.lotNumber long 20 登録した商品のロットナンバーを設定する。
※ 現状では、ロットナンバーの発行を現行システムから連携される想定のため、
本APIでは、設定されない。
6 個別 商品コード response.registerResult.itemCode string 256 登録した商品の商品コードを設定する。
7 個別 エラー情報 response.registerResult.error group
8 個別 エラーコード response.registerResult.error.code string 7 メッセージ一覧のメッセージIDを参照。
9 個別 エラーメッセージ response.registerResult.error.message string 1000 メッセージ一覧の詳細メッセージを参照。