文档中心 > API类目 > 欢行开发平台API

alibaba.happytrip.taxi.order.get (订单详情)

获取订单状态及详情

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_id String 必须 12333234 订单id

响应参数

名称 类型 示例值 描述
errno Number 0 错误码
errmsg String SUCCESS 错误信息
data OrderGetResult 订单获取结果
  • price
  • CostInfo
  • 费用信息,如果订单有折扣,这里为折后价格,如果没有折扣,这里和original_price保持一致
  • detail
  • CostDetailInfo []
  • 费用明细
  • └ amount
  • String
  • 12.00
  • 费用金额
  • └ name
  • String
  • 远途费或超出套餐部分远途费
  • 费用类型名称
  • └ type
  • String
  • empty_fee
  • 费用类型,如果不需要显示直接设为null,为0也会显示出来。discount_fee:折扣金额;refund_price:退款;empty_fee:远途费或超出套餐部分远途费; highway_fee:高速费; bridge_fee:路桥费; low_speed_fee:低速费或超出套餐低速费; night_fee:夜间费用或超出套餐部分夜间费; normal_fee:正常行驶费用或超出套餐部分行驶距离费; other_fee:其他费用; park_fee:停车费; start_price:起步价格; tip_fee:加价费用; limit_fee:车最低消费; combo_fee:套餐费用; normal_time_fee:快车时长费; cancel_fee:违约费; dynamic_price:动态调价费用; wait_fee:等候费; clear_fee:清洁费; cross_city_fee:跨城费
  • └ total_price
  • String
  • 23.00
  • 总费用,折后金额
  • └ original_price
  • String
  • 213.00
  • 原价,如果订单有折扣这里为折扣前的价格,如果没有折扣和total_price字段保持一致
  • order
  • OrderInfo
  • 订单信息
  • └ id
  • String
  • 4880109188406595918
  • 订单id
  • └ status
  • Number
  • 400
  • 订单状态码
  • └ sub_status
  • Number
  • 4001
  • 订单详细状态码
  • └ city
  • String
  • 1
  • 城市id
  • └ type
  • Number
  • 0
  • 订单类型(0:实时、1:预约)
  • └ passenger_phone
  • String
  • 13269661202
  • 乘车人手机号
  • └ driver_name
  • String
  • 张师傅
  • 司机称呼
  • └ driver_phone
  • String
  • 18612249028
  • 号码保护中间号(如无号码保护,为司机真实手机号)
  • └ driver_id
  • String
  • 1
  • 司机唯一标识
  • └ driver_phone_real
  • String
  • 18612249028
  • 司机真实手机号
  • └ driver_num
  • Number
  • 109
  • 已通知司机数量
  • └ driver_car_type
  • String
  • 日产天籁
  • 司机车型
  • └ driver_card
  • String
  • 冀A**G05
  • 司机车牌
  • └ driver_avatar
  • String
  • http://xxxxx.jpg
  • 司机头像
  • └ driver_level
  • String
  • 4.9
  • 司机星级
  • └ driver_order_count
  • Number
  • 307
  • 司机抢单数
  • └ dlng
  • String
  • 116.307479
  • 司机当前实时经度
  • └ dlat
  • String
  • 40.045724
  • 司机当前实时纬度
  • └ clng
  • String
  • 116.307479
  • 乘客发单时位置经度
  • └ clat
  • String
  • 40.045724
  • 乘客发单时位置维度
  • └ flng
  • String
  • 116.307479
  • 出发经度
  • └ flat
  • String
  • 40.045724
  • 出发维度
  • └ tlng
  • String
  • 116.800012
  • 目的地经度
  • └ tlat
  • String
  • 39.689123
  • 目的地维度
  • └ extra_info
  • String
  • 微信支付
  • 扩展信息
  • └ start_name
  • String
  • 得实大厦
  • 出发地名称
  • └ start_address
  • String
  • 得实大厦东门
  • 出发地详细地址
  • └ end_name
  • String
  • 万达广场
  • 目的地名称
  • └ end_address
  • String
  • 万达广场西北角
  • 目的地详细地址
  • └ departure_time
  • String
  • 2015-03-11 17:06:58
  • 出发时间
  • └ order_time
  • String
  • 2015-03-11 17:06:58
  • 下单时间
  • └ strive_time
  • String
  • 2016-05-26 12:37:02
  • 司机接单时间
  • └ reach_time
  • String
  • 2015-03-11 16:06:58
  • 司机到达时间
  • └ begin_charge_time
  • String
  • 2015-03-11 15:06:58
  • 开始计价时间
  • └ finish_time
  • String
  • 2015-03-11 16:06:58
  • 行程结束时间
  • └ delay_time_start
  • String
  • 2015-03-11 15:06:58
  • 迟到计费时间
  • └ normal_distance
  • String
  • 4.80
  • 实际行驶公里数
  • └ normal_time
  • Number
  • 60
  • 实际行驶时长(分钟)
  • └ require_level
  • String
  • 100
  • 车型代码
  • └ strive_level
  • String
  • 100
  • 实际车型代码
  • └ driver_car_color
  • String
  • 汽车的颜色
  • └ remark
  • String
  • 无法联系到乘客
  • 备注,如取消原因
  • └ allow_modify_dest
  • Boolean
  • true
  • 是否允许修改目的地
  • └ allow_modify_passingpoints
  • Boolean
  • true
  • 是否允许修改途经点
  • └ allow_modify_passingpoints_max_times
  • Number
  • 3
  • 允许修改途经点的最大次数
  • carpool
  • CarpoolInfo
  • 拼车信息
  • └ carpool_flag
  • Number
  • 1
  • 0: 未拼成 1:拼成
  • └ carpool_order_id
  • String
  • 6892382
  • 拼车单id
  • passenger_orders
  • PassengerOrderInfo []
  • 乘客订单信息
  • └ id
  • String
  • 488010918840
  • 订单id
  • └ status
  • String
  • 610
  • 订单状态码
  • └ sub_status
  • String
  • 6101
  • 订单详细状态码
  • └ passenger_number
  • Number
  • 2
  • 乘客人数
  • └ flng
  • String
  • 120.026208
  • 出发地经度
  • └ flat
  • String
  • 30.279212
  • 出发地纬度
  • └ tlng
  • String
  • 120.068437
  • 目的地经度
  • └ tlat
  • String
  • 30.288773
  • 目的地纬度
  • reassign_info
  • ReassignInfo
  • 订单改派信息
  • └ pre_order_id
  • String
  • 1125905027640526
  • 改派前订单id,即此订单由哪个订单id改派而生成(当值为空时,表示该订单不是因为改派而生成的)
  • └ next_order_id
  • String
  • 1125905027643751
  • 改派后订单id,即由于订单改派而产生的订单id(当值为空时,表示当前订单未被改派而产生新订单)
  • └ init_order_id
  • String
  • 1125905027640526
  • 第一个被改派的订单id
  • └ latest_order_id
  • String
  • 1125905027643751
  • 最新被指派的订单id
  • passing_points
  • PassingPoints []
  • 途经点信息
  • └ poi_id
  • String
  • B000A816R6
  • 高德POI ID
  • └ name
  • String
  • 蒋村花园
  • 名称
  • └ lng
  • String
  • 120.026208
  • 经度
  • └ lat
  • String
  • 30.279212
  • 纬度
  • └ passing_time
  • String
  • 2024-01-17 10:42:22
  • 经过途经点的时间
  • └ passed
  • Boolean
  • true
  • 是否已经过途经点
  • pre_order
  • PreOrder
  • 前单信息
  • └ tlng
  • String
  • 120.068437
  • 目的地经度
  • └ tlat
  • String
  • 30.288773
  • 目的地纬度
  • └ finished
  • Boolean
  • true
  • 是否已完成

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaHappytripTaxiOrderGetRequest req = new AlibabaHappytripTaxiOrderGetRequest();
req.setOrderId("12333234");
AlibabaHappytripTaxiOrderGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<errno>0</errno>
<errmsg>SUCCESS</errmsg>
<data>
    <price>
        <detail>
            <cost_detail_info>
                <amount>12.00</amount>
                <name>远途费或超出套餐部分远途费</name>
                <type>empty_fee</type>
            </cost_detail_info>
        </detail>
        <total_price>23.00</total_price>
        <original_price>213.00</original_price>
    </price>
    <order>
        <id>4880109188406595918</id>
        <status>400</status>
        <sub_status>4001</sub_status>
        <city>1</city>
        <type>0</type>
        <passenger_phone>13269661202</passenger_phone>
        <driver_name>张师傅</driver_name>
        <driver_phone>18612249028</driver_phone>
        <driver_id>1</driver_id>
        <driver_phone_real>18612249028</driver_phone_real>
        <driver_num>109</driver_num>
        <driver_car_type>日产天籁</driver_car_type>
        <driver_card>冀A**G05</driver_card>
        <driver_avatar>http://xxxxx.jpg</driver_avatar>
        <driver_level>4.9</driver_level>
        <driver_order_count>307</driver_order_count>
        <dlng>116.307479</dlng>
        <dlat>40.045724</dlat>
        <clng>116.307479</clng>
        <clat>40.045724</clat>
        <flng>116.307479</flng>
        <flat>40.045724</flat>
        <tlng>116.800012</tlng>
        <tlat>39.689123</tlat>
        <extra_info>微信支付</extra_info>
        <start_name>得实大厦</start_name>
        <start_address>得实大厦东门</start_address>
        <end_name>万达广场</end_name>
        <end_address>万达广场西北角</end_address>
        <departure_time>2015-03-11 17:06:58</departure_time>
        <order_time>2015-03-11 17:06:58</order_time>
        <strive_time>2016-05-26 12:37:02</strive_time>
        <reach_time>2015-03-11 16:06:58</reach_time>
        <begin_charge_time>2015-03-11 15:06:58</begin_charge_time>
        <finish_time>2015-03-11 16:06:58</finish_time>
        <delay_time_start>2015-03-11 15:06:58</delay_time_start>
        <normal_distance>4.80</normal_distance>
        <normal_time>60</normal_time>
        <require_level>100</require_level>
        <strive_level>100</strive_level>
        <driver_car_color>白</driver_car_color>
        <remark>无法联系到乘客</remark>
        <allow_modify_dest>true</allow_modify_dest>
        <allow_modify_passingpoints>true</allow_modify_passingpoints>
        <allow_modify_passingpoints_max_times>3</allow_modify_passingpoints_max_times>
    </order>
    <carpool>
        <carpool_flag>1</carpool_flag>
        <carpool_order_id>6892382</carpool_order_id>
        <passenger_orders>
            <passenger_order_info>
                <id>488010918840</id>
                <status>610</status>
                <sub_status>6101</sub_status>
                <passenger_number>2</passenger_number>
                <flng>120.026208</flng>
                <flat>30.279212</flat>
                <tlng>120.068437</tlng>
                <tlat>30.288773</tlat>
            </passenger_order_info>
        </passenger_orders>
    </carpool>
    <reassign_info>
        <pre_order_id>1125905027640526</pre_order_id>
        <next_order_id>1125905027643751</next_order_id>
        <init_order_id>1125905027640526</init_order_id>
        <latest_order_id>1125905027643751</latest_order_id>
    </reassign_info>
    <passing_points>
        <passing_points>
            <poi_id>B000A816R6</poi_id>
            <name>蒋村花园</name>
            <lng>120.026208</lng>
            <lat>30.279212</lat>
            <passing_time>2024-01-17 10:42:22</passing_time>
            <passed>true</passed>
        </passing_points>
    </passing_points>
    <pre_order>
        <tlng>120.068437</tlng>
        <tlat>30.288773</tlat>
        <finished>true</finished>
    </pre_order>
</data>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
20001 请求参数错误 检查请求参数是否正确
20010 无效订单 确保订单id正确
36004 获取订单失败 重试

API工具

如何获得此API

FAQ

返回
顶部