7.21 - 7.30

7.21 Get_UserPoint_Rireki
7.22 Set_LoginInfo2
7.23 Get_UserMailAddressCheck
7.24 Set_ToriokiNew
7.25 Set_ToriokiStatus
7.26 Set_ToriokiCancel
7.27. Set_LcsOrderNew
7.28. Set_LcsOrderStatus
7.29. Set_LcsOrderCancel
7.30. Get_LcsOrderList

7.21 Get_UserPoint_Rireki

概要

顧客CDを送信し、顧客マスタのポイント履歴情報を取得する。

URL

https://(指定されたURL)/Get_UserPoint_Rireki.aspx

Request

必須	名前	属性	最大桁数	摘要
◯	user_code	string	30	顧客CD

Response

名前	属性	最大桁数	摘要
StatusCode	int	6	ステータスコード
Status	string	200	ステータス内容
UserPointRireki	(class)		顧客ポイント履歴データ(配列)
code	String	30	顧客CD
rank	String	4	ランク
sales_date	String	8	ポイント計上日
shop_code	String	8	店舗CD
register_no	Int	14	レジNO
receipt_no	Int	14	レシートNO
shain_cd	String	20	社員CD
sales_division	Int	2	取引区分
occurrence_division	Int	1	発生区分
get_point	Int	10	付与ポイント数
use_point	Int	10	使用ポイント数
lapse_point	Int	10	失効ポイント数
notes	String	200	備考

実行例

http://ap01.dtpnet.co.jp:85/cv.net_adi-mo/isql/api/Get_UserPoint_Rireki.aspx?user_code=1234567890123

結果例

成功）

{"StatusCode":0,"Status":"OK","UserPointRireki":[{"code":"5030000025125","rank":"5","sales_date":"20160923","register_no":28351,"shop_code":"20100000","receipt_no":61,"shain_cd":"0204","sales_division":10,"occurrence_division":0,"get_point":59,"use_point":0,"lapse_point":0,"notes":"POS売上"},{"code":"5030000025125","rank":"5","sales_date":"20160927","register_no":6251,"shop_code":"00000002","receipt_no":617,"shain_cd":"0001","sales_division":10,"occurrence_division":0,"get_point":29,"use_point":0,"lapse_point":0,"notes":"POS売上"}]} 

失敗）

{"StatusCode":-49002,"Status":"顧客CDが存在しません。","UserPointRireki":null} 

Status

StatusCode	Status
0	OK
-49001	パラメータが不足しています
-49002	顧客CDが存在しません
-49003	退会済み顧客です
-49004~-49099	内部エラー: (エラー内容詳細)

使用テーブル

テーブル名	内容
HC$MASTER_KOKYAKU_LOGIN	参照
HC$MASTER_KOKYAKU	参照
HC$TRAN_POINT_RIREKI	参照

7.22 Set_LoginInfo2

概要

トークンID、顧客CDを送信し、顧客ログインマスタのログインIDの更新を行う。

URL

https://(指定されたURL)/Set_LoginInfo2.aspx

Request

必須	名前	属性	最大桁数	摘要
○	Tokenid	string	64	顧客識別用トークンID
○	user_code	string	30	顧客CD
○	user_loginid_new	string	200	顧客が設定する新しいログインID（メールアドレス）

Response

名前	属性	最大桁数	摘要
StatusCode	int	6	ステータスコード
Status	string	200	ステータス内容
Code	string	30	顧客CD
Uuid	string	300	端末固有ID
TokenID	string	64	TokenID

実行例

http://ap01.dtpnet.co.jp:85/cv.net_adi-mo/isql/api/Set_LoginInfo2.aspx?user_loginid=********&user_password=********& user_code=*******& user_loginid_new=○○○

結果例

成功）

{"StatusCode":0,"Status":"OK","Code":"12345678","Uuid":".","TokenID":"**************************"}

失敗）

{"StatusCode":-50002,"Status":"既に使用されているログインIDです","Code":null,"Uuid":null,"TokenID":null}

Status

StatusCode	Status
0	OK
-50001	パラメータが不足しています
-50002	既に使用されているログインIDです
-50003	更新対象のログインIDがありません
-50004～-50099	内部エラー: (エラー内容詳細)

使用テーブル

テーブル名	内容
HC$MASTER_KOKYAKU_LOGIN	新しいログインIDをログインIDに上書き更新

7.23 Get_UserMailAddressCheck

概要

メールアドレスがログインIDに登録されているかチェックを行う。

URL

https://(指定されたURL)/Get_UserMailAddressCheck.aspx

Request

必須	名前	属性	最大桁数	摘要
○	MailAddress	string	200	メールアドレス

Response

名前	属性	最大桁数	摘要
StatusCode	int	6	ステータスコード
Status	string	200	ステータス内容
MailAddressCheck	int	1	0：登録なし　１：登録あり

実行例

http://ap01.dtpnet.co.jp:85/cv.net_adi-mo/isql/api/Get_UserMailAddressCheck.aspx? MailAddress=******************

結果例

成功）

{"StatusCode":0,"Status":"OK","MailAddressCheck":"0"}

失敗）

{"StatusCode":-51001,"Status":"パラメータが不足しています","MailAddressCheck":"0"}

Status

StatusCode	Status
0	OK
-51001	パラメータが不足しています
-51002～-51099	内部エラー: (エラー内容詳細)

使用テーブル

テーブル名	内容
HC$MASTER_KOKYAKU_LOGIN	ログインIDに使用されているか参照

7.24 Set_ToriokiNew

概要

新規に取置データを作成する。

URL

https://(指定されたURL)/Set_ToriokiNew.aspx

Request

		属性	最大桁数	摘要
○	date	string	8	指示日=年月日(yyyyMMdd)
○	user_code	string	30	顧客CD
○	shopcode	string	8	店舗CD
○	detail	string	2000	明細CSVデータ(行を@で区切ったCSVデータ) 商品CD、色CD、サイズCD、数量
○	terminal	string	300	端末ID (スマホを一意に識別できるユニークなID)

Response

名前	属性	最大桁数	摘要
StatusCode	int	6	ステータスコード
Status	String	200	ステータス内容 (取置伝票NO or エラー内容)

実行例

http://ap01.dtpnet.co.jp:85/cv.net_adi-mo/isql/api/Set_ToriokiNew.spx?date=20170401&user_code=7000000000123&shopcode=12001&detail=LTAT17S4524,27,002,1@ LTAT17S4999,28,001,2&terminal=g9ohIgCC66eqJcH8

結果例

成功）

{"StatusCode":0,"Status":"12000123"}

失敗）

{"StatusCode":"-49099","Status":"システムエラー"}

Status

StatusCode	Status
0	取置伝票NO
-49001	取置伝票が存在しません
-49002～-49099	内部エラー: (エラー内容詳細)

使用テーブル

テーブル名	内容
HC$TRAN_HIBN1	参照、追加

7.25 Set_ToriokiStatus

概要

取置データの状態を変更する。

URL

https://(指定されたURL)/Set_ToriokiStatus.aspx

Request

		属性	最大桁数	摘要
○	denno	string	14	取置伝票NO
○	statuscode	string	2	ステータスCD (1:在庫確認中, 2:在庫不足, 3:取置確定, 4:配送済, 5:店舗返品中, 6:取り置きキャンセル, 7:試着返品, 20:購入)
○	detail	string	2000	明細CSVデータ (行を@で区切ったCSVデータ) 商品CD、色CD、サイズCD ※空白は全件とみなす
○	terminal	string	300	端末ID (スマホを一意に識別できるユニークなID)

Response

名前	属性	最大桁数	摘要
StatusCode	int	6	ステータスコード
Status	String	200	ステータス内容

実行例

http://ap01.dtpnet.co.jp:85/cv.net_adi-mo/isql/api/Set_ToriokiStatus.spx?denno=12000123&statuscode=1&detail=aaaa001,21,001&terminal=g9ohIgCC66eqJcH8

結果例

成功）

{"StatusCode":0,"Status":"成功"}

失敗）

{"StatusCode":"-50099","Status":"システムエラー"}

Status

StatusCode	Status
0	OK
-50001	取置伝票が存在しません
-50002～-50099	内部エラー: (エラー内容詳細)

使用テーブル

テーブル名	内容
HC$TRAN_HIBN1	参照、修正

7.26 Set_ToriokiCancel

概要

取置データを削除する。

URL

https://(指定されたURL)/Set_ToriokiCancel.aspx

Request

		属性	最大桁数	摘要
○	denno	string	14	取置伝票NO
○	terminal	string	300	端末ID (スマホを一意に識別できるユニークなID)

Response

名前	属性	最大桁数	摘要
StatusCode	int	6	ステータスコード
Status	String	200	ステータス内容

実行例

http://ap01.dtpnet.co.jp:85/cv.net_adi-mo/isql/api/Set_ToriokiCancel.spx?denno=12000123&terminal=g9ohIgCC66eqJcH8

結果例

成功）

{"StatusCode":0,"Status":"成功"}

失敗）

{"StatusCode":"-51099","Status":"システムエラー"}

Status

StatusCode	Status
0	OK
-51001	取置伝票が存在しません
-51002～-51099	内部エラー: (エラー内容詳細)

使用テーブル

テーブル名	内容
HC$TRAN_HIBN1	削除

7.27. Set_LcsOrderNew

概要

新規に売上データを作成する。

URL

https://(指定されたURL)/Set_LcsOrderNew.aspx

Request

		属性	最大桁数	摘要
○	date	string	8	売上日=年月日(yyyyMMdd)
○	user_code	string	30	顧客CD
○	shopcode	string	8	店舗CD
○	detail	string	2000	明細CSVデータ(行を@で区切ったCSVデータ) ※数量*(単価-値引金額)=金額商品CD、色CD、サイズCD、数量、単価、値引金額、金額、明細消費税
○	shokei	Int	10	税抜小計金額
○	tax	int	10	消費税金額
○	total	int	10	合計金額
○	coupon	string	20	使用クーポンCD
○	terminal	string	300	端末ID (スマホを一意に識別できるユニークなID)
○	gmoid	string	14	決済のためにGMOに送る「オーダーID」

Response

名前	属性	最大桁数	摘要
StatusCode	int	6	ステータスコード
Status	String	200	ステータス内容 (売上伝票NO or エラー内容)

実行例

http://ap01.dtpnet.co.jp:85/cv.net_adi-mo/isql/api/Set_LcsOrderNew.spx?date=20170401&user_code=7000000000123&detail=LTAT17S4524,27,002,1,5000,0,5000,400@LTAT17S4599,27,002,2,5000,1000,8000,640&shokei=13000&tax=1040&total=14040&coupon=5000000123&terminal=g9ohIgCC66eqJcH8&gmoid=order1234567

結果例

成功）

{"StatusCode":0,"Status":"463000123"}

失敗）

{"StatusCode":"-52099","Status":"システムエラー"}

Status

StatusCode	Status
0	売上伝票NO
-52001～-52099	内部エラー: (エラー内容詳細)

使用テーブル

テーブル名	内容
HC$TRAN_TORI0	追加
HC$TRAN_TORI1	追加

7.28. Set_LcsOrderStatus

概要

売上データの状態を変更する。

URL

https://(指定されたURL)/Set_LcsOrderStatus.aspx

Request

		属性	最大件数	摘要
○	denno	string	14	売上伝票NO
○	statuscode	string	2	ステータスCD (1:在庫確認中, 2:在庫不足,4:配送済,5:店舗返品中,30:店舗返品完了)
○	detail	string	2000	明細CSVデータ(行を@で区切ったCSVデータ) 商品CD、色CD、サイズCD
○	terminal	string	300	端末ID (スマホを一意に識別できるユニークなID)

Response

名前	属性	最大件数	摘要
StatusCode	int	6	ステータスコード
Status	String	200	ステータス内容

実行例

http://ap01.dtpnet.co.jp:85/cv.net_adi-mo/isql/api/Set_LcsOrderStatus.spx?denno=12000123&statuscode=1&detail=LTAT17S4524,27,002@LTAT17S4599,27,002&&terminal=g9ohIgCC66eqJcH8

結果例

成功）

{"StatusCode":0,"Status":"成功"}

失敗）

{"StatusCode":"-53099","Status":"システムエラー"}

Status

StatusCode	Status
0	OK 、ステータスCDが30のときのみ、作成されたマイナス数量の売上伝票NO
-53001	売上伝票が存在しません
-53002～-53099	内部エラー: (エラー内容詳細)

使用テーブル

テーブル名	内容
HC$TRAN_TORI0	追加
HC$TRAN_TORI1	追加

7.29. Set_LcsOrderCancel

概要

売上データのマイナスデータを追加する。

URL

https://(指定されたURL)/Set_LcsOrderCancel.aspx

Request

		属性	最大件数	摘要
○	denno	string	14	売上伝票NO
○	terminal	string	300	端末ID (スマホを一意に識別できるユニークなID)

Response

名前	属性	最大件数	摘要
StatusCode	int	6	ステータスコード
Status	String	200	ステータス内容 (マイナス売上伝票NO or エラー内容)

実行例

http://ap01.dtpnet.co.jp:85/cv.net_adi-mo/isql/api/Set_LcsOrderCancel.spx?denno=12000123&terminal=g9ohIgCC66eqJcH8

結果例

成功）

{"StatusCode":0,"Status":"123456"}

失敗）

{"StatusCode":"-54099","Status":"システムエラー"}

Status

StatusCode	Status
0	(売上に対する赤伝として作成された伝票NO)
-54001	売上伝票が存在しません
-54002～-54099	内部エラー: (エラー内容詳細)

使用テーブル

テーブル名	内容
HC$TRAN_TORI0	追加(マイナスデータ)
HC$TRAN_TORI1	追加(マイナスデータ)

7.30. Get_LcsOrderList

概要

売上データ履歴の取得を行う

URL

https://(指定されたURL)/Get_LcsOrderList.aspx

Request

必須	名前	属性	最大件数	摘要
○	tokenid	string	64	顧客識別用トークンID
○	user_code	string	30	顧客CD
○	dstart	string	8	開始年月日(yyyyMMdd)
○	dend	string	8	終了年月日(yyyyMMdd)
	count	string	3	取得件数 (0か指定なしの場合には対象すべて)

Response

名前	属性	最大件数	摘要
StatusCode	int	6	ステータスコード
Status	string	200	ステータス内容
Sales	(class)		売上データ(配列) 購買年月日の降順
SalesDate	string	8	購買年月日(yyyyMMdd)
ShopCode	string	8	店舗CD
ShopName	string	100	店舗名
GoodsName	string	100	商品名
ColorName	string	100	色名
SizeName	string	100	サイズ名
Category	string	100	カテゴリ (アイテム名)
Brand	string	100	ブランド名
Price	int	10	売価
Quantity	int	10	数量
Amount	int	10	金額

実行例

http://ap01.dtpnet.co.jp:85/cv.net_adi-mo/isql/api/Get_LcsOrderList.aspx?tokenid=***********&user_code=12345697890123&dstart=20140401&dend=20140630

結果例

成功）

{“StatusCode”:“0”,“Status”:“OK”,”Sales”:{[“SalesDate”:”20140401”,”ShopCode”:”0001”,”ShopName”:”池袋店”,”Goods”:”Tシャツ”,……}]}

失敗）

{“StatusCode”:“-55002”,“Status”:“顧客CDが存在しません”,”Sales”:null}

Status

StatusCode	Status
0	OK
-55001	パラメータが不足しています
-55002	顧客CDが存在しません
-55003～-55099	内部エラー: (エラー内容詳細)

使用テーブル

テーブル名	内容
HC$MASTER_KOKYAKU_LOGIN	参照
HC$MASTER_KOKYAKU	参照
HC$TRAN_TORI0	参照
HC$TRAN_TORI1	参照

7.21 - 7.30

Table of contents

7.21 Get_UserPoint_Rireki

7.22 Set_LoginInfo2

7.23 Get_UserMailAddressCheck

7.24 Set_ToriokiNew

7.25 Set_ToriokiStatus

7.26 Set_ToriokiCancel

7.27. Set_LcsOrderNew

7.28. Set_LcsOrderStatus

7.29. Set_LcsOrderCancel

7.30. Get_LcsOrderList