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

2.2车辆出场(泊链,停车云)

时间:2022/3/16 11:31:20      点击:

应用场景
车场上传订单出场记录至停车云和泊链,在停车云后台可查看订单出场记录,在泊链平台可查看订单的交易记录。

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车牌String8京GH0093
in_time进场时间(unix时间戳格式,精确到秒)Number151490875218
out_time出场时间(unix时间戳格式,精确到秒)Number151490879218
uid入场收费员编号(支持数字 字母 _ )String24880099
duration停车时长(分钟)Number1550
car_type车型String12小车
c_type进场类型String12通道扫牌
out_type出场类型String12通道扫牌
pay_type支付类型,cash:现金支付,wallet:余额支付,sweepcode:扫码支付,escape:逃单出场String12cash,wallet,sweepcode,escape
auth_code授权码,支付类型是sweepcode时必传String48微信或支付宝支付码
empty_plot空闲车位数Number1520
total实时订单金额(不包含已预付、已减免的部分)String156.5
order_id订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号,支持数字 字母 _ )String489009
freereasons免费原因String101
out_channel_id出场通道String12A1
in_channel_id进场通道String12B1
work_station_uuid岗亭/工作站唯一标识String10qwrrw23534
ticket_id减免券IDString1534556677
reduce_amount减免金额String156.0
amount_receivable应收金额String1510.0
electronic_prepay电子预付String152.0
electronic_pay电子结算String151.0
cash_prepay现金预付String152.0
cash_pay现金结算String122.0
etc_payetc结算String151.0
out_uid出场收费员编号String2423456
islocked锁车标记Number20否1是
lock_key锁车密码Number82345
remark备注String32出场信息备注
derate_duration减免时长(分钟)Number1530
license_color车牌颜色,0蓝色;1黄色;2白色;3黑色;4、新能源;5、黄绿色;6、蓝白渐变色;7、其他(SDK必须升级4.0.0.0版本,微信4.0无感不传则默认蓝色)Number10
is_report数据是否上传到上海路政平台,0 不上报,1 上报Number21

车辆出场接口调用后,分为:方法返回结果(同步)和异步返回结果,pay_type为wallet或sweepcode时需要等待异步返回结果来处理业务(只是先返回state2再返回1异步结果等待时间较长):
调用同步返回结果:state是sdk收到数据后返回的状态,pay_type为wallet或sweepcode时的支付状态要从异步返回的state判断(只是先返回state2再返回1异步结果等待时间较长)。


车辆出场调用方法后同步返回结果:

名称说明类型最大长度示例是否必传字段
state状态Number20失败,1成功,2支付中
order_id订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号)String48325101
service_name接口名称String64out_park
net_status泊链网络状态Number20不通 1通
pay_type支付类型String12cash,wallet,sweepcode,free,monthuser
errmsg方法返回描述String48当net_status为0时:errmsg:“网络不通,请用现金支付!”;当net_status为1时:1.支付方式为wallet:(1).余额充足,发送消息给泊链(准备扣费放行);(2).余额不足,errmsg:”余额不足,请选其他支付方式”;2.支付方式为sweepcode时发送消息到泊链请求支付停车费(准备支付放行)。
car_number车牌String8京GH0093
out_channel_id出场通道String12A1
park_id车场编号String24test001

异步返回见3.4接口

http出场字段信息:

名称说明类型最大长度示例是否必传字段
service_name服务String64固定outpark
token令牌String64def684dd3b1f4e37bd7b14a378847b0a
sign数据签名String64EFB19B2ED7F78541F3AAF00432F696A5
data数据,下列字段组成的json对象Json48{}
car_number车牌String8苏DTTTT9
in_time进场时间(unix时间戳格式,精确到秒)Number151490875218
out_time出场时间(unix时间戳格式,精确到秒)Number151490879218
total实时订单金额(不包含已预付、已减免的部分)String156.5
order_id订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号)String489009
empty_plot空闲车位数Number1520
pay_type支付类型String12cash
auth_code授权码,支付类型是sweepcode时必传String64微信或支付宝支付码

{"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状态Number20失败,1成功
order_id订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号)String48325101
service_name接口名称String64outpark
pay_type支付类型String12cash,wallet,sweepcode,free,monthuser
trade_no交易流水号(pay_type为wallet、scancode、sweepcode必传)String642107110315352000
errmsg方法返回描述String64提示信息

{"state":1,"trade_no":"","errmsg":"结算成功","order_id":"A1_2C1510828170","pay_type":"cash","service_name":"outpark"}