-
店舗作成
-
入力パラメータはPOST、出力パラメータはレスポンス(レスポンスボディにJSON)になります
動作はメイン機能の店舗追加と同じです
【注意】メイン機能は50店舗まで作成可能ですが、一度登録した店舗は削除出来ません。開発時はチェックのみ実施するtest_flagを1にしてご利用下さい。店舗数が50になってしまった場合はこちらを確認下さい
-
入力パラメータ
-
パラメータ 値 省略 備考 access_token access_token取得により取得した値 必須(SDKの場合不要) refresh_token access_token取得により取得した値 可能(SDKの場合不要) 【指定してaccess_tokenの有効期限が切れた場合】
正常に出力パラメータが設定されaccess_tokenとrefresh_tokenが新しい値に更新されます
【省略してaccess_tokenの有効期限が切れた場合】
出力パラメータ「result」の値がredirectになります(成功時以外の出力パラメータ参照)wait_flag 1:メイン機能過負荷でも可能な限りエラーにせず実行
1以外:メイン機能過負荷の場合、003002のエラーを返却可能(省略時は1以外とする) 詳細はパラメータ共通事項「待機フラグについて」を参照して下さい test_flag 1:テスト, 1以外:通常 0(通常) テストの場合、入力チェックのみ実施し店舗を登録しません。作成したshop_idは固定で1を返却します data 作成する店舗情報のXML 必須 詳細はこちらを参照
-
出力パラメータ
-
パラメータ名 値 備考 result success success以外の場合の出力パラメータは成功時以外の出力パラメータ参照 access_token 入力パラメータで指定したaccess_token/新たに発行されたaccess_token 有効なrefresh_tokenを指定してaccess_tokenの有効期限がきれた場合、新たに発行(この時点から1日有効)されたaccess_tokenになります access_token_end_date access_tokenの有効期限切れ日時 refresh_token 入力パラメータで指定したrefresh_token/新たに発行されたrefresh_token access_tokenが新しく発行された場合、新たに発行(この時点から3日有効)されたrefresh_tokenになります refresh_token_end_date refresh_tokenの有効期限切れ日時 shop_id 登録した店舗のID
-
XML形式
-
入力パラメータのdataで指定する値です
サンプルはこちらを参照 -
階層 要素 必須 繰返 属性 内容 1 <root> ○ 2 <shop> ○ 店舗情報の親タグ 3 <xxxxxxxxx> ○ 作成する店舗のフィールド名と値を指定します
必須ではないフィールドは、タグ自体を省略することも可能です(値が空欄の場合と同じ挙動になります)2 </shop> ○ 1 </root> ○ -
XMLサンプル
<?xml version="1.0" encoding="utf-8"?> <root> <shop> <shop_mall_id>1</shop_mall_id> <shop_name>楽天店</shop_name> <shop_abbreviated_name>raku</shop_abbreviated_name> <shop_kana></shop_kana> <shop_note></shop_note> <shop_handling_goods_name>スマホグッズ</shop_handling_goods_name> <shop_tax_id>1</shop_tax_id> <shop_tax_calculation_sequence_id>1</shop_tax_calculation_sequence_id> <shop_currency_unit_id>1</shop_currency_unit_id> <shop_authorization_type_id></shop_authorization_type_id> <mall_login_id1>login_id</mall_login_id1> <mall_login_id2></mall_login_id2> <mall_login_id3></mall_login_id3> <mall_password1>password</mall_password1> <mall_password2></mall_password2> <mall_password3></mall_password3> <shop_type_id></shop_type_id> <default_delivery_id>13</default_delivery_id> </shop> </root>
-
作成仕様
-
APIで指定できるフィールドの一覧です
ここに記載されていないフィールドは指定できません
-
店舗情報
-
項目名 フィールド名 データ型 省略 備考 モール/カートID shop_mall_id 数値型 必須 モール/カートのIDを指定します。この項目は更新時に指定出来ません 店舗名 shop_name 文字列型 必須 店舗略名 shop_abbreviated_name 文字列型 必須 店舗カナ shop_kana 文字列型 備考 shop_note 文字列型 取扱商品名 shop_handling_goods_name 文字列型 税区分ID shop_tax_id 文字列型 必須 税区分のIDを指定します 税計算順序 shop_tax_calculation_sequence_id 文字列型 必須 0:商品計で税計算, 1:単価から税計算 通貨単位ID shop_currency_unit_id 文字列型 必須 通貨単位のIDを指定します オーソリ区分ID shop_authorization_type_id 文字列型 オーソリ区分のIDを指定します ログインID_1 mall_login_id1 文字列型 各ログインID/パスワードはモール/カートの種類により扱いが異なります。詳細はこちらを参照下さい
これらの項目は検索することは出来ませんが、接続確認することで正しい値か確認することが出来ますログインID_2 mall_login_id2 文字列型 ログインID_3 mall_login_id3 文字列型 パスワード_1 mall_password1 文字列型 パスワード_2 mall_password2 文字列型 パスワード_3 mall_password3 文字列型 インボイス形式を適用 shop_enabled_invoice 文字列型 1:適用する
1以外:適用しない
省略時:適用しない規定の発送方法ID default_delivery_id 文字列型 発送方法区分のIDを指定します。この項目は更新時に指定出来ません。また「21:ヤマト(コレクト)B2v6」、「25:ヤマト(コレクト)B2v5」、「36:楽天コンビニ受取(ゆうパック)」は規定の発送方法に対応していないため、指定しても規定の発送方法が登録されません 後払い.com サイトID shop_type_id 文字列型 -
ログインID/パスワードの扱い
-
モール/カートID モール/カート名 フィールド名 : 項目名 備考 1 楽天市場 mall_login_id2 : SMTP AUTH ID
mall_password2 : SMTP AUTH password
mall_login_id3 : FTP用 ID
mall_password3 : FTP用 password2 Yahoo!ショッピング mall_login_id1 : ストアアカウント(API使用時にのみ登録)
mall_password1 : リクエストURL(API使用時にのみ登録)
mall_login_id2 : 認証キー(API使用時にのみ登録)
mall_login_id3 : FTPアカウント
mall_password3 : FTPパスワード3 DeNAショッピング mall_login_id1 : ID
mall_password1 : password7 電脳卸 利用しません 8 電話FAX 利用しません 11 amazon(プロマーチャント) mall_login_id1 : Eメールアドレス
mall_password1 : パスワード
mall_login_id2 : 【MWSアカウント】出品者 ID
mall_login_id3 : 【MWSアカウント】マーケットプレイス ID13 おちゃのこネット mall_login_id1 : ログインID
mall_password1 : password
mall_login_id3 : 管理画面URL14 ショップサーブ mall_login_id1 : ショップID
password : mall_password1
mall_login_id2 : 管理画面URL15 ヤフオク!ストア mall_login_id1 : Yahoo! JAPANビジネスID
mall_password1 : password
mall_login_id2 : YahooJapanID
mall_password2 : password19 FutureShop2 mall_login_id1 : FTPユーザ
mall_password1 : password
mall_login_id2 : ホスト名20 ZenCartPro-R mall_login_id1 : 在庫更新実行URL
mall_login_id2 : FTPホスト名
mall_password2 : 読み込み対象ディレクトリ
mall_login_id3 : FTP用 ID
mall_password3 : FTP用 password21 EC-CUBE mall_login_id1 : 在庫更新用URL
mall_password1 : ご利用のバージョンを入力してください。例:2.13.122 カラーミーショップ mall_login_id1 : ログインID
mall_password1 : password23 スーパーデリバリー mall_login_id1 : ログインID
mall_password1 : password25 マーキュリー mall_password2 : FTPホスト
mall_login_id3 : FTPアカウント
mall_password3 : FTPパスワード26 WiseCart mall_login_id1 : ショップID 28 DeNA BtoB market mall_login_id1 : ログインID
mall_password1 : password30 ぐるなび食市場 mall_login_id1 : ID
mall_password1 : password31 aiship mall_login_id1 : ID
mall_password1 : password
mall_login_id2 : 管理者用ログイン画面URL32 BuyersClub mall_login_id2 : 企業ID 33 Qoo10(Gmarket) mall_login_id1 : IDまたはメール
mall_password1 : password35 MakeShop & NEカート mall_login_id1 : ショップID
mall_password1 : password40 SHOPLIST mall_login_id1 : 在庫更新用URL
mall_password1 : ストアアカウント
認証キー : mall_login_id241 楽天B2B mall_login_id1 : FTP用 ユーザ
mall_password1 : FTP用 password42 ポンパレモール mall_login_id1 : ショップログインID
mall_password1 : ショップパスワード90 汎用 mall_login_id1 : 在庫更新用URL
mall_password1 : ストアアカウント
mall_login_id2 : 認証キー91 卸 利用しません
-
店舗数が最大になってしまった場合
-
開発環境:リカバリすることは出来ませんが、[013011]のエラー(店舗数のチェック)が最後のチェックになっております。このエラーになる場合は、本番環境では登録が成功します
本番環境:お手数ですが弊社まで問い合わせするよう回答をお願いします