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

taobao.train.agent.order.get.vtwo (代理商获取订单信息回调APIv2--增加鉴权校验)

代理商获取订单信息回调API

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
main_order_id Number 必须 1231231231 淘宝的主订单号
agent_id Number 必须 123456 代理商id

响应参数

名称 类型 示例值 描述
address String 北京 北京市 朝阳区 北京市朝阳区东恒时代2期A区 (流火 收)13512345678 保险邮件地址
company_name String 淘宝网 如果是公司发票,需要公司名称,如果不需要公司名称,返回no
mailing Boolean true 是否需要保险邮件地址
main_order_id Number 123456 主订单id
order_status Number 1 1-已付款,2-关闭,3-成功
relation_name String 姓名 联系人姓名
is_success Boolean true 返回错误。
telephone String 12345678900 移动电话
tickets ToAgentTicketInfo [] 火车票信息。
  • └ birthday
  • String
  • 2013-08-08
  • 乘客生日
  • └ certificate_num
  • String
  • 123456
  • 证件编号
  • └ certificate_type
  • String
  • 0
  • 证件类型,0:身份证 1:护照 4:港澳通行证 5:台湾通行证
  • └ from_station
  • String
  • 北京
  • 出发站
  • └ from_time
  • String
  • 2013-08-08 08:08:00
  • 出发时间
  • └ insurance_price
  • Number
  • 1000
  • 保险价格,精确到分,例如10元,输入1000。
  • └ insurance_unit_price
  • Number
  • 1000
  • 保险的单一价格
  • └ passenger_name
  • String
  • 亚里士多德
  • 乘客姓名
  • └ passenger_type
  • Number
  • 0
  • 0:成人 1:儿童 2:学生
  • └ seat
  • Number
  • 1
  • 坐席
  • └ sub_order_id
  • String
  • 123456
  • 淘宝火车票子订单id.
  • └ tag
  • Number
  • 1
  • 1:单程票
  • └ ticket_price
  • Number
  • 10000
  • 单张票价(不包含保险价格),例如100元,输出为10000,精确到分.
  • └ to_station
  • String
  • 上海
  • 到达站
  • └ to_time
  • String
  • 2013-08-08 08:08:00
  • 到站时间
  • └ train_num
  • String
  • G101
  • 车次
  • student_info
  • StudentInfo
  • 学生信息
  • └ school_province
  • String
  • 100
  • demo
  • └ school_name
  • String
  • 100
  • demo
  • └ depart_ment
  • String
  • 100
  • demo
  • └ classes
  • String
  • 100
  • demo
  • └ student_no
  • String
  • 100
  • demo
  • └ eductional_system
  • String
  • 100
  • demo
  • └ entrance_year
  • String
  • 100
  • demo
  • └ card
  • String
  • 100
  • demo
  • └ from_city
  • String
  • 100
  • demo
  • └ to_city
  • String
  • 100
  • demo
  • └ segment_index
  • Number
  • 1
  • segmentIndex
  • └ valid_until
  • String
  • 2022-11-07
  • 证件有效期
  • └ nationality_code
  • String
  • AU
  • 国家code
  • └ nationality
  • String
  • 澳大利亚
  • 国家名称
  • └ gender
  • String
  • 1
  • 性别 1:男 0:女
  • └ telephone
  • String
  • 13811111111
  • 联系人电话
  • └ real_ticket_price
  • Number
  • 10000
  • 实际票价(不包含保险价格),例如100元,输出为10000,精确到分.
  • └ support_no_seat
  • Boolean
  • false
  • 是否支持无座
total_price Number 50000 整个订单的总价,包括每张票价及保险价格,价格精确到分,例如100元,输出为10000.
latest_issue_time Date 2000-01-01 00:00:00 最晚出票时间
ttp_order_id Number 1234 ttp_order_id
order_type Number 0 订单类型0:默认订单类型走代理商账号;1:走12306客户绑定的账号;2:线下邮寄票
paper_type Number 1 纸质票类型: 1 靠窗,2 连坐,3 上铺,4 中铺,5 下铺,6 是否同包厢
paper_backup Number 0 当下铺/靠窗/连坐无票时,是否支持非下铺/非靠窗/非连坐(0不接受,1接受)
paper_low_seat_count Number 1 至少接受下铺/靠窗/连坐数量
transport_name String 张三 线下票收件人姓名
transport_phone String 18098890900 线下票收件人手机号
transport_address String 地址 线下票收件人地址
transport_price Number 2000 快递费(分)
service_price Number 2000 手续费总价(分)
extend_params String 备用 扩展字段
online_book_seat String 用户在线选座的值 1A2B
interchange_station String 中转站 interchangeStation
is_multi_trip String 是否为连程 isMultiTrip
need_receipt Boolean false 是否需要发票
accept_no_vip_custom Number 0 是否接受非定制坐席 1:是 0:否
vip_custom_min_seat_count Number 1 用户可接受的最少定制票数量
vip_custom_type Number 1 定制票类型 1:下铺 2:下铺or中铺 3:过道 4:靠窗
refund_by_passenger Boolean false 是否需要乘车人退款 true:需要 false:不需要
vip_custom_list VipCustomResultItem [] vip定制信息
  • └ custom_type
  • String
  • onlineBooking
  • 定制类型
  • └ count
  • Number
  • 2
  • 定制数量
  • └ carriage_custom
  • String []
  • 定制车厢号
  • └ seat_custom
  • String
  • 1A2A#1B1B
  • 定制坐席号
  • └ accept_no_vip_custom
  • Number
  • 1
  • 是否接受非定制,0不接受,1接受
  • └ segment_index
  • Number
  • 1
  • 联程订单定制序号
customize_order Boolean false 是否是付费定制订单

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TrainAgentOrderGetVtwoRequest req = new TrainAgentOrderGetVtwoRequest();
req.setMainOrderId(1231231231L);
req.setAgentId(123456L);
TrainAgentOrderGetVtwoResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<train_agent_order_get_vtwo_response>
    <address>北京 北京市 朝阳区 北京市朝阳区东恒时代2期A区 (流火 收)13512345678</address>
    <company_name>淘宝网</company_name>
    <mailing>true</mailing>
    <main_order_id>123456</main_order_id>
    <order_status>1</order_status>
    <relation_name>姓名</relation_name>
    <is_success>true</is_success>
    <telephone>12345678900</telephone>
    <tickets>
        <to_agent_ticket_info>
            <birthday>2013-08-08</birthday>
            <certificate_num>123456</certificate_num>
            <certificate_type>0</certificate_type>
            <from_station>北京</from_station>
            <from_time>2013-08-08 08:08:00</from_time>
            <insurance_price>1000</insurance_price>
            <insurance_unit_price>1000</insurance_unit_price>
            <passenger_name>亚里士多德</passenger_name>
            <passenger_type>0</passenger_type>
            <seat>1</seat>
            <sub_order_id>123456</sub_order_id>
            <tag>1</tag>
            <ticket_price>10000</ticket_price>
            <to_station>上海</to_station>
            <to_time>2013-08-08 08:08:00</to_time>
            <train_num>G101</train_num>
            <student_info>
                <school_province>100</school_province>
                <school_name>100</school_name>
                <depart_ment>100</depart_ment>
                <classes>100</classes>
                <student_no>100</student_no>
                <eductional_system>100</eductional_system>
                <entrance_year>100</entrance_year>
                <card>100</card>
                <from_city>100</from_city>
                <to_city>100</to_city>
            </student_info>
            <segment_index>1</segment_index>
            <valid_until>2022-11-07</valid_until>
            <nationality_code>AU</nationality_code>
            <nationality>澳大利亚</nationality>
            <gender>1</gender>
            <telephone>13811111111</telephone>
            <real_ticket_price>10000</real_ticket_price>
            <support_no_seat>false</support_no_seat>
        </to_agent_ticket_info>
    </tickets>
    <total_price>50000</total_price>
    <latest_issue_time>2000-01-01 00:00:00</latest_issue_time>
    <ttp_order_id>1234</ttp_order_id>
    <order_type>0</order_type>
    <paper_type>1</paper_type>
    <paper_backup>0</paper_backup>
    <paper_low_seat_count>1</paper_low_seat_count>
    <transport_name>张三</transport_name>
    <transport_phone>18098890900</transport_phone>
    <transport_address>地址</transport_address>
    <transport_price>2000</transport_price>
    <service_price>2000</service_price>
    <extend_params>备用</extend_params>
    <online_book_seat>用户在线选座的值</online_book_seat>
    <interchange_station>中转站</interchange_station>
    <is_multi_trip>是否为连程</is_multi_trip>
    <need_receipt>false</need_receipt>
    <accept_no_vip_custom>0</accept_no_vip_custom>
    <vip_custom_min_seat_count>1</vip_custom_min_seat_count>
    <vip_custom_type>1</vip_custom_type>
    <refund_by_passenger>false</refund_by_passenger>
    <vip_custom_list>
        <vip_custom_result_item>
            <custom_type>onlineBooking</custom_type>
            <count>2</count>
            <seat_custom>1A2A#1B1B</seat_custom>
            <accept_no_vip_custom>1</accept_no_vip_custom>
            <segment_index>1</segment_index>
        </vip_custom_result_item>
    </vip_custom_list>
    <customize_order>false</customize_order>
</train_agent_order_get_vtwo_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>

错误码解释

错误码 错误描述 解决方案
isv.invalid-argument

API工具

如何获得此API

FAQ

返回
顶部