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

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

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_id Number 必须 109843843 订单号

响应参数

名称 类型 示例值 描述
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);
JipiaoAgentOrderBdetailRequest req = new JipiaoAgentOrderBdetailRequest();
req.setOrderId(109843843L);
JipiaoAgentOrderBdetailResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<jipiao_agent_order_bdetail_response>
    <is_success>true</is_success>
    <orders>
        <trip_order>
            <base_info>
                <order_id>3434</order_id>
                <trip_type>0</trip_type>
                <status>8</status>
                <pay_status>1</pay_status>
                <create_time>2000-01-01 00:00:00</create_time>
                <modify_time>2000-01-01 00:00:00</modify_time>
                <pay_latest_time>2000-01-01 00:00:00</pay_latest_time>
                <total_price>1200</total_price>
                <commission>250</commission>
                <relation_name>张三</relation_name>
                <relation_mobile>13800138000</relation_mobile>
                <relation_phone_bak>13800138000</relation_phone_bak>
                <relation_email>xxx@taobao.com</relation_email>
                <extra>扩展信息</extra>
                <alipay_trade_no>alipaynoxxxxxx</alipay_trade_no>
                <insure_promotion>true</insure_promotion>
                <force_insure>true</force_insure>
            </base_info>
            <flight_infos>
                <trip_flight_info>
                    <flight_id>344</flight_id>
                    <segment_type>1</segment_type>
                    <segment_number>1</segment_number>
                    <airline_code>CZ</airline_code>
                    <flight_no>CZ1934</flight_no>
                    <carrier>MU1934</carrier>
                    <flight_type>320</flight_type>
                    <dep_city_code>BJS</dep_city_code>
                    <arr_city_code>SHA</arr_city_code>
                    <dep_airport_code>PEK</dep_airport_code>
                    <arr_airport_code>SHA</arr_airport_code>
                    <dep_time>2012-06-03 10:00:00</dep_time>
                    <arr_time>2012-06-03 12:00:00</arr_time>
                    <ticket_price>10000</ticket_price>
                    <passengers>
                        <trip_flight_passenger>
                        </trip_flight_passenger>
                    </passengers>
                    <extra>扩展信息</extra>
                    <special_rule>特殊说明</special_rule>
                </trip_flight_info>
            </flight_infos>
            <itinerary>
                <type>1</type>
                <name>张三</name>
                <mobile>13800138000</mobile>
                <mobile_bak>13800138000</mobile_bak>
                <address>收件人地址</address>
                <price>10</price>
                <company_code>物流公司</company_code>
                <express_code>邮寄单号</express_code>
                <itinerary_no>行程单号</itinerary_no>
                <send_date>邮寄时间</send_date>
                <status>1</status>
                <extra>扩展字段</extra>
                <alipay_trade_no>alipaynoxxxxxx</alipay_trade_no>
                <id>666</id>
            </itinerary>
            <corp_info>
                <apply_name>妙海</apply_name>
                <apply_no>00931</apply_no>
                <form_no>3343</form_no>
                <trip_person_no>出差人工号</trip_person_no>
                <trip_person_name>出差人姓名</trip_person_name>
                <work_space>工作地点</work_space>
                <cost_center_code>成本中心代码</cost_center_code>
                <cost_center>成本中心</cost_center>
                <form_status>单据状态代码</form_status>
                <receipts_status>单据状态描述</receipts_status>
                <cost_ou>费用归属OU的CODE</cost_ou>
                <apply_time>2000-01-01 00:00:00</apply_time>
                <corpration_id>集团id</corpration_id>
                <extra>扩展字段</extra>
            </corp_info>
            <extra>扩展字段</extra>
        </trip_order>
    </orders>
</jipiao_agent_order_bdetail_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

返回
顶部