淘宝开放平台

登录
文档中心 > API类目 > 商旅API

商旅API

qimen.alitrip.btripcar.taxi.order.create (商旅用车-创建用车订单)

用户根据需要发起叫车请求，在发起请求之前必须事先获得order id.

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
uid String 可选 123 用户唯一标识
order_id String 必须 100000 请求id 获取请参见
type Number 必须 0 叫车车型，0(实时)；1(预约)
passenger_phone String 可选 15166666666 乘客手机号
city String 必须 12 出发地城市
flat String 必须 30.279212 出发地纬度
flng String 必须 120.026208 出发地经度
start_name String 必须 阿里巴巴西溪园区 出发地名称(最多50个字)
start_address String 可选 浙江省杭州市余杭区文一西路969号 出发地详细地址(最多100个字)
tlat String 可选 30.288773 目的地纬度
tlng String 可选 120.068437 目的地经度
end_name String 可选 蒋村花园 目的地名称(最多50个字)
end_address String 可选 浙江省杭州市余杭区文一西路xxx号 目的地详细地址(最多100个字)
clat String 可选 30.279212 当前位置纬度
clng String 可选 120.026208 当前位置经度
departure_time String 可选 2015-06-16 12:00:09 出发时间，不传表示现在用车（例如：2015-06-16 12:00:09
require_level String 必须 600 车型代码
app_time String 必须 2015-06-16 12:00:09 客户端时间（例如：2015-06-16 12:00:09
map_type String 可选 amap 地图类型:amap：高德，默认高德地图
sms_policy Number 可选 1 发送短信策略(0,为叫车人和乘车人都发送，1，乘车人发送叫车人不发，2乘车人不发叫车人发，3乘车人和叫车人都不发)
extra_info String 可选 备注 备注
dynamic_md5 String 必须 ASDF324567GH6543ERGFD323434RF 价格md5,通过 预估价接口获得
cost_center String 可选 A2324234 成本中心代码，用于区分不同的分账账号
line_type Number 可选 1 线路类型，0或空表示普通线路；1，表示一口价路线
carpool_type Number 可选 1 0：不拼车 1:允许拼车，默认不拼车
passenger_number Number 可选 2 乘车人数，允许拼车时该参数不为空
tail_number String 可选 1918 乘客手机尾号，用于司乘尾号验证
accept_relay_order Number 可选 1 是否允许派接力单（0:不允许 1:允许），默认允许
start_poi_id String 可选 150200 出发地高德POI唯一标识
end_poi_id String 可选 150300 目的地高德POI唯一标识
waypoints String 可选 [ { "index" : 1, "longitude": "116.407396", "latitude": "39.904200", "address": "天安门广场", "status": 0, }, { "index" : 2, "longitude": "121.473701", "latitude": "31.230416", "address": "东方明珠", "status": 0 } ] 途径点列表，带途径点下单时存在本字段，且内容不为空
price_type Number 可选 0
  • 默认值：0
    		•  价格类型 0:商旅价 1:商旅协议价 默认0

    响应参数

    名称 类型 示例值 描述
    errno Number 0 错误码
    data OrderCreateResult 订单创建结果
    • order
    • OrderInfo
    • 订单信息
    • └ id
    • String
    • 4880109188406595918
    • 订单id
    • └ city
    • String
    • 1
    • 城市id
    • └ type
    • Number
    • 0
    • 订单类型
    • └ call_phone
    • String
    • 13269661202
    • 叫车人手机号
    • └ passenger_phone
    • String
    • 13269661202
    • 乘车人手机号
    • └ status
    • Number
    • 300
    • 订单状态
    • └ flat
    • String
    • 40.045724
    • 出发地纬度
    • └ flng
    • String
    • 116.307479
    • 出发地经度
    • └ tlat
    • String
    • 39.689123
    • 目的地纬度
    • └ tlng
    • String
    • 116.800012
    • 目的地经度
    • └ clat
    • String
    • 39.689123
    • 当前纬度
    • └ clng
    • String
    • 116.800012
    • 当前经度
    • └ start_name
    • String
    • 得实大厦
    • 出发地名称
    • └ start_address
    • String
    • 上地东路9号西南角
    • 出发地地址
    • └ end_name
    • String
    • 万达广场
    • 目的地名称
    • └ end_address
    • String
    • 北京市石景山区万达广场
    • 目的地地址
    • └ extra_info
    • String
    • 这是订单备注
    • 备注
    • └ departure_time
    • String
    • 2015-03-11 17:06:58
    • 出发时间
    • └ order_time
    • String
    • 2015-03-11 17:06:58
    • 下单时间
    • └ require_level
    • String
    • 100
    • 所需车型代码
    • └ remark
    • String
    • 备注
    • 备注
    • └ cost_center
    • String
    • A2324234
    • 成本中心代码，用于区分不同的分账账号
    • price
    • PriceInfo
    • 价格信息
    • └ estimate
    • String
    • 20.12
    • 预估车费
    errmsg String SUCCESS 错误信息
    code String SUCCESS 二级错误码

    请求示例

    
                                
    
                            
    
                        
    
                    
    

                    
    响应示例
    
                    
    
                        
    
                            
    
                                
    
                                    
    {
    "errno":0,
    "data":{
        "order":{
            "id":"4880109188406595918",
            "city":"1",
            "type":0,
            "call_phone":"13269661202",
            "passenger_phone":"13269661202",
            "status":300,
            "flat":"40.045724",
            "flng":"116.307479",
            "tlat":"39.689123",
            "tlng":"116.800012",
            "clat":"39.689123",
            "clng":"116.800012",
            "start_name":"得实大厦",
            "start_address":"上地东路9号西南角",
            "end_name":"万达广场",
            "end_address":"北京市石景山区万达广场",
            "extra_info":"这是订单备注",
            "departure_time":"2015-03-11 17:06:58",
            "order_time":"2015-03-11 17:06:58",
            "require_level":"100",
            "remark":"备注",
            "cost_center":"A2324234"
        },
        "price":{
            "estimate":"20.12"
        }
    },
    "errmsg":"SUCCESS",
    "code":"SUCCESS"
}
    
                                
    
                            
    
                        
    
                    
    

                    
    验签示例
    
                    
    
                        
    
                            
    
                                
    
                                    
    {"errno":"不等于0","code":"sign-check-failure","errmsg":"Illegal request"}
    
                                
    
                            
    
                        
    
                    
    

                    
    错误码解释
    
                    
    
                        
     
                            
                                
     
                                   错误码 
                                   错误描述 
                                   解决方案 
                                
     
                                
                             
                                                                             
     
                                            response-body-parse-error 
                                            
                                            
                                        
     
                                                                      
                        
    
                     
           
                     
                 
    API工具
    
                    
    
                        
    
                             错误码查询工具
                             SDK下载
                         
    
                    
                

                    
                    
                
                    
    FAQ
    
                        
    
                                                    
     
                    
                    
    
                
                
    
                    
    
                                                    有用( 0 )
                                                我要提问
                    
    
               
    
                
                
	        	            
    
        
    
    
    
    
    返回
    顶部