文档中心 > API类目 > 国内机票订单API

taobao.jipiao.agent.order.detail (【机票代理商订单】订单详情)

根据淘宝系统订单号获取订单详情信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_ids Number [] 必须 10000
  • 最大列表长度:1
  • 淘宝订单id列表,当前支持列表长度为1,即当前只支持单个订单详情查询

    响应参数

    名称 类型 示例值 描述
    is_success Boolean true 返回操作成功失败信息
    orders TripOrder [] 机票订单的详情列表,当前支持返回一个订单
    • base_info
    • TripBaseInfo
    • 订单基础信息
    • └ order_id
    • Number
    • 3434
    • 淘宝机票订单id
    • └ trip_type
    • Number
    • 0
    • 航程类型:0,单程;1,往返;
    • └ status
    • Number
    • 8
    • 订单状态定义==> 0:未付款;(注:支持保险分润时,订单已付款,保险未付款也为0)1:处理中;2:确定出票;3:预定成功;4:预定失败;5:处理中超时失效;6:支付超时失效;7:买家取消
    • └ pay_status
    • Number
    • 1
    • 订单支付状态==> 0:未付款;1:已付款,冻结买家定金;2:付款给卖家;3:解冻定金给买家;4:已扣佣;5:交易关闭;6:确认可支付;7:确认不可支付
    • └ create_time
    • Date
    • 2000-01-01 00:00:00
    • 订单创建时间
    • └ modify_time
    • Date
    • 2000-01-01 00:00:00
    • 订单表最近一次修改时间
    • └ pay_latest_time
    • Date
    • 2000-01-01 00:00:00
    • 订单最晚支付时间
    • └ total_price
    • Number
    • 1200
    • 总金额,所有乘机人加机建燃油,单位:分
    • └ commission
    • String
    • 250
    • 佣金,单位:分
    • └ relation_name
    • String
    • 张三
    • 联系人姓名
    • └ relation_mobile
    • String
    • 13800138000
    • 联系人手机号
    • └ relation_phone_bak
    • String
    • 13800138000
    • 联系人备用电话
    • └ relation_email
    • String
    • xxx@taobao.com
    • 联系人邮箱
    • └ extra
    • String
    • 扩展信息
    • 扩展信息
    • └ alipay_trade_no
    • String
    • alipaynoxxxxxx
    • 支付宝交易号
    • └ insure_promotion
    • Boolean
    • true
    • 是否保险分润订单,有一个乘机人支持分润即为 True
    • └ force_insure
    • Boolean
    • true
    • 是否强制保险订单,有一张票为强制保险即为true
    • flight_infos
    • TripFlightInfo []
    • 订单航班信息(包含航班乘机人)
    • └ flight_id
    • Number
    • 344
    • 淘宝机票平台航班id
    • └ segment_type
    • Number
    • 1
    • 航段类型:0,去程;1,回程
    • └ segment_number
    • Number
    • 1
    • 去程或回程第几段航班,0,第1段;1,第2段航班
    • └ airline_code
    • String
    • CZ
    • 航班航空公司二字码
    • └ flight_no
    • String
    • CZ1934
    • 航班号
    • └ carrier
    • String
    • MU1934
    • 航班实际承运航班号
    • └ flight_type
    • String
    • 320
    • 航班机型
    • └ dep_city_code
    • String
    • BJS
    • 航班出发城市三字码
    • └ arr_city_code
    • String
    • SHA
    • 航班到达城市三字码
    • └ dep_airport_code
    • String
    • PEK
    • 航班出发机场三字码
    • └ arr_airport_code
    • String
    • SHA
    • 航班到达机场三字码
    • └ dep_time
    • String
    • 2012-06-03 10:00:00
    • 航班起飞时间,格式yyyy-mm-dd hh:mm:ss
    • └ arr_time
    • String
    • 2012-06-03 12:00:00
    • 航班到达时间,格式yyyy-mm-dd hh:mm:ss
    • └ ticket_price
    • Number
    • 10000
    • 当前航段票面价格,单位:分
    • passengers
    • TripFlightPassenger []
    • 乘机人信息列表
    • └ name
    • String
    • 张三
    • 乘机人姓名
    • └ cert_type
    • Number
    • 0
    • 乘机人证件类型:0,身份证;1,护照;3,军人证;4,回乡证;5,台胞证;6,港澳台胞;10,警官证;11,士兵证件
    • └ cert_no
    • String
    • 4343434
    • 乘机人证件号码
    • └ passenger_type
    • Number
    • 0
    • 乘机人类型:0,成人;1,儿童;
    • └ birthday
    • String
    • 1982-01-01
    • 乘机人生日:yyyy-mm-dd
    • └ trip_card_no
    • String
    • 常旅客卡号(暂时不提供 )
    • 常旅客卡号
    • └ pnr
    • String
    • HG6F98
    • PNR信息
    • └ ticket_no
    • String
    • 876-2327350964
    • 票号
    • └ extra
    • String
    • 扩展字段
    • 扩展字段
    • └ policy_id
    • Number
    • 1985
    • 政策id,淘宝系统政策唯一键
    • └ policy_type
    • Number
    • 0
    • 机票政策类型:0,默认;1,自定义
    • └ memo
    • String
    • 备注
    • 备注信息,政策中的备注信息
    • └ price
    • Number
    • 80000
    • 销售价格,单位:分
    • └ fee
    • Number
    • 5000
    • 航班机建费,单位:分
    • └ tax
    • Number
    • 13000
    • 航班燃油税,单位:分
    • └ cabin_code
    • String
    • C
    • 航班舱位代码
    • └ cabin_class
    • Number
    • 0
    • 舱位等级:0,头等舱(F);1,商务舱(C);2,经济舱(Y)
    • └ tuigaiqian
    • String
    • 退改签
    • 退改签
    • └ ei
    • String
    • ei项
    • ei项
    • └ insure_promotion_price
    • Number
    • 1500
    • 当前乘机人的保险分润金额,单位:分
    • └ force_insure_price
    • Number
    • 2000
    • 强制保险金额,单位:分
    • └ extra
    • String
    • 扩展信息
    • 扩展信息
    • └ special_rule
    • String
    • 特殊说明
    • 特殊说明
    • itinerary
    • Itinerary
    • 订单行程单信息
    • └ type
    • Number
    • 1
    • 行程单类型:6,快递
    • └ name
    • String
    • 张三
    • 收件人姓名
    • └ mobile
    • String
    • 13800138000
    • 收件人手机号
    • └ mobile_bak
    • String
    • 13800138000
    • 收件人备用手机号
    • └ address
    • String
    • 收件人地址
    • 收件人地址
    • └ price
    • String
    • 10
    • 行程单价格,单位:分
    • └ company_code
    • String
    • 物流公司
    • 物流公司代码
    • └ express_code
    • String
    • 邮寄单号
    • 邮寄单号
    • └ itinerary_no
    • String
    • 行程单号
    • 行程单号
    • └ send_date
    • String
    • 邮寄时间
    • 邮寄时间
    • └ status
    • Number
    • 1
    • 行程单订单的状态 0:未付款 1:已付款 2:转交易成功 3:已邮寄 4:已取消
    • └ extra
    • String
    • 扩展字段
    • 扩展字段
    • └ alipay_trade_no
    • String
    • alipaynoxxxxxx
    • 支付宝交易号
    • └ id
    • Number
    • 666
    • 淘宝主键id
    • corp_info
    • CorpInfo
    • 订单行政购票信息
    • └ apply_name
    • String
    • 妙海
    • 申请人姓名
    • └ apply_no
    • String
    • 00931
    • 申请人工号
    • └ form_no
    • String
    • 3343
    • BPM的fromNO
    • └ trip_person_no
    • String
    • 出差人工号
    • 出差人工号
    • └ trip_person_name
    • String
    • 出差人姓名
    • 出差人姓名
    • └ work_space
    • String
    • 工作地点
    • 工作地点
    • └ cost_center_code
    • String
    • 成本中心代码
    • 成本中心代码
    • └ cost_center
    • String
    • 成本中心
    • 成本中心
    • └ form_status
    • String
    • 单据状态代码
    • 单据状态代码
    • └ receipts_status
    • String
    • 单据状态描述
    • 单据状态描述
    • └ cost_ou
    • String
    • 费用归属OU的CODE
    • 费用归属OU的CODE
    • └ apply_time
    • Date
    • 2000-01-01 00:00:00
    • 申请时间
    • └ corpration_id
    • String
    • 集团id
    • 集团id
    • └ extra
    • String
    • 扩展字段
    • 扩展字段
    • └ extra
    • String
    • 扩展字段
    • 扩展字段

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    JipiaoAgentOrderDetailRequest req = new JipiaoAgentOrderDetailRequest();
    req.setOrderIds("10000");
    JipiaoAgentOrderDetailResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <jipiao_agent_order_detail_response>
        <is_success>true</is_success>
        <orders>
            <trip_order>
                <base_info>
                </base_info>
                <flight_infos>
                    <trip_flight_info>
                    </trip_flight_info>
                </flight_infos>
                <itinerary>
                </itinerary>
                <corp_info>
                </corp_info>
                <extra>扩展字段</extra>
            </trip_order>
        </orders>
    </jipiao_agent_order_detail_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-parameter:error 参数不正确 根据文档要求准备参数
    isv.remote-service-error 系统错误 + 相应的描述信息 向机票运营咨询
    isv.remote-service-error:NO_DATA 订单数据不存在 确认订单id是否正确
    isv.remote-service-error:USER_AUTH_FAIL 访问权限不够,Appkey未授权或者Appkey绑定非授权用户 向运营咨询处理方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部