2.2车辆出场(泊链,停车云)
应用场景:
车场上传订单出场记录至停车云和泊链,在停车云后台可查看订单出场记录,在泊链平台可查看订单的交易记录。
Java调用接口:UploadUtil.uploadOutParkOrder(String jsonData),调用时,把所有参数按json对象格式组成字符串,作为参数给java方法。
注:单个SDK 上传订单频率必须限制低于每秒10条!
注:车辆出场前,收费系统有电子支付业务需求时,需要先调用sdk提供的查询接口(4.1接口),来查询车主余额和泊链网络状态,收费系统需要根据返回数据来处理下一步的支付方式,接口说明见接口4.1,接口返回中net_status描述了SDK与泊链的网络状态(0不通,1通畅),balance是车主的余额,收费系统根据返回数据来判断车主余额是否充足以及目前到泊链的网络状态是否畅通,建议当网络状态通畅时,才需要调用此接口,余额充足时,pay_type=wallet,当余额不足或没有余额时,可以发起扫码枪支付,这时pay_type=sweepcode,同时auth_code为必传。出场结算业务可能会重复调用车辆出场接口,直到结算完成。
pay_type=sweepcode、wallet、cash、monthuser 、free时需要调用此接口
pay_type=scancode时如果只使用泊链支付功能无需调用2.2,如果同时需要云平台功能则调用2.3接口。
部分数字型字段说明:
in_channel_id,out_channel_id 与车场入场中的in_channel_id定义一致,worksite_id与车场入场中的worksite_id定义一致
freereasons:免费原因 可以在parkingOS系统中免费原因中设设置
ticket_id:减免券ID 可以在parkingOS系统中停车券管理中设置
上述的字段只能传入已定义好的数字类型值,其它数据无效,收费系统自定义的枚举值,需要在停车云后台增加相应修改,否则数据不能展示。
字段信息:
名称 | 说明 | 类型 | 最大长度 | 示例 | 是否必传字段 |
---|---|---|---|---|---|
car_number | 车牌 | String | 8 | 京GH0093 | 是 |
in_time | 进场时间(unix时间戳格式,精确到秒) | Number | 15 | 1490875218 | 是 |
out_time | 出场时间(unix时间戳格式,精确到秒) | Number | 15 | 1490879218 | 是 |
uid | 入场收费员编号(支持数字 字母 _ ) | String | 24 | 880099 | 是 |
duration | 停车时长(分钟) | Number | 15 | 50 | 否 |
car_type | 车型 | String | 12 | 小车 | 是 |
c_type | 进场类型 | String | 12 | 通道扫牌 | 是 |
out_type | 出场类型 | String | 12 | 通道扫牌 | 否 |
pay_type | 支付类型,cash:现金支付,wallet:余额支付,sweepcode:扫码支付,escape:逃单出场 | String | 12 | cash,wallet,sweepcode,escape | 是 |
auth_code | 授权码,支付类型是sweepcode时必传 | String | 48 | 微信或支付宝支付码 | 否 |
empty_plot | 空闲车位数 | Number | 15 | 20 | 是 |
total | 实时订单金额(不包含已预付、已减免的部分) | String | 15 | 6.5 | 是 |
order_id | 订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号,支持数字 字母 _ ) | String | 48 | 9009 | 是 |
freereasons | 免费原因 | String | 10 | 1 | 否 |
out_channel_id | 出场通道 | String | 12 | A1 | 否 |
in_channel_id | 进场通道 | String | 12 | B1 | 否 |
work_station_uuid | 岗亭/工作站唯一标识 | String | 10 | qwrrw23534 | 否 |
ticket_id | 减免券ID | String | 15 | 34556677 | 否 |
reduce_amount | 减免金额 | String | 15 | 6.0 | 否 |
amount_receivable | 应收金额 | String | 15 | 10.0 | 是 |
electronic_prepay | 电子预付 | String | 15 | 2.0 | 否 |
electronic_pay | 电子结算 | String | 15 | 1.0 | 否 |
cash_prepay | 现金预付 | String | 15 | 2.0 | 否 |
cash_pay | 现金结算 | String | 12 | 2.0 | 否 |
etc_pay | etc结算 | String | 15 | 1.0 | 否 |
out_uid | 出场收费员编号 | String | 24 | 23456 | 是 |
islocked | 锁车标记 | Number | 2 | 0否1是 | 否 |
lock_key | 锁车密码 | Number | 8 | 2345 | 否 |
remark | 备注 | String | 32 | 出场信息备注 | 否 |
derate_duration | 减免时长(分钟) | Number | 15 | 30 | 否 |
license_color | 车牌颜色,0蓝色;1黄色;2白色;3黑色;4、新能源;5、黄绿色;6、蓝白渐变色;7、其他(SDK必须升级4.0.0.0版本,微信4.0无感不传则默认蓝色) | Number | 1 | 0 | 否 |
is_report | 数据是否上传到上海路政平台,0 不上报,1 上报 | Number | 2 | 1 | 否 |
车辆出场接口调用后,分为:方法返回结果(同步)和异步返回结果,pay_type为wallet或sweepcode时需要等待异步返回结果来处理业务(只是先返回state2再返回1异步结果等待时间较长):
调用同步返回结果:state是sdk收到数据后返回的状态,pay_type为wallet或sweepcode时的支付状态要从异步返回的state判断(只是先返回state2再返回1异步结果等待时间较长)。
车辆出场调用方法后同步返回结果:
名称 | 说明 | 类型 | 最大长度 | 示例 | 是否必传字段 |
---|---|---|---|---|---|
state | 状态 | Number | 2 | 0失败,1成功,2支付中 | 是 |
order_id | 订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号) | String | 48 | 325101 | 是 |
service_name | 接口名称 | String | 64 | out_park | 是 |
net_status | 泊链网络状态 | Number | 2 | 0不通 1通 | 是 |
pay_type | 支付类型 | String | 12 | cash,wallet,sweepcode,free,monthuser | 是 |
errmsg | 方法返回描述 | String | 48 | 当net_status为0时:errmsg:“网络不通,请用现金支付!”;当net_status为1时:1.支付方式为wallet:(1).余额充足,发送消息给泊链(准备扣费放行);(2).余额不足,errmsg:”余额不足,请选其他支付方式”;2.支付方式为sweepcode时发送消息到泊链请求支付停车费(准备支付放行)。 | 是 |
car_number | 车牌 | String | 8 | 京GH0093 | 否 |
out_channel_id | 出场通道 | String | 12 | A1 | 否 |
park_id | 车场编号 | String | 24 | test001 | 否 |
异步返回见3.4接口
http出场字段信息:
名称 | 说明 | 类型 | 最大长度 | 示例 | 是否必传字段 |
---|---|---|---|---|---|
service_name | 服务 | String | 64 | 固定outpark | 是 |
token | 令牌 | String | 64 | def684dd3b1f4e37bd7b14a378847b0a | 是 |
sign | 数据签名 | String | 64 | EFB19B2ED7F78541F3AAF00432F696A5 | 是 |
data | 数据,下列字段组成的json对象 | Json | 48 | {} | 是 |
car_number | 车牌 | String | 8 | 苏DTTTT9 | 是 |
in_time | 进场时间(unix时间戳格式,精确到秒) | Number | 15 | 1490875218 | 是 |
out_time | 出场时间(unix时间戳格式,精确到秒) | Number | 15 | 1490879218 | 是 |
total | 实时订单金额(不包含已预付、已减免的部分) | String | 15 | 6.5 | 是 |
order_id | 订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号) | String | 48 | 9009 | 是 |
empty_plot | 空闲车位数 | Number | 15 | 20 | 是 |
pay_type | 支付类型 | String | 12 | cash | 是 |
auth_code | 授权码,支付类型是sweepcode时必传 | String | 64 | 微信或支付宝支付码 | 否 |
{"service_name":"outpark","token":"def684dd3b1f4e37bd7b14a378847b0a","sign":"CB649425CB5548A375099103AB04CC1E",data:{"car_number":"苏DTTTTT","in_time":1510132659,"out_time":1510135875,"total":"0.54","order_id":"A1_2C1510828170","empty_plot":20,"pay_type":"cash","auth_code":""}}
http车辆出场调用方法后返回结果:
名称 | 说明 | 类型 | 最大长度 | 示例 | 是否必传字段 |
---|---|---|---|---|---|
state | 状态 | Number | 2 | 0失败,1成功 | 是 |
order_id | 订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号) | String | 48 | 325101 | 是 |
service_name | 接口名称 | String | 64 | outpark | 是 |
pay_type | 支付类型 | String | 12 | cash,wallet,sweepcode,free,monthuser | 是 |
trade_no | 交易流水号(pay_type为wallet、scancode、sweepcode必传) | String | 64 | 2107110315352000 | 否 |
errmsg | 方法返回描述 | String | 64 | 提示信息 | 是 |
{"state":1,"trade_no":"","errmsg":"结算成功","order_id":"A1_2C1510828170","pay_type":"cash","service_name":"outpark"}
- 上一篇:2.3异常订单记录上传(停车云) 2022/3/16
- 下一篇:二、上行接口(收费系统调用 SDK) 2022/3/16