艺龙酒店api接口说明文档_v11新－

艺龙酒店api接口说明文档_v11新－内容摘要：

须输入， ID 的具体数值从 中获取 CommercialLocationId String 商业区 ID 空 Y LandmarkLocationID String 标志物 ID 空 Y OpeningDate DateTime 开业日期 00010101 00:00:00 Y 暂不支持 ，默认填写 00010101 00:00:00 DecorationDate DateTime 装修日期 00010101 00:00:00 Y 暂不支持 ，默认填写 00010101 00:00:00 RoomAmount Int 房间数量 0 Y 默认为 1，暂不支持 OrderByCode String 排序标准 空 Y elong：默认 star：按星级 price：按价格 distance：按距离 OrderTypeCode String 排序类型 空 Y asc :升序 desc:降序 PageIndex Int 分页页数 0 Y 默认 从 1 开始 MaxRows Int 最大返回记录数 0 Y 0 或空表示不限制 如果超过 elong 默认的最大记录数，则以elong设置为准，默认最大为 20 CurrencyCode String 空 RMB ：人民币 USD ： 美元 HKD ：港元 MOP ：澳元（ 暂 不支持） SGD ：新币（ 暂 不支持） ， 此查询条件 暂时不提供 输出参数 字段 类型 描述 可为 空 备注 HotelCount Int 酒店个数 N 查询结果中返回的酒店个数 Hotels Hotels 包含 n 个 Hotel 数组 Hotel Hotel 数组 HotelName String 酒店名称 N HotelId String 酒店 ID N StarCode String 星级代码 N 参见 静态数据文件 HotelAddress String 酒店地址 N HotelInvStatusCode String 酒店房态 N 0正常 1部分日期满房， 2全部满房 LowestPrice Decimal 酒店最低价 N Rooms Rooms 下包含 n 个 Room数组，参见下面介绍 HotelPromotions 酒店活动 节点 Rooms节点包含多个 Room子节点， Room 节点对应字段说明为 ： Room N RoomName String 房型名称 N RoomTypeId String 房型 ID N RoomInvStatusCode String 房型房态 N 0正常 1部分日期满房， 2全部满房 RatePlans RatePlan 数组 节点 RatePlans节点包含多个 RatePlan子节点， RatePlan 节点对应字段说明为 ： RatePlan RatePlanID Int RPID 艺龙在房型基础上把产品进一个细分，细分后的每一产品称为 RatePlan，简称 RP RatePlanCode String RP 业务编码 RatePlanName String RP 名称 GuestTypeCode String 客人 类型代码 参见 静态数据 文件 Rates N RP 价格数组 ，参见下面介绍 GaranteeRules Y 担保规则数组 ，参见下面介绍 BookingRuless Y 预订规则数组 ，参见下面 介绍 AddValues Y 增值服务信息数组 ，参见下面介绍 AddValuesDescription Y 增值服务信息描述 ，参见下面介绍 DRRRules Y 产品促销规则数组 ，参见下面介绍 HotelPromotions Y 酒店促销活动数组，参见下面介绍 节点 Rates对应字段说明为： Rates 房价数组 TotalPrice Decimal 总价 CurrencyCode String 货币代码 TaxesAmount Int 税费节点， 包含类型，价格，暂不 使用 Rate 每日价格数组 节点 Rate对应字段说明为： Rate 每日价格数组 Date DateTime 对应日期 N 假设你查询 2020105 到 2020107 价格，则对应Rate 展示 3 天（ 5， 6， 7）价格数据（ Rate） CurrencyCode String 货币代码 InvStatusCode String 每日房态 N 0正常 2全部满房 RetailRate Decimal 门市价 N MemberRate Decimal 会员价格 N 预订酒店价格 ，返回 1 代表此房无价，无价和满房都不能进行预订 AddBedRate Decimal 加床价格 Y 返回 1 代表不能加床 节点 GaranteeRules 节点包含多个 GaranteeRule子节点， GaranteeRule 节点对应字段说明为 ： GaranteeRules GaranteeRule GaranteeRulesTypeCode Int 担保规则类型 1 信用卡 日期担保 2 信用卡 房量担保 RuleValues DictionaryEntry 规则的具体数据数组 , 规则有几个参数，对应几个节点值 Description String 节点 RuleValues对应字段说明为： RuleValues Key 对应担保条件字段 N Value 对应担保条件值 Y RuleValue 项说明： 项 示例值 说明 备注 StartDate 20200504 00:00:00 需要担保开始时间 EndDate 20201231 00:00:00 需要担保结束时间 DateType 1 担保条件 入住日期还是在店日期 1 为入住日期 2 为在店日期 3 为预订日期 WeekSet 1,2,3,4,5,6,7 周 有效 天数 Gage 1 信用卡担保 系统默认为 1 信用卡 担保 IsArriveTimeVouch 0 是否 以到店时间为担 保 0 为不担保， 1为担保 当 IsArriveTimeVouch 为1 时， ArriveStatTime、ArriveEndTime 、IsTomorrow 才有值 ArriveStatTime 18:00 到店担保的开始时间 ArriveEndTime 6:00 到店担保的结束时间 IsTomorrow 1 到店担保的结束时间是否为第二天 0 为当天， 1为次日 IsRoomCountVouch 0 是否房量担保 0 为不担保， 1为担保 RoomCount 0 担保的 房间数 ,预定几间房以上要担保 当GaranteeRulesTypeCode为 2 时使用 VouchMoneyType 2 担保金额 , 1为首晚房费， 2为全额房费 IsChange 1 是否允许变更 1为允许变更， 2为不允许变更 ChangeRule 4 担保规则条数， 规则 不允许变更取消 规则 允许变更 /取消 ,需在 到店日期 前几日几时 通知 规则 允许变更 /取消 ,需在最早到店时间之 前 几 小时通知 规则 允许变更 /取消 ,需在到店日期的24 点之前 几 小时通知 当存在规则 4 时，需要查看 DayNum 、HourNum、 TimeNum 数据以及 IsChange 当 ChangeRule=2时， 还需包含字段为： DayNum 2 几天 当担保规则为 2时使用 TimeNum 18： 00 几时 当 ChangeRule=3时， 还需包含字段为： HourNum 6 几个小时 当 ChangeRule=4时， 还需包含字段为： HourNum 6 几个小时 节点 BookingRuless 节点包含多个 BookingRule 子节点， BookingRule 节点对应字段明为 ： BookingRule BookingRuleTypeCode Int 预订规则类型代码 参考预订规则规则类型代码 RuleValues DictionaryEntry 规则的具体数据数组 , 规则有几个参数，对应几个节点值 Description String RuleValue 项说明： 项 示例值 说明 备注 StartDate 20200504 00:00:00 预订规则生效开始日期 EndDate 20201231 00:00:00 预订规则生效结束日期 DateType 1 担保条件 入住日期还是在店日期 1 为 入住日期 2 为在店日期 3 为预订日期 ChangeRule 4 预订规则条数， （到店时间要求）几点到几点到店，酒店可能无法安排入住 （到店时间要求）几点到几点到店，酒店可能酌情加收费用 （订单信息要求）预订 N间房，必须提供 N位客人姓名 （订单信息要求）外宾必须提供国籍 （订单信息要求）必须提供客人手机号 当 ChangeRule=1时， 还需包含字段为： StartTime 17:00:00 EndTime 21:00:00 当 ChangeRule=2时， 还需包含字段为： StartTime 17:00:00 EndTime 21:00:00 当 ChangeRule=3时， 还需包含字段为： MustNName 0 0不需提供 1必须满足N间房填写 N 位客人 当 ChangeRule=4时， 还需包含字段为： MustCountry 0 0不需提供 1必须提供 当 ChangeRule=5时， 还需包含字段为： MustHavePhone 0不需提供 1必须提供 节点 AddValues节点包含多个 AddValue 子节点， AddValue 节点对应字段说明为： Addvalue AddValueID Int 增值服务 ID BusinessCode String 业务代码 参考 代码表 BusinessCode IsInclude Int 是否包含在房费中 0不包含 1包含 IncludedCount Int 包含的份数 CurrencyCode String 货币代码 PriceDefaultOption Int 单价默认选项 1金额， 2比例 PriceNumber Decimal 单价 IsAdd Int 是否单加 SinglePriceOption Int 单加单价默认选项 1金额， 2比例 SinglePrice Decimal 单加单价 Description String 节点 DRRRules 节点包含多个 DRRRule子节点， DRRRule 节点对应字段说明为： DRRRule DRRRuleTypeCode Int 产品促销规则类型代码 参 考 产 品 促 销 规 则 类 型 代 码 DRRRuleTypeCode RuleValues DictionaryEntry 规则的具体数据数组 , 规则有几个参数，对应几个节点值 Description String 当 DRRRuleTypeCode=1,2,3,4,5,6,7 时， RuleValue 项说明： 项 示例值 说明 备注 StartDate 20200504 00:00:00 促销生效开始日期 EndDate 20201231 00:00:00 促销生效结束日期 DateType 1 生效日期类型 入住日 期 在店日期 预订日期。