alitrip.btrip.supplychain.train.callback.book (商旅火车票正向预订出票回调)

商旅火车票正向预订出票回调

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
book_callback_param BookCallbackParam 必须 正向预订出票回调信息
  • book_train_details
  • BookTrainDetail []
  • 必须
  • bookTrainDetail
  • 正向预订出票详情
  • └ to_station_name
  • String
  • 必须
  • 上海
  • 到达站名
  • └ arrive_time
  • String
  • 必须
  • 2022-10-28 12:00:00
  • 到达时间,yyyy-MM-dd hh:mm:ss
  • └ order_total_price
  • String
  • 必须
  • 1000
  • 订单金额,单位分
  • └ train_date
  • String
  • 必须
  • 2022-10-28
  • 乘车日期 yyyy-MM-dd
  • └ from_station_name
  • String
  • 必须
  • 北京
  • 出发站名
  • └ ticket_num
  • String
  • 必须
  • 1
  • 票数
  • └ to_station_code
  • String
  • 必须
  • SHH
  • 到达站三字码
  • book_ticket_details
  • BookTicketDetail []
  • 必须
  • bookTicketDetail
  • 票信息
  • └ resign_flag
  • String
  • 必须
  • 1
  • 是否允许改签,0:允许,1:不允许
  • └ coach_no
  • String
  • 可选
  • 01
  • 车厢号
  • └ ticket_price
  • String
  • 可选
  • 1000
  • 车票单价,单位分
  • └ ticket_entrance
  • String
  • 可选
  • {"0":"xx检票口"}
  • 检票口
  • passenger_info
  • PassengerInfo
  • 必须
  • 乘客信息
  • └ passenger_name
  • String
  • 必须
  • 张三
  • 乘客姓名,SM4加密
  • └ passenger_mobile
  • String
  • 必须
  • 1667xx87xxx
  • 乘客手机号,SM4加密
  • └ passenger_id_no
  • String
  • 必须
  • 432524100011191212
  • 证件号,SM4加密
  • └ passenger_id_type
  • String
  • 必须
  • 0
  • 证件类型,SM4加密,枚举值提供
  • └ country_code
  • String
  • 可选
  • CN
  • 国籍码,SM4加密,证件为非身份证类型必传
  • └ sex
  • String
  • 可选
  • 0
  • 性别,SM4加密
  • └ passenger_id
  • String
  • 必须
  • 123452
  • 乘客id,SM4加密,商旅提供
  • └ valid_date_start
  • String
  • 可选
  • 2000-12-12
  • 签发日期,SM4加密
  • └ birth_date
  • String
  • 可选
  • 1000-11-19
  • 出生日期,SM4加密, yyyy-MM-dd格式,证件为非身份证类型必传
  • └ valid_date_end
  • String
  • 可选
  • 2030-12-12
  • 证件有效期,SM4加密,yyyy-MM-dd格式,证件为非身份证类型必传
  • └ ticket_type
  • String
  • 必须
  • 1
  • 票类型,0:儿童票,1:成人票,2:学生票
  • └ seat_type
  • String
  • 必须
  • 1
  • 坐席类型,枚举值
  • └ ticket_status
  • String
  • 必须
  • 11
  • 票状态,枚举值提供
  • └ refund_flag
  • String
  • 必须
  • 0
  • 是否允许退票,0:允许,1:不允许
  • └ seat_name
  • String
  • 必须
  • 硬座
  • 坐席名称,枚举值提供
  • └ change_flag
  • String
  • 必须
  • 1
  • 是否允许变更到站,0:允许,1:不允许
  • └ seat_no
  • String
  • 可选
  • 001
  • 坐席号
  • └ passenger_ticket_no
  • String
  • 可选
  • EW123123212
  • 乘客取票号
  • └ fail_code
  • String
  • 可选
  • 1001
  • 失败code
  • └ fail_reason
  • String
  • 可选
  • 车次已无票
  • 失败原因
  • └ train_no
  • String
  • 必须
  • T123
  • 短车次号
  • └ from_station_code
  • String
  • 必须
  • BJP
  • 出发站三字码
  • └ start_time
  • String
  • 必须
  • 2022-10-10 12:00:00
  • 出发时间,yyyy-MM-dd hh:mm:ss
  • └ train_id
  • String
  • 可选
  • 车次id
  • 车次id
  • └ supplier_order_id
  • String
  • 必须
  • 987654321
  • 供应商订单号
  • └ ticket_no
  • String
  • 可选
  • EW123452
  • 12306票号
  • └ order_id
  • String
  • 必须
  • 123456789
  • 商旅订单号
  • └ order_status
  • String
  • 必须
  • 11
  • 订单状态,状态枚举提供
  • └ purchase_type
  • String
  • 必须
  • 2
  • 采购模式
  • └ fail_code
  • String
  • 可选
  • 1001
  • 失败原因code
  • └ fail_reason
  • String
  • 可选
  • 车次已无票
  • 失败原因描述

响应参数

名称 类型 示例值 描述
data OrderInfo 数据
  • └ order_id
  • String
  • 123456789
  • 商旅订单号
  • └ supplier_order_id
  • String
  • 987654321
  • 供应商订单号
result_code String 200 返回结果码
status String true 是否成功
result_msg String 成功 返回结果描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripBtripSupplychainTrainCallbackBookRequest req = new AlitripBtripSupplychainTrainCallbackBookRequest();
AlitripBtripSupplychainTrainCallbackBookRequest.BookCallbackParam obj1 = new AlitripBtripSupplychainTrainCallbackBookRequest.BookCallbackParam();
List<AlitripBtripSupplychainTrainCallbackBookRequest.BookTrainDetail> list3 = new ArrayList<AlitripBtripSupplychainTrainCallbackBookRequest.BookTrainDetail>();
AlitripBtripSupplychainTrainCallbackBookRequest.BookTrainDetail obj4 = new AlitripBtripSupplychainTrainCallbackBookRequest.BookTrainDetail();
list3.add(obj4);
obj4.setToStationName("上海");
obj4.setArriveTime("2022-10-28 12:00:00");
obj4.setOrderTotalPrice("1000");
obj4.setTrainDate("2022-10-28");
obj4.setFromStationName("北京");
obj4.setTicketNum("1");
obj4.setToStationCode("SHH");
List<AlitripBtripSupplychainTrainCallbackBookRequest.BookTicketDetail> list7 = new ArrayList<AlitripBtripSupplychainTrainCallbackBookRequest.BookTicketDetail>();
AlitripBtripSupplychainTrainCallbackBookRequest.BookTicketDetail obj8 = new AlitripBtripSupplychainTrainCallbackBookRequest.BookTicketDetail();
list7.add(obj8);
obj8.setResignFlag("1");
obj8.setCoachNo("01");
obj8.setTicketPrice("1000");
obj8.setTicketEntrance("{\"0\":\"xx检票口\"}");
AlitripBtripSupplychainTrainCallbackBookRequest.PassengerInfo obj10 = new AlitripBtripSupplychainTrainCallbackBookRequest.PassengerInfo();
obj10.setPassengerName("张三");
obj10.setPassengerMobile("1667xx87xxx");
obj10.setPassengerIdNo("432524100011191212");
obj10.setPassengerIdType("0");
obj10.setCountryCode("CN");
obj10.setSex("0");
obj10.setPassengerId("123452");
obj10.setValidDateStart("2000-12-12");
obj10.setBirthDate("1000-11-19");
obj10.setValidDateEnd("2030-12-12");
list9.setPassengerInfo(obj10);
obj8.setTicketType("1");
obj8.setSeatType("1");
obj8.setTicketStatus("11");
obj8.setRefundFlag("0");
obj8.setSeatName("硬座");
obj8.setChangeFlag("1");
obj8.setSeatNo("001");
obj8.setPassengerTicketNo("EW123123212");
obj8.setFailCode("1001");
obj8.setFailReason("车次已无票");
list5.setBookTicketDetails(list7);
obj4.setTrainNo("T123");
obj4.setFromStationCode("BJP");
obj4.setStartTime("2022-10-10 12:00:00");
obj4.setTrainId("车次id");
obj1.setBookTrainDetails(list3);
obj1.setSupplierOrderId("987654321");
obj1.setTicketNo("EW123452");
obj1.setOrderId("123456789");
obj1.setOrderStatus("11");
obj1.setPurchaseType("2");
obj1.setFailCode("1001");
obj1.setFailReason("车次已无票");
req.setBookCallbackParam(obj1);
AlitripBtripSupplychainTrainCallbackBookResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_btrip_supplychain_train_callback_book_response>
    <data>
        <order_id>123456789</order_id>
        <supplier_order_id>987654321</supplier_order_id>
    </data>
    <result_code>200</result_code>
    <status>true</status>
    <result_msg>成功</result_msg>
</alitrip_btrip_supplychain_train_callback_book_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

返回
顶部