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

查询订单价格(泊链)

时间:2022/3/16 14:59:07      点击:

数据返回时的data_target固定为bolink,发送到泊链
车主在本车场停车,且不是本停车云的会员时,车主操作公众号或app查询订单,泊链下发查询订单金额请求到sdk,sdk回调收费系统查询订单金额,收费系统计算后返回给sdk,收费系统通过sdk的方法UploadUtil.uploadData(String jsonData)将当前订单金额上传到泊链,再通知到车主终端,显示订单金额 。
注:无牌车扫出场直付码支付成功后,再次扫码泊链下发的价格查询消息pay_scene是1
注:有牌车扫出场直付码查询价格,车场本地收费系统根据泊链推送的车场编号、pay_scene支付场景、出口通道号等信息判断并返回相应车场、通道当前需要结算的车辆订单价格信息(例如:A车开到车场出口通道D3,这时扫出口通道D3的出场直付码,车场根据pay_scene支付场景、出口通道号D3等信息判断返回车辆A的订单价格信息)
字段信息:

名称说明类型最大长度示例是否必传字段
car_number车牌String8京HP00G6否,pay_scene为0,2时必传
service_name接口名称String64query_price
order_id订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号)String4810000否,pay_scene为0,2时必传;pay_scene为0时,无在场订单会下发order_id为空串
park_id车场编号String2420003
pay_scene支付场景,0:场内预付,1:结算待支付,2:无牌车请求结算,默认:0Number20
out_channel_id出口通道:字母、数字和下划线组成String16A1否,pay_scene为1,2时必传
query_order_no查询价格编号:本次收费系统查询价格的编号,返回时,原值返回,在预付通知中返回给收费系统String48300022否,pay_scene为1,2时必传
licence无牌车车牌String10AD42F3B否,车场以出口待结算车辆为准;泊链下发当前扫码车主产生过的无牌车牌号,当车场本地不存在待结算有牌车订单且存在该无牌车的在场订单的情况下,才使用licence车牌来进行结算
pay_app支付APP,枚举值 : 0微信、1支付宝、2农行Number20否(只有SDK对接的车场且支付通道是农业银行的才能在查询价格的时候下发pay_app 字段)
pay_user_id微信openID或者支付宝的BuyerIDString100ouc2o01Annba-HFNNfij-3xBXHrEEWEW否,当车主用微信或者支付宝APP扫码支付时,并且支付通道是微信直连、支付宝直连、乐刷、汇付为必传

示例:
{"query_order_no":"218402018060000000p-863","park_id":"20003","car_number":"62000F9","service_name":"query_price","order_id":"15000001195","pay_scene":0,"licence":"AD42F3B"}


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

名称说明类型最大长度示例是否必传字段
service_name接口名称String64query_price
data_target传输位置,SDK模式必传,HTTP模式不传String8bolink
state状态Number20失败1成功
free_out_time免费离场时间(分钟)Number1510否(默认显示10分钟)
query_time查询价格时间Number(unix时间戳格式,精确到秒)151490875218
duration停车时长(分钟)Number1550
derate_money减免金额(元)String155
derate_duration减免时长(分钟)Number155
park_id车场编号String2420003
order_id订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号)String4810000
query_order_no查询价格编号:本次收费系统查询价格的编号,返回时,原值返回,在预付通知中返回给收费系统String48300022否,查询调用pay_scene为1,2时必传
errmsg方法返回描述String48State=0时不能为空否(有值时必传)
price当前应收金额(元)String154.0
total订单总金额(元)String156.0
position停车位置String24A001
in_time进场时间,unix时间戳格式,精确到秒Number151490875218否, pay_scene为0,2时必传;(与car_number同时返回,可以支付未上传的订单)
car_number车牌String8京GH0093否, pay_scene为0,2时必传;(与in_time同时返回,可以支付未上传的订单)
hide_inpark_info有了这字段我们就不显示入场时间和停车时长等需要入场信息的字段Number21是 0否否(pay_scene为1,2时,返回hide_inpark_info值为1,可以隐藏入场时间和停车时长等需要入场信息)
multiple_prepay车场返回价格时加上这个参数,0不支持多次预付,1支持多次预付;默认0。Number10不支持,1支持






discount_info本地积分电子券,以下为discount_info 的字段参数json

否,本地有已对接的积分电子券时返回
member_id会员编号String50Adad123123123123123
use_type使用方式:1:积分与电子券只能使用其中一种;2:积分与电子券均可使用Number11否,当积分信息和电子券信息并存时必传
limit_hour最大兑换小时Number105
limit_count电子券最大使用张数Number105






member_points_info会员积分信息,以下为member_points_info 的字段参数json

member_points总积分数Number1010000
points_per_hour兑换每小时所用积分Number10100
coupon_list电子券列表,以下为具体的字段JsonArray

coupon_id电子券idString64Qwqe1231231231
amount电子券面额Number3010
unit单位 1-小时 2-元Number101
expires_time过期时间Number(unix时间戳格式,精确到秒)201564419661
attach附加信息,回调时返回Json128{"should_pay":"0.08"}






park_info_detail子车场停车详情列表 ,以下为具体的字段JsonArray

area_name子车场名称String30地库一层
duration子车场停车时长说明String301天3小时10分钟
isEscape是否强缴,0不显示逃单 ,1显示逃单不强缴 ,2显示逃单并强缴,默认传0不显示逃单Number10






is_report数据是否上传到上海路政平台,0 不上报,1 上报Number21
empty_plot空闲车位数Number1220

示例:
{"service_name":"query_price","data_target":"bolink","errmsg":"我查询成功啦","state":1,"park_id":"21840","order_id":"38320","price":"0.01","duration":1,"query_time":1564538334,"derate_money":"2.00","derate_duration":123,"query_order_no":"2184020190731095912-426","car_number":"","in_time":1561676330,"discount_info":{"member_id":"liu20190729id001","use_type":1,"limit_hour":3,"limit_count":1,"member_points_info":{"member_points":999999666,"points_per_hour":100},"coupon_list":[{"amount":2,"unit":2,"coupon_id":"200002","expires_time":1560000000},{"amount":1,"unit":1,"coupon_id":"100001","expires_time":1564374975}],  "park_info_detail":[{"area_name":"地库一层","duration":"1天3小时10分钟"},{"area_name":"地库二层","duration": "3天3小时10分钟"}],"multiple_prepay":1,"attach":{"should_pay":"0.08"},"position":"A2-1层","isEscape":"1"}

http方式返回字段信息

名称说明类型最大长度示例是否必传字段
service_name服务String64query_price
token令牌String64b1ce1026cb794d8ca515159b4b5cecea
sign数据签名String6450BE7B01F8531AE4346B1170BE8E90DA
data数据,下列字段组成的json对象Json48{}
state状态Number20失败1成功
free_out_time免费离场时间(分钟)Number1510否(默认显示10分钟)
query_time查询价格时间Number(unix时间戳格式,精确到秒)151490875218
duration停车时长(分钟)Number1550
derate_money减免金额(元)String155
derate_duration减免时长(分钟)Number155
park_id车场编号String2420003
order_id订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号)String4810000
query_order_no查询价格编号:本次收费系统查询价格的编号,返回时,原值返回,在预付通知中返回给收费系统String48300022否,查询调用pay_scene为1,2时必传
errmsg方法返回描述String48State=0时不能为空否(有值时必传)
price应收金额(元)String156.0
total订单金额(元)String156.0
position停车位置String24A001
in_time进场时间unix时间戳格式,精确到秒Number151490875218否, pay_scene为0,2时必传;(与car_number同时返回,可以支付未上传的订单)
car_number车牌String8京GH0093否, pay_scene为0,2时必传;(与in_time同时返回,可以支付未上传的订单)
multiple_prepay车场返回价格时加上这个参数,0不支持多次预付,1支持多次预付;默认0。Number10不支持,1支持
attach附加信息,回调时返回Json128{"should_pay":"0.08"}