文档中心 > 综合交通-商家对接

qimen.alitrip.ship.product.querynumber (查询班次接口)

查询班次

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
to_station_code String 可选 S001 到达港口编码
from_city_code String 可选 C001 出发城市编码
from_city_name String 可选 北京 出发城市名称
to_station_name String 可选 古北水镇 到达港口名称
depart_date String 可选 2018-08-80 出发日期

响应参数

名称 类型 示例值 描述
ret_desc String 成功 错误描述
ship_number_list ShipNumber [] 班次列表
  • └ presell_time
  • String
  • 120
  • 班次发车前可售时间
  • └ from_longitude
  • String
  • 105.469673
  • 出发地经度
  • └ distance
  • String
  • 380
  • 里程
  • └ refund_msg
  • String
  • 本产品可在线退票,退票手续费3元
  • 退票提示文案
  • └ from_station_name
  • String
  • 六里桥
  • 上车点名称
  • └ dest_longitude
  • String
  • 100.12456004
  • 目的地经度
  • └ to_station_code
  • String
  • 111
  • 下车点区域code
  • └ service_info
  • String
  • 服务说明,温馨提示
  • 服务须知
  • parking_points
  • ParkingPoints []
  • 游玩点
  • └ parkingMinutes
  • Number
  • 60
  • 游玩时间
  • └ name
  • String
  • 卧佛寺
  • 游玩点名称
  • └ desc
  • String
  • 植物园停车游玩一小时
  • 游玩点详细说明
  • └ is_order_refund
  • String
  • 1
  • 是否按照整个订单退款
  • └ dest_latitude
  • String
  • 25.12456004
  • 目的地维度
  • └ to_province_name
  • String
  • 北京市
  • 下车点所属省份
  • obtain_ticket
  • ObtainTicket
  • 取票信息
  • └ obtain_voucher
  • String
  • 凭预订短信验证码取票
  • 取票凭证描述
  • └ address
  • String
  • 四惠汽车站对面
  • 取票详细地址
  • └ latitude
  • String
  • 100.12456004
  • 取票地址纬度
  • └ invoice
  • Boolean
  • true
  • 是否可以作为发票凭证
  • └ longitude
  • String
  • 25.62456004
  • 取票地址经度
  • └ ticket_tel
  • String
  • 4000535411
  • 取票电话
  • └ arrive_time
  • String
  • 2018-11-30 11:30
  • 到达时间
  • └ refund_type
  • String
  • 1
  • 退票类型1:在线退票 2:不可在线退票 3:不可退票
  • └ fromLatitude
  • String
  • 32.433114
  • 出发地维度
  • └ last_schedule
  • String
  • 18:00
  • 最晚发车时间 mm:ss 流水班返回
  • └ from_city_name
  • String
  • 北京
  • 上车点城市名称
  • └ ship_type
  • String
  • 普通客船/大型高速客船/高级游轮等
  • 航线类型
  • └ schedule_id
  • String
  • A1K001_AP6A6A70_2366_201811301520
  • 班次id
  • └ stationId
  • String
  • A0001
  • stationId
  • └ to_city_name
  • String
  • 北京
  • 下车点归属城市
  • └ depart_time
  • String
  • 2018-11-30 05:00
  • 发车时间
  • └ shift_type
  • String
  • 1
  • 班次类型0:固定班 1:流水班2:加班班次
  • └ refund_time
  • String
  • 30
  • 发车前允许退票时间,分钟。发车前允许退票时间,分钟
  • number_goods
  • NumberGoods []
  • 商品goods
  • └ goods_id
  • String
  • 0001
  • 商品id(舱位类型)
  • └ stock
  • String
  • 38
  • 总库存
  • └ goods_name
  • String
  • 三等B
  • 商品名称
  • └ goods_desc
  • String
  • 8人间
  • 商品描述
  • └ goods_url
  • String
  • http
  • 商品图片
  • price_types
  • PriceTypes []
  • 价格类型
  • └ price_type_rule
  • String
  • 儿童票身高1.1.2-1.5米(不含1.5米)之间的儿童可至港口购买儿童票,超过1.5米请购买全价票;14周岁以上请购成人票。
  • 价格类型说明(多个用|分隔)
  • └ price_type
  • Number
  • 3
  • 价格类型(0:全价票,1:儿童票,2:携童票,3:残疾人,4:军人,5:高龄老人,6:学生票)
  • └ price
  • Number
  • 40
  • 价格
  • └ support_age_min
  • Number
  • 5
  • 支持最小年龄
  • └ support_age_max
  • Number
  • 10
  • 支持最大年龄
  • └ stock
  • Number
  • 10
  • 库存
  • └ origin_price
  • Number
  • 50
  • 原始价格
  • └ price_type_id
  • String
  • 0001
  • 价格类型id(支付标识)
  • └ total_seats
  • String
  • 55
  • 总座位数
  • └ ship_number
  • String
  • AP6A6A70
  • 航线班次号
  • └ product_info
  • String
  • 本产品可领取上车礼,可能根据预订人数升级车型
  • 产品信息
  • └ to_station_name
  • String
  • 古北水镇
  • 下车点名称
  • └ real_name_grade
  • String
  • 2|3
  • 实名校验规则
  • └ max_sell_num
  • String
  • 5
  • 一单最大乘车人数
  • schedulePoints
  • SchedulePoints []
  • 换乘信息,中途需要换乘的填写
  • └ from_station_name
  • String
  • 南浦大桥客运站
  • 出发站
  • └ to_station_name
  • String
  • 干斜码头
  • 到达站
  • └ dep_time
  • String
  • 10:35
  • 出发时间
  • └ to_time
  • String
  • 19:06
  • 到达时间
  • └ vehicle_type
  • String
  • 中型客车/大型高速客运/普通客运
  • 交通工具
  • └ cost_time
  • String
  • 1小时45分
  • 花费时间单位(分)
  • └ from_station_longitude
  • String
  • 1
  • 出发站经度
  • └ from_station_latitude
  • String
  • 1
  • 出发站维度
  • └ to_station_longitude
  • String
  • 1
  • 到达站经度
  • └ to_station_latitude
  • String
  • 1
  • 到达站经度
  • └ service_price
  • String
  • 100
  • 服务费
  • └ is_refund
  • String
  • 1
  • 是否会允许退票1:是 0:否(可空,为空时以查询车站接口出参中的isRefund字段为准)
  • └ support_eticket
  • String
  • true
  • 是否支持电子票true:表示支持,false:表示不支持
  • └ from_station_code
  • String
  • 006
  • 上车点编码
  • └ from_city_code
  • String
  • 110100
  • 上车点城市编号 选
  • └ ticket_wicket
  • String
  • 码头
  • 检票口
  • └ via_station
  • String
  • a,b,c
  • 途径站,逗号分隔
  • └ transfer_station
  • String
  • xxx,xxx
  • 中转(逗号分隔)
  • └ ship_url
  • String
  • http://
  • 船图片
  • └ ship_name
  • String
  • 中铁渤海2号
  • 船名
  • └ to_date
  • String
  • 2018-11-30
  • 到达日期
  • └ vendor
  • String
  • 中铁渤海铁路轮渡有限责任公司--2--RG
  • 供应商
  • └ region_name
  • String
  • 渤海海峡
  • 区域名称
  • └ ext_category_id
  • String
  • 0为普通班次, 1为车船联运, 2为机场线,3为携车上船
  • 路线类型
  • └ flow_schedule_interval
  • Number
  • 20
  • 流水班间隔(单位分钟)
  • └ route_type_desc
  • String
  • 车送码头...
  • 路线类型说明
  • └ route_type_tag
  • String
  • 无需中转 车送码头
  • 路线类型标签
  • └ ext_category_desc
  • String
  • 本航线仅用于飞机航班接驳,且您的飞行目的地(包括中转地)必须为境外城市。由香港出发或前往香港作入境停留的旅客、持航空公司职员或家属机票、需前往机场取行李或其他遗留物品或接送亲朋好友者、所选航班不在海天码头合作航空公司名单内的及其他情况不可购买!
  • 票种描述
  • └ ticket_voucher
  • String
  • 电子二维码
  • 检票凭证
ret_code String 0 错误码
extAttr String {"param":"param"} 扩展属性 json格式
success Boolean true 成功状态

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
AlitripShipProductQuerynumberRequest req = new AlitripShipProductQuerynumberRequest();
req.setToStationCode("S001");
req.setFromCityCode("C001");
req.setFromCityName("北京");
req.setToStationName("古北水镇");
req.setDepartDate("2018-08-80");
AlitripShipProductQuerynumberResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<ret_desc>成功</ret_desc>
<ship_number_list>
    <ship_number>
        <presell_time>120</presell_time>
        <from_longitude>105.469673</from_longitude>
        <distance>380</distance>
        <refund_msg>本产品可在线退票,退票手续费3元</refund_msg>
        <from_station_name>六里桥</from_station_name>
        <dest_longitude>100.12456004</dest_longitude>
        <to_station_code>111</to_station_code>
        <service_info>服务说明,温馨提示</service_info>
        <parking_points>
            <parking_points>
                <parkingMinutes>60</parkingMinutes>
                <name>卧佛寺</name>
                <desc>植物园停车游玩一小时</desc>
            </parking_points>
        </parking_points>
        <is_order_refund>1</is_order_refund>
        <dest_latitude>25.12456004</dest_latitude>
        <to_province_name>北京市</to_province_name>
        <obtain_ticket>
            <obtain_voucher>凭预订短信验证码取票</obtain_voucher>
            <address>四惠汽车站对面</address>
            <latitude>100.12456004</latitude>
            <invoice>true</invoice>
            <longitude>25.62456004</longitude>
            <ticket_tel>4000535411</ticket_tel>
        </obtain_ticket>
        <arrive_time>2018-11-30 11:30</arrive_time>
        <refund_type>1</refund_type>
        <fromLatitude>32.433114</fromLatitude>
        <last_schedule>18:00</last_schedule>
        <from_city_name>北京</from_city_name>
        <ship_type>普通客船/大型高速客船/高级游轮等</ship_type>
        <schedule_id>A1K001_AP6A6A70_2366_201811301520</schedule_id>
        <stationId>A0001</stationId>
        <to_city_name>北京</to_city_name>
        <depart_time>2018-11-30 05:00</depart_time>
        <shift_type>1</shift_type>
        <refund_time>30</refund_time>
        <number_goods>
            <number_goods>
                <goods_id>0001</goods_id>
                <stock>38</stock>
                <goods_name>三等B</goods_name>
                <goods_desc>8人间</goods_desc>
                <goods_url>http</goods_url>
                <price_types>
                    <price_types>
                        <price_type_rule>儿童票身高1.1.2-1.5米(不含1.5米)之间的儿童可至港口购买儿童票,超过1.5米请购买全价票;14周岁以上请购成人票。</price_type_rule>
                        <price_type>3</price_type>
                        <price>40</price>
                        <support_age_min>5</support_age_min>
                        <support_age_max>10</support_age_max>
                        <stock>10</stock>
                        <origin_price>50</origin_price>
                        <price_type_id>0001</price_type_id>
                    </price_types>
                </price_types>
            </number_goods>
        </number_goods>
        <total_seats>55</total_seats>
        <ship_number>AP6A6A70</ship_number>
        <product_info>本产品可领取上车礼,可能根据预订人数升级车型</product_info>
        <to_station_name>古北水镇</to_station_name>
        <real_name_grade>2|3</real_name_grade>
        <max_sell_num>5</max_sell_num>
        <schedulePoints>
            <schedule_points>
                <from_station_name>南浦大桥客运站</from_station_name>
                <to_station_name>干斜码头</to_station_name>
                <dep_time>10:35</dep_time>
                <to_time>19:06</to_time>
                <vehicle_type>中型客车/大型高速客运/普通客运</vehicle_type>
                <cost_time>1小时45分</cost_time>
                <from_station_longitude>1</from_station_longitude>
                <from_station_latitude>1</from_station_latitude>
                <to_station_longitude>1</to_station_longitude>
                <to_station_latitude>1</to_station_latitude>
            </schedule_points>
        </schedulePoints>
        <service_price>100</service_price>
        <is_refund>1</is_refund>
        <support_eticket>true</support_eticket>
        <from_station_code>006</from_station_code>
        <from_city_code>110100</from_city_code>
        <ticket_wicket>码头</ticket_wicket>
        <via_station>a,b,c</via_station>
        <transfer_station>xxx,xxx</transfer_station>
        <ship_url>http://</ship_url>
        <ship_name>中铁渤海2号</ship_name>
        <to_date>2018-11-30</to_date>
        <vendor>中铁渤海铁路轮渡有限责任公司--2--RG</vendor>
        <region_name>渤海海峡</region_name>
        <ext_category_id>0为普通班次, 1为车船联运, 2为机场线,3为携车上船</ext_category_id>
        <flow_schedule_interval>20</flow_schedule_interval>
        <route_type_desc>车送码头...</route_type_desc>
        <route_type_tag>无需中转 车送码头</route_type_tag>
        <ext_category_desc>本航线仅用于飞机航班接驳,且您的飞行目的地(包括中转地)必须为境外城市。由香港出发或前往香港作入境停留的旅客、持航空公司职员或家属机票、需前往机场取行李或其他遗留物品或接送亲朋好友者、所选航班不在海天码头合作航空公司名单内的及其他情况不可购买!</ext_category_desc>
        <ticket_voucher>电子二维码</ticket_voucher>
    </ship_number>
</ship_number_list>
<ret_code>0</ret_code>
<extAttr>{&quot;param&quot;:&quot;param&quot;}</extAttr>
<success>true</success>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部