5.5(祥云在线卡第三方接口)+(ybb大屏接口/南苑老年食堂)+(中债登OCS-HTTP)接口说明

祥云技术部发表于 2021-03-29 最后更新 2023-02-10

httpserver对应的服务端口是：21111，需要注意是否有防火墙，如果有防火墙，需要开放该端口
开启程序目录下的接口文件 zxcyb_httpserver.exe

祥云在线卡http服务接口V2021版本更新时间：2021-05-19 13:53:22

杭州祥云科技的在线卡模式，提供给第三方的http服务，以便第三方能查询余额，或者直接扣卡，（目前公开发布的测试环境是 ybb.sunwayit.com 也就是 http://ybb.sunwayit.com:21111/api/vip2021）（备注 127.0.0.1 这个ip地址，最后需要以客户的最终服务器ip地址为准）

祥云在线卡http服务接口会员余额查询更新时间：2021-05-19 16:12:03

用于查询会员卡的数据库余额（备注 127.0.0.1 这个ip地址，最后需要以客户的最终服务器ip地址为准）（目前公开发布的测试环境是 ybb.sunwayit.com 也就是 http://ybb.sunwayit.com:21111/api/vip2021）http服务 + post + "application/json; charset=utf-8"

基本信息

接口状态: 已完成
接口URL： http://127.0.0.1:21111/api/vip2021
请求方式： POST
Content-Type：application/json

请求参数

body参数及说明

{
	"cardno": "0080399557",
	"apifunction": "chaxun",
	"skjh": "服务器端分配的工作站点编号"
}

字段描述

参数名	示例值	参数类型	是否必填	参数描述
cardno	00803995571	String	是	卡号
apifunction	chaxun	String	是	code描述 chaxun=查询; koukuan=扣款
skjh	101	String	是	服务器端分配的工作站点编号

成功响应示例

{
	"cardno": "0080399557",
	"vipstatus": "1",
	"vipmessage": "该卡状态正常，最新余额=4989.66，最新积分=0.00",
	"vipmoney": 4989.66,
	"vippoints": 0,
	"servertime": "2021-05-19 14:42:38"
}

字段描述

参数名	示例值	参数类型	参数描述
cardno	0080399557	String	卡号
vipstatus	1	String	1=成功，<>1代表失败
vipmessage	该卡状态正常，最新余额=4989.66，最新积分=0.00	String	返回相应的提示信息
vipmoney	4989.66	Number	当前数据库最新的卡上可用余额
vippoints	0	Number	当前数据库最新的卡上积分
servertime	2021-05-19 14:42:38	DateTime	暂无描述

失败响应示例

{
	"cardno": "00803995571",
	"vipstatus": "0",
	"vipmessage": "该卡未建档，请联系收银台",
	"vipmoney": 0,
	"vippoints": 0,
	"servertime": "2021-05-19 14:42:00"
}

字段描述

参数名	示例值	参数类型	参数描述
cardno	00803995571	String	卡号
vipstatus	0	String	1=成功，<>1代表失败
vipmessage	该卡未建档，请联系收银台	String	返回相应的提示信息
vipmoney	0	Number	当前数据库最新的卡上可用余额
vippoints	0	Number	当前数据库最新的卡上积分
servertime	2021-05-19 14:42:00	DateTime	暂无描述

Tag : httpserver 祥云接口

祥云技术部发表于 2021-12-15 最后更新 2023-02-10

祥云在线卡http服务接口会员扣卡操作更新时间：2021-05-19 16:12:24

可以不用先查询会员卡余额，每次直接用这个扣卡接口直接扣款也是可行的（备注 127.0.0.1 这个ip地址，最后需要以客户的最终服务器ip地址为准）（目前公开发布的测试环境是 ybb.sunwayit.com 也就是 http://ybb.sunwayit.com:21111/api/vip2021） http服务 + post + "application/json; charset=utf-8"

基本信息

接口状态: 已完成
接口URL： http://127.0.0.1:21111/api/vip2021
请求方式： POST
Content-Type：application/json

请求参数

body参数及说明

{
	"cardno": "0080399557",
	"apifunction": "koukuan",
	"koukuanjine": 1.1,
	"skjh": "服务器端分配的工作站点编号"
}

字段描述

参数名	示例值	参数类型	是否必填	参数描述
cardno	0080399557	String	是	卡号
apifunction	koukuan	String	是	code描述 chaxun=查询; koukuan=扣款
koukuanjine	1.1	Number	是	本次扣款金额，带小数点2位，例如1.1，该金额需要大于0
skjh	101	String	是	服务器端分配的工作站点编号

成功响应示例

{
	"cardno": "0080399557",
	"vipstatus": "1",
	"vipmessage": "刷卡消费成功，本次扣款=1.10，最新余额=4992.96",
	"vipmoney": 4992.96,
	"vippoints": 0,
	"servertime": "2021-05-19 14:32:21"
}

字段描述

参数名	示例值	参数类型	参数描述
cardno	0080399557	String	卡号
vipstatus	1	String	1=成功，<>1代表失败
vipmessage	刷卡消费成功，本次扣款=1.10，最新余额=4992.96	String	返回相应的提示信息
vipmoney	4992.96	Number	当前数据库最新的卡上可用余额
vippoints	0	Number	当前数据库最新的卡上积分
servertime	2021-05-19 14:32:21	DateTime	暂无描述

失败响应示例

{
	"cardno": "00803995571",
	"vipstatus": "0",
	"vipmessage": "该卡未建档，请联系收银台",
	"vipmoney": 0,
	"vippoints": 0,
	"servertime": "2021-05-19 14:05:52"
}

字段描述

参数名	示例值	参数类型	参数描述
cardno	00803995571	String	卡号
vipstatus	0	String	1=成功，<>1代表失败
vipmessage	该卡未建档，请联系收银台	String	返回相应的提示信息
vipmoney	0	Number	当前数据库最新的卡上可用余额
vippoints	0	Number	当前数据库最新的卡上积分
servertime	2021-05-19 14:05:52	DateTime	暂无描述

祥云技术部发表于 2023-02-09 最后更新 2023-02-27

OCS-HTTP接口说明账户收支明细交互接口(祥云部分)

简要描述

中债登两个刷卡系统之间充值/消费明细记录交换接口2023
zxcyb_httpserver.exe是接收OCS-http他们这边发送的收支明细,然后写入祥云的后台数据库
zxcyb_ocshttp_update.exe是将我方发生的收支明细,post给OCS-http,让他们写入他们的后台数据库
通过上述的操作,让两边的系统都有全部的收支明细,然后两边的余额全部一致
升级步骤
1:服务器电脑上面的软件升级
2:然后在服务器的SQLserver企业管理器中手工执行 ms_jfk_hyda_telephone_trigger.sql
    这个触发器的作用是当会员档案中手机号码重复就提示错误
    中债登两个卡务系统同步数据采用的校验手机号码唯一的,也就是根据手机号码能定位到唯一的会员卡号
    否则两个或者多个会员用同一个手机号码,那么根据手机号码定位到会员卡号的时候就无法定位了
3:然后在需要开启接口exe程序的目录下的shopsoft.ini,将OCS-http给我们的接口http地址配置进去
    文件shopsoft.ini节[zxcyb_httpserver]字段zzd_ocspro_http_url=中配置即可
    配置的格式是 http://对方(金控)服务器ip地址:端口/api/zzd/accountinout
4:增加一个工作站点编号 httpjk (所有的接口数据全部计入这个工作站点,推荐该站点对应新的门店编号)
5:为了增强数据库的多用户读写,推荐采用READ_COMMITTED_SNAPSHOT模式
    (方法参考数据库2000和2008READ_COMMITTED_SNAPSHOT的版本说明.txt 就是美食城数据库的配置方法)
6:中债登的数据库居然 hycktz和hyxstz 这两个表没有和会员资料表外键(导致会员资料表能随便删除和修改)
    ALTER TABLE hyxstz ADD CONSTRAINT FK_hyxstz_hyda FOREIGN KEY (hyh) REFERENCES hyda (hy_no)
    ALTER TABLE hyxstz ADD CONSTRAINT FK_hycktz_hyda FOREIGN KEY (hyh) REFERENCES hycktz (hy_no)
    因为已经有记录不对应了,导致上述的语句无法执行,只能企业管理器手工建立外键
请求URL
http://yzj.sunwayit.com:21111/api/zzd/accountinout
yzj.sunwayit.com 这个是测试地址,实际部署就是我方接口电脑的网络ip地址,(:21111/api/zzd/accountinout部分是固定的)

请求方式

post

请求参数示例

{
"emptel": "13957191591",
"empname": "张三",
"out_trade_no": "2022123012042301232323012",
"Inout_type": 20,
"inout_money": 5.5,
"recdate": "2022-12-30",
"rectime": "12:09:30"
}

json字段说明

字段名	必选	类型	说明
emptel	是	string	人员电话(人员唯一值)
empname	否	string	姓名
out_trade_no	是	string	订单号(由第三方系统生成订单号)
Inout_type	是	int	收支类型 10-充值 20-消费
inout_money	是	number	操作金额(单位元)
recdate	是	string	消费日期 Yyyy-mm-dd
rectime	是	string	消费时间 Hh:mm:ss

成功返回示例

{
"rtncode": 0,
"rtntext": "操作成功",
"rtnservertime": "2022-12-30 13:43:32"
}

成功返回示例的参数说明

参数名	类型	说明
rtncode	long	0表示成功，其他表示失败
rtntext	string	成功返回相应的处理信息,失败的时候返回错误信息,
rtnservertime	string	返回服务器的电脑时间

失败返回示例

{
"rtncode": 10005,
"rtntext": "error-10005:未找到人员信息","
rtnservertime": "2022-12-30 13:43:32"
}

失败返回示例的参数说明

参数名	类型	说明
rtncode	long	0表示成功，其他表示失败
rtntext	string	成功返回相应的处理信息,失败的时候返回错误信息,
rtnservertime	string	返回服务器的电脑时间

备注 yzj.sunwayit.com 这个是测试地址,实际部署就是我方接口电脑的网络ip地址

祥云技术部发表于 2023-02-09 最后更新 2023-02-10

zxcyb_ocshttp_update.exe是将我方发生的收支明细,post给OCS-http,让他们写入他们的后台数据库
注意:
1:会员档案中的电话号码长度大于等于11位的会员收支明细才会触发处理,所以需要测试的话,修改一个电话号码的长度大于等于11位,就自动触发了
    反过来说:手机号码长度 < 11位的会员收支明细是不会通讯给他们的
2:操作金额(单位元) 如果等于 = 0 ,就不再post给对方,因为没有意义,我方直接update为已经上传
3:是否上传的标志是字段: duizhang_flag (说明:duizhang_flag=1已上传;duizhang_flag=0未上传(默认值))
4:其他字段说明: duizhang_date是上传成功的操作时间

提取需要发送的会员充值明细的SQL语句
SELECT hycktz.hy_no as jiekou_hy_no,
         jfk_hyda.telephone as '人员电话(人员唯一值)',
         jfk_hyda.name as '姓名',
         'hycktz' + RIGHT('00000000' + CONVERT(VARCHAR,hycktz.lsh), 8) as '订单号(由第三方系统生成订单号)',
         10 as '收支类型 10-充值 20-消费',
         hycktz.saving_amount as '操作金额(单位元)',
         hycktz.yyrq as '消费日期 Yyyy-mm-dd',
         hycktz.saving_time as '消费时间 Hh:mm:ss',
         hycktz.lsh
     FROM hycktz,jfk_hyda
   WHERE ( hycktz.hy_no = jfk_hyda.hy_no ) and
        ( hycktz.duizhang_flag = 0 ) AND
        ( len(jfk_hyda.telephone) >= 11 )
ORDER BY hycktz.yyrq ASC,hycktz.saving_time ASC

提取需要发送的会员消费明细的SQL语句
SELECT hyxstz.hyh as jiekou_hy_no,
         jfk_hyda.telephone as '人员电话(人员唯一值)',
         jfk_hyda.name as '姓名',
         'hyxstz' + RIGHT('00000000' + CONVERT(VARCHAR,hyxstz.lsh), 8) as '订单号(由第三方系统生成订单号)',
         20 as '收支类型 10-充值 20-消费',
         hyxstz.je as '操作金额(单位元)',
         hyxstz.yyrq as '消费日期 Yyyy-mm-dd',
         hyxstz.rq as '消费时间 Hh:mm:ss',
         hyxstz.lsh
FROM hyxstz,jfk_hyda
   WHERE ( hyxstz.hyh = jfk_hyda.hy_no ) and
        ( hyxstz.duizhang_flag = 0 ) AND
        ( len(jfk_hyda.telephone) >= 11 )
ORDER BY hyxstz.yyrq ASC,hyxstz.rq ASC

祥云技术部发表于 2023-02-10 最后更新 2023-02-10

5:增加一个员工编号 httpjk (所有的接口数据全部计入操作员,推荐该员工对应新的门店编号),并且设置为离职

如果不添加员工编号 httpjk 也问题不大, 就是会员报表中操作员这一栏空白而已

祥云技术部发表于 2023-02-10 最后更新 2023-02-10

阿里云ybb服务器大屏查询接口

简要描述    祥云结算系统,手表报表阿里云服务器ybb对应大屏查询接口
接口状态    已完成
请求URL     http://ybb.sunwayit.com:21111/api/ybbdapin
请求方式    post

请求参数示例

{

"dogid": -2143249364,

"day": 7

}

json字段说明

字段名	必选	类型	说明
dogid	是	number	对应的加密狗号码
day	是	number	day=7 代表返回7天内合计数据, 其他值(例如day=1或者day=0)代表返回当天数据

成功返回示例

{

"dogid": -2143249364,

"returnstatus": "1",

"returnmess": "接口状态正常(返回最近7天内数据)",

"bill": [

{

"billtotal": 9207.19,

"billdisc": 1339,

"billreal": 7868.19,

"billnumber": 531,

"billnumber_isvip": 336,

"billnumber_notvip": 195

}

],

"payment": [

{

"paymentname": "储值卡",

"paymentamount": 4175.17

},

{

"paymentname": "微信支付",

"paymentamount": 2073.01

},

{

"paymentname": "现金",

"paymentamount": 522

},

{

"paymentname": "支付宝支付",

"paymentamount": 1098.01

}

],

"plu": [

{

"plunumber": "1",

"pluname": "圆形-白色"

},

{

"plunumber": "2",

"pluname": "圆边方形-白色"

},

{

"plunumber": "3",

"pluname": "圆形-翠绿色"

},

{

"plunumber": "4",

"pluname": "正方形-白色"

},

{

"plunumber": "5",

"pluname": "圆边方形-翠绿色"

},

{

"plunumber": "6",

"pluname": "圆边方形-淡黄色"

},

{

"plunumber": "7",

"pluname": "船边矩形-白色"

},

{

"plunumber": "8",

"pluname": "正方形-紫色"

},

{

"plunumber": "9",

"pluname": "椭圆-白色"

},

{

"plunumber": "10",

"pluname": "盅形-淡黄色"

}

],

"servertime": "2022-11-15 09:18:20"

}

成功返回示例的参数说明

参数名	类型	说明
dogid	number	查询对应的加密狗号码
returnstatus	string	1代表处理成功,不是1代表处理失败
returnmess	string	这个是处理之后返回的文字描述
bill	array	订单相关信息数组
billtotal	number	订单总金额
billdisc	number	订单优惠金额(含打折,老年人每餐优惠5元,8元)
billreal	number	订单实收金额
billnumber	number	订单总数量
billnumber_isvip	number	会员订单数量
billnumber_notvip	number	非会员订单数量
payment	array	订单支付信息数组
paymentname	string	支付方式名称
paymentamount	number	支付方式金额
plu	array	销售排行前10的商品数组

5.5(祥云在线卡第三方接口)+(ybb大屏接口/南苑老年食堂)+(中债登OCS-HTTP)接口说明

目录

祥云在线卡http服务接口V2021版本更新时间：2021-05-19 13:53:22

祥云在线卡http服务接口会员余额查询 复制接口 更新时间：2021-05-19 16:12:03

基本信息

请求参数

body参数及说明

字段描述

字段描述

失败响应示例

字段描述

祥云在线卡http服务接口会员扣卡操作 复制接口 更新时间：2021-05-19 16:12:24

基本信息

请求参数

body参数及说明

字段描述

字段描述

失败响应示例

字段描述

OCS-HTTP接口说明账户收支明细交互接口(祥云部分)

简要描述

请求方式

请求参数示例

json字段说明

成功返回示例

成功返回示例的参数说明

失败返回示例

失败返回示例的参数说明

备注 yzj.sunwayit.com 这个是测试地址,实际部署就是我方接口电脑的网络ip地址

阿里云ybb服务器大屏查询接口

简要描述 祥云结算系统,手表报表阿里云服务器ybb对应大屏查询接口接口状态 已完成请求URL http://ybb.sunwayit.com:21111/api/ybbdapin 请求方式 post

请求参数示例

json字段说明

成功返回示例

成功返回示例的参数说明

祥云在线卡http服务接口会员余额查询更新时间：2021-05-19 16:12:03

祥云在线卡http服务接口会员扣卡操作更新时间：2021-05-19 16:12:24

简要描述祥云结算系统,手表报表阿里云服务器ybb对应大屏查询接口
接口状态已完成
请求URL http://ybb.sunwayit.com:21111/api/ybbdapin
请求方式 post