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

qimen.alitrip.ship.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。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
to_city_name	String	必须	青城山		到达城市
ticket_count	Number	必须	2		车票数量
goods_id	String	必须	964455ALD		商品id列表
contact_name	String	必须	罗大佑		联系人姓名
alipay_trade_no	String	必须	1223939393993939399339		支付宝交易流水号
from_station_name	String	可选	人民广场		出发港口名称
to_station_code	String	可选	0245		到达港口编码
to_station_name	String	可选	青城山凉亭		到达港口名称
from_time	String	必须	23:00:00		出发时间
to_city_code	String	可选	001		到达城市编码
from_station_code	String	可选	0224		出发港口编码
order_amount	Number	必须	10000		订单价格(单位分)
passenger_list	Passenger []	可选		最大列表长度：999999	乘客列表
└ passenger_name String 必须罗大佑乘客姓名 └ ticket_price Number 必须 2500 票价(单位分) └ passenger_certificate_no String 必须 212100198902171763 证件编码 └ passenger_certificate_type String 必须 01 证件类型:参考证件类型说明 └ passenger_type String 必须 0 乘客类型:参考乘客类型说明 └ ticket_commission Number 可选 100 服务费(单位分) └ passenger_id String 可选 33499 乘客ID └ passenger_spell String 可选 Zhang/San 乘客姓名拼音 └ birth_day String 可选 1990-01-01 乘客生日 └ visa_date String 可选签证有效期 2050-09-23 └ price_type_id String 可选 3333ffd3333 价格Id唯一标识,部分商家使用
schedule_id	String	可选	2233333		航班id
contact_mobile	String	必须	189113344343		联系人电话
contact_certificate_no	String	必须	212100198902171763		联系人证件号
contact_certificate_type	String	必须	1		联系人证件类型
from_date	String	必须	2018-11-01		出发日期
from_city_code	String	可选	001		出发城市编码
from_city_name	String	可选	成都		出发城市名称
seat_grade_code	String	可选	SIT001		舱位等级代码
seat_grade_name	String	可选	一等座		舱位等级名称
ticket_amount	Number	必须	1000		票总金额(单位分)
extAttr	String	可选	{"param","param"}		扩展属性
alitrip_order_id	String	必须	2385464071101		飞猪平台订单id

响应参数

名称	类型	示例值	描述
agent_order_id	String	2222	商家订单id
success	Boolean	true	业务是否成功
alitrip_order_id	String	22222	飞猪平台订单id
ret_code	String	0	业务结果编码
ret_desc	String	成功	业务结果描述

请求示例

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

QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
AlitripShipOrderCreateRequest req = new AlitripShipOrderCreateRequest();
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<AlitripShipOrderCreateRequest.Passenger> list2 = new ArrayList<AlitripShipOrderCreateRequest.Passenger>();
AlitripShipOrderCreateRequest.Passenger obj3 = new AlitripShipOrderCreateRequest.Passenger();
list2.add(obj3);
obj3.setPassengerName("罗大佑");
obj3.setTicketPrice(2500L);
obj3.setPassengerCertificateNo("212100198902171763");
obj3.setPassengerCertificateType("01");
obj3.setPassengerType("0");
obj3.setTicketCommission(100L);
obj3.setPassengerId("33499");
obj3.setPassengerSpell("Zhang/San");
obj3.setBirthDay("1990-01-01");
obj3.setVisaDate("签证有效期");
obj3.setPriceTypeId("3333ffd3333");
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.setExtAttr("{\"param\",\"param\"}");
req.setAlitripOrderId("2385464071101");
AlitripShipOrderCreateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripShipOrderCreateRequest req = new AlitripShipOrderCreateRequest();
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<AlitripShipOrderCreateRequest.PassengerDomain> list2 = new List<AlitripShipOrderCreateRequest.PassengerDomain>();
AlitripShipOrderCreateRequest.PassengerDomain obj3 = new AlitripShipOrderCreateRequest.PassengerDomain();
list2.Add(obj3);
obj3.PassengerName = "罗大佑";
obj3.TicketPrice = 2500L;
obj3.PassengerCertificateNo = "212100198902171763";
obj3.PassengerCertificateType = "01";
obj3.PassengerType = "0";
obj3.TicketCommission = 100L;
obj3.PassengerId = "33499";
obj3.PassengerSpell = "Zhang/San";
obj3.BirthDay = "1990-01-01";
obj3.VisaDate = "签证有效期";
obj3.PriceTypeId = "3333ffd3333";
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.ExtAttr = "{\"param\",\"param\"}";
req.AlitripOrderId = "2385464071101";
AlitripShipOrderCreateResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripShipOrderCreateRequest;
$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");
$passenger_list = new Passenger;
$passenger_list->passenger_name="罗大佑";
$passenger_list->ticket_price="2500";
$passenger_list->passenger_certificate_no="212100198902171763";
$passenger_list->passenger_certificate_type="01";
$passenger_list->passenger_type="0";
$passenger_list->ticket_commission="100";
$passenger_list->passenger_id="33499";
$passenger_list->passenger_spell="Zhang/San";
$passenger_list->birth_day="1990-01-01";
$passenger_list->visa_date="签证有效期";
$passenger_list->price_type_id="3333ffd3333";
$req->setPassengerList(json_encode($passenger_list));
$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->setExtAttr("{\"param\",\"param\"}");
$req->setAlitripOrderId("2385464071101");
$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.ship.order.create' \
-d 'partner_id=apidoc' \
-d 'sign=F756C7482822E8603953E84AF0D246AB' \
-d 'sign_method=hmac' \
-d 'timestamp=2024-04-20+03%3A47%3A05' \
-d 'v=2.0' \
-d 'alipay_trade_no=1223939393993939399339' \
-d 'alitrip_order_id=2385464071101' \
-d 'contact_certificate_no=212100198902171763' \
-d 'contact_certificate_type=1' \
-d 'contact_mobile=189113344343' \
-d 'contact_name=%E7%BD%97%E5%A4%A7%E4%BD%91' \
-d 'extAttr=%7B%5C%22param%5C%22%2C%5C%22param%5C%22%7D' \
-d 'from_city_code=001' \
-d 'from_city_name=%E6%88%90%E9%83%BD' \
-d 'from_date=2018-11-01' \
-d 'from_station_code=0224' \
-d 'from_station_name=%E4%BA%BA%E6%B0%91%E5%B9%BF%E5%9C%BA' \
-d 'from_time=23%3A00%3A00' \
-d 'goods_id=964455ALD' \
-d 'order_amount=10000' \
-d 'passenger_list=null' \
-d 'schedule_id=2233333' \
-d 'seat_grade_code=SIT001' \
-d 'seat_grade_name=%E4%B8%80%E7%AD%89%E5%BA%A7' \
-d 'ticket_amount=1000' \
-d 'ticket_count=2' \
-d 'to_city_code=001' \
-d 'to_city_name=%E9%9D%92%E5%9F%8E%E5%B1%B1' \
-d 'to_station_code=0245' \
-d 'to_station_name=%E9%9D%92%E5%9F%8E%E5%B1%B1%E5%87%89%E4%BA%AD'

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

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

req.to_city_name="青城山"
req.ticket_count=2
req.goods_id="964455ALD"
req.contact_name="罗大佑"
req.alipay_trade_no="1223939393993939399339"
req.from_station_name="人民广场"
req.to_station_code="0245"
req.to_station_name="青城山凉亭"
req.from_time="23:00:00"
req.to_city_code="001"
req.from_station_code="0224"
req.order_amount=10000
req.passenger_list="null"
req.schedule_id="2233333"
req.contact_mobile="189113344343"
req.contact_certificate_no="212100198902171763"
req.contact_certificate_type="1"
req.from_date="2018-11-01"
req.from_city_code="001"
req.from_city_name="成都"
req.seat_grade_code="SIT001"
req.seat_grade_name="一等座"
req.ticket_amount=1000
req.extAttr="{\"param\",\"param\"}"
req.alitrip_order_id="2385464071101"
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.ship.order.create");
add_param(pRequest,"to_city_name","青城山");
add_param(pRequest,"ticket_count","2");
add_param(pRequest,"goods_id","964455ALD");
add_param(pRequest,"contact_name","罗大佑");
add_param(pRequest,"alipay_trade_no","1223939393993939399339");
add_param(pRequest,"from_station_name","人民广场");
add_param(pRequest,"to_station_code","0245");
add_param(pRequest,"to_station_name","青城山凉亭");
add_param(pRequest,"from_time","23:00:00");
add_param(pRequest,"to_city_code","001");
add_param(pRequest,"from_station_code","0224");
add_param(pRequest,"order_amount","10000");
add_param(pRequest,"passenger_list","数据结构JSON示例");
add_param(pRequest,"schedule_id","2233333");
add_param(pRequest,"contact_mobile","189113344343");
add_param(pRequest,"contact_certificate_no","212100198902171763");
add_param(pRequest,"contact_certificate_type","1");
add_param(pRequest,"from_date","2018-11-01");
add_param(pRequest,"from_city_code","001");
add_param(pRequest,"from_city_name","成都");
add_param(pRequest,"seat_grade_code","SIT001");
add_param(pRequest,"seat_grade_name","一等座");
add_param(pRequest,"ticket_amount","1000");
add_param(pRequest,"extAttr","{\"param\",\"param\"}");
add_param(pRequest,"alitrip_order_id","2385464071101");
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.ship.order.create', {
	'to_city_name':'青城山',
	'ticket_count':'2',
	'goods_id':'964455ALD',
	'contact_name':'罗大佑',
	'alipay_trade_no':'1223939393993939399339',
	'from_station_name':'人民广场',
	'to_station_code':'0245',
	'to_station_name':'青城山凉亭',
	'from_time':'23:00:00',
	'to_city_code':'001',
	'from_station_code':'0224',
	'order_amount':'10000',
	'passenger_list':'数据结构JSON示例',
	'schedule_id':'2233333',
	'contact_mobile':'189113344343',
	'contact_certificate_no':'212100198902171763',
	'contact_certificate_type':'1',
	'from_date':'2018-11-01',
	'from_city_code':'001',
	'from_city_name':'成都',
	'seat_grade_code':'SIT001',
	'seat_grade_name':'一等座',
	'ticket_amount':'1000',
	'extAttr':'{\"param\",\"param\"}',
	'alitrip_order_id':'2385464071101'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

XML示例
JSON示例

<agent_order_id>2222</agent_order_id>
<success>true</success>
<alitrip_order_id>22222</alitrip_order_id>
<ret_code>0</ret_code>
<ret_desc>成功</ret_desc>

{
    "agent_order_id":"2222",
    "success":true,
    "alitrip_order_id":"22222",
    "ret_code":"0",
    "ret_desc":"成功"
}

异常示例

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"
	}
}

错误码解释

错误码	错误描述	解决方案

开放平台

综合交通-商家对接