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

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

商家侧查询订单详情

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
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>

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

异常示例

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测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部