文档中心 > API类目 > 国内机票京杭API

taobao.alitrip.orderinfo.get (【京杭】——查询订单详情)

查询订单详情

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
channel_name String 必须 feiye 接入方提供的用户名
order_id Number 可选 123 阿里旅行订单号(该入参及外部订单号其中一个必填)
password String 必须 7b1e6dd7e98f6e84f246cb4783880449 接入方提供的密码,以MD5方式加密后传入
reservation_code String 可选 1393 外部订单号(该入参及阿里旅行订单号其中一个必填)

响应参数

名称 类型 示例值 描述
flight_info_list AtsrOrderFlightInfo [] 机票信息
  • └ airline_code
  • String
  • CA
  • 航空公司大写二字码
  • └ arr_airport
  • String
  • TNA
  • 到达机场三字码
  • └ arr_time
  • String
  • 2014-12-05 14:22
  • 到达时间(yyyy-MM-dd HH:mm) 24小时制
  • └ cabin
  • String
  • Y
  • 仓位
  • └ dep_airport
  • String
  • HGH
  • 出发机场三字码
  • └ dep_date
  • String
  • 2014-12-05
  • 起飞日期(yyyy-MM-dd)
  • └ dep_time
  • String
  • 2014-12-05 10:22
  • 起飞时间(yyyy-MM-dd HH:mm) 24小时制
  • └ flight_no
  • String
  • CA177
  • 航班号
  • └ sale_price
  • Number
  • 900
  • 销售价(单位:元)
  • └ segment_type
  • String
  • 0
  • 行程类型 0:去程 1:回程
status String 0 订单状态 0:订单取消 1:支付失败 2:出票中 3:出票成功 4:未付款 5:未知的状态
total_money String 1000 订单总金额(优惠前)
traveler_info_list AtsrOrderTravelerInfo [] 游客信息
  • └ birth_date
  • String
  • 1987-07-16
  • 出生日期
  • └ doc_id
  • String
  • 432431
  • 证件号码
  • └ doc_type
  • Number
  • 1
  • 证件类型0,身份证;1,护照;3,军人证;4,回乡证;5,台胞证;6,港澳台胞;10,警官证;11,士兵证件
  • └ passenger_name
  • String
  • 张三
  • 旅客姓名
  • └ passenger_type
  • String
  • ADT
  • 旅客类型ADT:成人 CHD:儿童
  • └ ticket_no
  • String
  • 999-7296000115
  • 票号
alipay_trade_no String 12343213433 支付宝订单号
actual_pay Number 970 订单实际支付金额(优惠后)
product_type String 产品类型 QW:全网最低价产品 JX:精选产品 JP:金牌产品 HS:航司产品 KUFEI:酷飞产品 默认HS,即:下单默认选择旗舰店产品
pay_time Date 2015-09-23 12:30:43 订单支付时间
is_quality_order Boolean true 是否金牌订单
is_speedy_order Boolean false 是否精选订单
is_voucher_order Boolean true 是否使用了优惠券
seller_taobao_nick String 中国国际航空旗舰店 卖家昵称
gmt_create Date 2015-09-23 12:30:40 订单产生时间
pay_status Number 1 支付状态 0:初始 9:创建支付宝交易成功 1:支付成功(冻结) 3:解冻成功 5:转交易成功 11:关闭交易成功(未支付) 13:卖家确认可以支付
order_id Number 79387483432 阿里旅行订单号
reservation_code String 543324234 外部订单号

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripOrderinfoGetRequest req = new AlitripOrderinfoGetRequest();
req.setChannelName("feiye");
req.setOrderId(123L);
req.setPassword("7b1e6dd7e98f6e84f246cb4783880449");
req.setReservationCode("1393");
AlitripOrderinfoGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_orderinfo_get_response>
    <flight_info_list>
        <atsr_order_flight_info>
            <airline_code>CA</airline_code>
            <arr_airport>TNA</arr_airport>
            <arr_time>2014-12-05 14:22</arr_time>
            <cabin>Y</cabin>
            <dep_airport>HGH</dep_airport>
            <dep_date>2014-12-05</dep_date>
            <dep_time>2014-12-05 10:22</dep_time>
            <flight_no>CA177</flight_no>
            <sale_price>900</sale_price>
            <segment_type>0</segment_type>
        </atsr_order_flight_info>
    </flight_info_list>
    <status>0</status>
    <total_money>1000</total_money>
    <traveler_info_list>
        <atsr_order_traveler_info>
            <birth_date>1987-07-16</birth_date>
            <doc_id>432431</doc_id>
            <doc_type>1</doc_type>
            <passenger_name>张三</passenger_name>
            <passenger_type>ADT</passenger_type>
            <ticket_no>999-7296000115</ticket_no>
        </atsr_order_traveler_info>
    </traveler_info_list>
    <alipay_trade_no>12343213433</alipay_trade_no>
    <actual_pay>970</actual_pay>
    <product_type>产品类型</product_type>
    <pay_time>2015-09-23 12:30:43</pay_time>
    <is_quality_order>true</is_quality_order>
    <is_speedy_order>false</is_speedy_order>
    <is_voucher_order>true</is_voucher_order>
    <seller_taobao_nick>中国国际航空旗舰店</seller_taobao_nick>
    <gmt_create>2015-09-23 12:30:40</gmt_create>
    <pay_status>1</pay_status>
    <order_id>79387483432</order_id>
    <reservation_code>543324234</reservation_code>
</alitrip_orderinfo_get_response>

异常示例

  • 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>

错误码解释

错误码 错误描述 解决方案
isv.invalid-channel:error channel_name非法 使用预先约定的channel_name
isv.invalid-password:error 密码错误 使用预先分配的密码
isv.invalid-orderid:NO_DATA 订单数据不存在 根据订单ID无法查找到订单数据,请联系系统管理员确认问题
isp.remote-service-error 系统异常 系统出现异常,请联系管理员解决
isv.invalid-orderid:NO_AUTH 没有指定订单的查询权限 仅订单创建者才能查询订单详情
isv.remote-service-error:NO_DATA 订单数据不存在 确认该订单号是否淘宝订单号
isv.remote-service-error 远程服务器错误 联系阿里旅行小二或稍后重试
isp.service-unavailable 远程服务不可用 联系阿里旅行小二或稍后重试

API工具

如何获得此API

FAQ

返回
顶部