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

taobao.bus.order.get (汽车票订单查询)

商家汽车票订单查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_query_order_rq TopQueryOrderRq 可选 查询订单参数
  • └ partner_order_id
  • String
  • 必须
  • 123456
  • 分销商订单号
  • └ alitrip_order_id
  • String
  • 必须
  • 123456
  • 飞猪订单号

响应参数

名称 类型 示例值 描述
ticket_count Number 2 票数
tickets TicketInfo [] 票列表
  • └ refundable_amount
  • Number
  • 7300
  • 退款总金额,单位分,逆向订单时使用
  • └ refund_fee
  • Number
  • 800
  • 退票手续费,单位分,逆向订单时使用
  • └ service_charge
  • Number
  • 200
  • 服务费金额,单位分,正向订单时使用
  • └ refundable_ticket_price
  • Number
  • 7200
  • 退票款金额,单位分,逆向订单时使用
  • └ ticket_price
  • Number
  • 8000
  • 票价,单位分,正向订单时使用
  • └ ticket_no
  • String
  • 123456
  • 票号
  • └ ticket_type
  • Number
  • 成人票
  • 票种类型,0-成人票,1-儿童票,2-携童票
  • └ refundable_service_price
  • Number
  • 100
  • 退服务费金额,单位分,逆向订单时使用
  • └ rider_name
  • String
  • 张三
  • 乘客姓名
  • └ rider_cert_type
  • String
  • 身份证
  • 乘客证件类型,01-身份证,02-护照,03-港澳通行证,04-台湾通行证,05-港澳往返内地通行证,06-台湾往返内地通行证,07-港澳居民居住证
  • └ sub_alitrip_order_id
  • String
  • 12345678
  • 飞猪子订单号
  • └ rider_cert_number
  • String
  • 123456
  • 乘客身份证号
  • └ seat_no
  • String
  • 03
  • 座位号
  • └ ticket_status
  • String
  • 1
  • 票状态:1-出票中,2-已出票,3-无票(出票失败),4 -退票中,5-已退票,6-退票失败
  • └ refund_channel
  • String
  • STATION
  • 退票渠道
  • └ refund_time
  • String
  • 2025-04-20 13:00:00
  • 退票成功时间,绝对时间,格式:yyyy-MM-dd HH:mm:ss
  • └ refund_desc
  • String
  • 全额退
  • 退款说明,停运or全额退时会返回
partner_order_id String 123456 分销商订单号
dep_time String 18:00 发车时间
order_status Number 1 订单状态,1-未付款、2-已付款(出票中)、3-出票成功、4-订单关闭(出票失败)、5-订单取消
alitrip_order_id String 123456 飞猪订单号
result_code String SYS_ERROR 错误码
result_msg String 系统异常 错误信息
is_success Boolean true 是否成功
issue_time_out String 2025-04-20 13:00:00 出票超时时间,绝对时间,格式:yyyy-MM-dd HH:mm:ss
fetch_ticket_number String 12345 取票号
fetch_ticket_pwd String abcdefg 取票密码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
BusOrderGetRequest req = new BusOrderGetRequest();
BusOrderGetRequest.TopQueryOrderRq obj1 = new BusOrderGetRequest.TopQueryOrderRq();
obj1.setPartnerOrderId("123456");
obj1.setAlitripOrderId("123456");
req.setTopQueryOrderRq(obj1);
BusOrderGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<bus_order_get_response>
    <ticket_count>2</ticket_count>
    <tickets>
        <ticket_info>
            <refundable_amount>7300</refundable_amount>
            <refund_fee>800</refund_fee>
            <service_charge>200</service_charge>
            <refundable_ticket_price>7200</refundable_ticket_price>
            <ticket_price>8000</ticket_price>
            <ticket_no>123456</ticket_no>
            <ticket_type>成人票</ticket_type>
            <refundable_service_price>100</refundable_service_price>
            <rider_name>张三</rider_name>
            <rider_cert_type>身份证</rider_cert_type>
            <sub_alitrip_order_id>12345678</sub_alitrip_order_id>
            <rider_cert_number>123456</rider_cert_number>
            <seat_no>03</seat_no>
            <ticket_status>1</ticket_status>
            <refund_channel>STATION</refund_channel>
            <refund_time>2025-04-20 13:00:00</refund_time>
            <refund_desc>全额退</refund_desc>
        </ticket_info>
    </tickets>
    <partner_order_id>123456</partner_order_id>
    <dep_time>18:00</dep_time>
    <order_status>1</order_status>
    <alitrip_order_id>123456</alitrip_order_id>
    <result_code>SYS_ERROR</result_code>
    <result_msg>系统异常</result_msg>
    <is_success>true</is_success>
    <issue_time_out>2025-04-20 13:00:00</issue_time_out>
    <fetch_ticket_number>12345</fetch_ticket_number>
    <fetch_ticket_pwd>abcdefg</fetch_ticket_pwd>
</bus_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

返回
顶部