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

qimen.alitrip.bus.order.query (查询订单接口)

根据飞猪旅行订单号alitripOrderId和代理商订单agentOrderId查询订单的所有信息。包括正向的出票结果和逆向的退票结果。

公共参数

请求地址：

环境	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	必须	22333333		商家订单Id
alitripOrderId	String	必须	33333334444		飞猪订单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准时乘车	短信内容,商家如有特殊定制，则需要严格按照参数返回json格式数据。{"driverContactPhone":"18611330989","identificationCode","988838389","ticketInstructions":"套票使用说明"} driverContactPhone:司机联系电话 identificationCode:乘车验证码 ticketInstructions:门票使用说明（仅供门票+车票类型商品使用，非必填，默认为“凭身份证入园”）
agentIssueTime	String	2018-11-29 21:00:00	业务成功时间（是必填）
alitripOrderId	String	3892200000033	飞猪订单id（是必填）
passengerList	Passenger []		乘客信息（list必填）
└ passengerName String 罗大佑乘客姓名（是必填） ticketList Ticket [] 票信息（是必填，有填写） └ ticketPwd String 223345 取票密码（选填） └ ticketNo String 388888 票号 └ ticketSeatNo String 48 坐席号 └ eTicketNo String 3333099 电子票号 └ ticketType String 1 票种类别1-旅游巴士汽车票;2-门票;3-酒店;4-其他（选填） └ ticketSubType String 12 子票种类型11-去程;12-往返;21普通门票；31酒店（选填） └ ticketId String 334k 票Id,必须填写用于后续区分唯一标识的票（必填） └ ticketStatus String 票状态票状态：1-出票中2-已出票3-无票4-退票中5-已退票6-退票失败（选填） └ ticketRefundSurcharge Number 200 退票手续费，如果票状态是已退票，需要进行填写 └ ticketExpireTime String 过期时间 2019-12-20 09:30:00 └ ticketPrice Number 330 票价 └ ticketTitle String 船票等票标题（选填） └ ticketDesc String 请准时到达指定地点票描述（选填） └ passengerCertificateNo String 212100198902171763 乘客证件号（是必填） └ passengerCertificateType String 1 乘客证件类型（是必填） └ passengerId String 28499930 乘客id（是必填） └ passengerType String 乘客类型 0-普通乘客1-儿童票（是必填）
retCode	String	0	业务结果编码（是必填）
status	String	3	订单状态，参考订单状态编码（是必填）
bookFaildCode	String	1102	订单状态为关闭状态时，返回错误码。1102:班次停运，1104:余票不足，1114：查询不到班次，1401：班次信息有误，不能下单
bookFaildMsg	String	班次停运	参考code说明中的文案

请求示例

{"agentOrderId":"22333333","alitripOrderId":"33333334444"}

响应示例

{
    "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":[
        {
                "passengerName":"罗大佑",
                "ticketList":[
                    {
                            "ticketPwd":"223345",
                            "ticketNo":"388888",
                            "ticketSeatNo":"48",
                            "eTicketNo":"3333099",
                            "ticketType":"1",
                            "ticketSubType":"12",
                            "ticketId":"334k",
                            "ticketStatus":"票状态",
                            "ticketRefundSurcharge":200,
                            "ticketExpireTime":"过期时间",
                            "ticketPrice":330,
                            "ticketTitle":"船票等",
                            "ticketDesc":"请准时到达指定地点"
                    }
                ],
                "passengerCertificateNo":"212100198902171763",
                "passengerCertificateType":"1",
                "passengerId":"28499930",
                "passengerType":"乘客类型"
        }
    ],
    "retCode":"0",
    "status":"3",
    "bookFaildCode":"1102",
    "bookFaildMsg":"班次停运"
}

验签示例

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

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

汽车票API

qimen.alitrip.bus.order.query (查询订单接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ