淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	更多限制	描述
id_type	String	可选	asmksmdksmdksm		酒店下单唯一标识，可以是uuid
order_id	String	必须	1122333		酒店订单id

名称	类型	示例值	描述
errno	String	0	错误码
data	Data		数据实体
order Order 订单实体 └ total_amount String 1000 总金额 └ buyer_xuser_name String 王超下单用户名称 └ memo String 测试TC 订单备注 └ total_amount_currency_code String CNY 币种 └ payment_mode String 1 支付类型：1：企业垫付；2: 个人支付 └ uuid String e2a5ec15-e5fd-4392-9c91-a60a7a0c9a15 idtype，下单唯一标识 └ order_status String reserved reserved : 已预订; canceled : 已取消; error : 预定失败; pending : 预定处理中 people_contact_list PeopleContactList [] 联系人实体 └ fax String 汾酒的fax 下单人的传真 └ memo String 汾酒作为联系人的memo 联系人的备注 └ email String xiaolei.zhang@alibaba-inc.com 联系人邮箱 └ tel String 汾酒的tel 联系人电话 └ name String 汾酒联系人名称 └ country_code String CN 国家Code └ mobile_num String 13337700111 联系人电话 people_tourist_list PeopleTouristList [] 旅行人信息 └ tourist_type String 0 3: 入住人， 4:合住人 └ first_name String 王名 └ birthday String 2000-01-01 生日 └ sex String 2 性别 └ nationality String 中国国籍 └ name String 王兵全名 └ last_name String 兵姓 └ room_index String 1 房间序号 hotel_item_list HotelItemList [] 酒店信息列表 └ checkin String 2018-12-28 入住日期 hotel_info HotelInfo 酒店信息 └ region String 东城区行政区 └ city_id String 11 城市Code └ phone String 11222333 酒店电话 └ city_name String 北京城市名称 └ address String 长安街酒店地址 └ name String 北京大酒店酒店名称 └ lng String 32.22442 经度 └ lat String 113.232323 纬度 └ checkout String 2018-12-31 离店日期 room_offer_details RoomOfferDetails [] offer信息 └ offer_id String 1fb636f6d9a39181132dade894fd6c7a\|242.40\|CNY\|standard\|standard\|singleroom\| offerid └ cancellation_fee_percent String 10 取消扣款比例 └ breakfast_price String 15 早餐价格 └ room_type_name String 双床房房型名称 └ rate_plan_name String 连住3天特惠售卖计划名称 └ room_count String 2 房间数量 └ currency String CNY 币种 └ room_status String canbooking 房态，房态 canbooking：可订；notavailable：不可订 └ credit_card_security_code_required Boolean true 是否必须信用卡支付 └ exclusive_rate Boolean false 是否独家价格 └ cancelable Boolean true 是否可以取消 └ guarantee_type String standard 担保类型：standard：标准(无担保), guaranteed：个人担保, guaranteed_by_company：企业担保 └ must_guarantee_if_etp Boolean false 如果企业垫付是否必须担保 └ credit_card_reservation_only Boolean true 是否只支持信用卡预定 └ hotel_key String 252454 酒店唯一key └ hot_deal Boolean false 是否热卖 └ offer_detail String {} 可以是offerdetail的JSON字符串 └ room_type_desc String 标准间: 标准双人房, 双床1.1米、2-5楼、20平米、免费宽带、可入住2人房型说明 └ cancellation_deadline String 2018-11-10 18:00:00 最晚取消时间 rate_items RateItems [] 每日报价 └ room_status String canbooking 房态，房态 canbooking：可订；notavailable：不可订 └ room_price_hotel String 300 报价 └ date String 2018-11-10 币种 └ rate_plan_id String 1fb636f6d9a39181132dade894fd6c7a\|242.40\|CNY\|standard\|standard\|singleroom\| 售卖计划唯一 ID └ room_type_id String 1fb636f6d9a39181132dade894fd6c7a\|242.40\|CNY\|standard\|standard\|singleroom\| 房型唯一ID └ breakfast_type String inclusive 早餐类型：exclusive：不含早, unknown：未知, not_available：不支持, variant：可变的, inclusive：含早, inclusive_half_board：单早，inclusive_double_board: 双早 └ high_season Boolean false 是否旺季 └ guarantee_rule String 在18.11.08至18.11.20入住需要您提供信用卡担保。客人入住日12:00点前可以变更取消，之后无法变更取消，如未入住，将扣除第一晚房费作为违约金。担保规则描述 └ average_room_price_hotel String 200 平均价格 └ payment_mode String 1 支付类型，1: 企业垫付 2:个人支付 └ adult_count String 2 入住人数 credit_card_list CreditCardList [] 信用卡信息 └ credit_card_showcvvtext String 安全码 353 └ credit_card_holder String 张三持卡人 └ credit_card_number String VISA卡号卡号 └ credit_card_show_creditcard_infos String 黑卡卡信息 └ credit_card_validity String 12/22 mm/yy └ credit_card_type String VISA 卡类型
errmsg	String	success	错误码

{"id_type":"asmksmdksmdksm","order_id":"1122333"}

{
    "errno":"0",
    "data":{
        "order":{
            "total_amount":"1000",
            "buyer_xuser_name":"王超",
            "memo":"测试TC",
            "total_amount_currency_code":"CNY",
            "payment_mode":"1",
            "uuid":"e2a5ec15-e5fd-4392-9c91-a60a7a0c9a15",
            "order_status":"reserved"
        },
        "people_contact_list":[
            {
                    "fax":"汾酒的fax",
                    "memo":"汾酒作为联系人的memo",
                    "email":"xiaolei.zhang@alibaba-inc.com",
                    "tel":"汾酒的tel",
                    "name":"汾酒",
                    "country_code":"CN",
                    "mobile_num":"13337700111"
            }
        ],
        "people_tourist_list":[
            {
                    "tourist_type":"0",
                    "first_name":"王",
                    "birthday":"2000-01-01",
                    "sex":"2",
                    "nationality":"中国",
                    "name":"王兵",
                    "last_name":"兵",
                    "room_index":"1"
            }
        ],
        "hotel_item_list":[
            {
                    "checkin":"2018-12-28",
                    "hotel_info":{
                        "region":"东城区",
                        "city_id":"11",
                        "phone":"11222333",
                        "city_name":"北京",
                        "address":"长安街",
                        "name":"北京大酒店",
                        "lng":"32.22442",
                        "lat":"113.232323"
                    },
                    "checkout":"2018-12-31",
                    "room_offer_details":[
                        {
                                "offer_id":"1fb636f6d9a39181132dade894fd6c7a|242.40|CNY|standard|standard|singleroom|",
                                "cancellation_fee_percent":"10",
                                "breakfast_price":"15",
                                "room_type_name":"双床房",
                                "rate_plan_name":"连住3天特惠",
                                "room_count":"2",
                                "currency":"CNY",
                                "room_status":"canbooking",
                                "credit_card_security_code_required":true,
                                "exclusive_rate":false,
                                "cancelable":true,
                                "guarantee_type":"standard",
                                "must_guarantee_if_etp":false,
                                "credit_card_reservation_only":true,
                                "hotel_key":"252454",
                                "hot_deal":false,
                                "offer_detail":"{}",
                                "room_type_desc":"标准间: 标准双人房, 双床1.1米、2-5楼、20平米、免费宽带、可入住2人",
                                "cancellation_deadline":"2018-11-10 18:00:00",
                                "rate_items":[
                                    {
                                            "room_status":"canbooking",
                                            "room_price_hotel":"300",
                                            "date":"2018-11-10"
                                    }
                                ],
                                "rate_plan_id":"1fb636f6d9a39181132dade894fd6c7a|242.40|CNY|standard|standard|singleroom|",
                                "room_type_id":"1fb636f6d9a39181132dade894fd6c7a|242.40|CNY|standard|standard|singleroom|",
                                "breakfast_type":"inclusive",
                                "high_season":false,
                                "guarantee_rule":"在18.11.08至18.11.20入住需要您提供信用卡担保。客人入住日12:00点前可以变更取消，之后无法变更取消，如未入住，将扣除第一晚房费作为违约金。",
                                "average_room_price_hotel":"200",
                                "payment_mode":"1",
                                "adult_count":"2"
                        }
                    ]
            }
        ],
        "credit_card_list":[
            {
                    "credit_card_showcvvtext":"安全码",
                    "credit_card_holder":"张三",
                    "credit_card_number":"VISA卡号",
                    "credit_card_show_creditcard_infos":"黑卡",
                    "credit_card_validity":"12\/22",
                    "credit_card_type":"VISA"
            }
        ]
    },
    "errmsg":"success"
}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

欢行开发平台API

qimen.alibaba.happytrip.hotel.order.get (订单信息查询)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ