你的位置:首页 > 新闻动态 > 技术文章

优惠券信息同步(停车云)

时间:2022/3/16 15:05:23      点击:

应用场景
车场合作商家将优惠券发放给车主,车主扫描优惠券二维码关联订单后,优惠券的信息同步到车场收费系统。

字段信息:

名称说明类型最大长度示例是否必传字段
service_name接口名称String64deliver_ticket
ticket_id优惠券编号String1510022
create_time新建时间(unix时间戳格式)Number151490879218
limit_day失效日期(unix时间戳格式)Number151490879218
money优惠券金额String155否(ticket_type为0时必传)
duration优惠券时长Number155否(ticket_type为1时必传)
car_number车牌String8京GH0093
ticket_unit时长劵单位:1表示分钟,2表示小时,3表示天Number41否(ticket_type为1时必传)
discount折扣券额度String647
ticket_type减免类型:0表示减免停车金额,1表示减免停车时长,2 全免劵,3折扣券,4外部优惠券,5指定截止时间的全免券40是, ticket_type 为 4 时,ticket_id 字段携带扫描外部券获取的优惠券信息,本地需确认返回该值
order_id订单编号String489880是,have_order 为0时,下发order_id 为空字符串
remark备注String32两小时内免3元
shop_name商户名称String241号商店
time_range如果一张全免券或固定码发出的优惠券支持多次使用,该字段为这张券可以减免的有效时长。此时有值。其它时候为0(当ticket_type为5时,该字段为时间戳,精确到秒)int120,单位为小时
have_order云平台是否有在场订单Number11 表示云平台有该车牌的在场订单;0 表示没有,本地根据该字段进行业务处理;该字段原值返回。have_order值为0时 ,与car_number同时返回,可减免未上传的订单,否则记录用券信息失败。(have_order值为0时,与intime、order_id、car_number同时返回,可限制用券的张数(与有在场订单的用券数一致))
park_id车场编号String24test001
fix_code_name固定码名称String24测试1固定码否,使用固定码时下发
starttime券可用开始时间String1500:00否,使用固定码时下发
endtime券可用结束时间String1523:59否,使用固定码时下发
startdate券可用开始日期(unix时间戳格式)Number1523:59否,使用固定码时下发
enddate券可用结束日期(unix时间戳格式)Number1523:59否,使用固定码时下发
active_start_time券生效开始时间String1500:00否,使用固定码时下发,由本地收费系统判断
active_end_time券生效结束时间String1523:59否,使用固定码时下发,由本地收费系统判断
buy_money车主买券支付金额(元)String151否,使用固定码且设置车主支付的优惠券下发时必传
pay_limit支付公司限制Number150,不限制;1,农行APP否,使用固定码时下发(使用该功能时车场需开通农行支付通道,计费系统对此类优惠券做相应的减免)
shop_id商户编号Number24234

示例:
{"ticket_type":2,"create_time":1575687031,"limit_day":1575687331,"fix_code_name":"测试1固定码","service_name":"deliver_ticket","have_order":1,"park_id":"12345","discount":"","endtime":"23:59","remark":"","starttime":"00:00","ticket_id":"26105715","shop_name":"不回收折扣券","startdate":1575686996,"active_end_time":"23:59","duration":0,"enddate":1575773396,"money":"","time_range":0,"car_number":"京123124","active_start_time":"00:00","order_id":"A1_2C1575686500","shop_id":234}


返回:调用UploadUtil.uploadData(String jsonData)返回上传结果,方法返回描述如下

名称说明类型最大长度示例是否必传字段
service_name接口名称String64deliver_ticket
data_target传输位置String8cloud
ticket_id优惠券编号String1510022
order_id订单编号String489880
state状态Number20失败1成功
errmsg方法返回描述String48State=0时不能为空否(有值时必传)
time_range如果一张全免券支持多次使用,该字段为这张全免券可以减免的有效时长。此时有值。其它时候为0int120
ticket_type减免类型:0表示减免停车金额,1表示减免停车时长,2 全免劵,3折扣券,4外部优惠券(为4时必传)Number40
have_order云平台是否有在场订单number11 表示云平台有该车牌的在场订单;0 表示没有否,下发的have_order 值为0时,与car_number同时返回,可减免未上传的订单
car_number车牌String8京GH0093否,下发的have_order 值为0时,与have_order 同时返回,可减免未上传的订单
intime进场时间unix时间戳格式Number151490875218否, 下发的have_order值为0时,与order_id、car_number同时返回,可限制用券的张数(与有在场订单的用券数一致)
order_id订单记录号(车辆在停车场停车唯一订单编号,支持数字 字母 _ )String48325101否, 下发的have_order值为0时,与intime、car_number同时返回,可限制用券的张数(与有在场订单的用券数一致)

http方式返回字段信息

名称说明类型最大长度示例是否必传字段
service_name服务String64deliver_ticket
token令牌String64b1ce1026cb794d8ca515159b4b5cecea
sign数据签名String6450BE7B01F8531AE4346B1170BE8E90DA
data数据,下列字段组成的json对象Json48{}
data_target传输位置String8cloud
ticket_id优惠券编号String1510022
order_id订单编号String489880是,订单号为空时无法限制叠加张数
state状态Number20失败1成功
errmsg方法返回描述String48State=0时不能为空否(有值时必传)
time_range如果一张全免券支持多次使用,该字段为这张全免券可以减免的有效时长。此时有值。其它时候为0int120
have_order云平台是否有在场订单number11 表示云平台有该车牌的在场订单;0 表示没有否,下发的have_order 值为0时,与car_number同时返回,可减免未上传的订单
car_number车牌String8京GH0000否,下发的have_order 值为0时,与have_order 同时返回,可减免未上传的订单

示例:
{"service_name":"deliver_ticket","have_order":0,"car_number":"京GH0000","errmsg":"已减免!!","data_target":"cloud","state":1,"ticket_id":"17561669","order_id":"a_12345670981"}