酒店订单列表接口

功能介绍

企业可调用此接口获取酒店订单列表数据，可根据时间范围查询有变更的订单，并返回订单的最新数据。

订单相关数据的任何变更，都会将订单输出至增量列表中，不仅仅是订单状态变化。

如果收到相同状态的更新，可能是状态的内部变化或者订单其他数据发生了变化，通过调用订单详情接口获取详细变更信息。

可用于租户查询。

调用方法

POST

URI

/napi/enterprise/hotel/order/list

请求参数

名称	类型	是否必选	描述
msgId	String	是	消息id，保持唯一
corpCode	String	否	企业编码，传了查询指定企业，不传查询租户
language	String	否	语言 zh：中文 en：英文，不填默认为中文
orderId	String	否	订单号，传值时不考虑changeStartTime和changeEndTime
changeStartTime	String	否	变更开始时间 yyyyMMddHHmmss，订单号为空时必填。包含
changeEndTime	String	否	变更结束时间 yyyyMMddHHmmss，订单号为空时必填，时间查询跨度不超过24小时。不包含
pageIndex	Integer	是	查询的页码
size	Integer	是	每页条数描述：建议20，上限50
businessType	String	否	业务类型，CHOTEL:国内酒店,IHOTEL:国际酒店,ALL:全部,ALL:查全部,不传默认 ALL

响应参数

名称	类型	是否必选	描述
resultCode	String	是	错误码
description	String	是	错误描述
pageIndex	Integer	否	查询的页码
size	Integer	否	每页条数,建议20，上限50
total	Integer	否	总记录数
orderList	List<ListOrderInfo>	否	订单列表

ListOrderInfo

名称	类型	是否必选	描述
orderId	String	是	订单号
orderStatus	String	是	订单状态:1:待确认,3:已确认,7:已取消,9:待支付,11:已复核
travelType	String	是	出行方式:BUSINESS:因公,PRIVATE:因私
payWay	String	是	支付方式:0:员工电子流,1:在线支付,14:到店付款,3:个人现金,4:个人pos,5:关联月结,6:因公欠款,8:担保欠款,10:外部月结,11:转账
payStatus	String	否	支付状态:0:未支付,1:已支付
roomPrice	BigDecimal	是	房价
serviceFee	BigDecimal	是	服务费
currency	String	是	币种
hotelName	String	是	酒店名称
roomTypeName	String	是	房型
breakfastNum	Integer	是	早餐数:0:无早餐,1:1份早餐,2:2份早餐,N:N份早餐,99:含早
createTime	String	是	下订单时间 yyyyMMddHHmmss
checkinDate	String	是	入住日期 yyyyMMdd
checkoutDate	String	是	退房日期 yyyyMMdd
enterpriseTrId	String	否	企业客户系统审批单编号
changeTime	String	是	变更时间

请求示例

{	
    "orderId":"",
    "corpCode": "",
    "language": "zh",
    "msgId": "4142413413414",
    "privacyPolicy":"DESENSITIZED",
    "changeStartTime":"20251202000000",
    "changeEndTime":"20251203000000",
    "pageIndex":1,
    "size":20,
    "businessType":"ALL"
}

响应示例

{
    "resultCode": "0",
    "description": "成功",
    "pageIndex": 1,
    "size": 20,
    "total": 5,
    "orderList": [
        {
            "orderId": "H0125112115083842904",
            "orderStatus": "11",
            "travelType": "BUSINESS",
            "payWay": "10",
            "roomPrice": 660,
            "serviceFee": 30,
            "currency": "CNY",
            "hotelName": "木兰酒店",
            "roomTypeName": "标准山景房",
            "breakfastNum": 0,
            "createTime": "20251121150839",
            "checkinDate": "20251123",
            "checkoutDate": "20251126",
            "enterpriseTrId": "",
            "changeTime": "20251202163306"
        },
        {
            "orderId": "H0125120211360543711",
            "orderStatus": "1",
            "travelType": "BUSINESS",
            "payWay": "6",
            "roomPrice": 440,
            "serviceFee": 0,
            "currency": "CNY",
            "hotelName": "木兰酒店",
            "roomTypeName": "标准山景房",
            "breakfastNum": 0,
            "createTime": "20251202113606",
            "checkinDate": "20251202",
            "checkoutDate": "20251204",
            "enterpriseTrId": "TA0612134418",
            "changeTime": "20251202113801"
        },
        {
            "orderId": "H0125120211281443705",
            "orderStatus": "1",
            "travelType": "BUSINESS",
            "payWay": "6",
            "roomPrice": 400,
            "serviceFee": 0,
            "currency": "CNY",
            "hotelName": "木兰酒店",
            "roomTypeName": "渠道分销房",
            "breakfastNum": 0,
            "createTime": "20251202112816",
            "checkinDate": "20251202",
            "checkoutDate": "20251204",
            "enterpriseTrId": "TA0612138933",
            "changeTime": "20251202112816"
        },
        {
            "orderId": "H0125120210495843699",
            "orderStatus": "1",
            "travelType": "BUSINESS",
            "payWay": "10",
            "roomPrice": 204,
            "serviceFee": 0,
            "currency": "CNY",
            "hotelName": "深圳东方银座美爵酒店",
            "roomTypeName": "高级客房（大/双床）",
            "breakfastNum": 0,
            "createTime": "20251202104959",
            "checkinDate": "20251213",
            "checkoutDate": "20251215",
            "enterpriseTrId": "",
            "changeTime": "20251202105100"
        },
        {
            "orderId": "H0125120209391643689",
            "orderStatus": "11",
            "travelType": "BUSINESS",
            "payWay": "10",
            "roomPrice": 50,
            "serviceFee": 0,
            "currency": "CNY",
            "hotelName": "南京奥体博览中心希尔顿欢朋酒店",
            "roomTypeName": "12321(部分有窗)",
            "breakfastNum": 0,
            "createTime": "20251202093917",
            "checkinDate": "20251202",
            "checkoutDate": "20251203",
            "enterpriseTrId": "TA0612139595",
            "changeTime": "20251202094057"
        }
    ]
}