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

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
to_city_name String 必须 青城山 到达城市
ticket_count Number 必须 2 车票数量
goods_id String 必须 964455ALD 商品id列表
contact_name String 必须 罗大佑 联系人姓名
alipay_trade_no String 必须 1223939393993939399339 支付宝交易流水号
from_station_name String 可选 人民广场 出发港口名称
to_station_code String 可选 0245 到达港口编码
to_station_name String 可选 青城山凉亭 到达港口名称
from_time String 必须 23:00:00 出发时间
to_city_code String 可选 001 到达城市编码
from_station_code String 可选 0224 出发港口编码
order_amount Number 必须 10000 订单价格(单位分)
passenger_list Passenger [] 可选
  • 最大列表长度:999999
  • 乘客列表
    • └ passenger_name
    • String
    • 必须
    • 罗大佑
    • 乘客姓名
    • └ ticket_price
    • Number
    • 必须
    • 2500
    • 票价(单位分)
    • └ passenger_certificate_no
    • String
    • 必须
    • 212100198902171763
    • 证件编码
    • └ passenger_certificate_type
    • String
    • 必须
    • 01
    • 证件类型:参考证件类型说明
    • └ passenger_type
    • String
    • 必须
    • 0
    • 乘客类型:参考乘客类型说明
    • └ ticket_commission
    • Number
    • 可选
    • 100
    • 服务费(单位分)
    • └ passenger_id
    • String
    • 可选
    • 33499
    • 乘客ID
    • └ passenger_spell
    • String
    • 可选
    • Zhang/San
    • 乘客姓名拼音
    • └ birth_day
    • String
    • 可选
    • 1990-01-01
    • 乘客生日
    • └ visa_date
    • String
    • 可选
    • 签证有效期
    • 2050-09-23
    • └ price_type_id
    • String
    • 可选
    • 3333ffd3333
    • 价格Id唯一标识,部分商家使用
    schedule_id String 可选 2233333 航班id
    contact_mobile String 必须 189113344343 联系人电话
    contact_certificate_no String 必须 212100198902171763 联系人证件号
    contact_certificate_type String 必须 1 联系人证件类型
    from_date String 必须 2018-11-01 出发日期
    from_city_code String 可选 001 出发城市编码
    from_city_name String 可选 成都 出发城市名称
    seat_grade_code String 可选 SIT001 舱位等级代码
    seat_grade_name String 可选 一等座 舱位等级名称
    ticket_amount Number 必须 1000 票总金额(单位分)
    extAttr String 可选 {"param","param"} 扩展属性
    alitrip_order_id String 必须 2385464071101 飞猪平台订单id

    响应参数

    名称 类型 示例值 描述
    agent_order_id String 2222 商家订单id
    success Boolean true 业务是否成功
    alitrip_order_id String 22222 飞猪平台订单id
    ret_code String 0 业务结果编码
    ret_desc String 成功 业务结果描述

    请求示例

    {"from_station_name":"人民广场","alitrip_order_id":"2385464071101","from_city_code":"001","from_time":"23:00:00","to_city_code":"001","seat_grade_name":"一等座","seat_grade_code":"SIT001","to_station_code":"0245","order_amount":10000,"passenger_list":[{"birth_day":"1990-01-01","price_type_id":"3333ffd3333","passenger_certificate_no":"212100198902171763","ticket_commission":100,"ticket_price":2500,"passenger_spell":"Zhang/San","passenger_id":"33499","passenger_certificate_type":"01","passenger_name":"罗大佑","visa_date":"签证有效期","passenger_type":"0"}],"contact_name":"罗大佑","alipay_trade_no":"1223939393993939399339","from_date":"2018-11-01","ticket_count":2,"from_city_name":"成都","goods_id":"964455ALD","from_station_code":"0224","to_city_name":"青城山","extAttr":"{\"param\",\"param\"}","to_station_name":"青城山凉亭","contact_certificate_type":"1","contact_mobile":"189113344343","ticket_amount":1000,"schedule_id":"2233333","contact_certificate_no":"212100198902171763"}

    响应示例

    {
        "agent_order_id":"2222",
        "success":true,
        "alitrip_order_id":"22222",
        "ret_code":"0",
        "ret_desc":"成功"
    }

    验签示例

    {"success":"false","ret_desc":"Illegal request","ret_code":"sign-check-failure"}

    错误码解释

    错误码 错误描述 解决方案

    API工具

    FAQ

    返回
    顶部