文档中心 > API类目 > 度假&门票-交易管理API

alitrip.travel.trade.query (飞猪度假-订单详情查询接口)

飞猪度假订单详情查询接口

公共参数

请求参数

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

响应参数

名称 类型 示例值 描述
first_result TopTripOrderResult 交易主订单详情
  • └ order_id
  • Number
  • 1233
  • 主订单id
  • └ order_id_string
  • String
  • 1234
  • string类型订单id
  • └ created_time
  • Date
  • 2017-02-02 12:00:00
  • 订单创建时间
  • └ modified_time
  • Date
  • 2017-02-02 12:00:00
  • 订单修改时间
  • └ end_time
  • Date
  • 2017-02-02 12:00:00
  • 交易结束时间。交易成功时间(更新交易状态为成功的同时更新)/确认收货时间或者交易关闭时间
  • └ status
  • String
  • WAIT_SELLER_SEND_GOODS
  • 主订单状态。交易状态。可选值: TRADE_NO_CREATE_PAY(没有创建支付宝交易);WAIT_BUYER_PAY(等待买家付款);SELLER_CONSIGNED_PART(卖家部分发货);WAIT_SELLER_SEND_GOODS(等待卖家发货,即:买家已付款);WAIT_BUYER_CONFIRM_GOODS(等待买家确认收货,即:卖家已发货);TRADE_FINISHED(交易成功);TRADE_CLOSED(付款以后用户退款成功,交易自动关闭);TRADE_CLOSED_BY_TAOBAO(付款以前,卖家或买家主动关闭交易);PAY_PENDING(国际信用卡支付付款确认中);
  • └ type
  • String
  • fixed
  • 交易类型列表,fixed(一口价);auction(拍卖);guarantee_trade(一口价、拍卖);auto_delivery(自动发货);cod(货到付款);external_trade(统一外部交易);instant_trade(即时交易);b2c_cod(大商家货到付款);nopaid(即时到帐);eticket(电子凭证订单);step(分阶段付款)
  • pay_info
  • PayInfo
  • 主订单支付信息
  • └ alipay_no
  • String
  • 1223445
  • 支付宝交易号
  • └ discount_fee
  • Number
  • 111.00
  • 系统优惠金额(如打折,VIP,满就送等),精确到2位小数,单位:分。
  • └ pay_time
  • Date
  • 2017-02-02 12:00:00
  • 订单付款时间
  • └ received_payment
  • Number
  • 111.00
  • 卖家实际收到的支付宝打款金额(由于子订单可以部分确认收货,这个金额会随着子订单的确认收货而不断增加,交易成功后等于买家实付款减去退款金额)。精确到2位小数;单位:分
  • └ step_paid_fee
  • Number
  • 122.22阶段付款的已付金额
  • 分阶段付款的已付金额
  • └ step_trade_status
  • String
  • FRONT_NOPAID_FINAL_NOPAID
  • 分阶段付款的订单状态,目前有三返回状态FRONT_NOPAID_FINAL_NOPAID(定金未付尾款未付),FRONT_PAID_FINAL_NOPAID(定金已付尾款未付),FRONT_PAID_FINAL_PAID(定金和尾款都付)
  • seller_info
  • SellerInfo
  • 卖家信息
  • └ seller_can_rate
  • Boolean
  • false
  • 卖家是否可以对订单进行评价
  • └ seller_email
  • String
  • 卖家邮件地址
  • 卖家邮件地址
  • └ seller_flag
  • Number
  • 1
  • 卖家备注旗帜(与淘宝网上订单的卖家备注旗帜对应,只有卖家才能查看该字段)红、黄、绿、蓝、紫 分别对应 1、2、3、4、5
  • └ seller_memo
  • String
  • 卖家备注
  • 卖家备注
  • └ seller_name
  • String
  • 卖家姓名
  • 卖家姓名
  • └ seller_nick
  • String
  • 卖家昵称
  • 卖家昵称
  • └ seller_phone
  • String
  • 卖家联系方式
  • 卖家联系方式
  • └ seller_rate
  • Boolean
  • false
  • 卖家是否已评价。可选值:true(已评价),false(未评价)
  • └ seller_shop
  • String
  • 卖家店铺名称
  • 卖家店铺名称
  • buyer_info
  • BuyerInfo
  • 买家信息
  • └ buyer_email
  • String
  • 123@qq.com
  • 买家邮件地址
  • └ buyer_message
  • String
  • 买家留言
  • 买家留言
  • └ buyer_nick
  • String
  • buyer1
  • 买家昵称
  • └ buyer_phone
  • String
  • 137777777
  • 买家联系方式
  • └ buyer_rate
  • Boolean
  • true
  • 买家是否已评价
  • promotion_details
  • PromotionDetail []
  • 主、子订单优惠信息
  • └ discount_fee
  • String
  • 111
  • 优惠金额(免运费、限时打折时为空),单位:分
  • └ id
  • Number
  • 1222
  • 交易的主订单或子订单号
  • └ promotion_desc
  • String
  • 优惠活动的描述
  • 优惠活动的描述
  • └ promotion_id
  • String
  • mjs-123024_211143
  • 优惠id,(由营销工具id、优惠活动id和优惠详情id组成,结构为:营销工具id-优惠活动id_优惠详情id,如mjs-123024_211143)
  • └ promotion_name
  • String
  • 满减
  • 优惠信息的名称
  • sub_orders
  • SubOrderInfo []
  • 主订单包含的各个子订单信息
  • └ adjust_fee
  • Number
  • 2000
  • 卖家手工调整金额,单位:分
  • └ biz_type
  • Number
  • 1
  • 订单所属业务类型。0-未知,1-度假(自由行,跟团游),2-签证,3-门票,4-wifi,7-当地玩乐,9-邮轮,10-用车,12-电话卡,13-流量充值
  • buy_item_info
  • BuyItemInfo
  • 购买的商品信息(商品、sku信息,单价、数量、出行日期等信息)
  • └ category_ext_infos
  • String
  • k1:v1;k2:v2
  • 商品类目相关的扩展信息。KV对形式,多个KV对以英文封号分隔,k1:v1;k2:v2。各类目支持的枚举key详见:https://open.alitrip.com/docs/doc.htm?docType=1&articleId=107548
  • └ category_id
  • Number
  • 22211
  • 商品所属叶子类目id
  • └ item_id
  • Number
  • 1322
  • 商品id
  • └ item_title
  • String
  • 商品标题
  • 商品标题
  • └ num
  • Number
  • 1
  • 购买的数量
  • └ out_product_id
  • String
  • 121
  • 商家自定义的商品编码
  • └ out_sku_id
  • String
  • 2221
  • sku_id对应的商家自定义sku编码(即商品上套餐的外部商家编码)
  • └ price
  • Number
  • 111
  • 商品价格
  • └ sku_id
  • Number
  • 2313
  • 用户所购买的商品上sku的id
  • └ sku_properties
  • String
  • k1:v1;k2:v2
  • 用户所购买的Sku信息。包含商品套餐名称(对于门票商品即指票种),出游人群信息等
  • └ trip_end_date
  • Date
  • 2017-02-02 12:00:00
  • 出行结束日期,如果没有出行结束日期,则该值为空。(对于wifi/电话卡商品 指激活/租用结束日期;对于流量充值商品 指结束使用日期)
  • └ trip_start_date
  • Date
  • 2017-02-02 12:00:00
  • 出行开始日期。(对于wifi/电话卡商品 指激活/租用日期;对于门票商品 指入园日期;对于流量充值商品 指开始使用日期)
  • contactor
  • TravellerInfo
  • 联系人/取件人信息。通用联系人信息,没有配置度假出行人模板的商品订单(如wifi电话卡等类目),从这里获取联系人或取件人信息
  • └ birthday
  • String
  • 2017-02-02
  • 出生日期,格式yyyy-mm-dd
  • └ credential_no
  • String
  • 312121
  • 证件号码
  • └ credential_type
  • Number
  • 0
  • 证件类型。0:身份证 1:护照 2:学生证3:军官证 4:回乡证 5:台胞证 6:港澳通行证 10:警官证 11:士兵证 12:台湾通行证
  • └ email
  • String
  • 123@xxx.com
  • 联系电子邮箱
  • └ extend_attributes
  • String
  • k1:v1;k2:v2
  • 预留,KV对形式,商家自定义的个性化出行人信息。目前支持的Key列表如下:overseaPhoneNumber(国外手机号),emergencyPhoneNumber(紧急联系方式),memo(备注)
  • └ issue_country
  • String
  • 中国
  • 证件签发国
  • └ issue_place
  • String
  • 杭州
  • 证件签发地
  • └ name
  • String
  • 姓名
  • 姓名
  • └ name_pinyin
  • String
  • zhangsan
  • 姓名(拼音)
  • └ nationality
  • String
  • 中国
  • 国籍
  • └ phone
  • String
  • 123344
  • 联系电话
  • └ post_address
  • String
  • 西湖区
  • 具体收件地址(对于需要物流的实物商品)
  • └ post_area
  • String
  • 收件区域
  • 收件区域
  • └ post_city
  • String
  • 杭州
  • 收件市(对于需要物流的实物商品)
  • └ post_province
  • String
  • 浙江
  • 收件省(对于需要物流的实物商品)
  • └ sex
  • Number
  • 1
  • 性别。0-男,1-女
  • └ valid_date
  • String
  • 2017-02-02
  • 证件有效期
  • └ surname_pinyin
  • String
  • zhang
  • 姓(拼音)
  • └ given_name_pinyin
  • String
  • san
  • 名(拼音)
  • └ discount_fee
  • Number
  • 2000
  • 子订单优惠金额(如打折,VIP,满就送等),不包含带资优惠(如红包、旅行券)。单位:分
  • └ end_time
  • Date
  • 2017-02-02 12:00:00
  • 子订单交易结束时间。交易成功时间(更新交易状态为成功的同时更新)/确认收货时间或者交易关闭时间
  • └ expire_time
  • Date
  • 2017-02-02 12:00:00
  • 子订单超时自动关单(卖家未能及时发货)时间
  • └ extend_attributes
  • String
  • k1:v1;k2:v2
  • 子订单扩展属性。KV对结构。每个KV对间使用分号隔开。如:k1:v1;k2:v2
  • └ order_type
  • Number
  • 1
  • 订单类型。1、普通订单,2、二次确认订单,3、二次预约订单
  • └ payment
  • Number
  • 112
  • 买家实付金额。单位:分
  • └ refund_id
  • Number
  • 12345
  • 子订单退款编号。如果子订单没有发生退款,则该值为空
  • └ refund_status
  • String
  • NO_REFUND
  • 退款状态。WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意);WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货);WAIT_SELLER_CONFIRM_GOODS(买家已经退货,等待卖家确认收货);SELLER_REFUSE_BUYER(卖家拒绝退款);CLOSED(退款关闭);SUCCESS(退款成功)
  • └ status
  • String
  • WAIT_SELLER_SEND_GOODS
  • 子订单状态
  • └ sub_order_id
  • Number
  • 2111
  • 子订单id
  • └ total_fee
  • Number
  • 2222
  • 应付金额(商品价格 * 商品数量 + 手工调整金额 - 子订单优惠金额),大于等于payment,因为可能包含了带资优惠(如红包、旅行券)。单位:分
  • travellers
  • TravellerInfo []
  • xx
  • 出行人信息
  • └ name
  • String
  • 姓名
  • 姓名
  • └ birthday
  • String
  • 2017-02-02
  • 出生日期,格式yyyy-mm-dd
  • └ credential_no
  • String
  • 312121
  • 证件号码
  • └ credential_type
  • Number
  • 0
  • 证件类型。0:身份证 1:护照 2:学生证3:军官证 4:回乡证 5:台胞证 6:港澳通行证 10:警官证 11:士兵证 12:台湾通行证
  • └ email
  • String
  • 123@xxx.com
  • 联系电子邮箱
  • └ extend_attributes
  • String
  • k1:v1;k2:v2
  • KV对形式,商家自定义的个性化出行人信息。支持的key列表详见:https://open.alitrip.com/docs/doc.htm?docType=1&articleId=107550
  • └ issue_country
  • String
  • 中国
  • 证件签发国
  • └ issue_place
  • String
  • 杭州
  • 证件签发地
  • └ name_pinyin
  • String
  • zhangsan
  • 姓名(拼音)
  • └ nationality
  • String
  • 中国
  • 国籍
  • └ phone
  • String
  • 123344
  • 联系电话
  • └ post_address
  • String
  • 西湖区
  • 具体收件地址(对于需要物流的实物商品)
  • └ post_area
  • String
  • 收件区域
  • 收件区域
  • └ post_city
  • String
  • 杭州
  • 收件市(对于需要物流的实物商品)
  • └ post_province
  • String
  • 浙江
  • 收件省(对于需要物流的实物商品)
  • └ sex
  • Number
  • 1
  • 性别。0-男,1-女
  • └ valid_date
  • String
  • 2017-02-02
  • 证件有效期
  • └ surname_pinyin
  • String
  • zhang
  • 姓(拼音)
  • └ given_name_pinyin
  • String
  • san
  • 名(拼音)
  • └ sub_order_id_string
  • String
  • 1234
  • string类型子订单id
  • └ process_time
  • String
  • 20170202100000
  • 订单处理时间 精确到秒
  • └ confirm_status
  • Number
  • 1
  • 二次确认状态
  • └ order_with_depo
  • Boolean
  • true
  • 该笔订单是否押金合并支付订单(即该主订单是否已包含押金订单金额)
  • └ post_fee
  • Number
  • 111
  • 订单邮费,需要邮寄的实体商品才有

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTravelTradeQueryRequest req = new AlitripTravelTradeQueryRequest();
req.setOrderId(12233L);
AlitripTravelTradeQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_travel_trade_query_response>
    <first_result>
        <order_id>1233</order_id>
        <order_id_string>1234</order_id_string>
        <created_time>2017-02-02 12:00:00</created_time>
        <modified_time>2017-02-02 12:00:00</modified_time>
        <end_time>2017-02-02 12:00:00</end_time>
        <status>WAIT_SELLER_SEND_GOODS</status>
        <type>fixed</type>
        <pay_info>
            <alipay_no>1223445</alipay_no>
            <discount_fee>111.00</discount_fee>
            <pay_time>2017-02-02 12:00:00</pay_time>
            <received_payment>111.00</received_payment>
            <step_paid_fee>122.22阶段付款的已付金额</step_paid_fee>
            <step_trade_status>FRONT_NOPAID_FINAL_NOPAID</step_trade_status>
        </pay_info>
        <seller_info>
            <seller_can_rate>false</seller_can_rate>
            <seller_email>卖家邮件地址</seller_email>
            <seller_flag>1</seller_flag>
            <seller_memo>卖家备注</seller_memo>
            <seller_name>卖家姓名</seller_name>
            <seller_nick>卖家昵称</seller_nick>
            <seller_phone>卖家联系方式</seller_phone>
            <seller_rate>false</seller_rate>
            <seller_shop>卖家店铺名称</seller_shop>
        </seller_info>
        <buyer_info>
            <buyer_email>123@qq.com</buyer_email>
            <buyer_message>买家留言</buyer_message>
            <buyer_nick>buyer1</buyer_nick>
            <buyer_phone>137777777</buyer_phone>
            <buyer_rate>true</buyer_rate>
        </buyer_info>
        <promotion_details>
            <promotion_detail>
                <discount_fee>111</discount_fee>
                <id>1222</id>
                <promotion_desc>优惠活动的描述</promotion_desc>
                <promotion_id>mjs-123024_211143</promotion_id>
                <promotion_name>满减</promotion_name>
            </promotion_detail>
        </promotion_details>
        <sub_orders>
            <sub_order_info>
                <adjust_fee>2000</adjust_fee>
                <biz_type>1</biz_type>
                <buy_item_info>
                    <category_ext_infos>k1:v1;k2:v2</category_ext_infos>
                    <category_id>22211</category_id>
                    <item_id>1322</item_id>
                    <item_title>商品标题</item_title>
                    <num>1</num>
                    <out_product_id>121</out_product_id>
                    <out_sku_id>2221</out_sku_id>
                    <price>111</price>
                    <sku_id>2313</sku_id>
                    <sku_properties>k1:v1;k2:v2</sku_properties>
                    <trip_end_date>2017-02-02 12:00:00</trip_end_date>
                    <trip_start_date>2017-02-02 12:00:00</trip_start_date>
                </buy_item_info>
                <contactor>
                    <birthday>2017-02-02</birthday>
                    <credential_no>312121</credential_no>
                    <credential_type>0</credential_type>
                    <email>123@xxx.com</email>
                    <extend_attributes>k1:v1;k2:v2</extend_attributes>
                    <issue_country>中国</issue_country>
                    <issue_place>杭州</issue_place>
                    <name>姓名</name>
                    <name_pinyin>zhangsan</name_pinyin>
                    <nationality>中国</nationality>
                    <phone>123344</phone>
                    <post_address>西湖区</post_address>
                    <post_area>收件区域</post_area>
                    <post_city>杭州</post_city>
                    <post_province>浙江</post_province>
                    <sex>1</sex>
                    <valid_date>2017-02-02</valid_date>
                    <surname_pinyin>zhang</surname_pinyin>
                    <given_name_pinyin>san</given_name_pinyin>
                </contactor>
                <discount_fee>2000</discount_fee>
                <end_time>2017-02-02 12:00:00</end_time>
                <expire_time>2017-02-02 12:00:00</expire_time>
                <extend_attributes>k1:v1;k2:v2</extend_attributes>
                <order_type>1</order_type>
                <payment>112</payment>
                <refund_id>12345</refund_id>
                <refund_status>NO_REFUND</refund_status>
                <status>WAIT_SELLER_SEND_GOODS</status>
                <sub_order_id>2111</sub_order_id>
                <total_fee>2222</total_fee>
                <travellers>
                    <traveller_info>
                        <name>姓名</name>
                        <birthday>2017-02-02</birthday>
                        <credential_no>312121</credential_no>
                        <credential_type>0</credential_type>
                        <email>123@xxx.com</email>
                        <extend_attributes>k1:v1;k2:v2</extend_attributes>
                        <issue_country>中国</issue_country>
                        <issue_place>杭州</issue_place>
                        <name_pinyin>zhangsan</name_pinyin>
                        <nationality>中国</nationality>
                        <phone>123344</phone>
                        <post_address>西湖区</post_address>
                        <post_area>收件区域</post_area>
                        <post_city>杭州</post_city>
                        <post_province>浙江</post_province>
                        <sex>1</sex>
                        <valid_date>2017-02-02</valid_date>
                        <surname_pinyin>zhang</surname_pinyin>
                        <given_name_pinyin>san</given_name_pinyin>
                    </traveller_info>
                </travellers>
                <sub_order_id_string>1234</sub_order_id_string>
                <process_time>20170202100000</process_time>
                <confirm_status>1</confirm_status>
            </sub_order_info>
        </sub_orders>
        <order_with_depo>true</order_with_depo>
        <post_fee>111</post_fee>
    </first_result>
</alitrip_travel_trade_query_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.isv.trade-cat-not-support 不支持的类目 订单查询不支持此类目
isv.rights-invalid:VIEW_NOT_PERMIT 没有权限 请确定该订单属于你
isv.invalid-parameter:ERROR 参数异常 请根据错误提示修改
isv.isv.rights-invalid:ISV_ITEM_AUTH_FAIL 没有授权 请根据错误提示修改
isv.biz-error:INVALID_SUB_ORDER_ID 无效的子订单ID 请根据错误提示修改
isv.remote-service-error 远程服务异常 请根据错误提示修改

API工具

如何获得此API

拥有此API的权限组 可获得/可申请此API权限组的应用类型
度假&门票-交易管理 飞猪-门票   飞猪-度假   飞猪-系统商  

FAQ

返回
顶部