7.31 - 7.40

7.31. Get_CouponTanka
7.32. Get_CouponDiscountAmount
7.33. FTPファイル仕様
7.34. 自動実行仕様
7.35. Get_ToriokiStatus
7.36. Get_LcsOrderStatus
7.37. Set_UserTempCd
7.38. Set_UserMerge
7.39. Get_SalesInfo2
7.40. Get_SalesInfo3

7.31. Get_CouponTanka

概要

商品のクーポンを適用した場合の単価を取得する （Set_CouponMstでマスタがきていることが前提）

URL

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

Request

		属性	最大桁数	摘要
○	shopcode	string	8	店舗CD
○	goods	string	20	商品CD
○	color	string	20	色CD
○	size	string	20	サイズCD
	coupon	string	20	クーポンCD (指定ない場合には現在の単価を返す)
	datetime	string	8	売上日(yyyyMMddhhmmss) (指定ない場合には現在日時で計算年月日時分秒例:20170411000000)

Response

名前	属性	最大桁数	摘要
StatusCode	int	6	ステータスコード
Status	String	200	ステータス内容 (税抜単価or エラー内容)

実行例

http://ap01.dtpnet.co.jp:85/cv.net_adi-mo/isql/api/Get_CouponTanka.spx?shop=12000123&goods=LLMM001&color=025&size=02&coupon=7000000000123

結果例

成功）

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

失敗）

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

Status

StatusCode	Status
0	OK
-56001	商品が存在しません
-56002～-56099	内部エラー: (エラー内容詳細)

使用テーブル

テーブル名	内容
HC$MASTER_SHOHIN	参照 (get_jodai()関数を使用)
HC$MASTER_COUPON	参照

7.32. Get_CouponDiscountAmount

概要

配列に設定した商品に対して、クーポン適用した値引き額を取得する （Set_CouponMstでマスタがきていることが前提）

URL

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

Request

		属性	最大件数	摘要
	coupon	string	20	クーポンCD (指定ない場合には0を返す)
	datetime	String	8	売上日(yyyyMMddhhmmss) (指定ない場合には現在日時で計算年月日時分秒例:20170411000000)
	goodsList	(class)		商品データ(配列)
〇	goods	String	20	商品CD
〇	color	String	20	色CD
〇	size	String	20	サイズCD
〇	price	Int	10	単価
〇	quantity	Int	10	数量
○	shopcode	String	8	店舗CD

Response

名前	属性	最大桁数	摘要
StatusCode	int	6	ステータスコード
Status	String	200	ステータス内容 (値引き金額or エラー内容)

実行例

http://ap01.dtpnet.co.jp:85/cv.net_adi-mo/isql/api/Get_CouponDiscountAmount.spx?coupon=7000000000123&goodsList =[{"goods":" LLMM001","color":"025","size":"02","price":"1000","quantity":"1", shopcode":"12000123"},{・・・}]

結果例

成功）

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

失敗）

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

Status

StatusCode	Status
0	OK
-56100	店舗CDが存在しません
-56101	商品が存在しません
-56102	クーポンが存在しません
-56103～-56199	内部エラー: (エラー内容詳細)

使用テーブル

テーブル名	内容
HC$MASTER_SHOHIN	参照 (get_jodai()関数を使用)
HC$MASTER_COUPON	参照

7.33. FTPファイル仕様

概要

商品マスタおよび在庫データについてはFTPでの受け渡しを前提とする

FTP基本情報 (サイトIDごとに異なる)

サーバ	例) ap01.dtpnet.co.jp
Id, pass	例) xxxxxx / xxxxx
フォルダパス	例) /cvnet_lcs/lcv/send (CVのFTPでは/フォルダでは/cvnet_lcsは参照できないようになっている。ダイレクトにフォルダを指定する必要あり)

商品マスタCSVフォーマット

1行目からデータ、データは”で区切られる場合もあり、改行コードはLF (0x0a) 商品CD, 商品名, 略称, 色CD, 色名, サイズCD, サイズ名, ブランドCD, ブランド名, アイテムCD, アイテム名, 元上代, 上代, 削除フラグ

例) LLMM001,”赤ジャケット”,”ｱｶｼｬｹ”,052,赤,02,M,02,”ブランドA”,03,ジャケット,5200, 5000,0

全件ファイル名	shohin_master_all_yyyymmdd.csv	(yymmddは年月日が入る例:20170412)
差分ファイル名	shohin_master_dif_yyyymmdd.csv	(yymmddは年月日が入る例:20170412)

夜間01：00以降に取得可能になるよう00:00に出力開始する。削除フラグは、通常0、削除されたものは1

全件ファイル	商品マスタの出力対象（全件）が毎日対象フォルダに出力される
差分ファイル	商品マスタの出力対象（差分）が毎日対象フォルダに出力される。差分=本日変更されたデータ

※CV上の商品マスタの出力条件予備15 に1が設定されてるもの

在庫データCSVフォーマット

1行目からデータ、データは”で区切られる場合もあり、改行コードはLF (0x0a) 店舗CD, 商品CD, 色CD, サイズCD, 在庫数

例) 	123001,LLMM001,052, 02,10
	123002,LLMM001,052, 02,2

全件ファイル名

shohin_zaiko_all_yyyymmdd.csv

(yymmddは年月日が入る例:20170412)

夜間01：00以降に取得可能になるよう00:00に出力開始する。

全件ファイル

商品在庫の出力対象（全件）が毎日対象フォルダに出力される

在庫数はマイナスやゼロのものは出力しない。したがって全件洗い替えする必要がある。

7.34. 自動実行仕様

概要

自動実行処理にて、指定時間にファイルを出力する (CV)

自動実行No 91 商品マスタCSV出力

1) 全件出力の場合、パラメータ1のみ指定

パラメータ1 フォルダ名 (…../Data/以下のフォルダ名指定)　　　　例）lcs

2) 差分出力の場合、パラメータ1と2を指定

パラメータ1 フォルダ名 (…../Data/以下のフォルダ名指定)　　　　例）lcs
パラメータ2 vdate_updateの遡り日数(小数点OK)                例)1

※全件出力と差分出力を同時に自動実行に指定する場合には番号が同じなので時間をずらす

自動実行No 92 在庫データCSV出力

パラメータ1 フォルダ名 (…../Data/以下のフォルダ名指定)　　　　例）lcs

自動実行No 93 汎用CSV出力

パラメータ1 フォルダ名 (…../Data/以下のフォルダ名指定)　　　　例）lcs
パラメータ2 ファイル名 (???_yyyyMMdd.csvの接頭辞)
パラメータ3 SQL文　(パラメータ設定するときには :1,:2 などと指定)
パラメータ4以降 パラメータ(設定しない場合にはパラメータなし、設定あるところまでパラメータありとみなす。空白をはさむことはできない)

7.35. Get_ToriokiStatus

概要

取置データが保持されているDBの内容を取得する

URL

https://(指定されたURL)/Get_ToriokiStatus

Request

		属性	最大桁数	摘要
○	denno	string	14	取置伝票NO

Response

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

実行例

http://ap01.dtpnet.co.jp:85/cv.net_adi-mo/isql/api/Get_ToriokiStatus.spx?denno=8701607

結果例

成功）

{"StatusCode":0,"Status":"伝票NO,配分指示日,倉庫CD,商品CD,色CD,サイズCD,予定数量,単価,金額,メモ1,メモ2,メモ3,メモ4,完了FLG@8701607,20170422,01111,0113002412,08,00,1,4300,4300,7031000167106,アプリ20170425180732,g9ohIgCC66eqJcH8,3,1"}

失敗）

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

Status

StatusCode	Status
0	該当伝票NOの情報(行は＠列は,で区切り) メモ1は顧客CD、メモ2は実行日時、メモ3は端末ID、メモ4はステータス、完了FLG=1はSet_ToriokiCancelされるかステータスが2,6,7,20の場合
-57001	取置伝票が存在しません
-57002～-57099	内部エラー: (エラー内容詳細)

使用テーブル

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

7.36. Get_LcsOrderStatus

概要

売上データが保持されているDBの内容を取得する

URL

https://(指定されたURL)/Get_LcsOrderStatus

Request

		属性	最大桁数	摘要
○	denno	string	14	売上伝票NO

Response

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

実行例

http://ap01.dtpnet.co.jp:85/cv.net_adi-mo/isql/api/Get_LcsOrderStatus.spx?denno=8701607

結果例

成功）

{"StatusCode":0,"Status":"ヘッダNO,行NO,在庫計上日,取引区分,取引先CD1,顧客TEL,メモ,手入力伝票NO,商品CD,色CD,サイズCD,数量,単価,金額,明細メモ,拡張摘要1@1732506,1,20170523,10,881,7000000002007,アプリ20170523093439 dummy_93746899E9,1234,0110302287,49,15,1,120000,120000,.,. "}

失敗）

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

Status

StatusCode	Status
0	該当伝票NOの情報(行は＠列は,で区切り) 顧客TELは顧客CD、メモは実行日時と端末ID(LcsOrderNew)、手入力伝票NOはクーポン、明細メモはstatus,拡張摘要1は実行日時と端末ID(LcsOrderStatus)
-58001	売上伝票が存在しません
-58002～-58099	内部エラー: (エラー内容詳細)

使用テーブル

テーブル名	内容
HC$TRAN_TORI0,TORI1	参照

7.37. Set_UserTempCd

仮会員番号採番と仮会員情報の登録を行う。

URL

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

Request

必須	名前	属性	最大桁数	摘要
				なし

Response

名前	属性	最大桁数	摘要
StatusCode	int	6	ステータスコード
Status	string	200	ステータス内容
TempCd	string	30	仮会員CD　（顧客CD）

実行例

http://ap01.dtpnet.co.jp:85/cv.net_adi-mo/isql/api/Set_UserTempCd.aspx

結果例

成功）

{"StatusCode":0,"Status":"OK","TempCd":"501234567890"}

失敗）

{“StatusCode”:“-59001”,“Status”:“顧客CDを登録できません”,” TempCd”:null}

Status

StatusCode	Status
0	OK
-59001	顧客CDを登録できません
-59002～ -59099	内部エラー: (エラー内容詳細)

使用テーブル

テーブル名	内容
HC$MASTER_KOKYAKU	仮会員CD登録　（顧客CD）
HC$MASTER_MEISHO	連番最終番号更新

7.38. Set_UserMerge

概要

本会員情報と仮会員情報の名寄せを行う。ポイント情報も含む。（本会員情報に名寄せ）

URL

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

Request

必須	名前	属性	最大桁数	摘要
○	user_code	string	30	仮会員顧客CD
○	user_id	string	30	本会員顧客CD

Response

名前	属性	最大桁数	摘要
StatusCode	int	6	ステータスコード
Status	string	200	ステータス内容
user_code	string	30	顧客CD（名寄せ元の顧客CD）
user_id	string	30	顧客CD（名寄せ先の顧客CD）

実行例

http://ap01.dtpnet.co.jp:85/cv.net_adi-mo/isql/api/Set_ UserMerge.aspx?tokenid=************&user_code =********&user_id =********
結果例

成功）

{"StatusCode":"0","Status":"OK"," user_code”:”***************”,"user_id”:”***************”}

失敗）

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

Status

StatusCode	Status
0	OK
-60001	パラメータが不足しています
-60002	顧客CDが存在しません
-60003	顧客マスタ修正エラー
-60004	仮顧客CDが存在しません
-60005	名寄せ対象外エラー
-60006～-60099	内部エラー: (エラー内容詳細)

使用テーブル

テーブル名	内容
HC$MASTER_KOKYAKU	名寄せ更新（名寄せ元は退会）
HC$TRAN_ POINT_RIREKI	追加(顧客CD = user_code,ランク = HC$master_kokyakuのポイントランク, ポイント計上日 = sales_date,店舗CD = sales_shop,レジNO = register_no, レシートNO = receipt_no,取引区分 = sales_division,発生区分 = 0, 付与ポイント数 = get_point,使用ポイント数 = use_point)
HC$POINT_REAL	修正(Realポイント =名寄せ先のRealポイント +名寄せ元のRealポイント、名寄せ元のRealポイントは0)
HC$TRAN_NAYOSE	追加(顧客CD = user_code、名寄元CD = user_id)

7.39. Get_SalesInfo2

概要

購買履歴の取得を行う

URL

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

Request

必須	名前	属性	最大桁数	摘要
○	tokenid	string	64	顧客識別用トークンID
○	user_code	string	30	顧客CD
	month	string	8	年月(YYYYMMDD) ※指定年月日を含む、それ以前の購買履歴が対象
	count	string	3	取得件数

Response

名前	属性	最大桁数	摘要
StatusCode	int	6	ステータスコード
Status	string	200	ステータス内容
Sales	(class)		売上データ(配列) 購買年月日の降順
Seq_no	string	14	受注ID
division	string	2	取引区分 (10:売上、11:セール売上、20:返品、21:セール返品)
SalesDate	string	8	購買年月日(yyyyMMdd)
ShopCode	string	8	店舗CD
ShopName	string	100	店舗名
Quantity	int	10	数量
Amount	int	10	金額

実行例

http://ap01.dtpnet.co.jp:85/cv.net_adi-mo/isql/api/Get_SalesInfo2.aspx?tokenid=***********&user_code=12345697890123&month=201404

結果例

成功）

{“StatusCode”:“0”,“Status”:“OK”,”Sales”:{“SeqNo”:”12121”,“division”:”10”,“SalesDate”:”20140401”,”ShopCode”:”0001”,”ShopName”:”池袋店”,”,……}]}

失敗）

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

Status

StatusCode	Status
0	OK
-33001	パラメータが不足しています
-33002	顧客CDが存在しません
-33003	指定範囲の売上データがありません。
-33004～-33099	内部エラー: (エラー内容詳細)

使用テーブル

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

7.40. Get_SalesInfo3

概要

店舗購買明細履歴の取得を行う

URL

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

Request

必須	名前	属性	最大桁数	摘要
○	tokenid	string	64	顧客識別用トークンID
○	user_code	string	30	顧客CD
○	Seq_no	string	14	受注ID

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	サイズ名
Brand	string	100	ブランド名
Category	string	100	アイテム名
Price	int	10	単価
Quantity	int	10	数量
Amount	int	10	金額

実行例

http://ap01.dtpnet.co.jp:85/cv.net_adi-mo/isql/api/Get_SalesInfo3.aspx?tokenid=***********&user_code=12345697890123&Seq_no=12345

結果例

成功）

{“StatusCode”:“0”,“Status”:“OK”,”Sales”:{[“SalesDate”:”20140401”,”ShopCode”:”0001”,”ShopName”:”池袋店”,”Brand”:”テスト”,……}]}

失敗）

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

Status

StatusCode	Status
0	OK
-33001	パラメータが不足しています
-33002	顧客CDが存在しません
-33003	指定範囲の売上データがありません。
-33004～ -33099	内部エラー: (エラー内容詳細)

使用テーブル

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

7.31 - 7.40

Table of contents

7.31. Get_CouponTanka

7.32. Get_CouponDiscountAmount

7.33. FTPファイル仕様

7.34. 自動実行仕様

7.35. Get_ToriokiStatus

7.36. Get_LcsOrderStatus

7.37. Set_UserTempCd

7.38. Set_UserMerge

7.39. Get_SalesInfo2

7.40. Get_SalesInfo3