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

qimen.alitrip.bus.order.confirm (订单确认(出票)接口)

创建订单(锁定座席)成功之后，调用订单出票接口，要求幂等。商家以agentOrderId或者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。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
agentOrderId	String	必须	22222		分销商订单Id
alitripOrderId	String	必须	33333		飞猪平台订单id

响应参数

名称	类型	示例值	描述
retDesc	String	成功	业务结果描述
statusDesc	String	出票成功	订单状态描述（是必填）
agentOrderId	String	13334099888	商家订单Id（是必填）
fetchTicketSpot	String	成都人民广场	取票地址
shipNumber	String	川A 88899	航班号
success	Boolean	true	业务结果状态
ticketWicket	String	检票口	检票口详细信息
smsContent	String	出票成功，恭喜您购票，请于2018-11-30日21:30:00准时乘车	短信
agentIssueTime	String	2018-11-29 21:00:00	出票成功时间（是必填）
alitripOrderId	String	3892200000033	飞猪订单id（是必填）
passengerList	Passenger []		乘客信息（是必填）
└ passengerName String 罗大佑乘客姓名（是必填） ticketList Ticket [] 票信息（是必填，list里有则填） └ ticketTitle String 公园门票票标题 └ ticketPwd String 223345 取票密码 └ ticketNo String 388888 票号 └ ticketSeatNo String 48 票座位号 └ ticketPrice Number 100 当前票价格(分) └ eTicketNo String 3333099 电子票码 └ ticketDesc String 当日使用票描述信息 └ ticketType String 1 票种1-船票;2-门票;3-酒店;4-其他（是必填） └ ticketSubType String 12 字符串11-去程;12-往返;21普通门票；31酒店（是必填） └ ticketId String 票id 必须填写用于后续区分唯一标识的票 └ ticketStatus String 1 票状态：1-出票中2-已出票3-无票4-退票中5-已退票6-退票失败 └ ticketExpireTime String 票过期时间 2019-12-20 09:30:00 └ passengerCertificateNo String 212100198902171763 乘客证件号（是必填） └ passengerCertificateType String 1 乘客证件类型（是必填） └ passengerId String 2903345 乘客id（是必填） └ passengerType String 乘客类型 0-普通乘客1-儿童票（是必填）
retCode	String	0	业务结果编码（是必填）
status	String	3	订单状态参考订单状态码（是必填）

请求示例

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

QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
AlitripBusOrderConfirmRequest req = new AlitripBusOrderConfirmRequest();
req.setAgentOrderId("22222");
req.setAlitripOrderId("33333");
AlitripBusOrderConfirmResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripBusOrderConfirmRequest req = new AlitripBusOrderConfirmRequest();
req.AgentOrderId = "22222";
req.AlitripOrderId = "33333";
AlitripBusOrderConfirmResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripBusOrderConfirmRequest;
$req->setAgentOrderId("22222");
$req->setAlitripOrderId("33333");
$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.confirm' \
-d 'partner_id=apidoc' \
-d 'sign=DB7383D33B3FD70F64FA31738790FB5B' \
-d 'sign_method=hmac' \
-d 'timestamp=2024-04-16+20%3A11%3A36' \
-d 'v=2.0' \
-d 'agentOrderId=22222' \
-d 'alitripOrderId=33333'

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

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

req.agentOrderId="22222"
req.alitripOrderId="33333"
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.confirm");
add_param(pRequest,"agentOrderId","22222");
add_param(pRequest,"alitripOrderId","33333");
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.confirm', {
	'agentOrderId':'22222',
	'alitripOrderId':'33333'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

XML示例
JSON示例

<retDesc>成功</retDesc>
<statusDesc>出票成功</statusDesc>
<agentOrderId>13334099888</agentOrderId>
<fetchTicketSpot>成都人民广场</fetchTicketSpot>
<shipNumber>川A 88899</shipNumber>
<success>true</success>
<ticketWicket>检票口</ticketWicket>
<smsContent>出票成功，恭喜您购票，请于2018-11-30日21:30:00准时乘车</smsContent>
<agentIssueTime>2018-11-29 21:00:00</agentIssueTime>
<alitripOrderId>3892200000033</alitripOrderId>
<passengerList>
    <passenger>
        <passengerName>罗大佑</passengerName>
        <ticketList>
            <ticket>
                <ticketTitle>公园门票</ticketTitle>
                <ticketPwd>223345</ticketPwd>
                <ticketNo>388888</ticketNo>
                <ticketSeatNo>48</ticketSeatNo>
                <ticketPrice>100</ticketPrice>
                <eTicketNo>3333099</eTicketNo>
                <ticketDesc>当日使用</ticketDesc>
                <ticketType>1</ticketType>
                <ticketSubType>12</ticketSubType>
                <ticketId>票id</ticketId>
                <ticketStatus>1</ticketStatus>
                <ticketExpireTime>票过期时间</ticketExpireTime>
            </ticket>
        </ticketList>
        <passengerCertificateNo>212100198902171763</passengerCertificateNo>
        <passengerCertificateType>1</passengerCertificateType>
        <passengerId>2903345</passengerId>
        <passengerType>乘客类型</passengerType>
    </passenger>
</passengerList>
<retCode>0</retCode>
<status>3</status>

{
    "retDesc":"成功",
    "statusDesc":"出票成功",
    "agentOrderId":"13334099888",
    "fetchTicketSpot":"成都人民广场",
    "shipNumber":"川A 88899",
    "success":true,
    "ticketWicket":"检票口",
    "smsContent":"出票成功，恭喜您购票，请于2018-11-30日21:30:00准时乘车",
    "agentIssueTime":"2018-11-29 21:00:00",
    "alitripOrderId":"3892200000033",
    "passengerList":{
        "passenger":[
            {
                "passengerName":"罗大佑",
                "ticketList":{
                    "ticket":[
                        {
                            "ticketTitle":"公园门票",
                            "ticketPwd":"223345",
                            "ticketNo":"388888",
                            "ticketSeatNo":"48",
                            "ticketPrice":100,
                            "eTicketNo":"3333099",
                            "ticketDesc":"当日使用",
                            "ticketType":"1",
                            "ticketSubType":"12",
                            "ticketId":"票id",
                            "ticketStatus":"1",
                            "ticketExpireTime":"票过期时间"
                        }
                    ]
                },
                "passengerCertificateNo":"212100198902171763",
                "passengerCertificateType":"1",
                "passengerId":"2903345",
                "passengerType":"乘客类型"
            }
        ]
    },
    "retCode":"0",
    "status":"3"
}

异常示例

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

错误码解释

错误码	错误描述	解决方案

开放平台

综合交通-商家对接

qimen.alitrip.bus.order.confirm (订单确认(出票)接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ