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"
  }

results matching ""

    No results matching ""