优惠券信息同步(停车云)
应用场景:
车场合作商家将优惠券发放给车主,车主扫描优惠券二维码关联订单后,优惠券的信息同步到车场收费系统。
字段信息:
名称 | 说明 | 类型 | 最大长度 | 示例 | 是否必传字段 |
---|---|---|---|---|---|
service_name | 接口名称 | String | 64 | deliver_ticket | 是 |
ticket_id | 优惠券编号 | String | 15 | 10022 | 是 |
create_time | 新建时间(unix时间戳格式) | Number | 15 | 1490879218 | 否 |
limit_day | 失效日期(unix时间戳格式) | Number | 15 | 1490879218 | 是 |
money | 优惠券金额 | String | 15 | 5 | 否(ticket_type为0时必传) |
duration | 优惠券时长 | Number | 15 | 5 | 否(ticket_type为1时必传) |
car_number | 车牌 | String | 8 | 京GH0093 | 是 |
ticket_unit | 时长劵单位:1表示分钟,2表示小时,3表示天 | Number | 4 | 1 | 否(ticket_type为1时必传) |
discount | 折扣券额度 | String | 64 | 7 | 是 |
ticket_type | 减免类型:0表示减免停车金额,1表示减免停车时长,2 全免劵,3折扣券,4外部优惠券,5指定截止时间的全免券 | 4 | 0 | 是, ticket_type 为 4 时,ticket_id 字段携带扫描外部券获取的优惠券信息,本地需确认返回该值 | |
order_id | 订单编号 | String | 48 | 9880 | 是,have_order 为0时,下发order_id 为空字符串 |
remark | 备注 | String | 32 | 两小时内免3元 | 否 |
shop_name | 商户名称 | String | 24 | 1号商店 | 是 |
time_range | 如果一张全免券或固定码发出的优惠券支持多次使用,该字段为这张券可以减免的有效时长。此时有值。其它时候为0(当ticket_type为5时,该字段为时间戳,精确到秒) | int | 12 | 0,单位为小时 | 是 |
have_order | 云平台是否有在场订单 | Number | 1 | 1 表示云平台有该车牌的在场订单;0 表示没有,本地根据该字段进行业务处理;该字段原值返回。have_order值为0时 ,与car_number同时返回,可减免未上传的订单,否则记录用券信息失败。(have_order值为0时,与intime、order_id、car_number同时返回,可限制用券的张数(与有在场订单的用券数一致)) | 是 |
park_id | 车场编号 | String | 24 | test001 | 是 |
fix_code_name | 固定码名称 | String | 24 | 测试1固定码 | 否,使用固定码时下发 |
starttime | 券可用开始时间 | String | 15 | 00:00 | 否,使用固定码时下发 |
endtime | 券可用结束时间 | String | 15 | 23:59 | 否,使用固定码时下发 |
startdate | 券可用开始日期(unix时间戳格式) | Number | 15 | 23:59 | 否,使用固定码时下发 |
enddate | 券可用结束日期(unix时间戳格式) | Number | 15 | 23:59 | 否,使用固定码时下发 |
active_start_time | 券生效开始时间 | String | 15 | 00:00 | 否,使用固定码时下发,由本地收费系统判断 |
active_end_time | 券生效结束时间 | String | 15 | 23:59 | 否,使用固定码时下发,由本地收费系统判断 |
buy_money | 车主买券支付金额(元) | String | 15 | 1 | 否,使用固定码且设置车主支付的优惠券下发时必传 |
pay_limit | 支付公司限制 | Number | 15 | 0,不限制;1,农行APP | 否,使用固定码时下发(使用该功能时车场需开通农行支付通道,计费系统对此类优惠券做相应的减免) |
shop_id | 商户编号 | Number | 24 | 234 | 是 |
示例:
{"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 | 接口名称 | String | 64 | deliver_ticket | 是 |
data_target | 传输位置 | String | 8 | cloud | 是 |
ticket_id | 优惠券编号 | String | 15 | 10022 | 是 |
order_id | 订单编号 | String | 48 | 9880 | 是 |
state | 状态 | Number | 2 | 0失败1成功 | 是 |
errmsg | 方法返回描述 | String | 48 | State=0时不能为空 | 否(有值时必传) |
time_range | 如果一张全免券支持多次使用,该字段为这张全免券可以减免的有效时长。此时有值。其它时候为0 | int | 12 | 0 | 是 |
ticket_type | 减免类型:0表示减免停车金额,1表示减免停车时长,2 全免劵,3折扣券,4外部优惠券(为4时必传) | Number | 4 | 0 | 否 |
have_order | 云平台是否有在场订单 | number | 1 | 1 表示云平台有该车牌的在场订单;0 表示没有 | 否,下发的have_order 值为0时,与car_number同时返回,可减免未上传的订单 |
car_number | 车牌 | String | 8 | 京GH0093 | 否,下发的have_order 值为0时,与have_order 同时返回,可减免未上传的订单 |
intime | 进场时间unix时间戳格式 | Number | 15 | 1490875218 | 否, 下发的have_order值为0时,与order_id、car_number同时返回,可限制用券的张数(与有在场订单的用券数一致) |
order_id | 订单记录号(车辆在停车场停车唯一订单编号,支持数字 字母 _ ) | String | 48 | 325101 | 否, 下发的have_order值为0时,与intime、car_number同时返回,可限制用券的张数(与有在场订单的用券数一致) |
http方式返回字段信息
名称 | 说明 | 类型 | 最大长度 | 示例 | 是否必传字段 |
---|---|---|---|---|---|
service_name | 服务 | String | 64 | deliver_ticket | 是 |
token | 令牌 | String | 64 | b1ce1026cb794d8ca515159b4b5cecea | 是 |
sign | 数据签名 | String | 64 | 50BE7B01F8531AE4346B1170BE8E90DA | 是 |
data | 数据,下列字段组成的json对象 | Json | 48 | {} | 是 |
data_target | 传输位置 | String | 8 | cloud | 是 |
ticket_id | 优惠券编号 | String | 15 | 10022 | 是 |
order_id | 订单编号 | String | 48 | 9880 | 是,订单号为空时无法限制叠加张数 |
state | 状态 | Number | 2 | 0失败1成功 | 是 |
errmsg | 方法返回描述 | String | 48 | State=0时不能为空 | 否(有值时必传) |
time_range | 如果一张全免券支持多次使用,该字段为这张全免券可以减免的有效时长。此时有值。其它时候为0 | int | 12 | 0 | 是 |
have_order | 云平台是否有在场订单 | number | 1 | 1 表示云平台有该车牌的在场订单;0 表示没有 | 否,下发的have_order 值为0时,与car_number同时返回,可减免未上传的订单 |
car_number | 车牌 | String | 8 | 京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"}
- 上一篇:通道数据下发 (停车云) 2022/3/16
- 下一篇:公众号月卡续费查询价格(停车云) 2022/3/16