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

taobao.train.agent.order.get (代理商获取订单信息回调API)

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

公共参数

请求参数

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

响应参数

名称 类型 示例值 描述
ttp_order_id Number 1234 ttp_order_id
is_success Boolean true 返回错误。
main_order_id Number 123456 主订单id
tickets ToAgentTicketInfo [] 火车票信息。
  • student_info
  • StudentInfo
  • 学生信息
  • └ card
  • String
  • 100
  • demo
  • └ classes
  • String
  • 100
  • demo
  • └ depart_ment
  • String
  • 100
  • demo
  • └ eductional_system
  • String
  • 100
  • demo
  • └ entrance_year
  • String
  • 100
  • demo
  • └ from_city
  • String
  • 100
  • demo
  • └ school_name
  • String
  • 100
  • demo
  • └ school_province
  • String
  • 100
  • demo
  • └ student_no
  • String
  • 100
  • demo
  • └ to_city
  • String
  • 100
  • demo
  • └ sub_order_id
  • String
  • 123456
  • 淘宝火车票子订单id.
  • └ from_station
  • String
  • 北京
  • 出发站
  • └ from_time
  • String
  • 2013-08-08 08:08:00
  • 出发时间
  • └ to_station
  • String
  • 上海
  • 到达站
  • └ seat
  • Number
  • 1
  • 坐席
  • └ train_num
  • String
  • G101
  • 车次
  • └ passenger_name
  • String
  • 亚里士多德
  • 乘客姓名
  • └ certificate_num
  • String
  • 123456
  • 证件编号
  • └ certificate_type
  • String
  • 0
  • 证件类型,0:身份证 1:护照 4:港澳通行证 5:台湾通行证
  • └ insurance_price
  • Number
  • 1000
  • 保险价格,精确到分,例如10元,输入1000。
  • └ ticket_price
  • Number
  • 10000
  • 单张票价(不包含保险价格),例如100元,输出为10000,精确到分.
  • └ birthday
  • String
  • 2013-08-08
  • 乘客生日
  • └ to_time
  • String
  • 2013-08-08 08:08:00
  • 到站时间
  • └ tag
  • Number
  • 1
  • 1:单程票
  • └ insurance_unit_price
  • Number
  • 1000
  • 保险的单一价格
  • └ passenger_type
  • Number
  • 0
  • 0:成人 1:儿童 2:学生
total_price Number 50000 整个订单的总价,包括每张票价及保险价格,价格精确到分,例如100元,输出为10000.
telephone String 12345678900 移动电话
mailing Boolean true 是否需要保险邮件地址
address String 北京 北京市 朝阳区 北京市朝阳区东恒时代2期A区 (流火 收)13512345678 保险邮件地址
relation_name String 姓名 联系人姓名
company_name String 淘宝网 如果是公司发票,需要公司名称,如果不需要公司名称,返回no
order_status Number 1 1-已付款,2-关闭,3-成功
latest_issue_time Date 2000-01-01 00:00:00 最晚出票时间
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 备用 扩展字段

请求示例

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

响应示例

  • XML示例
  • JSON示例
<train_agent_order_get_response>
    <ttp_order_id>1234</ttp_order_id>
    <is_success>true</is_success>
    <main_order_id>123456</main_order_id>
    <tickets>
        <to_agent_ticket_info>
            <student_info>
            </student_info>
            <sub_order_id>123456</sub_order_id>
            <from_station>北京</from_station>
            <from_time>2013-08-08 08:08:00</from_time>
            <to_station>上海</to_station>
            <seat>1</seat>
            <train_num>G101</train_num>
            <passenger_name>亚里士多德</passenger_name>
            <certificate_num>123456</certificate_num>
            <certificate_type>0</certificate_type>
            <insurance_price>1000</insurance_price>
            <ticket_price>10000</ticket_price>
            <birthday>2013-08-08</birthday>
            <to_time>2013-08-08 08:08:00</to_time>
            <tag>1</tag>
            <insurance_unit_price>1000</insurance_unit_price>
            <passenger_type>0</passenger_type>
        </to_agent_ticket_info>
    </tickets>
    <total_price>50000</total_price>
    <telephone>12345678900</telephone>
    <mailing>true</mailing>
    <address>北京 北京市 朝阳区 北京市朝阳区东恒时代2期A区 (流火 收)13512345678</address>
    <relation_name>姓名</relation_name>
    <company_name>淘宝网</company_name>
    <order_status>1</order_status>
    <latest_issue_time>2000-01-01 00:00:00</latest_issue_time>
    <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>
</train_agent_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

返回
顶部