文档中心 > API类目 > 汽车票API

taobao.bus.merchant.order.get (商家侧查询订单详情)

商家侧查询订单详情

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_agent_query_order_r_q AgentQueryOrderRQ 必须 入参
  • └ agent_order_ids
  • String
  • 可选
  • 220918014640659766, 2209180146406597655
  • 商家订单号,多个使用英文逗号进行分隔
  • └ complete_order_date_interval
  • String
  • 可选
  • 20220910-20220930
  • 订单完成日期区间,格式:yyyyMMdd
  • └ complete_refund_date_interval
  • String
  • 可选
  • 20220910-20220930
  • 退票完成日期区间,,格式:yyyyMMdd
  • └ create_order_date_interval
  • String
  • 可选
  • 20220910-20220930
  • 订单创建日期区间,格式:yyyyMMdd
  • └ create_refund_date_interval
  • String
  • 可选
  • 20220910-20220930
  • 申请退票日期区间,,格式:yyyyMMdd
  • └ order_ids
  • String
  • 可选
  • 4571883790274, 4571883790275
  • 飞猪订单号,多个使用英文逗号进行分隔
  • └ page_index
  • Number
  • 可选
  • 1
  • 当前页码从1开始
  • └ page_size
  • Number
  • 可选
  • 100
  • 每页数量最大为100,超过100会有超时
  • └ refund_apply_ids
  • String
  • 可选
  • 3977042066252, 3977042066253
  • 退票申请id,多个使用英文逗号进行分隔

响应参数

名称 类型 示例值 描述
refund_order_infos MerchantBusRefundOrderInfo [] 退票订单列表
  • refund_apply_info_list
  • MerchantBusRefundApplyInfo []
  • 退票申请列表
  • └ apply_type
  • Number
  • 0
  • 0-用户申请1-商家申请2-二次退款
  • └ refund_ticket_amount
  • Number
  • 300
  • 退票款金额,单位分
  • └ refund_time
  • Date
  • 2022-09-17 23:28:13
  • 退款时间
  • └ refund_reason
  • String
  • 退票原因
  • 退票原因
  • └ refund_total_amount
  • Number
  • 300
  • 退款总金额,单位分
  • └ refund_status
  • Number
  • 5
  • 退票状态:1:新申请 2:代理商处理中 3:同意 4:拒绝 5:已退款
  • └ ext_attr
  • String
  • 扩展属性
  • 扩展属性
  • └ apply_id
  • Number
  • 3977042066252
  • 退票申请id
  • bus_ticket_info
  • MerchantBusTicketInfo
  • 票信息
  • └ agent_ticket_id
  • String
  • 8930
  • 商家票id
  • └ service_charge
  • Number
  • 300
  • 商家服务费
  • └ rider_seat_number
  • String
  • 04
  • 座位号
  • └ sub_order_id
  • Number
  • 397704206
  • 子订单号
  • └ ticket_price
  • Number
  • 300
  • 票价,单位分
  • └ rider_name
  • String
  • 王大拿
  • 乘客姓名
  • └ create_time
  • Date
  • 2022-09-17 23:28:13
  • 退票申请创建时间
  • └ commission_charge_amount
  • Number
  • 100
  • 退票手续费,单位分
  • └ agree_or_refuse_time
  • Date
  • 2022-09-17 23:28:13
  • 同意/拒绝时间
  • └ apply_time
  • Date
  • 2022-09-17 23:28:13
  • 申请时间
  • └ refuse_reason
  • String
  • 已发车
  • 拒绝原因
  • └ refund_service_charge_amount
  • Number
  • 50
  • 退商家服务费金额,单位分
  • └ agent_order_id
  • String
  • 220918014640659766
  • 商家订单号
  • └ alipay_trade_id
  • String
  • 2022091722001162831428265217
  • 支付流水号
  • └ main_order_id
  • Number
  • 4594274941964
  • 飞猪订单号
  • └ tp_order_id
  • String
  • 2894118697802946419
  • 淘宝订单号
error_msg_code String failed 错误码
order_infos MerchantBusOrderInfo [] 订单信息列表
  • └ end_station
  • String
  • 天津西站
  • 到达站点
  • └ ticket_count
  • Number
  • 3
  • 票数量
  • └ total_price
  • Number
  • 3000
  • 票总价,单位分
  • └ issue_time
  • String
  • 2022-09-17 23:28:13
  • 出票时间
  • └ pay_time
  • String
  • 2022-09-17 23:28:13
  • 支付时间
  • bus_ticket_info_list
  • MerchantBusTicketInfo []
  • ticketList
  • 票信息列表
  • └ agent_ticket_id
  • String
  • 333555
  • 商家票id
  • └ service_charge
  • Number
  • 300
  • 商家服务费,单位分
  • └ rider_seat_number
  • String
  • 4
  • 坐席号
  • └ sub_order_id
  • Number
  • 16665663871964
  • 子订单号
  • └ ticket_price
  • Number
  • 500
  • 票价,单位分
  • └ rider_name
  • String
  • 王大拿
  • 乘客姓名
  • └ ticket_type
  • Number
  • 0
  • 0-全票(成人) 1-半票(儿童) 2-免票(携童)
  • └ agent_order_id
  • String
  • 16665663871964
  • 代理商订单号
  • └ order_status
  • Number
  • 01
  • 订单状态:1-待支付;2-已取消;3-待出票;4-出票成功;5-已关闭
  • └ alipay_trade_id
  • String
  • 2022091722001162831428265217
  • 支付流水号
  • └ is_self_sale_order
  • Boolean
  • true
  • 自营订单
  • └ is_wechat
  • Boolean
  • true
  • 微信订单
  • bus_line_info
  • MerchantBusLineInfo
  • 班次信息
  • └ last_place_name
  • String
  • 望京西
  • 目的地
  • └ arrive_station_name
  • String
  • 望京西
  • 到达站点
  • └ depart_date
  • String
  • 2022-09-19
  • 出发日期
  • └ bus_number
  • String
  • 33345
  • 车牌号
  • └ start_time
  • Date
  • 出发时间
  • 出发时间
  • └ schedule_id
  • String
  • 7yjddkx
  • 班次id
  • └ start_station_name
  • String
  • 出发站
  • 出发站名称
  • └ gmt_create
  • String
  • 2022-09-17 23:28:13
  • 创建时间
  • └ trans_type
  • String
  • 普通巴士
  • 业务类型:普通巴士,旅游巴士
  • bus_fetch_holder_info
  • MerchantBusFetchHolderInfo
  • 取票人信息
  • └ fetch_phone
  • String
  • 193339393
  • 取票电话
  • └ fetch_ticket_name
  • String
  • xxx王
  • 取票人信息
  • └ start_station
  • String
  • 北京西
  • 出发站点
  • └ main_order_id
  • Number
  • 4594274941964
  • 飞猪订单号
  • └ tp_order_id
  • Number
  • 2894118697802946419
  • 淘宝订单号
  • refund_apply_info_list
  • MerchantBusRefundApplyInfo []
  • 退票信息
  • └ apply_type
  • Number
  • 1
  • 0-用户申请1-商家申请2-二次退款
  • └ refund_ticket_amount
  • Number
  • 300
  • 退票款金额单位分
  • └ refund_time
  • Date
  • 2022-09-17 23:28:13
  • 退款时间
  • └ refund_reason
  • String
  • 卖家申请
  • 退款原因
  • └ refund_total_amount
  • Number
  • 300
  • 退款总金额,单位分
  • └ refund_status
  • Number
  • 5
  • 退票状态:1:新申请 2:代理商处理中 3:同意 4:拒绝 5:已退款
  • └ ext_attr
  • String
  • json格式数据
  • 扩展属性
  • └ create_time
  • Date
  • 2022-09-17 23:28:13
  • 退票创建时间
  • └ commission_charge_amount
  • Number
  • 100
  • 退票手续费,单位分
  • └ agree_or_refuse_time
  • Date
  • 2022-09-17 23:28:13
  • 同意/拒绝时间
  • └ apply_time
  • Date
  • 2022-09-17 23:28:13
  • 申请退票时间
  • └ refund_service_charge_amount
  • Number
  • 100
  • 退商家服务费金额,单位分
  • bus_ticket_info
  • MerchantBusTicketInfo
  • 票信息
  • └ agent_ticket_id
  • String
  • xxx786
  • 商家票id
  • └ service_charge
  • Number
  • 100
  • 商家服务费
  • └ rider_seat_number
  • String
  • 06号
  • 座位号
  • └ sub_order_id
  • Number
  • 8844773
  • 子订单id
  • └ ticket_price
  • Number
  • 8900
  • 票价,单位分
  • └ rider_name
  • String
  • 王大拿
  • 乘客姓名
  • └ apply_id
  • Number
  • 3977042066252
  • 退票申请id
error_msg_desc String 系统异常 错误描述
is_success Boolean true/false 业务接口是否成功
total_count Number 500 根据总数进行分页查询

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
BusMerchantOrderGetRequest req = new BusMerchantOrderGetRequest();
BusMerchantOrderGetRequest.AgentQueryOrderRQ obj1 = new BusMerchantOrderGetRequest.AgentQueryOrderRQ();
obj1.setAgentOrderIds("220918014640659766, 2209180146406597655");
obj1.setCompleteOrderDateInterval("20220910-20220930");
obj1.setCompleteRefundDateInterval("20220910-20220930");
obj1.setCreateOrderDateInterval("20220910-20220930");
obj1.setCreateRefundDateInterval("20220910-20220930");
obj1.setOrderIds("4571883790274, 4571883790275");
obj1.setPageIndex(1L);
obj1.setPageSize(100L);
obj1.setRefundApplyIds("3977042066252, 3977042066253");
req.setParamAgentQueryOrderRQ(obj1);
BusMerchantOrderGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<bus_merchant_order_get_response>
    <refund_order_infos>
        <merchant_bus_refund_order_info>
            <refund_apply_info_list>
                <merchant_bus_refund_apply_info>
                    <apply_type>0</apply_type>
                    <refund_ticket_amount>300</refund_ticket_amount>
                    <refund_time>2022-09-17 23:28:13</refund_time>
                    <refund_reason>退票原因</refund_reason>
                    <refund_total_amount>300</refund_total_amount>
                    <refund_status>5</refund_status>
                    <ext_attr>扩展属性</ext_attr>
                    <apply_id>3977042066252</apply_id>
                    <bus_ticket_info>
                        <agent_ticket_id>8930</agent_ticket_id>
                        <service_charge>300</service_charge>
                        <rider_seat_number>04</rider_seat_number>
                        <sub_order_id>397704206</sub_order_id>
                        <ticket_price>300</ticket_price>
                        <rider_name>王大拿</rider_name>
                    </bus_ticket_info>
                    <create_time>2022-09-17 23:28:13</create_time>
                    <commission_charge_amount>100</commission_charge_amount>
                    <agree_or_refuse_time>2022-09-17 23:28:13</agree_or_refuse_time>
                    <apply_time>2022-09-17 23:28:13</apply_time>
                    <refuse_reason>已发车</refuse_reason>
                    <refund_service_charge_amount>50</refund_service_charge_amount>
                </merchant_bus_refund_apply_info>
            </refund_apply_info_list>
            <agent_order_id>220918014640659766</agent_order_id>
            <alipay_trade_id>2022091722001162831428265217</alipay_trade_id>
            <main_order_id>4594274941964</main_order_id>
            <tp_order_id>2894118697802946419</tp_order_id>
        </merchant_bus_refund_order_info>
    </refund_order_infos>
    <error_msg_code>failed</error_msg_code>
    <order_infos>
        <merchant_bus_order_info>
            <end_station>天津西站</end_station>
            <ticket_count>3</ticket_count>
            <total_price>3000</total_price>
            <issue_time>2022-09-17 23:28:13</issue_time>
            <pay_time>2022-09-17 23:28:13</pay_time>
            <bus_ticket_info_list>
                <merchant_bus_ticket_info>
                    <agent_ticket_id>333555</agent_ticket_id>
                    <service_charge>300</service_charge>
                    <rider_seat_number>4</rider_seat_number>
                    <sub_order_id>16665663871964</sub_order_id>
                    <ticket_price>500</ticket_price>
                    <rider_name>王大拿</rider_name>
                    <ticket_type>0</ticket_type>
                </merchant_bus_ticket_info>
            </bus_ticket_info_list>
            <agent_order_id>16665663871964</agent_order_id>
            <order_status>01</order_status>
            <alipay_trade_id>2022091722001162831428265217</alipay_trade_id>
            <is_self_sale_order>true</is_self_sale_order>
            <is_wechat>true</is_wechat>
            <bus_line_info>
                <last_place_name>望京西</last_place_name>
                <arrive_station_name>望京西</arrive_station_name>
                <depart_date>2022-09-19</depart_date>
                <bus_number>33345</bus_number>
                <start_time>出发时间</start_time>
                <schedule_id>7yjddkx</schedule_id>
                <start_station_name>出发站</start_station_name>
            </bus_line_info>
            <gmt_create>2022-09-17 23:28:13</gmt_create>
            <trans_type>普通巴士</trans_type>
            <bus_fetch_holder_info>
                <fetch_phone>193339393</fetch_phone>
                <fetch_ticket_name>xxx王</fetch_ticket_name>
            </bus_fetch_holder_info>
            <start_station>北京西</start_station>
            <main_order_id>4594274941964</main_order_id>
            <tp_order_id>2894118697802946419</tp_order_id>
            <refund_apply_info_list>
                <merchant_bus_refund_apply_info>
                    <apply_type>1</apply_type>
                    <refund_ticket_amount>300</refund_ticket_amount>
                    <refund_time>2022-09-17 23:28:13</refund_time>
                    <refund_reason>卖家申请</refund_reason>
                    <refund_total_amount>300</refund_total_amount>
                    <refund_status>5</refund_status>
                    <ext_attr>json格式数据</ext_attr>
                    <create_time>2022-09-17 23:28:13</create_time>
                    <commission_charge_amount>100</commission_charge_amount>
                    <agree_or_refuse_time>2022-09-17 23:28:13</agree_or_refuse_time>
                    <apply_time>2022-09-17 23:28:13</apply_time>
                    <refund_service_charge_amount>100</refund_service_charge_amount>
                    <bus_ticket_info>
                        <agent_ticket_id>xxx786</agent_ticket_id>
                        <service_charge>100</service_charge>
                        <rider_seat_number>06号</rider_seat_number>
                        <sub_order_id>8844773</sub_order_id>
                        <ticket_price>8900</ticket_price>
                        <rider_name>王大拿</rider_name>
                    </bus_ticket_info>
                    <apply_id>3977042066252</apply_id>
                </merchant_bus_refund_apply_info>
            </refund_apply_info_list>
        </merchant_bus_order_info>
    </order_infos>
    <error_msg_desc>系统异常</error_msg_desc>
    <is_success>true/false</is_success>
    <total_count>500</total_count>
</bus_merchant_order_get_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

返回
顶部