文档中心 > 综合交通-商家对接

qimen.alitrip.bus.order.create (创建订单(锁单坐席)接口)

创建订单(锁定坐席)接口。根据航线id，出发日期、出发到达港口等信息下单，返回订单号，本接口的主要目的是锁定坐席，一个订单号可以对应多张票。下单接口需要根据飞猪订单号(alitripOrderId)幂等。即相同的alitripOrderId第二次调用后，返回相同的订单详情结果。相同的alitripOrderId请求报文不会改变。同时商家要对订单总价格、出发时间、出发和到达港口等关键数据进行逻辑校验。失败时，请严格按照错误码进行返回。

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
toCityName	String	必须	青城山		到达城市
ticketCount	Number	必须	2		车票数量
goodsId	String	必须	964455ALD		商品id列表
contactName	String	必须	罗大佑		联系人姓名
alipayTradeNo	String	必须	1223939393993939399339		支付宝交易流水号
fromStationName	String	可选	人民广场		出发港口名称
toStationCode	String	可选	0245		到达港口编码
toStationName	String	可选	青城山凉亭		到达港口名称
fromTime	String	必须	23:00:00		出发时间
toCityCode	String	可选	001		到达城市编码
fromStationCode	String	可选	0224		出发港口编码
orderAmount	Number	必须	10000		订单价格(单位分)
passengerList	Passenger []	可选		最大列表长度：999999	乘客列表
└ passengerName String 必须罗大佑乘客姓名 └ ticketPrice Number 必须 2500 票价(单位分) └ passengerCertificateNo String 必须 212100198902171763 证件编码 └ passengerCertificateType String 必须 1 证件类型 └ passengerType String 必须 1 乘客类型:1-成人;2-儿童 └ ticketCommission Number 可选 100 服务费(单位分) └ passengerId String 必须 33499 乘客ID └ passengerSpell String 可选 Zhang/San 乘客姓名拼音 └ birthDay String 可选 1990-01-01 乘客生日 └ visaDate String 可选签证有效期 2050-09-23
scheduleId	String	可选	2233333		航班id
contactMobile	String	必须	189113344343		联系人电话
contactCertificateNo	String	必须	212100198902171763		联系人证件号
contactCertificateType	String	必须	1		联系人证件类型
fromDate	String	必须	2018-11-01		出发日期
fromCityCode	String	可选	001		出发城市编码
fromCityName	String	可选	成都		出发城市名称
seatGradeCode	String	可选	SIT001		舱位等级代码
seatGradeName	String	可选	一等座		舱位等级名称
ticketAmount	Number	必须	1000		票总金额(单位分)
alitripOrderId	String	必须	23334040404		飞猪平台订单id

响应参数

名称	类型	示例值	描述
agentOrderId	String	2222	商家订单id（是必填）
success	Boolean	true	业务是否成功（是必填）
alitripOrderId	String	22222	飞猪平台订单id（是必填）
retCode	String	0	业务结果编码（是必填）
retDesc	String	成功	业务结果描述（是必填）

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
AlitripBusOrderCreateRequest req = new AlitripBusOrderCreateRequest();
req.setToCityName("青城山");
req.setTicketCount(2L);
req.setGoodsId("964455ALD");
req.setContactName("罗大佑");
req.setAlipayTradeNo("1223939393993939399339");
req.setFromStationName("人民广场");
req.setToStationCode("0245");
req.setToStationName("青城山凉亭");
req.setFromTime("23:00:00");
req.setToCityCode("001");
req.setFromStationCode("0224");
req.setOrderAmount(10000L);
List<AlitripBusOrderCreateRequest.Passenger> list2 = new ArrayList<AlitripBusOrderCreateRequest.Passenger>();
AlitripBusOrderCreateRequest.Passenger obj3 = new AlitripBusOrderCreateRequest.Passenger();
list2.add(obj3);
obj3.setPassengerName("罗大佑");
obj3.setTicketPrice(2500L);
obj3.setPassengerCertificateNo("212100198902171763");
obj3.setPassengerCertificateType("1");
obj3.setPassengerType("1");
obj3.setTicketCommission(100L);
obj3.setPassengerId("33499");
obj3.setPassengerSpell("Zhang/San");
obj3.setBirthDay("1990-01-01");
obj3.setVisaDate("签证有效期");
req.setPassengerList(list2);
req.setScheduleId("2233333");
req.setContactMobile("189113344343");
req.setContactCertificateNo("212100198902171763");
req.setContactCertificateType("1");
req.setFromDate("2018-11-01");
req.setFromCityCode("001");
req.setFromCityName("成都");
req.setSeatGradeCode("SIT001");
req.setSeatGradeName("一等座");
req.setTicketAmount(1000L);
req.setAlitripOrderId("23334040404");
AlitripBusOrderCreateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripBusOrderCreateRequest req = new AlitripBusOrderCreateRequest();
req.ToCityName = "青城山";
req.TicketCount = 2L;
req.GoodsId = "964455ALD";
req.ContactName = "罗大佑";
req.AlipayTradeNo = "1223939393993939399339";
req.FromStationName = "人民广场";
req.ToStationCode = "0245";
req.ToStationName = "青城山凉亭";
req.FromTime = "23:00:00";
req.ToCityCode = "001";
req.FromStationCode = "0224";
req.OrderAmount = 10000L;
List<AlitripBusOrderCreateRequest.PassengerDomain> list2 = new List<AlitripBusOrderCreateRequest.PassengerDomain>();
AlitripBusOrderCreateRequest.PassengerDomain obj3 = new AlitripBusOrderCreateRequest.PassengerDomain();
list2.Add(obj3);
obj3.PassengerName = "罗大佑";
obj3.TicketPrice = 2500L;
obj3.PassengerCertificateNo = "212100198902171763";
obj3.PassengerCertificateType = "1";
obj3.PassengerType = "1";
obj3.TicketCommission = 100L;
obj3.PassengerId = "33499";
obj3.PassengerSpell = "Zhang/San";
obj3.BirthDay = "1990-01-01";
obj3.VisaDate = "签证有效期";
req.PassengerList_ = list2;
req.ScheduleId = "2233333";
req.ContactMobile = "189113344343";
req.ContactCertificateNo = "212100198902171763";
req.ContactCertificateType = "1";
req.FromDate = "2018-11-01";
req.FromCityCode = "001";
req.FromCityName = "成都";
req.SeatGradeCode = "SIT001";
req.SeatGradeName = "一等座";
req.TicketAmount = 1000L;
req.AlitripOrderId = "23334040404";
AlitripBusOrderCreateResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripBusOrderCreateRequest;
$req->setToCityName("青城山");
$req->setTicketCount("2");
$req->setGoodsId("964455ALD");
$req->setContactName("罗大佑");
$req->setAlipayTradeNo("1223939393993939399339");
$req->setFromStationName("人民广场");
$req->setToStationCode("0245");
$req->setToStationName("青城山凉亭");
$req->setFromTime("23:00:00");
$req->setToCityCode("001");
$req->setFromStationCode("0224");
$req->setOrderAmount("10000");
$passengerList = new Passenger;
$passengerList->passenger_name="罗大佑";
$passengerList->ticket_price="2500";
$passengerList->passenger_certificate_no="212100198902171763";
$passengerList->passenger_certificate_type="1";
$passengerList->passenger_type="1";
$passengerList->ticket_commission="100";
$passengerList->passenger_id="33499";
$passengerList->passenger_spell="Zhang/San";
$passengerList->birth_day="1990-01-01";
$passengerList->visa_date="签证有效期";
$req->setPassengerList(json_encode($passengerList));
$req->setScheduleId("2233333");
$req->setContactMobile("189113344343");
$req->setContactCertificateNo("212100198902171763");
$req->setContactCertificateType("1");
$req->setFromDate("2018-11-01");
$req->setFromCityCode("001");
$req->setFromCityName("成都");
$req->setSeatGradeCode("SIT001");
$req->setSeatGradeName("一等座");
$req->setTicketAmount("1000");
$req->setAlitripOrderId("23334040404");
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=qimen.alitrip.bus.order.create' \
-d 'partner_id=apidoc' \
-d 'sign=8344B77D0046CDC374D55CE47B14CD09' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-27+21%3A48%3A10' \
-d 'v=2.0' \
-d 'alipayTradeNo=1223939393993939399339' \
-d 'alitripOrderId=23334040404' \
-d 'contactCertificateNo=212100198902171763' \
-d 'contactCertificateType=1' \
-d 'contactMobile=189113344343' \
-d 'contactName=%E7%BD%97%E5%A4%A7%E4%BD%91' \
-d 'fromCityCode=001' \
-d 'fromCityName=%E6%88%90%E9%83%BD' \
-d 'fromDate=2018-11-01' \
-d 'fromStationCode=0224' \
-d 'fromStationName=%E4%BA%BA%E6%B0%91%E5%B9%BF%E5%9C%BA' \
-d 'fromTime=23%3A00%3A00' \
-d 'goodsId=964455ALD' \
-d 'orderAmount=10000' \
-d 'passengerList=null' \
-d 'scheduleId=2233333' \
-d 'seatGradeCode=SIT001' \
-d 'seatGradeName=%E4%B8%80%E7%AD%89%E5%BA%A7' \
-d 'ticketAmount=1000' \
-d 'ticketCount=2' \
-d 'toCityCode=001' \
-d 'toCityName=%E9%9D%92%E5%9F%8E%E5%B1%B1' \
-d 'toStationCode=0245' \
-d 'toStationName=%E9%9D%92%E5%9F%8E%E5%B1%B1%E5%87%89%E4%BA%AD'

# -*- coding: utf-8 -*-
import top.api

req=top.api.QimenAlitripBusOrderCreateRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.toCityName="青城山"
req.ticketCount=2
req.goodsId="964455ALD"
req.contactName="罗大佑"
req.alipayTradeNo="1223939393993939399339"
req.fromStationName="人民广场"
req.toStationCode="0245"
req.toStationName="青城山凉亭"
req.fromTime="23:00:00"
req.toCityCode="001"
req.fromStationCode="0224"
req.orderAmount=10000
req.passengerList="null"
req.scheduleId="2233333"
req.contactMobile="189113344343"
req.contactCertificateNo="212100198902171763"
req.contactCertificateType="1"
req.fromDate="2018-11-01"
req.fromCityCode="001"
req.fromCityName="成都"
req.seatGradeCode="SIT001"
req.seatGradeName="一等座"
req.ticketAmount=1000
req.alitripOrderId="23334040404"
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"qimen.alitrip.bus.order.create");
add_param(pRequest,"toCityName","青城山");
add_param(pRequest,"ticketCount","2");
add_param(pRequest,"goodsId","964455ALD");
add_param(pRequest,"contactName","罗大佑");
add_param(pRequest,"alipayTradeNo","1223939393993939399339");
add_param(pRequest,"fromStationName","人民广场");
add_param(pRequest,"toStationCode","0245");
add_param(pRequest,"toStationName","青城山凉亭");
add_param(pRequest,"fromTime","23:00:00");
add_param(pRequest,"toCityCode","001");
add_param(pRequest,"fromStationCode","0224");
add_param(pRequest,"orderAmount","10000");
add_param(pRequest,"passengerList","数据结构JSON示例");
add_param(pRequest,"scheduleId","2233333");
add_param(pRequest,"contactMobile","189113344343");
add_param(pRequest,"contactCertificateNo","212100198902171763");
add_param(pRequest,"contactCertificateType","1");
add_param(pRequest,"fromDate","2018-11-01");
add_param(pRequest,"fromCityCode","001");
add_param(pRequest,"fromCityName","成都");
add_param(pRequest,"seatGradeCode","SIT001");
add_param(pRequest,"seatGradeName","一等座");
add_param(pRequest,"ticketAmount","1000");
add_param(pRequest,"alitripOrderId","23334040404");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('qimen.alitrip.bus.order.create', {
	'toCityName':'青城山',
	'ticketCount':'2',
	'goodsId':'964455ALD',
	'contactName':'罗大佑',
	'alipayTradeNo':'1223939393993939399339',
	'fromStationName':'人民广场',
	'toStationCode':'0245',
	'toStationName':'青城山凉亭',
	'fromTime':'23:00:00',
	'toCityCode':'001',
	'fromStationCode':'0224',
	'orderAmount':'10000',
	'passengerList':'数据结构JSON示例',
	'scheduleId':'2233333',
	'contactMobile':'189113344343',
	'contactCertificateNo':'212100198902171763',
	'contactCertificateType':'1',
	'fromDate':'2018-11-01',
	'fromCityCode':'001',
	'fromCityName':'成都',
	'seatGradeCode':'SIT001',
	'seatGradeName':'一等座',
	'ticketAmount':'1000',
	'alitripOrderId':'23334040404'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

XML示例
JSON示例

<agentOrderId>2222</agentOrderId>
<success>true</success>
<alitripOrderId>22222</alitripOrderId>
<retCode>0</retCode>
<retDesc>成功</retDesc>

{
    "agentOrderId":"2222",
    "success":true,
    "alitripOrderId":"22222",
    "retCode":"0",
    "retDesc":"成功"
}

异常示例

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码解释

错误码	错误描述	解决方案

开放平台

综合交通-商家对接