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

taobao.bus.order.create (汽车票-创建订单)

汽车票-创建订单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_create_order_rq TopCreateOrderRq 可选 创建订单参数
  • └ fetch_phone
  • String
  • 必须
  • 188xxxxxxxx
  • 取票人手机号
  • └ fetch_cert_number
  • String
  • 可选
  • 110101200003015974
  • 取票人身份证号
  • └ item_unique_key
  • String
  • 必须
  • 12345678
  • 班次唯一键
  • └ ticket_count
  • Number
  • 必须
  • 2
  • 票数
  • └ fetch_ticket_name
  • String
  • 必须
  • 张三
  • 取票人姓名
  • tickets
  • TicketInfo []
  • 必须
  • []
  • 票列表
  • └ service_charge
  • Number
  • 可选
  • 200
  • 服务费金额
  • └ ticket_price
  • Number
  • 必须
  • 8000
  • 票价
  • └ ticket_type
  • Number
  • 必须
  • 1
  • 票类型,0-成人票,1-儿童票,2-携童票
  • └ rider_name
  • String
  • 必须
  • 张三
  • 乘客姓名
  • └ rider_cert_type
  • String
  • 必须
  • 02
  • 乘客证件类型,01-身份证,02-护照,03-港澳通行证,04-台湾通行证,05-港澳往返内地通行证,06-台湾往返内地通行证,07-港澳居民居住证
  • └ rider_cert_number
  • String
  • 必须
  • 110101200003015974
  • 乘客证件号
  • └ partner_order_id
  • String
  • 必须
  • 1234567X
  • 分销商订单号
  • └ dep_time
  • String
  • 必须
  • 06:00
  • 发车时间
  • └ fetch_cert_type
  • String
  • 可选
  • 03
  • 取票人证件类型,01-身份证,02-护照,03-港澳通行证,04-台湾通行证,05-港澳往返内地通行证,06-台湾往返内地通行证,07-港澳居民居住证
  • └ pay_time_out
  • Number
  • 必须
  • 20
  • 支付超时时间,单位分钟

响应参数

名称 类型 示例值 描述
dep_time String 08:00 发车时间
alitrip_order_id String 12345678 飞猪订单号
is_success Boolean true 是否业务成功
result_code String SYS_ERROR 错误码
result_msg String 系统异常 错误信息
ticket_price Number 2000 票价
service_charge Number 300 服务费金额

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
BusOrderCreateRequest req = new BusOrderCreateRequest();
BusOrderCreateRequest.TopCreateOrderRq obj1 = new BusOrderCreateRequest.TopCreateOrderRq();
obj1.setFetchPhone("188xxxxxxxx");
obj1.setFetchCertNumber("110101200003015974");
obj1.setItemUniqueKey("12345678");
obj1.setTicketCount(2L);
obj1.setFetchTicketName("张三");
List<BusOrderCreateRequest.TicketInfo> list3 = new ArrayList<BusOrderCreateRequest.TicketInfo>();
BusOrderCreateRequest.TicketInfo obj4 = new BusOrderCreateRequest.TicketInfo();
list3.add(obj4);
obj4.setServiceCharge(200L);
obj4.setTicketPrice(8000L);
obj4.setTicketType(1L);
obj4.setRiderName("张三");
obj4.setRiderCertType("02");
obj4.setRiderCertNumber("110101200003015974");
obj1.setTickets(list3);
obj1.setPartnerOrderId("1234567X");
obj1.setDepTime("06:00");
obj1.setFetchCertType("03");
obj1.setPayTimeOut(20L);
req.setTopCreateOrderRq(obj1);
BusOrderCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<bus_order_create_response>
    <dep_time>08:00</dep_time>
    <alitrip_order_id>12345678</alitrip_order_id>
    <is_success>true</is_success>
    <result_code>SYS_ERROR</result_code>
    <result_msg>系统异常</result_msg>
    <ticket_price>2000</ticket_price>
    <service_charge>300</service_charge>
</bus_order_create_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

返回
顶部