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

alibaba.happytrip.order.taxi.list (打车订单同步)

打车订单同步

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_order_get_request OrderGetRequest 必须 订单获取请求
  • └ create_begin_time
  • String
  • 可选
  • 2023-09-10 09:12:00
  • 订单创建时间-开始时间
  • └ create_end_time
  • String
  • 可选
  • 2023-09-10 09:12:00
  • 订单创建时间-结束时间
  • └ modified_begin_time
  • String
  • 可选
  • 2023-09-10 09:12:00
  • 订单修改时间-开始时间
  • └ modified_end_time
  • String
  • 可选
  • 2023-09-10 09:12:00
  • 订单修改时间-结束时间
  • └ order_id
  • String
  • 可选
  • 020000000100000000000001xxxx4926
  • 订单号
  • └ page_number
  • Number
  • 必须
  • 1
  • 分页页码,从0开始
  • └ page_size
  • Number
  • 必须
  • 20
  • 分页大小,默认每次20,最大不得超过100
  • └ user_work_no
  • String
  • 可选
  • 000001
  • 待查询用户工号
  • └ source_ta_head_id
  • String
  • 可选
  • 100001
  • 差旅单号
  • └ corp_id
  • String
  • 可选
  • -1
  • 租户ID,一个应用使用多租户模式下启用,需要欢行提供

响应参数

名称 类型 示例值 描述
result ResultDTO 返回结果
  • content
  • Page
  • 业务处理返回结果
  • cotents
  • TaxiOrderDTO []
  • 订单列表
  • expense_list
  • OrderExpenseDetailDTO []
  • 订单费用信息;可空
  • └ amount
  • String
  • 100.000000000
  • 金额;不可空
  • └ currency_code
  • String
  • CNY
  • 币种;不可空
  • └ expense_detail
  • String
  • 打车费用
  • 费用类型描述;不可空
  • └ expense_type
  • String
  • TAXI_PRICE
  • 费项类型:打车费用 TAXI_PRICE、退款 TAXI_REFUND_FEE;不可空
  • └ order_id
  • String
  • 020000000100000000000001xxxx4926
  • 订单号;不可空
  • └ resource_id
  • String
  • 111
  • 资源ID,资源唯一标识;不可空
  • └ expense_time
  • String
  • 2023-09-10 09:12:00
  • 费用产生时间;不可空
  • └ apply_type
  • String
  • BOOK
  • 预定类型:预定 BOOK,退款 REFUND;不可空
  • └ trade_action
  • Number
  • 1
  • 支付方向:1支付 2退款;不可空
  • └ pay_type
  • Number
  • 1
  • 支付类型:1企业支付,2个人支付;不可空
  • order_base_info
  • OrderBaseDTO
  • 订单基础信息
  • └ book_time
  • String
  • 2023-09-10 09:12:00
  • 订单下单时间;不可空
  • └ buyer_user_name
  • String
  • 张三
  • 预订人名称;不可空
  • └ buyer_user_work_no
  • String
  • 000001
  • 预订人工号;不可空
  • └ order_class_id
  • String
  • 6
  • 订单主类型:4是机票、5是酒店、6是打车、7是火车;不可空
  • └ order_class_id_desc
  • String
  • 用车
  • 机酒火大类,是订单主类型的描述信息;不可空
  • └ order_class_second_id
  • Number
  • 23
  • 订单子类型;不可空
  • └ order_class_second_id_desc
  • String
  • 国内用车
  • 国内国际等;不可空
  • └ order_id
  • String
  • 020000000100000000000001xxxx4926
  • 欢行订单号;不可空
  • └ order_status
  • String
  • 700
  • 订单状态:0-等待派单,2-等待接单,3-等待接单超时结束,5-等待司机接驾,4-已取消,400-取消产生费用待确认,6-取消产生费用已确认,404-取消产生费用费用异议,40-司机已到达,7-行驶中,50-行程结束待确认,500-行程结束费用异议,700-行程结束费用合理;不可空
  • └ order_status_desc
  • String
  • 行程结束费用合理
  • 订单状态描述,订单状态的描述;不可空
  • └ submit_user_name
  • String
  • 张三
  • 差旅单提交人名称;可空
  • └ submit_user_work_no
  • String
  • 000001
  • 差旅单提交人工号;可空
  • └ supplier_order_id
  • String
  • 100001
  • 供应商订单号;不可空
  • └ source_id
  • String
  • 100001
  • 差旅单号;可空
  • └ source_ta_line_id
  • String
  • 1
  • 来源系统差旅单行程ID,作为行程标识;可空
  • └ total_amount
  • String
  • 100.000000000
  • 订单总金额;不可空
  • └ total_amount_currency_code
  • String
  • CNY
  • 币种代码;不可空
  • └ company_code
  • String
  • A50
  • 单据归属公司编码;不可空
  • └ company_pay_amount
  • String
  • 100.000000000
  • 订单企业支付实付金额,等于订单费用中公付费用的金额总和;不可空
  • └ pay_mode
  • Number
  • 1
  • 订单支付类型:1企业支付,2个人支付,3混合支付(企业支付+个人支付);不可空
  • └ person_pay_amount
  • String
  • 100.000000000
  • 订单个付实付金额,等于订单费用中个付费用的金额总和;可空
  • resource_list
  • TaxiResourceDTO []
  • 打车详细信息,一个订单中仅存在一个打车资源信息
  • └ business_category
  • String
  • TRAFFIC
  • 因公类型:TRAVEL- 差旅, TRAFFIC- 市内交通, NIGHT:-夜间;不可空
  • └ cancel_reason
  • String
  • 平台派单太远
  • 取消原因;可空
  • └ cancel_time
  • String
  • 2023-09-10 09:12:00
  • 取消订单时间;可空
  • └ cancel_type
  • Number
  • 1
  • 取消类型:0-系统取消,1-用户取消,2-司机取消,3-客服取消;可空
  • └ car_level
  • String
  • 600
  • 供应商车型;不可空
  • └ complaint_type
  • String
  • 司机绕路
  • 投诉类型:0-其他原因,1-司机原因导致行程被取消,2-服务态度恶劣,3-未坐车产生费用,4-额外收取不合理费用,5-路不熟多产生费用,6-提前计费,7-未及时结束计费,8-司机绕路,9-司机迟到,10-司机爽约或拒载,11-骚扰乘客,12-危险驾驶,13-不是订单显示车辆或司机;可空
  • └ finish_time
  • String
  • 2023-09-10 09:12:00
  • 行程结束时间;不可空
  • └ from_addr
  • String
  • 杭州市人民政府
  • 出发地名称;不可空
  • └ from_city_name
  • String
  • 杭州市
  • 出发地城市;不可空
  • └ is_cross_city
  • String
  • n
  • 是否跨城,值为y表示是跨城,值为n表示未跨城;不可空
  • └ memo
  • String
  • 测试
  • 打车事由;可空
  • └ order_id
  • String
  • 020000000100000000000001xxxx4926
  • 欢行订单号;不可空
  • └ passenger_name
  • String
  • 张三
  • 乘客姓名;不可空
  • └ pay_status
  • String
  • 0
  • 支付状态:1-已支付,0-未支付;不可空
  • └ pay_time
  • String
  • 2023-09-10 09:12:00
  • 支付时间;可空
  • └ provider_name
  • String
  • 曹操出行
  • 供应商名称;不可空
  • └ riding_time
  • String
  • 2023-09-10 09:12:00
  • 预约乘车时间;可空
  • └ status_desc
  • String
  • 行程结束待确认
  • 状态描述;不可空
  • └ taken_time
  • String
  • 2023-09-10 09:12:00
  • 乘客上车时间;不可空
  • └ time_type
  • Number
  • 0
  • 时间类型:0-实时单,1-预约单;不可空
  • └ to_addr
  • String
  • 阿里巴巴西溪园区
  • 目的地名称;不可空
  • └ to_city_name
  • String
  • 杭州市
  • 目的地城市;不可空
  • └ travel_distance
  • String
  • 1.48
  • 行驶距离;可空
  • └ travel_time
  • Number
  • 6
  • 行驶时长(分钟);可空
  • └ user_confirm
  • Number
  • 0
  • 用户确认:0-未确认 ,1-认可,2-有异议;不可空
  • └ user_confirm_reason
  • String
  • 司机绕路
  • 用户认可/不认可原因;可空
  • └ user_confirm_time
  • String
  • 2023-09-10 09:12:00
  • 用户确认时间;可空
  • └ user_work_no
  • String
  • 000001
  • 工号;不可空
  • └ driver_license
  • String
  • 浙A88888
  • 车牌号;可空
  • └ driver_car_type
  • String
  • 东风风神E70,白
  • 司机车型信息;可空
  • └ estimate_price
  • String
  • 100.000000000
  • 订单预估价格;可空
  • └ resource_id
  • String
  • 111
  • 资源ID,资源唯一标识;不可空
  • pagination
  • Pagination
  • 页码参数
  • └ page_number
  • String
  • 1
  • 分页页码
  • └ page_size
  • String
  • 20
  • 分页大小
  • └ total_count
  • String
  • 20
  • 返回总数
  • └ error_code
  • String
  • 100000
  • 错误码
  • └ error_msg
  • String
  • 内部服务处理异常
  • 错误信息
  • └ stack_trace
  • String
  • TaeBussinessException
  • 错误异常栈
  • └ success
  • String
  • true
  • 请求是否处理成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaHappytripOrderTaxiListRequest req = new AlibabaHappytripOrderTaxiListRequest();
AlibabaHappytripOrderTaxiListRequest.OrderGetRequest obj1 = new AlibabaHappytripOrderTaxiListRequest.OrderGetRequest();
obj1.setCreateBeginTime("2023-09-10 09:12:00");
obj1.setCreateEndTime("2023-09-10 09:12:00");
obj1.setModifiedBeginTime("2023-09-10 09:12:00");
obj1.setModifiedEndTime("2023-09-10 09:12:00");
obj1.setOrderId("020000000100000000000001xxxx4926");
obj1.setPageNumber(1L);
obj1.setPageSize(20L);
obj1.setUserWorkNo("000001");
obj1.setSourceTaHeadId("100001");
obj1.setCorpId("-1");
req.setParamOrderGetRequest(obj1);
AlibabaHappytripOrderTaxiListResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_happytrip_order_taxi_list_response>
    <result>
        <content>
            <cotents>
                <taxi_order_d_t_o>
                    <expense_list>
                        <order_expense_detail_d_t_o>
                            <amount>100.000000000</amount>
                            <currency_code>CNY</currency_code>
                            <expense_detail>打车费用</expense_detail>
                            <expense_type>TAXI_PRICE</expense_type>
                            <order_id>020000000100000000000001xxxx4926</order_id>
                            <resource_id>111</resource_id>
                            <expense_time>2023-09-10 09:12:00</expense_time>
                            <apply_type>BOOK</apply_type>
                            <trade_action>1</trade_action>
                            <pay_type>1</pay_type>
                        </order_expense_detail_d_t_o>
                    </expense_list>
                    <order_base_info>
                        <book_time>2023-09-10 09:12:00</book_time>
                        <buyer_user_name>张三</buyer_user_name>
                        <buyer_user_work_no>000001</buyer_user_work_no>
                        <order_class_id>6</order_class_id>
                        <order_class_id_desc>用车</order_class_id_desc>
                        <order_class_second_id>23</order_class_second_id>
                        <order_class_second_id_desc>国内用车</order_class_second_id_desc>
                        <order_id>020000000100000000000001xxxx4926</order_id>
                        <order_status>700</order_status>
                        <order_status_desc>行程结束费用合理</order_status_desc>
                        <submit_user_name>张三</submit_user_name>
                        <submit_user_work_no>000001</submit_user_work_no>
                        <supplier_order_id>100001</supplier_order_id>
                        <source_id>100001</source_id>
                        <source_ta_line_id>1</source_ta_line_id>
                        <total_amount>100.000000000</total_amount>
                        <total_amount_currency_code>CNY</total_amount_currency_code>
                        <company_code>A50</company_code>
                        <company_pay_amount>100.000000000</company_pay_amount>
                        <pay_mode>1</pay_mode>
                        <person_pay_amount>100.000000000</person_pay_amount>
                    </order_base_info>
                    <resource_list>
                        <taxi_resource_d_t_o>
                            <business_category>TRAFFIC</business_category>
                            <cancel_reason>平台派单太远</cancel_reason>
                            <cancel_time>2023-09-10 09:12:00</cancel_time>
                            <cancel_type>1</cancel_type>
                            <car_level>600</car_level>
                            <complaint_type>司机绕路</complaint_type>
                            <finish_time>2023-09-10 09:12:00</finish_time>
                            <from_addr>杭州市人民政府</from_addr>
                            <from_city_name>杭州市</from_city_name>
                            <is_cross_city>n</is_cross_city>
                            <memo>测试</memo>
                            <order_id>020000000100000000000001xxxx4926</order_id>
                            <passenger_name>张三</passenger_name>
                            <pay_status>0</pay_status>
                            <pay_time>2023-09-10 09:12:00</pay_time>
                            <provider_name>曹操出行</provider_name>
                            <riding_time>2023-09-10 09:12:00</riding_time>
                            <status_desc>行程结束待确认</status_desc>
                            <taken_time>2023-09-10 09:12:00</taken_time>
                            <time_type>0</time_type>
                            <to_addr>阿里巴巴西溪园区</to_addr>
                            <to_city_name>杭州市</to_city_name>
                            <travel_distance>1.48</travel_distance>
                            <travel_time>6</travel_time>
                            <user_confirm>0</user_confirm>
                            <user_confirm_reason>司机绕路</user_confirm_reason>
                            <user_confirm_time>2023-09-10 09:12:00</user_confirm_time>
                            <user_work_no>000001</user_work_no>
                            <driver_license>浙A88888</driver_license>
                            <driver_car_type>东风风神E70,白</driver_car_type>
                            <estimate_price>100.000000000</estimate_price>
                            <resource_id>111</resource_id>
                        </taxi_resource_d_t_o>
                    </resource_list>
                </taxi_order_d_t_o>
            </cotents>
            <pagination>
                <page_number>1</page_number>
                <page_size>20</page_size>
            </pagination>
            <total_count>20</total_count>
        </content>
        <error_code>100000</error_code>
        <error_msg>内部服务处理异常</error_msg>
        <stack_trace>TaeBussinessException</stack_trace>
        <success>true</success>
    </result>
</alibaba_happytrip_order_taxi_list_response>

异常示例

  • 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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部