代理商获取订单信息回调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 [] | 火车票信息。 | |
|
|||
| 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定制信息 | |
|
|||
| customize_order | Boolean | false | 是否是付费定制订单 |
| force_issue_success | Boolean | false | 是否需要持续监控出票标识 |
| trip_type | Number | 1 | 行程类型 |
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());
<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>
<ticket_extend_params>扩展信息</ticket_extend_params>
</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>
<accept_no_custom_type>carriage,adjacencySeat</accept_no_custom_type>
<accept_no_custom_desc>用户选择座位无票时,接受其它连座或者同车厢的不连座</accept_no_custom_desc>
</vip_custom_result_item>
</vip_custom_list>
<customize_order>false</customize_order>
<force_issue_success>false</force_issue_success>
<trip_type>1</trip_type>
</train_agent_order_get_vtwo_response>
<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 |