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

qimen.alitrip.custombus.order.confirm (定制巴士订单确认(出票)接口)

汽车票定制巴士-订单确认(出票)接口

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
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。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
agentOrderId	String	必须	1234567		商家订单id
alitripOrderId	String	必须	3345678		飞猪平台订单id

响应参数

名称	类型	示例值	描述
retCode	String	0	业务结果编码（是必填）
retDesc	String	成功	业务状态结果描述（是必填）
success	Boolean	true	业务结果（是必填）
alitripOrderId	String	1233445	飞猪订单id（是必填）
agentOrderId	String	13334099888	商家订单Id（是必填）
agentIssueTime	String	2018-11-29 21:00:00	业务成功时间（是必填）
status	String	3	订单状态，参考订单状态编码（是必填），1:下单未付款;2:已付款;3:出票成功;4:订单关闭;5:订单取消;9:退款订单;11:退款成功
statusDesc	String	出票成功	订单状态描述
fetchTicketSpot	String	成都人民广场	取票地址信息
ticketWicket	String	检票口	检票口
smsContent	String	出票成功，恭喜您购票，请于2018-11-30日21:30:00准时乘车	短信内容,商家如有特殊定制，则需要严格按照参数返回json格式数据。{"driverContactPhone":"18611330989","identificationCode","988838389","ticketInstructions":"套票使用说明"} driverContactPhone:司机联系电话 identificationCode:乘车验证码 ticketInstructions:门票使用说明（仅供门票+车票类型商品使用，非必填，默认为“凭身份证入园”）
passengerList	PassengerList []		乘客信息（list必填）
└ passengerName String 罗大佑乘客姓名（是必填） └ passengerType String 乘客类型 0-普通乘客1-儿童票（是必填） └ passengerCertificateNo String 212100198902171763 乘客证件号（是必填） └ passengerCertificateType String 1 乘客证件类型（是必填） └ passengerId String 28499930 乘客id（是必填） ticketList TicketList [] 票信息（是必填，有填写） └ ticketId String 334k 票Id,必须填写用于后续区分唯一标识的票（必填） └ ticketPrice Number 330 票价 └ ticketNo String 388888 票号 └ ticketPwd String 223345 取票密码（选填） └ ticketStatus String 票状态票状态：1-出票中2-已出票3-无票4-退票中5-已退票6-退票失败（选填） └ ticketSubType String 12 子票种类型11-去程;12-往返;21普通门票；31酒店（选填） └ ticketSeatNo String 48 坐席号 └ ticketType String 1 票种类别1-旅游巴士汽车票;2-门票;3-酒店;4-其他（选填） └ ticketDesc String 请准时到达指定地点票描述（选填） └ ticketTitle String 船票等票标题（选填） └ eTicketNo String 3333099 电子票号 └ ticketExpireTime String 2019-12-20 09:30:00 过期时间

请求示例

{"agentOrderId":"1234567","alitripOrderId":"3345678"}

响应示例

{
    "retCode":"0",
    "retDesc":"成功",
    "success":true,
    "alitripOrderId":"1233445",
    "agentOrderId":"13334099888",
    "agentIssueTime":"2018-11-29 21:00:00",
    "status":"3",
    "statusDesc":"出票成功",
    "fetchTicketSpot":"成都人民广场",
    "ticketWicket":"检票口",
    "smsContent":"出票成功，恭喜您购票，请于2018-11-30日21:30:00准时乘车",
    "passengerList":[
        {
                "passengerName":"罗大佑",
                "passengerType":"乘客类型",
                "passengerCertificateNo":"212100198902171763",
                "passengerCertificateType":"1",
                "passengerId":"28499930",
                "ticketList":[
                    {
                            "ticketId":"334k",
                            "ticketPrice":330,
                            "ticketNo":"388888",
                            "ticketPwd":"223345",
                            "ticketStatus":"票状态",
                            "ticketSubType":"12",
                            "ticketSeatNo":"48",
                            "ticketType":"1",
                            "ticketDesc":"请准时到达指定地点",
                            "ticketTitle":"船票等",
                            "eTicketNo":"3333099",
                            "ticketExpireTime":"2019-12-20 09:30:00"
                    }
                ]
        }
    ]
}

验签示例

{"retDesc":"Illegal request","success":"false","retCode":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

汽车票API

qimen.alitrip.custombus.order.confirm (定制巴士订单确认(出票)接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ