淘宝开放平台 - 文档中心

请求地址：

环境	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	业务成功时间（是必填）
statusDesc	String	出票成功	订单状态描述
status	String	3	订单状态，参考订单状态编码（是必填）,1:下单未付款;2:已付款;3:出票成功;4:订单关闭;5:订单取消;9:退款订单;11:退款成功
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 罗大佑乘客姓名（是必填） ticketList TicketList [] 票信息（是必填，有填写） └ ticketPrice Number 330 票价 └ ticketType String 1 票种类别1-旅游巴士汽车票;2-门票;3-酒店;4-其他（选填） └ ticketSubType String 12 子票种类型11-去程;12-往返;21普通门票；31酒店（选填） └ ticketPwd String 223345 取票密码（选填） └ ticketNo String 388888 票号 └ ticketStatus String 票状态票状态：1-出票中2-已出票3-无票4-退票中5-已退票6-退票失败（选填） └ ticketSeatNo String 48 坐席号 └ ticketTitle String 船票等票标题（选填） └ ticketRefundSurcharge Number 200 退票手续费，如果票状态是已退票，需要进行填写 └ eTicketNo String 3333099 电子票号 └ ticketExpireTime String 2019-12-20 09:30:00 过期时间 └ ticketDesc String 请准时到达指定地点票描述（选填） └ ticketId String 334k 票Id,必须填写用于后续区分唯一标识的票（必填） └ passengerType String 乘客类型 0-普通乘客1-儿童票（是必填） └ passengerCertificateNo String 212100198902171763 乘客证件号（是必填） └ passengerCertificateType String 1 乘客证件类型（是必填）01身份证02护照03港澳通行证04太晚通行证05港澳往返内地通行证06台湾往返内地通行证07港澳居民居住证 └ passengerId String 28499930 乘客id（是必填）(数字类型)
isRefund	Boolean	true	退票是否需要退款（若已线下退款则为false）
scheduleInfo	BusScheduleInfo		运行班次信息
└ driverName String 王师傅司机姓名 └ driverPhone String 18790908765 司机电话 └ licensePlateNumber String 京A.839383 车牌号 └ vehicleBrands String 金龙车辆品牌 └ motorcycleType String 大型巴士、商务车车型,大型巴士、商务车等
bookFaildCode	String	1102	订单状态为关闭状态时，返回错误码。1102:班次停运，1104:余票不足，1114：查询不到班次，1401：班次信息有误，不能下单
bookFaildMsg	String	班次停运	参考bookFaildCode中的文案说明

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

{
    "retCode":"0",
    "retDesc":"成功",
    "success":true,
    "alitripOrderId":"1233445",
    "agentOrderId":"13334099888",
    "agentIssueTime":"2018-11-29 21:00:00",
    "statusDesc":"出票成功",
    "status":"3",
    "fetchTicketSpot":"成都人民广场",
    "ticketWicket":"检票口",
    "smsContent":"出票成功，恭喜您购票，请于2018-11-30日21:30:00准时乘车",
    "passengerList":[
        {
                "passengerName":"罗大佑",
                "ticketList":[
                    {
                            "ticketPrice":330,
                            "ticketType":"1",
                            "ticketSubType":"12",
                            "ticketPwd":"223345",
                            "ticketNo":"388888",
                            "ticketStatus":"票状态",
                            "ticketSeatNo":"48",
                            "ticketTitle":"船票等",
                            "ticketRefundSurcharge":200,
                            "eTicketNo":"3333099",
                            "ticketExpireTime":"2019-12-20 09:30:00",
                            "ticketDesc":"请准时到达指定地点",
                            "ticketId":"334k"
                    }
                ],
                "passengerType":"乘客类型",
                "passengerCertificateNo":"212100198902171763",
                "passengerCertificateType":"1",
                "passengerId":"28499930"
        }
    ],
    "isRefund":true,
    "scheduleInfo":{
        "driverName":"王师傅",
        "driverPhone":"18790908765",
        "licensePlateNumber":"京A.839383",
        "vehicleBrands":"金龙",
        "motorcycleType":"大型巴士、商务车"
    },
    "bookFaildCode":"1102",
    "bookFaildMsg":"班次停运"
}

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

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

汽车票API

qimen.alitrip.custombus.orderdetail.query (定制巴士查询订单详情)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ