淘宝开放平台

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

汽车票API

qimen.alitrip.bus.order.create (创建订单(锁单坐席)接口)

创建订单(锁定坐席)接口。根据航线id，出发日期、出发到达港口等信息下单，返回订单号，本接口的主要目的是锁定坐席，一个订单号可以对应多张票。下单接口需要根据飞猪订单号(alitripOrderId)幂等。即相同的alitripOrderId第二次调用后，返回相同的订单详情结果。相同的alitripOrderId请求报文不会改变。同时商家要对订单总价格、出发时间、出发和到达港口等关键数据进行逻辑校验。失败时，请严格按照错误码进行返回。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
toCityName String 必须 青城山 到达城市
ticketCount Number 必须 2 车票数量
goodsId String 必须 964455ALD 商品id列表
contactName String 必须 罗大佑 联系人姓名
alipayTradeNo String 必须 1223939393993939399339 支付宝交易流水号
fromStationName String 可选 人民广场 出发港口名称
toStationCode String 可选 0245 到达港口编码
toStationName String 可选 青城山凉亭 到达港口名称
fromTime String 必须 23:00:00 出发时间
toCityCode String 可选 001 到达城市编码
fromStationCode String 可选 0224 出发港口编码
orderAmount Number 必须 10000 订单价格(单位分)
passengerList Passenger [] 可选
  • 最大列表长度：999999
    		•  乘客列表
    • └ passengerName
    • String
    • 必须
    • 罗大佑
    • 乘客姓名
    • └ ticketPrice
    • Number
    • 必须
    • 2500
    • 票价(单位分)
    • └ passengerCertificateNo
    • String
    • 必须
    • 212100198902171763
    • 证件编码
    • └ passengerCertificateType
    • String
    • 必须
    • 1
    • 证件类型
    • └ passengerType
    • String
    • 必须
    • 1
    • 乘客类型:1-成人;2-儿童
    • └ ticketCommission
    • Number
    • 可选
    • 100
    • 服务费(单位分)
    • └ passengerId
    • String
    • 必须
    • 33499
    • 乘客ID
    • └ passengerSpell
    • String
    • 可选
    • Zhang/San
    • 乘客姓名拼音
    • └ birthDay
    • String
    • 可选
    • 1990-01-01
    • 乘客生日
    • └ visaDate
    • String
    • 可选
    • 签证有效期
    • 2050-09-23
    scheduleId String 可选 2233333 航班id
    contactMobile String 必须 189113344343 联系人电话
    contactCertificateNo String 必须 212100198902171763 联系人证件号
    contactCertificateType String 必须 1 联系人证件类型
    fromDate String 必须 2018-11-01 出发日期
    fromCityCode String 可选 001 出发城市编码
    fromCityName String 可选 成都 出发城市名称
    seatGradeCode String 可选 SIT001 舱位等级代码
    seatGradeName String 可选 一等座 舱位等级名称
    ticketAmount Number 必须 1000 票总金额(单位分)
    alitripOrderId String 必须 23334040404 飞猪平台订单id

    响应参数

    名称 类型 示例值 描述
    agentOrderId String 2222 商家订单id（是必填）
    success Boolean true 业务是否成功（是必填）
    alitripOrderId String 22222 飞猪平台订单id（是必填）
    retCode String 0 业务结果编码（是必填）
    retDesc String 成功 业务结果描述（是必填）

    请求示例

    {"toCityName":"青城山","contactMobile":"189113344343","ticketCount":2,"goodsId":"964455ALD","contactName":"罗大佑","alipayTradeNo":"1223939393993939399339","fromStationName":"人民广场","contactCertificateType":"1","toStationCode":"0245","contactCertificateNo":"212100198902171763","seatGradeName":"一等座","seatGradeCode":"SIT001","toStationName":"青城山凉亭","fromDate":"2018-11-01","fromCityCode":"001","ticketAmount":1000,"orderAmount":10000,"fromTime":"23:00:00","toCityCode":"001","fromCityName":"成都","fromStationCode":"0224","passengerList":[{"passengerName":"罗大佑","birthDay":"1990-01-01","visaDate":"签证有效期","passengerType":"1","ticketPrice":2500,"passengerCertificateNo":"212100198902171763","passengerCertificateType":"1","passengerId":"33499","passengerSpell":"Zhang/San","ticketCommission":100}],"alitripOrderId":"23334040404","scheduleId":"2233333"}

    响应示例

    {
    "agentOrderId":"2222",
    "success":true,
    "alitripOrderId":"22222",
    "retCode":"0",
    "retDesc":"成功"
}

    验签示例

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

    错误码解释

    错误码 错误描述 解决方案

    API工具

    错误码查询工具 SDK下载

    FAQ

    有用( 0 ) 我要提问
    返回
    顶部