TranshipOrder(v2.0)接驳下单
接口说明 参数说明| 参数 | 类型 | 长度 | 必填 | 参与签名 | 描述 |
|---|---|---|---|---|---|
| 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，如：2021-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为错误原因）， |
|