店舗マスタ店舗接続確認

リクエストURL

ホスト

https://api.next-engine.org

エンドポイント

/api_v1_master_shop/checkconnect

リファレンス内容

店舗接続確認

入力パラメータはPOST、出力パラメータはレスポンス(レスポンスボディにJSON)になります

動作はメイン機能の店舗の接続確認と同じです

接続に成功した場合はresultがsuccessになります

入力パラメータ

パラメータ	値	省略	備考
`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以外とする)	詳細はパラメータ共通事項「待機フラグについて」を参照して下さい
`shop_id`	店舗ID	必須	接続確認対象の店舗のshop_id

出力パラメータ

パラメータ名	値	備考
`result`	`success`	success以外の場合の出力パラメータは成功時以外の出力パラメータ参照
`access_token`	入力パラメータで指定したaccess_token／新たに発行されたaccess_token	有効なrefresh_tokenを指定してaccess_tokenの有効期限がきれた場合、新たに発行(この時点から1日有効)されたaccess_tokenになります
`refresh_token`	入力パラメータで指定したrefresh_token／新たに発行されたrefresh_token	access_tokenが新しく発行された場合、新たに発行(この時点から3日有効)されたrefresh_tokenになります

店舗マスタ

項目名	フィールド名	データ型	備考
店舗ID	`shop_id`	数値型
店舗名	`shop_name`	文字列型
店舗名カナ	`shop_kana`	文字列型
店舗略名	`shop_abbreviated_name`	文字列型
取扱商品名	`shop_handling_goods_name`	文字列型
閉店日	`shop_close_date`	日時型
備考	`shop_note`	文字列型
モールID	`shop_mall_id`	数値型
オーソリ区分ID	`shop_authorization_type_id`	文字列型
オーソリ区分名	`shop_authorization_type_name`	文字列型
税区分ID	`shop_tax_id`	文字列型
税区分名	`shop_tax_name`	文字列型
通貨単位区分ID	`shop_currency_unit_id`	文字列型
通貨単位区分名	`shop_currency_unit_name`	文字列型
税計算順序	`shop_tax_calculation_sequence_id`	文字列型	0:商品計で税計算,1:単価から税計算
後払い.com サイトID	`shop_type_id`	文字列型
削除フラグ	`shop_deleted_flag`	文字列型
作成日	`shop_creation_date`	日時型
最終更新日	`shop_last_modified_date`	日時型
最終更新日	`shop_last_modified_null_safe_date`	日時型	NULLの場合作成日
作成担当者ID	`shop_creator_id`	数値型
作成担当者名	`shop_creator_name`	文字列型
最終更新者ID	`shop_last_modified_by_id`	数値型
最終更新者ID	`shop_last_modified_by_null_safe_id`	数値型	NULLの場合作成者ID
最終更新者名	`shop_last_modified_by_name`	文字列型
最終更新者名	`shop_last_modified_by_null_safe_name`	文字列型	NULLの場合作成者名

サンプル

リクエスト

curl -X POST -H 'content-type: application/x-www-form-urlencoded' \
 -d 'access_token=xxx&refresh_token=xxx&wait_flag=1&shop_id=xxx' \
 https://api.next-engine.org/api_v1_master_shop/checkconnect

レスポンス

{
  "result": "error",
  "code": "012005",
  "message": "FTPユーザ名またはパスワードが違います",
  "request_id": "",
  "access_token": "xxx",
  "access_token_end_date": "2017-04-19 11:21:13",
  "refresh_token": "xxx",
  "refresh_token_end_date": "2017-04-21 11:21:13"
}

エラー

エラーコード

エンドポイント固有のエラーコードを以下に示します。共通エラーコードはメッセージコード一覧を参照してください。

エラーコード	メッセージ	対処方法
`012001`	アクセス情報[xxxxxx]の許可が必要です。	ネクストエンジンの「アプリを作る」「APIタブ」にてアクセス許可をする必要があります
`012002`	POSTパラメータにshop_idが指定されていない、または値が空です。	shop_idを指定してください
`012003`	店舗[xxx]は存在しません。	shop_idを確認してください
`012004`	店舗[xxx]は使用停止中の為、接続確認出来ません。	メイン機能で店舗の使用を再開してください
`012005`	xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx	接続失敗の理由を確認してください