Skip to main content

价格和销售限制条款

接入方获取酒店一段时间内房价和销售限制条款，返回结果为数组，数组顺序与日期对应

请求方式#

POST

uri: /ari/daily/offers

Content-Type: application/json

请求参数说明#

RequestHeader#

公共请求头[引用]

RequestBody#

参数类型是否必填最大长度示例描述
hotelIdStringY3212**567华住酒店ID
startDateDateY-2021-10-01开始日期，格式 yyyy-MM-dd
endDateDateY-2021-10-02结束日期，格式 yyyy-MM-dd (查询出的ARI包含这一天)，一次最大支持开始结束间隔30天的报价，即endDate-startDate=29
checkinTypeStringY16DAY入住类型，区分大小写，取值参考枚举
productCandidatesList<ProductCandidate>N-传则查询指定商品
不传则查询酒店在开始至结束日期内的全部房价和销售限制条款信息

ProductCandidate#

参数类型是否必填最大长度示例描述
roomTypeCodeStringY64DR1房型Code
rateCodeStringY64Base-NTR房价码

响应参数说明#

公共响应参数[引用]

响应码-code[引用]

content#

参数类型是否必填最大长度示例描述
hotelIdStringY32华住酒店ID
startDateStringY-2021-10-01开始日期，格式 yyyy-MM-dd
endDateStringY-2021-10-02结束日期，格式 yyyy-MM-dd (查询出的房价、销售限制条款包含这一天)，一次最大支持开始结束间隔30天的报价，即endDate-startDate=29
dailyOffersList<DailyOffers>Y-房价、销售限制条款列表

DailyOffers#

参数类型是否必填最大长度示例描述
roomTypeCodeStringY64DR1房型Code
rateCodeStringY64Base-NTR房价码[引用]
currencyCodeStringY8CNY价格对应的币种，目前国内只有CNY，参考国际标准： ISO-4217
ratesList<RateInfo >Y-包含endDate，几人价（每日房价信息）
mealPlanTypeStringY8餐饮类型
mealPlanCountsList<Integer>Y-对应餐饮类型每天数量
restrictionRestrictionInfoY-包含endDate，每日限制条款信息
guaranteePoliciesList<GuaranteePolicy >Y-包含endDate，担保政策，按照预定入住日规则为准进行下单
cancelPoliciesList<CancelPolicy >Y-包含endDate，取消政策，按照预定入住日规则为准进行下单

RateInfo#

参数类型是否必填最大长度示例描述
rackRateList<BigDecimal>N-[ 110, 130]门市价，门市价可能为空
amountBeforeTaxList<BigDecimal>N-[ 100, 120]不含税价
amountAfterTaxList<BigDecimal>Y-[ 100, 130]含税价
maxAdultCountIntegerY-1最大成人数，小于等于maxAdultCount的价格与此节点对应，如maxAdultCount为2，则2人 1人都可用2人价
maxChildCountIntegerN-2最大儿童数，为null表示不限制
childAgesList<Integer>N-长度为2的list儿童年龄段，长度需与最大儿童数量保持一致，为null表示不限制

GuaranteePolicy#

参数类型是否必填最大长度示例描述
codeStringY32担保政策code，取值参考枚举

CancelPolicy#

参数类型是否必填最大长度示例描述
codeStringY64取消政策code，取值参考code规则

RestrictionInfo#

参考说明示例：销售条款示例

参数类型是否必填最大长度示例描述
closeList<Boolean>Y-每日关房状态，true：关房， false：未关房，元素为null表示开
minStayArrivalList<Integer>Y-每日最小连住天数，针对订单入住首日生效，元素为null表示不限制
maxStayArrivalList<Integer>Y-每日最大连住天数，针对订单入住首日生效，元素为null表示不限制
minStayThroughList<Integer>Y-每日穿过最小连住天数，针对订单经过那天生效，元素为null表示不限制
maxStayThroughList<Integer>Y-每日穿过最大连住天数，针对订单经过那天生效，元素为null表示不限制
minAdvanceDayList<Integer>Y-每日最小提前预订天数，针对订单入住首日生效，元素为null表示不限制
maxAdvanceDayList<Integer>Y-每日最大提前预订天数，针对订单入住首日生效，元素为null表示不限制
ctaList<Boolean>Y-每日是否可到达Close To Arrival (CTA)，针对订单入住首日生效，true：可以； false：不可到达，元素为null表示不限制
ctdList<Boolean>Y-每日是否可离店Close To Departure (CTD)，针对订单离店日生效，true：可以； false：不可离店，元素为null表示不限制
fplosList<String>Y-每日全程连住天数限制Full Patten LOS，每日设置最长31位，元素为null或空字符串表示不限制

响应码#

异常码异常类型说明
1000Success
4201Invalid hotel Id酒店Id不存在
4202Hotel is closed酒店停业
4203Start date and end date does not match the rules开始结束日期不符合规则
4204End date is invalid结束日期无效
4205Start date is invalid开始日期无效
4206No match found未找到与条件匹配的数据
其他全局异常码全局异常[引用]

报文示例#

Case1: 查询酒店下ARI#

请求示例#

{    "hotelId":"12**567",    "startDate":"2021-10-06",    "endDate":"2021-10-07",    "checkinType":"DAY"}

响应成功示例#

{    "code":1000,    "content":{        "hotelId":"12**567",        "startDate":"2021-10-06",        "endDate":"2021-10-07",        "dailyOffers":[            {                "roomTypeCode":"ERX1",                "rateCode":"Base-NTR",                "currencyCode":"CNY",                "rates":[                    {                        "maxAdultCount":2,                        "rackRate":[                            330,                            330                        ],                        "amountAfterTax":[                            328,                            328                        ],                        "amountBeforeTax":[                            309,                            309                        ]                    }                ],                "mealPlanType":"BB",                "mealPlanCounts":[                    1,                    1                ],                "guaranteePolicies":[                    {                        "code":"PL"                    },                    {                        "code":"PN"                    }                ],                "cancelPolicies":[                    {                        "code":"AD0_0"                    },                    {                        "code":"AD100_6PM0D1N_1N"                    }                ],                "restriction":{                    "close":[                        false,                        false                    ],                    "cta":[                        false,                        false                    ],                    "ctd":[                        false,                        false                    ],                    "maxAdvanceDay":[                        999,                        999                    ],                    "maxStayArrival":[                        999,                        999                    ],                    "maxStayThrough":[                        0,                        0                    ],                    "minAdvanceDay":[                        3,                        3                    ],                    "minStayArrival":[                        5,                        5                    ],                    "minStayThrough":[                        0,                        0                    ],                    "fplos": [                      "0000000",                      "1110111"                    ]                }            }        ]    }}

响应失败示例#

{    "code":4206,    "message":"No match found"}