淘宝开放平台

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

汽车票API

taobao.bus.tvmqueryorder.get (线下自助机查询订单信息)

查询订单详情

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
alitrip_order_id String 必须 1212 阿里订单标编号

响应参数

名称 类型 示例值 描述
result_code String 0 errorCode
result_msg String 0 errorMsg
is_success Boolean true success
tvm_bus_order_line_info TvmBusOrderLineInfo 0 tvmBusOrderLineInfo
  • └ agent_order_id
  • String
  • 11
  • 代理商订单号
  • └ alipay_trade_no
  • String
  • 1
  • 阿里支付交易号
  • └ alitrip_order_id
  • String
  • 1
  • 阿里订单编号
  • └ gmt_create
  • String
  • 2017-01-03
  • 订单创建时间
  • └ issue_time
  • String
  • 2017-01-03
  • 出票时间
  • └ order_status
  • Number
  • 2
  • CREATED_NO_PAY(10, 已创建，待支付),PAYED_NO_NOTIFY(20, 已支付，待通知代理商),PAYED_AND_NOTIFY(30, 已支付，待代理商出票),BOOKED_AND_CONFIRM（50, 已出票,已确认）,BOOK_FAILED(-1, 出票失败),PAY_TIME_OUT(-2, 支付超时),BOOK_TIME_OUT(-3, 出票超时),CANCEL(-4, 订单取消),CLOSE(-5, 订单关闭)
  • passengers
  • TvmPassengerVo []
  • 1
  • passengers
  • └ agent_eticket
  • String
  • 123456789
  • 电子票号
  • └ agent_ticket_id
  • String
  • 1234
  • 商家票号
  • └ full_price
  • Number
  • 1
  • 全票价
  • └ has_children
  • Boolean
  • 1
  • hasChildren
  • └ rider_cert_number
  • String
  • 1
  • 身份证
  • └ rider_cert_type
  • String
  • 1
  • 乘客证件类型
  • └ rider_name
  • String
  • 1
  • riderName
  • └ seat_number
  • String
  • 1
  • 座位号
  • └ service_charge
  • Number
  • 1
  • 服务费
  • └ ticket_price
  • Number
  • 1
  • 票价
  • tvm_insurance_infos
  • TvmInsuranceInfo []
  • 乘客购买保险信息
  • └ insure_status
  • Number
  • 1
  • 保险状态: -1下单失败 0初始化 1已取消 2已关闭 3已挂起 4已挂起 5未知状态 6未生效 7保障中 8已失效 9退保中 10已退保 11未生效或保障中
  • └ insure_price
  • Number
  • 1000
  • 保险产品单价(分)
  • └ insure_name
  • String
  • 意外险
  • 保险名称
  • └ product_no
  • String
  • 111abc
  • 保险唯一标识 购买必传
  • └ pay_time
  • String
  • 2017-01-03 11:22:12
  • 支付时间
  • refunds
  • TvmRefundApply []
  • 1
  • 退款信息
  • └ apply_id
  • Number
  • 111111
  • 申请单id
  • └ gmt_create
  • String
  • 2018-01-01 00:00:00
  • 创建时间
  • └ gmt_refund_succ_time
  • String
  • 2018-01-01 00:01:00
  • 成功时间
  • └ out_trade_no
  • String
  • A124
  • 退款批次号
  • └ refund_amount
  • Number
  • 100
  • 退款金额（分）
  • └ refund_status
  • Number
  • 40
  • 退款状态 10(处理中) 20(已拒绝) 30(已同意) 40(已退款) 50(已受理)
  • └ rp_apply_id
  • Number
  • 144339989988337
  • 淘宝退款申请单id
  • └ ticket_count
  • Number
  • 1
  • 票数
  • └ total_price
  • Number
  • 1
  • totalPrice
  • tvm_bus_line_info
  • TvmBusLineInfo
  • 1
  • tvmBusLineInfo
  • └ bus_number
  • String
  • PT122
  • 车次
  • └ bus_type
  • String
  • 高客
  • busType
  • └ dep_time
  • String
  • 1
  • 发车时间
  • └ distance
  • Number
  • 1
  • 距离
  • └ last_place_name
  • String
  • 1
  • 目的地
  • └ runtime
  • Number
  • 2
  • 车程时间(小时)
  • └ start_city_name
  • String
  • 1
  • startCityName
  • └ start_province_name
  • String
  • 北京
  • startProvinceName
  • └ start_station_address
  • String
  • xx路
  • 出发站地址
  • └ start_station_id
  • String
  • 33444
  • startStationId
  • └ start_station_name
  • String
  • 1
  • startStationName
  • └ terminal
  • String
  • 3393939
  • terminal
  • └ to_station_city_name
  • String
  • 1
  • toStationCityName
  • └ to_station_id
  • String
  • 2344
  • toStationId
  • └ to_station_name
  • String
  • 北京站
  • 到达站名称
  • └ to_station_province_name
  • String
  • 北京市
  • toStationProvinceName
  • └ real_pay_mode
  • String
  • ALIPAY或WECHAT
  • 实际支付方式:取值范围: ALIPAY （飞猪渠道）; WECHAT（微信）
  • └ buyer_info_unique_key
  • String
  • ***王d827bdf1d250fa37e25a059da36230a7
  • 买家用户信息唯一标识
  • └ alitrip_tp_order_id
  • String
  • 3242387423
  • 阿里tp订单号

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
BusTvmqueryorderGetRequest req = new BusTvmqueryorderGetRequest();
req.setAlitripOrderId("1212");
BusTvmqueryorderGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
<bus_tvmqueryorder_get_response>
    <result_code>0</result_code>
    <result_msg>0</result_msg>
    <is_success>true</is_success>
    <tvm_bus_order_line_info>
        <agent_order_id>11</agent_order_id>
        <alipay_trade_no>1</alipay_trade_no>
        <alitrip_order_id>1</alitrip_order_id>
        <gmt_create>2017-01-03</gmt_create>
        <issue_time>2017-01-03</issue_time>
        <order_status>2</order_status>
        <passengers>
            <tvm_passenger_vo>
                <agent_eticket>123456789</agent_eticket>
                <agent_ticket_id>1234</agent_ticket_id>
                <full_price>1</full_price>
                <has_children>1</has_children>
                <rider_cert_number>1</rider_cert_number>
                <rider_cert_type>1</rider_cert_type>
                <rider_name>1</rider_name>
                <seat_number>1</seat_number>
                <service_charge>1</service_charge>
                <ticket_price>1</ticket_price>
                <tvm_insurance_infos>
                    <tvm_insurance_info>
                        <insure_status>1</insure_status>
                        <insure_price>1000</insure_price>
                        <insure_name>意外险</insure_name>
                        <product_no>111abc</product_no>
                    </tvm_insurance_info>
                </tvm_insurance_infos>
            </tvm_passenger_vo>
        </passengers>
        <pay_time>2017-01-03 11:22:12</pay_time>
        <refunds>
            <tvm_refund_apply>
                <apply_id>111111</apply_id>
                <gmt_create>2018-01-01 00:00:00</gmt_create>
                <gmt_refund_succ_time>2018-01-01 00:01:00</gmt_refund_succ_time>
                <out_trade_no>A124</out_trade_no>
                <refund_amount>100</refund_amount>
                <refund_status>40</refund_status>
                <rp_apply_id>144339989988337</rp_apply_id>
            </tvm_refund_apply>
        </refunds>
        <ticket_count>1</ticket_count>
        <total_price>1</total_price>
        <tvm_bus_line_info>
            <bus_number>PT122</bus_number>
            <bus_type>高客</bus_type>
            <dep_time>1</dep_time>
            <distance>1</distance>
            <last_place_name>1</last_place_name>
            <runtime>2</runtime>
            <start_city_name>1</start_city_name>
            <start_province_name>北京</start_province_name>
            <start_station_address>xx路</start_station_address>
            <start_station_id>33444</start_station_id>
            <start_station_name>1</start_station_name>
            <terminal>3393939</terminal>
            <to_station_city_name>1</to_station_city_name>
            <to_station_id>2344</to_station_id>
            <to_station_name>北京站</to_station_name>
            <to_station_province_name>北京市</to_station_province_name>
        </tvm_bus_line_info>
        <real_pay_mode>ALIPAY或WECHAT</real_pay_mode>
        <buyer_info_unique_key>***王d827bdf1d250fa37e25a059da36230a7</buyer_info_unique_key>
        <alitrip_tp_order_id>3242387423</alitrip_tp_order_id>
    </tvm_bus_order_line_info>
</bus_tvmqueryorder_get_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<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

我要提问
返回
顶部