newOrder
功能: 创建行程,支持实时单和预约单
请求参数
参数名 | 类型 | 说明 |
---|---|---|
oid | string | 接入方订单id,必须提供,防止重复发单,每个用户(手机号)默认只能有一个进行中(即计费中)的行程 |
remark | string(可选) | 第三方传入的标记字段,长度限制为64位(过长则截取),在查询或者回调行程信息时会带上,不做任何修改 |
product | json类型 | {"product_type":"private-car","ride_type":"compact"}必须包含产品类型和运力类型 |
product_type | 产品类型 | |
ride_type | 运力类型 | |
passenger | json类型 | {"phone":"13900000000","name":"张三","lng":116.312615,"lat":40.058922}乘客相关数据,电话,姓名(可选),当前位置坐标(平台接入时可选,接入滴滴反作弊时必须) |
phone | 手机号 | |
name(可选) | 姓名 | |
lng(平台可选) | 经度 | |
lat(平台可选) | 纬度 | |
user | json类型 | {"user_id":"123456789","name":"张三","phone":"13900000001","openid":"2088902330753740"}叫车人信息,用户在第三方平台的id,电话(与乘车人相同时可选),姓名(可选),openid(可选),如果平台无法提供用户的设备信息,则在滴滴审核通过之后,可以使用叫车人在第三方平台的个人信息。openid:真身idtype:openid类型,默认1:支付宝,2:百度type:1(默认)支付宝openid,若接入方开通支付宝真身未支付订单校验,必传。开通此功能需要提前申请权限。 |
user_id | 用户在第三方平台的id | |
phone(可选) | 电话(与乘车人相同时可选) | |
name(可选) | 姓名(可选) | |
openid(可选) | 真身id | |
type(可选) | openid类型,默认1:支付宝,2:百度type:1(默认)支付宝openid,若接入方开通支付宝真身未支付订单校验,必传。开通此功能需要提前申请权限 | |
origin | json类型 | {"lng":116.312615,"lat":40.058922,"name":"西二旗地铁站","address":"上地十街"}接驾地点信息 |
lng | 经度 | |
lat | 纬度 | |
name | 地名 | |
address(可选) | 地址 | |
destination | json类型 | {"lng":116.344434,"lat":39.998568,"name":"五道口购物中心","address":"成府路"}目的地信息 |
lng | 经度 | |
lat | 纬度 | |
name | 地名 | |
address(可选) | 地址 | |
device | json类型 | {"imei":"123we125","suuid":"123juuiuiausd","network":"WIFI","wifi_name":"tp_link123","wifi_ip":"10.10.10.10","wifi_mac":"aasdasd"}imei/suuid:必须存在一个deviceid:设备idip:设备ip地址,接入滴滴反作弊时必须network:如果network为wifi,wifi_name,wifi_ip,wifi_mac必须提供 |
imei/suuid | 必须存在一个 | |
deviceid(可选) | 设备id | |
network(可选,wifi/2G/3G/4G) | ||
ip | 设备ip地址,接入滴滴反作弊时必须 | |
wifi_name(可选) | network=wifi,必填 | |
wifi_ip(可选) | network=wifi,必填 | |
wif_mac(可选) | network=wifi,必填 | |
create_time | string(可选,接入滴滴反作弊时必须) | 2016-03-01T10:00:00+0800用户请求接入方服务的时间,默认为当前时间,支持ISO8601格式和timestamp格式 |
departure_time | string(可选) | 2016-03-01T10:00:00+0800用户选择的出行时间,默认为当前时间,支持ISO8601格式和timestamp格式 |
estimate_id | string(出租车业务无需提供) | 费用预估id,有效时间2分钟用户使用滴滴非出租车服务必须先预估行程费用,此id在预估价格时下发,必须在请求行程时上传,用户请求行程时候的信息和预估时候的信息必须一致,出行时间与预估时候的时间误差不得大于5分钟 |
map_type | string(可选) | 坐标系类型,默认soso,支持坐标系见备注 |
o_type | int(可选) | 订单类别,3航班接机,4航班送机,5列车接站,6列车送站注:如果不能提供航班号/列车号和出发时间,本字段请勿赋值 |
traffic_no | string(o_type为空时可选,否则必须提供) | 航班号/列车号 |
traffic_date | string(o_type为空时可选,否则必须提供) | 航班/列车出发日期,Y-m-d:2016-08-30 |
date_type | int(可选) | 支持按航班/列车的到达时间提交数据0:traffic_date为出发时间1:traffic_date为到达时间 |
taxi_info | json类型(可选) | {"tag":1,"add_price":1000}出租车发单额外信息tag:是否打表来接,1表示打表接,其它表示不打表add_price:出租车调度费,单位为分,只支持100的倍数,最大为5000 |
tag(可选) | tag:是否打表来接,1表示打表接,其它表示不打表 | |
add_price(可选) | add_price:出租车调度费,单位为分,只支持100的倍数,最大为5000 | |
price | json类型(可选) | {"amount":10000,"saving":2000,"coupon":2000},乘客支付的费用详情,计量单位必须是分,包括:总价、减免金额,券优惠金额,总价必须>=0,优惠减免金额必须<=总价注:本字段仅对开放优惠权限的接入方有效 |
amount(必须) | 总价 | |
coupon(可选) | 券优惠金额 | |
saving(可选) | 减免金额 |
备注
默认是标准坐标系,坐标必须精确到小数点后6位,demo请求请注意更换出行时间。注意发单接口通常依赖预估价格接口,newOrder参数值需要跟getEstimatePrice同名参数值保持一致
返回
参数名 | 类型 | 说明 |
---|---|---|
oid | string | 第三方订单id(如果提供了) |
didi_oid | string | 滴滴订单id |
status | string | 行程状态(见备注) |
product_type | string | 产品类型 |
ride_type | string | 运力类型 |
示例
{
"oid": "123123123",
"didi_oid": "didi5F9EBC54197B4FA24B29E9568A19BE9FC31EACE14BDDBE679196D8F42B5F0007",
"status": "Pending",
"product_type": "private-car",
"ride_type": "compact"
}