> **应用场景**:
>车场合作商家将优惠券发放给车主,车主扫描优惠券二维码关联订单后,优惠券的信息同步到车场收费系统。
字段信息:
| 名称 | 说明 | 类型|最大长度 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- | --- |
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 |否,have_order=1时必传; have_order=0时,与intime、car_number同时返回,可限制用券的张数(与有在场订单的用券数一致)| |
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同时返回,可限制用券的张数(与有在场订单的用券数一致)|
*****
### **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"}
- 停车收费系统对接协议(车场管理+支付)
- 修订记录
- SDK开发包下载
- 一、系统集成
- 1.1初始化(废弃版本)
- 1.2 车场初始化(SDK 4.2 及后续版本)
- 1.2.1 加密说明
- 1.3反初始化
- 1.4 http退出登录接口
- 二、上行接口(收费系统调用 SDK)
- 2.1 车辆入场(停车云,泊链)
- 2.2车辆出场(泊链,停车云)
- 2.3异常订单记录上传(停车云)
- 2.4车场收费员信息上传(停车云)
- 2.5员工上下班记录上传(停车云)
- 2.6日志上传(停车云)
- 2.8月卡套餐上传(停车云)
- 2.9价格上传(停车云)
- 2.10月卡会员上传(停车云)
- 2.11异常抬杆/落杆上传(停车云)
- 2.12车辆图片上传
- 2.13月卡续费记录上传(停车云)
- 2.14通道数据上传 (停车云)
- 2.15黑名单上传(停车云)
- 2.16车型数据上传(停车云)
- 2.17出场模糊匹配确认事件上传(停车云)
- 2.18获取二维码地址(泊链)
- 2.19车场订单电子支付状态查询接口
- 2.20 查询在场订单(泊链)
- 2.21岗亭交易订单查询(泊链返回h5 url)
- 2.22 岗亭交接班记录(泊链)
- 2.23 云平台对账接口(停车云)
- 2.24 月卡信息查询(停车云)
- 2.25 储值卡上传(停车云)
- 2.26 储值卡充值记录上传(停车云)
- 2.27 储值卡扣除余额上传(停车云)
- 2.28 储值卡余额查询(停车云)
- 2.29 上传优惠券减免接口(停车云)
- 2.30 泊链电子支付对账接口
- 2.31电子发票上传接口
- 2.32 上传收费系统日志
- 2.33 分页查询月卡信息(停车云)
- 2.34 充电减免信息上传(停车云)
- 2.35 内部车上传(停车云)
- 2.36 平台转发接口(停车云)
- 2.37 ETC扣费
- 2.38 逃单查询
- 2.39停车场停车业务纠正
- 2.40在停业务总数查询
- 2.41在停业务详情查询
- 2.42市级车入场判定
- 2.43获取车道屏幕文字
- 2.44离线订单(先走后付)
- 三、下行接口(SDK回调收费系统)
- 3.1查询订单价格(泊链)
- 3.2预付订单通知(泊链)
- 3.3无牌车入场请求(泊链)
- 3.4电子收费异步返回结果(泊链)
- 3.5价格同步(停车云)
- 3.6月卡套餐同步(停车云)
- 3.7月卡会员同步(停车云)
- 3.8车场收费员信息同步(停车云)
- 3.9接收消息实现锁车/解锁(停车云)
- 3.10月卡续费(泊链)
- 3.11 公众号月卡续费查询价格(停车云)
- 3.12优惠券信息同步(停车云)
- 3.13通道数据下发 (停车云)
- 3.14黑名单下发(停车云)
- 3.15车型数据下发(停车云)
- 3.16月卡续费记录下发(停车云)
- 3.17手动匹配订单通知(停车云)
- 3.18 抬杆/落杆通知(停车云)
- 3.19 访客管理下发 (停车云)
- 3.20 储值卡同步(停车云)
- 3.21 储值卡余额变更记录下发(停车云)
- 3.22 云平台透传接口
- 3.23 退款下发通知(泊链)
- 3.24 找零支出下发通知(泊链)
- 3.25 平台缴费通知(停车云)
- 3.26 查询车场停车位通知(停车云)
- 3.27 内部车同步(停车云)
- 3.28 手动结算(停车云)
- 3.29 追缴订单异步返回结果(泊链)
- 3.30 积分电子券信息同步(泊链)
- 3.31 车道监控抓拍下发(停车云)
- 3.32 通知上传收费系统日志(泊链)
- 3.33 下发收费系统升级通知(泊链)
- 3.34 公众号新建月卡查询价格(停车云)
- 3.35 车场有效期下发(停车云)
- 3.36 充电桩充电通知(泊链)
- 3.37 逃单补缴异步返回结果(泊链)
- 3.38 车辆包月账单信息查询
- 3.39 修改道闸余位
- 3.40 查询月卡车、特殊车
- 3.41 门禁读取的健康码状态下发(停车云)
- 3.42 补录订单手动入场
- 3.43 在场订单车牌校正
- 3.44 无在场订单固定收费
- 四、查询免密及电子支付(SDK提供)
- 4.1获取车牌是否支持免密和SDK心跳
- 4.2推送当前车牌余额及是否支持无感支付(http)
- 五、常见问题与数据定义
- 5.1 数据定义
- 5.1.1车型:car_type
- 5.1.2 入场/出场车型:c_type/out_type
- 5.1.3 订单支付类型:pay_type
- 5.1.4锁车标记:islocked
- 5.1.5性别:sex
- 5.1.6操作类型:operate_type
- 5.1.7员工上下班类型:state
- 5.1.8数据上传位置:data_target
- 5.1.9异常抬杆原因:reason
- 5.1.10是否是泊涟会员:is_exist
- 5.1.11网络状态:net_status
- 5.1.12订单支付通道:pay_channel
- 5.2 常见问题答疑
- 六、专题文档
- 七、智慧屏应用
- 7.1 获取智慧屏 ip(收费系统调用SDK)
- 7.2 初始化连接智慧屏(收费系统调用SDK)
- 7.3 推送出场订单(收费系统调用SDK)
- 7.4 接收被扫数据(SDK回调收费系统)
- 7.5 车场生成出口支付码
- 7.6 推送语音播报
- 7.7 推送进场订单