酒店订单详情接口

功能介绍

企业可调用此接口获取酒店订单详情数据。

可用于租户查询。

调用方法

POST

接口URL

/napi/enterprise/hotel/order/detail

请求参数

名称	类型	是否必选	描述
msgId	String	是	消息id，保持唯一
corpCode	String	否	企业编码，传了查询指定企业，不传查询租户
language	String	否	语言 zh：中文 en：英文，不填默认为中文
orderId	String	是	订单号
privacyPolicy	String	否	隐私策略, NORMAL:正常返回, NORETURN:不返回, DESENSITIZED:脱敏返回, 不传则脱敏返回（默认）

响应参数

名称	类型	是否必选	描述
resultCode	String	是	错误码
description	String	是	错误描述
orderId	String	是	订单号
orderBase	OrderBase	是	订单基本信息
hotelInfo	HotelInfo	是	酒店信息
checkinPersonList	List<OrderDetailCheckinPerson>	是	入住人列表
contactList	List<ContactInfo>	是	联系人列表
dailyPriceList	List<DailyPrice>	是	每日价格信息

OrderBase

名称	类型	是否必选	描述
checkinDate	String	是	入住日期 yyyyMMdd
checkoutDate	String	是	离店日期 yyyyMMdd
clientRemark	String	否	客人备注，用户下单时填写的备注
orderStatus	String	是	订单状态：1:待确认,3:已确认,7:已取消,9:待支付,11:已复核
roomPrice	BigDecimal	是	房费
serviceFee	Number	是	服务费
currency	String	是	币种，如 CNY
guaranteeFormat	String	是	担保方式:0:不担保,1:平台担保,2:第三方担保
guaranteeType	String	否	担保类型:1:首晚担保,2:全额担保,3:比例,4:固定金额,5:晚数
travelType	String	是	出行方式:BUSINESS:因公,PRIVATE:因私
roomNum	Integer	是	房间数
breakfastNum	Integer	是	早餐数:0:无早餐,1:1份早餐,2:2份早餐,N:N份早餐,99:含早
freeCancelTime	String	否	免费取消时间 yyyyMMddHHmmss
latestCancelTime	String	否	最晚取消时间 yyyyMMddHHmmss
latestArrivalTime	String	否	最晚到店时间 yyyyMMddHHmmss
enterpriseTrId	String	否	企业客户系统的审批单编号
bookingChannel	String	否	预订渠道
payWay	String	是	支付方式:0:员工电子流,1:在线支付,14:到店付款,3:个人现金,4:个人pos,5:关联月结,6:因公欠款,8:担保欠款,10:外部月结,11:转账
payDetailList	List< PayRecordDetail>	否	支付明细，用于混合支付时区分因公因私各自承担的费用
protocolSource	Boolean	否	是否协议资源
cancelPolicyType	String	否	取消标识:FREE_CANCEL:免费取消,CANCEL_AND_PENALTY:限时取消,NO_CANCEL:不可取消

HotelInfo

名称	类型	是否必选	描述
cityId	String	是	城市Id
cityName	String	是	城市名称
countryId	String	是	国家Id
countryName	String	是	国家名称
hotelId	String	是	酒店Id
hotelName	String	是	酒店名称
hotelPhone	String	否	酒店电话
hotelAddr	String	否	酒店地址
hotelStar	String	否	酒店星级:2:二星(钻)及以下/经济型,3:三星(钻)/舒适型,4:四星(钻)/高档型,5:五星(钻)/豪华型
hotelStarRating	String	否	酒店钻级:2:二星(钻)及以下/经济型,3:三星(钻)/舒适型,4:四星(钻)/高档型,5:五星(钻)/豪华型。酒店星级和酒店钻级相互补充，没有星级时则会用钻级。
roomTypeName	String	是	房型
bedTypeName	String	是	床型名称

PayRecordDetail

名称	类型	是否必选	描述
payWay	String	是	支付方式:0:员工电子流,1:在线支付,14:到店付款,3:个人现金,4:个人pos,5:关联月结,6:因公欠款,8:担保欠款,10:外部月结,11:转账
amount	BigDecimal	是	金额

OrderDetailCheckinPerson

名称	类型	是否必选	描述
checkinPersonName	String	是	入住人姓名，由入参决定是否返回或者返回匿名化结果
gender	String	否	性别:M:男,F:女
nationality	String	否	国籍

ContactInfo

名称	类型	是否必选	描述
contactName	String	是	联系人姓名，英文姓名之间用 / 间隔，比如，Zhang/sa，由入参决定是否返回或者返回匿名化结果
contactMobile	String	否	联系人手机号，由入参决定是否返回或者返回匿名化结果
phoneCountryCode	String	否	联系人手机国家码
contactMail	String	否	联系人邮件，由入参决定是否返回或者返回匿名化结果

DailyPrice

名称	类型	是否必选	描述
date	String	是	日期 yyyyMMdd
roomPrice	BigDecimal	是	房价

请求示例

{	
    "orderId":"H0125120210090343692",
    "corpCode": "",
    "language": "en",
    "msgId": "200214098490218492018491",
    "privacyPolicy":"DESENSITIZED"
}

响应示例

{
    "resultCode": "0",
    "description": "成功",
    "orderId": "H0125120210090343692",
    "orderBase": {
        "checkinDate": "20251202",
        "checkoutDate": "20251205",
        "clientRemark": "",
        "orderStatus": "3",
        "roomPrice": 3,
        "serviceFee": 11,
        "currency": "CNY",
        "guaranteeFormat": "0",
        "guaranteeType": null,
        "travelType": "BUSINESS",
        "roomNum": 1,
        "breakfastNum": 3,
        "freeCancelTime": "20251203060000",
        "latestCancelTime": "20251203060000",
        "latestArrivalTime": "20251202180000",
        "enterpriseTrId": null,
        "bookingChannel": null,
        "payWay": "10",
        "payDetailList": [],
        "protocolSource": true,
        "cancelPolicyType": "FREE_CANCEL"
    },
    "hotelInfo": {
        "cityId": "156320100",
        "cityName": "Nanjing",
        "countryId": null,
        "countryName": "China",
        "hotelId": "1004418369",
        "hotelName": "GP Test Hotel",
        "hotelPhone": "19014521236",
        "hotelAddr": "Xinjiekou",
        "hotelStar": "0",
        "hotelStarRating": "5",
        "roomTypeName": "Deluxe Mountain view Double room",
        "bedTypeName": "Big bed"
    },
    "checkinPersonList": [
        {
            "checkinPersonName": "郭*",
            "gender": "M",
            "nationality": "CN"
        }
    ],
    "contactList": [
        {
            "contactName": "GUO*****",
            "contactMobile": "190****8563",
            "phoneCountryCode": "+86",
            "contactMail": "1*5@H.com"
        }
    ],
    "dailyPriceList": [
        {
            "date": "20251202",
            "roomPrice": 1,
            "serviceFee": null
        },
        {
            "date": "20251203",
            "roomPrice": 1,
            "serviceFee": null
        },
        {
            "date": "20251204",
            "roomPrice": 1,
            "serviceFee": null
        }
    ]
}