接驳下单

TranshipOrder(v2.0)接驳下单

接口说明

HTTPS请求方式:POST

url:https://dllyfw.com/OpenApi/TranshipOrderV2

使用调试工具调试该接口
参数说明
参数 类型 长度 可空 描述
apiKey string 32 由官方平台提供的apiKey
productCode string 4-32 产品码

是双方在对接过程中,约定好的。通过产品码,可以在我方找到唯一对应的一个产品。

querymode int 1 是否下单问询模式,1:是,0:不是。下单问询模式不会实际下单,仅检测能否下单成功,建议对接方提交订单前先进行问询,以免下单后推送时无法推送成功。
quantity decimal 18(2) 接驳人数,以此为计价数量。(按人头计费直接计算,按车计费则除以每车座位数的最大整数)
tel string 30 客人电话
collectedContact string 20 姓名
transhipTime string 16 接驳时间司机将在此时间上门接驳客人,格式 yyyy-MM-dd HH:mm,如:2019-08-27 10:30
接驳时间必须在服务时间范围,且必须距离当前时间至少30分钟。
placeId int 接驳目的地编号
lng long 接驳地址定位,经度
lat long 接驳地址定位,纬度
address
(选填)
string 50 接驳地址
transhipP
(选填)
string 50 省(必须为高德地图定位数据addressComponent.province,便于接驳系统分配司机,如非高德地图数据请勿提供以免影响接驳效率)
transhipC
(选填)
string 50 市(必须为高德地图定位数据addressComponent.city,便于接驳系统分配司机,如非高德地图数据请勿提供以免影响接驳效率)
transhipD
(选填)
string 50 区(必须为高德地图定位数据addressComponent.district,便于接驳系统分配司机,如非高德地图数据请勿提供以免影响接驳效率)
transhipT
(选填)
string 50 镇(必须为高德地图定位数据addressComponent.township,便于接驳系统分配司机,如非高德地图数据请勿提供以免影响接驳效率)
mark
(选填)
string 50 接驳备注
number
(选填)
string 32 对接方订单号

如果提供此参数,将存入我方订单中,方便对接方根据自己的订单号查询下单是否成功。

sign string 32

由apiSecret,与参数productCode、quantity、tel,通过MD5签名运算后的值。

注意:选填参数不参与签名运算

签名规则
返回说明

Json格式的Result对象

{
    "ErrorCode": 0,
    "Success": true,
    "Message": null,
    "HasException": false,
    "Value": 123123222,
    "Tag": 3423321,
    "HasETicket": true
}
返回值 描述
Success 本次调用是否成功
ErrorCode 错误代码
Message 失败时为异常信息,成功时为null
Value Number:订单号
Tag 客人消费码(验证码)
支持下单重试,但number参数必填(为对接方的订单号),如果没有填写number参数,视为新下单。
在带有number参数的情况下,我方会对此number进行判重检查,如果发现已经下过单,会将之前的订单返回 (Value为订单号,Tag为验证码,Success为False,Message为错误原因),