酒店复核列表接口


酒店复核列表接口

功能介绍

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

复核订单相关数据的任何变更,都会将复核订单输出至增量列表中。

可用于租户查询。

复核是指订单和供应商、员工反馈对比后的核对结果,结算报销等需要准确费用的情况使用复核数据。在没有三方核对前(未复核),复核单数据与订单数据一致。

调用方法

POST

URI

/napi/enterprise/hotel/recheck/list

请求参数

名称

类型

是否必选

描述

msgId

String

消息id,保持唯一

corpCode

String

企业编码,传了查询指定企业,不传查询租户

language

String

语言 zh:中文 en:英文,不填默认为中文

orderId

String

酒店订单号,根据订单号查询,有orderId的前提下不考虑changeStartTime和changeEndTime

changeStartTime

String

变更开始时间 描述:包含当前时间 举例值:yyyyMMddHHmmss。包含

changeEndTime

String

变更结束时间 描述:不包含当前时间,查询跨度不超过24小时 举例值:yyyyMMddHHmmss。不包含

pageIndex

Integer

查询的页码

size

Integer

每页条数描述:建议20,上限50

businessType

String

业务类型:CHOTEL:国内酒店,IHOTEL:国际酒店

privacyPolicy

String

隐私策略, NORMAL:正常返回, NORETURN:不返回, DESENSITIZED:脱敏返回, 不传则脱敏返回(默认)

响应参数

名称

类型

是否必选

描述

resultCode

String

错误码

description

String

错误描述

pageIndex

Integer

页码

size

Integer

每页条数

total

Integer

总记录数

recheckList

List<RecheckInfo>

复核列表

RecheckInfo

名称

类型

是否必选

描述

orderId

String

订单号

recheckOrderId

String

复核单号

checkinDate

String

实际入住日期 yyyyMMdd

checkoutDate

String

实际离店日期 yyyyMMdd

checkinPersonList

List< RecheckCheckinPerson>

入住人信息

moreHalfDay

Boolean

是否多半天

roomNight

BigDecimal

间夜

roomPrice

BigDecimal

房费

serviceFee

BigDecimal

服务费

recheckStatus

String

复核状态:0:未复核,1:已复核,2:已关闭

recheckTime

String

复核时间 yyyyMMddHHmmss

dailyPriceList

List< NApiRecheckDailyPrice>

每日价格信息

currency

String

应收币种,默认CNY 人民币

payWay

String

支付方式:0:员工电子流,1:在线支付,14:到店付款,3:个人现金,4:个人pos,5:关联月结,6:因公欠款,8:担保欠款,10:外部月结,11:转账

RecheckCheckinPerson

名称

类型

是否必选

描述

checkinPersonName

String

入住人姓名,由入参PrivacyPolicy决定是否返回或者返回匿名化结果

staffId

String

入住人工号

RecheckDailyPrice

名称

类型

是否必选

描述

date

String

日期 yyyyMMdd

roomPrice

BigDecimal

房价

请求示例

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

响应示例

{
    "resultCode": "0",
    "description": "成功",
    "pageIndex": 1,
    "size": 20,
    "total": 4,
    "recheckList": [
        {
            "orderId": "G0125102014180540213",
            "recheckOrderId": "ARG0125102014180540213-1",
            "checkinDate": "20251019",
            "checkoutDate": "20251020",
            "checkinPersonList": [
                {
                    "checkinPersonName": "tian******",
                    "staffId": "30061580"
                }
            ],
            "moreHalfDay": false,
            "roomNight": 1,
            "roomPrice": 102,
            "serviceFee": 10.2,
            "recheckStatus": "1",
            "recheckTime": "20251202153525",
            "dailyPriceList": [
                {
                    "date": "20251019",
                    "roomPrice": 102
                }
            ],
            "currency": "CNY",
            "payWay": "10"
        },
        {
            "orderId": "G0125102014180540213",
            "recheckOrderId": "ARG0125102014180540213-2",
            "checkinDate": "20251019",
            "checkoutDate": "20251020",
            "checkinPersonList": [
                {
                    "checkinPersonName": "si*********",
                    "staffId": "wx1341299"
                }
            ],
            "moreHalfDay": false,
            "roomNight": 1,
            "roomPrice": 102,
            "serviceFee": 10.2,
            "recheckStatus": "1",
            "recheckTime": "20251202153525",
            "dailyPriceList": [
                {
                    "date": "20251019",
                    "roomPrice": 102
                }
            ],
            "currency": "CNY",
            "payWay": "10"
        },
        {
            "orderId": "H0125112114403542882",
            "recheckOrderId": "ARH0125112114403542882-1",
            "checkinDate": "20251201",
            "checkoutDate": "20251202",
            "checkinPersonList": [
                {
                    "checkinPersonName": "李**",
                    "staffId": ""
                }
            ],
            "moreHalfDay": false,
            "roomNight": 1,
            "roomPrice": 220,
            "serviceFee": 10,
            "recheckStatus": "2",
            "recheckTime": "20251202160311",
            "dailyPriceList": [
                {
                    "date": "20251201",
                    "roomPrice": 220
                }
            ],
            "currency": "CNY",
            "payWay": "10"
        },
        {
            "orderId": "H0125120209391643689",
            "recheckOrderId": "ARH0125120209391643689-1",
            "checkinDate": "20251202",
            "checkoutDate": "20251203",
            "checkinPersonList": [
                {
                    "checkinPersonName": "陈*",
                    "staffId": ""
                }
            ],
            "moreHalfDay": false,
            "roomNight": 1,
            "roomPrice": 50,
            "serviceFee": 0,
            "recheckStatus": "1",
            "recheckTime": "20251203092426",
            "dailyPriceList": [
                {
                    "date": "20251202",
                    "roomPrice": 50
                }
            ],
            "currency": "CNY",
            "payWay": "10"
        }
    ]
}