华住商旅对接Q&A
返回码解释
| 返回码 | 错误码返回信息 | 调用接口 | 详细解释 | 处理方案 |
|---|---|---|---|---|
| 200 | 业务处理成功 | 涉及所有接口 | 业务处理成功信息 | 无需处理 |
| 400 | 客户端请求发生的错误 | 涉及所有接口 | 一般性是客户的调用请求参数有问题，由客户在客户端排查下调用链接及参数 | 一般性是客户请求参数问题，客户需要在客户端，排查下调用链接及参数 |
| 430 | 请求被限流 | 可能涉及接口：房量房价相关接口 | 已达到QPS上限 | 请根据华住商旅接入房量房价拉取方案整改（查看华住商旅API接口文档：华住商旅API接口-基础接口列表-酒店信息相关接口中的房量房价接口） |
| 500 | 应用程序繁忙，请稍后再试！ | 可能涉及接口：下单接口 （order/add） | 查看华住商旅API在线接口文档，查看下单接口文档重试机制 | 1、查看下单接口文档重试机制 2、若无法解决，联系华住产研处理 |
| 501 | 您的访问请求可能对网站造成安全威胁, 请求已被阻断 | 涉及所有接口 | 由于接入方非法访问华住对外接口，触发华住集团安全防护机制，自动将访问IP加入华住黑名单 | 联系华住商旅销售及运营，与华住商旅产研反馈，确认信息安全影响后果再执行相关方案 |
| 504 | 请求频繁，请稍后再试 | 涉及所有接口 | 请求频繁，系统自动加锁 | 一般性等待30秒后重新请求 |
| 521 | 企业V卡号或者验证码错误! | 可能涉及接口：所有传输卡号/密码的接口 | 出现521错误原因：卡号或密码写错 | 检查参数中的卡号卡密，确保传输正确的卡号密码 |
| 522 | 企业卡不支持该业务模式! | 可能涉及接口：下单接口 （order/add） | 仅支持个人现付；不支持总对总模式下单，下单接口中总对总字段不能使用isGroup=true | 1、联系商旅运营确认结算方式 2、下单接口总对总字段使用个人现付模式，如：isGroup=false |
| 523 | 企业卡担保方式不正确 | 可能涉及接口：下单接口 （order/add） | 1、担保模式 NONE：无 FIRST_NIGHT：首晚担保 FULL_AMOUNT：全额担保 2、担保模式使用 a、企业协议价按照企业卡的担保模式（运营开卡时确认的担保模式） b、活动价按照房价码担保模式（注：活动价下单时，验价及下单接口必须要传 activityId，否则会视为会员价），判断BookDTO中的guaranteeMode（担保模式）（房量房价接口中activityId不为空就是活动房价码） 3、现付客户不能使用活动价注意事项 由于活动价的担保模式都是需预付，导致因公现付或者因私订单，下单后会在5分钟内自动取消。所以建议因公现付客户或者因私订单不要使用活动价，而是使用企业协议价下单 | 1、联系运营确认企业卡的担保模式设置 2、按照正确担保模式下单传输 |
| 530 | 无权限访问资源! | 涉及所有接口 | 原因：H5对接模式是不允许调用API对接模式的相关接口 | 客户上线时配置是H5对接，只能使用华住商旅H5下的接口。不允许使用华住商旅API对接的接口。 如客户有需求可找中台运营配置 |
| 545 | 获取AccessToken失败 | 涉及所有接口 | 1、使用https方式对外提供服务，调用业务接口前必须先拿到Token，Token有效期为3600秒，失效后需要重新申请，申请新Token将会使旧Token失效。建议将获取到的token放缓存，设置成58分钟失效，有效期内可以重复使用 2、获取token的代码请注意多线程保护，如果多线程同时发起获取token，获取新token就会导致旧的失效，导致线程冲突 | 1、token失效情况出现比较多，一般性重新获取token即可 2、商旅技术服务商，存在服务多个华住商旅企业客户时，需要区分不同客户的卡号，使用各种独立的token，不能混用 |
| 606 | 请求参数过长 | 可能涉及接口：下单接口 （order/add） | 请求参数字符串超过8千字符无法下单；检查下单参数是否有多余参数，对比API下单接口 | 缩短请求字符串 |
| 2700 | 获取房价失败 | 可能涉及接口：房量房价相关接口 | 调用华住商旅下游系统相关接口失败 | 1、重新调用下相关接口重试 2、若无法解决，联系华住产研处理 |
| 2703 | 酒店不存在 | 可能涉及接口：下单和房量房价相关接口 | 酒店可能已在华住商旅渠道下线 | 重新获取酒店列表及酒店相关信息 接口：酒店列表（hotel/getHotelList)、酒店详情(hotel/getHotelComplexList) |
| 2949 | 个人会员价验价、验房量时，所传手机号未查到个人会员信息 | 可能涉及接口：下单接口（order/add） | 手机号没匹配到会员信息 | 手机号对应的会员信息支持根据员工会员认证接口完成员工认证（查看华住商旅API接口文档：华住商旅API接口-扩展接口列表-员工认证类接口）认证完成可关联新的企业并且支持下单个人价格 |
| 3001 | 房量不足，请刷新请求号 | 可能涉及接口：下单接口（order/add） | 当前酒店的房量不足 (重新请求需刷新请求号) | 1、等酒店有房量时重新请求下单 2、重新下单时，需更换请求号 |
| 3004 | 查询订单失败 | 可能涉及接口: 查询接口（order/query） | 调取下游接口失败 | 1、重新调用下相关接口重试 2、若无法解决，联系华住产研处理 |
| 3005 | 下单失败,请使用新请求号重新下单 | 可能涉及接口：下单接口（order/add） | 调取华住商旅的下游系统接口失败 | 出现此错误，直接使用新的请求号重新下单即可 |
| 3006 | 未查询到企业卡的会员信息 | 可能涉及接口：下单接口（order/add）、验价接口（hotel/checkAvailability） | 未查询到企业卡会员等级情况： 1、未设置企业卡等级 2、企业卡已停用 | 联系商务运营跟进处理 |
| 3007 | 订单不存在 | 可能涉及接口：查询订单（order/query） | 1、下单失败了 2、查询订单参数不对，如cardid错误 | 1、下单失败，继续重试下单 2、检查查询参数（一般性TMC经常会出现此问题，一般性都是cardid参数传参不对导致，建议优先检查此参数） |
| 3010 | 最大入住天数不能超过X天 | 可能涉及接口：下单接口 （order/add） | 一单最大入住天数不能超过60天，如果客户有需求，可以让客户下多个订单 | 建议分多次下单 |
| 3012 | 企业卡未建立绑定关系 | 可能涉及接口：下单接口 （order/add） | 此企业卡没有与TMC创建托管关系 | 联系商务运营跟进处理 |
| 3013 | Double Chcek失败 | 可能涉及接口：下单接口（order/add）、验价接口（hotel/checkAvailability） | 没有正确获取房量房价数据 | 1、重新调用下相关接口重试 2、若无法解决，联系华住产研处理 |
| 3014 | Double Check失败，房量不足 | 可能涉及接口：下单接口（order/add）、验价接口（hotel/checkAvailability） | 当前酒店的房量不足 | 等酒店有房量才能下单 |
| 3015 | Double Check失败，房价校验不通过 | 可能涉及接口：下单接口（order/add）、验价接口（hotel/checkAvailability） | 房价校验不通过 | 重新获取房量房价 注：无论是否小规模纳税人酒店，验价和下单需使用字段“afterTaxPrice” |
| 3023 | 订单超过最晚取消时间 | 可能涉及接口：取消订单（order/cancel） | 超过最晚免费取消时间 | 1、接入超时取消接口（查看华住商旅API在线文档-退改签相关接口） 2、与酒店前台协商、由酒店前台取消 |
| 3028 | 订单支付失败 | 可能涉及接口：下单接口 （order/add） | 订单生成后，调用华住商旅支付服务接口，若支付失败，则返回此错误；可能产生的原因，如扣款失败、计算税点差失败等；客户模式：预存款客户、授信月结客户、支付宝代扣客户；订单支付失败后，已产生的订单会被系统自动取消。 | 1、查看下单接口规范，查询订单订单状态，进行相关处理（查看华住商旅API接口文档：华住商旅API对接-基础接口列表-订单相关接口模式中下单相关接口） 2、如若多次下单支付失败，可联系华住产研处理 |
| 3043 | 此活动价要求的担保方式和下单的担保方式不匹配 | 可能涉及接口：下单接口 （order/add） | 活动价担保模式需查看接口房量房价 | 基于房价码来确定使用担保模式的 第一、企业协议价，是判断企业卡的担保模式，在配置公司等级时，就定了 第二、活动房价，判断BookDTO中的guaranteeMode（担保模式）（房量房价接口中activityId不为空就是活动房价码） （注：活动价下单时，验价及下单接口必须要传 activityId，否则会视为会员价） |
| 3044 | 纳税人识别号不能为空 | 可能涉及接口：下单接口 （order/add） | API下单接口中invoiceNo要传值 | 若税号为空，联系华住商旅运营增加纳税人识别号 |
| 3045 | 纳税人识别号不匹配 | 可能涉及接口：下单接口 （order/add） | API下单接口中invoiceNo传值与后台设置不一致 | 联系商旅运营查看纳税人识别号；若缺少税号，联系华住商旅运营增加 |
| 3047 | 房价码不支持 | 可能涉及接口：下单接口 （order/add）、验价接口（hotel/checkAvailability） | 一般性当前活动房价码(国内和国外)未加入配置白名单或者加入黑名单，不支持此企业下单 | 通华住商旅接口，重新获取房量房价，判断当前企业可支持的房价码黑白名单情况进行显示 |
| 3071 | 个人会员下挂公司信息不存在 | 可能涉及接口：下单接口 （order/add） | 使用个人会员价下单，联系人必须先绑定到企业上，否则会提示此错误 | 1、检查联系人是否已经绑定到当前企业上 2、若没有绑定，手机号对应的会员信息支持根据员工会员认证接口完成员工认证（查看华住商旅API接口文档：华住商旅API接口-扩展接口列表-员工认证类接口）认证完成可关联新的企业并且支持下单个人价格 |
| 3075 | 下单传输的个人会员已下挂公司卡号与个人会员实际下挂的公司卡号不一致 | 可能涉及接口：下单接口 （order/add） | 下单传输的个人会员已下挂公司卡号与个人会员实际下挂的公司卡号不一致 | 手机号对应的会员信息支持根据员工会员认证接口完成员工认证 （查看华住商旅API接口文档：华住商旅API接口-扩展接口列表-员工认证类接口）认证完成可关联新的企业并且支持下单个人价格 |
| 3080 | 卡等级和房价码等级不匹配 | 可能涉及接口：下单接口 （order/add） | 企业卡等级与房价码不匹配 | 一般性TMC比较容易报错 1、获取多个等级的房价码，托管公司卡等级没有正确匹配 举例：获取D,J,C,K四个等级房价，托管公司是C，TMC下单时使用了K等级房价码，就会出现此错误 2、公司卡等级已调整，需要重新匹配；可以通过API查询卡等级接口（/member/getCardInfo）确认或者找运营确认 |
| 3082 | 当前房价码暂不支持此签约模式下单 | 可能涉及接口：下单接口 （order/add） | 海外房价码未配置价格 | 找华住商旅运营申请开通海外预订以及海外房价码配置 |
| 3086 | 无效的员工信息，预订人员工编号不正确，请先同步员工信息！ | 可能涉及接口：下单接口 （order/add） | 预订人必须是此企业（bookId）中真实有效的员工且有员工编号 | API对接客户可以通过接口先同步员工信息再下单（查看华住商旅API接口文档：华住商旅API接口-基础接口列表-员工信息同步接口） |
| 3087 | 预订人手机号必须下挂或者认证！ | 可能涉及接口：下单接口 （order/add） | 下单个人价时，预订人必须先下挂或者认证，否则出现此错误参数一般性：bookerPriceType=PERSON | 手机号对应的会员信息支持根据员工会员认证接口完成员工认证（查看华住商旅API接口文档：华住商旅API接口-扩展接口列表-员工认证类接口）认证完成可关联新的企业并且支持下单个人价格 |
| 3088 | 无效的员工信息，预订人员工编号和预订人手机号不正确，请先同步员工信息！ | 可能涉及接口：下单接口 （order/add） | 预订人必须是此企业（bookId）中真实有效的员工且有员工编号和手机号 | 通过API接口先同步员工信息再下单（查看华住商旅API接口文档：华住商旅API接口-基础接口列表-员工信息同步接口） |
| 3089 | 订单已经入住,订单无法取消! | 可能涉及接口：取消订单（order/cancel） | 订单已经在酒店前台办理入住了，API调用取消订单接口时会出现此提示 | 订单已经入住不可取消，如有疑问可咨询酒店 |
| 3090 | 订单不可取消，请查看房价码取消规则！ | 可能涉及接口：取消订单（order/cancel） | 订单取消政策不支持取消 | 1、订单页面上可以查看取消政策 2、API接口对接，可以查看房量房价中房价码的CancelDTO规则 |
| 3094 | 当前订单命中风控规则，无法下单 | 可能涉及接口：下单接口 （order/add） | 合规团队风控，不能操作下单 | 联系商务运营沟通处理 |
| 4015 | 离店日期不正确 | 可能涉及退改签接口：新建超时取消/提前离店申请单（/order/discrepantReservationCancel）；提前离店预审（/order/checkDiscrepantEarlyDeparture） | 申请离店日期需要在实际入住日期和实际离店日期之间 | 1、申请离店需要在实际入住日期和实际离店日期之间；离店日最后一天不可申请提前离店 2、提前离店场景当天在线最晚申请时间为：企业卡会员级别对应的当日离店时间前30分钟，级别情况如下： 企业银会员/企业玫瑰金是12点30分， 企业金/企业铂金是13点30分。 非托管卡（TMC客户使用卡）是11点30分。 注：如门店30分钟不回复默认拒绝（PS: 申请原因必传，一般使用中文，描述越准确门店审批效率越高），华住系统同意后不支持修改 |
| 7103 | 不满足会员查询条件 | 可能涉及接口：会员等级查询（/member/getMemberInfo) | 1、查询的下挂企业（bookid）不存在 2、此手机号的个人会员信息不存在 3、此手机号的会员信息没找到下挂的公司 4、此手机号的会员信息下挂企业（bookid）不是查询接口中传的企业（bookid） 5、此手机号的会员信息的下挂企业（bookid）没有托管在TMC下 | 1、检查手机号的会员信息及下挂的企业信息是否正确 2、手机号对应的会员信息支持根据员工会员认证接口完成员工认证（查看华住商旅API接口文档：华住商旅API接口-扩展接口列表-员工认证类接口）认证完成可关联新的企业并且支持下单个人价格 |
酒店基础信息
| 问题 | 问题描述 | 问题回复 |
|---|---|---|
| 酒店列表 | 如何查看下线酒店 | 查看酒店列表接口hotel/getHotelList 1、每天同步一次酒店列表，若同步不到则说明此酒店已下线 2、每次同步到新的酒店，通过酒店详情接口更新数据 注：华住没有酒店下架和房型下架通知接口 |
| 酒店详情 | 如何查看酒店的纳税人性质？ | 查看酒店详情接口hotel/getHotelComplexList 1、纳税人性质：scaleOfTaxpayer NONE：未知 GENERAL：一般纳税人 COMMON：小规模纳税人 2、小规模纳税人税点：companyPayTax，目前华住商旅小规模纳税人税点统一是：5.23% |
| 酒店详情 | 如何区分海外酒店 | 查看酒店详情接口hotel/getHotelComplexList 1、是否国际酒店：isInternational |
| 酒店详情 | 华住是否有酒店星级字段 | 华住没有酒店星级，但有酒店档次 查看酒店详情接口hotel/getHotelComplexList 1、酒店档次Code：hotelBrandOuterLevelCode 2、酒店档次名称：hotelBrandOuterLevelName |
| 酒店详情 | 华住酒店开业时间显示规则 | 酒店开业时间可以与华住商旅逻辑一致， 取值逻辑优先级：overhaulTime(装修日期) => firstOpeningDate(首次开业日期) => whenBuilt(建造年份) |
| 酒店详情 | 酒店详情中窗型内容如何和华住会app一致 | 通过酒店详情接口中HotelRoomType的字段“isHasWindow”和“isHasWindowNewDesc”组合拼接一下即可 如窗型描述展示：封闭窗，不可打开 |
房量房价
| 问题 | 问题描述 | 问题回复 |
|---|---|---|
| Taglist输出释义 | Taglist中输出类型解释 | 华住商旅的房量房价中，taglist会有不同类型输出，分别是： 1、门市价（RackRate）：没有任何折扣的价格，这个一般性不输出 2、会员价（Base）：基于企业卡等级折扣的价格，比如企业卡等级是K，就是85折价格 3、固定价(RFPNegotiation)：某企业与某酒店的某个或多个房型签订的价格，比如A企业与A酒店大床房签订一段时间200元的价格 4、活动价（Standard）:有两种折扣模式，一种折上折模式，比如提前1天预订9折，就是在会员价基础上再打9折；一种是固定活动价格，比如固定400元；活动价上线前需要运营配置指定的企业；代码判断是否是活动价可以基于activityId是否不为空，不为空就是活动价 |
| 房价和房量推送规则 | 房价和房量推送规则是什么？ | 推送逻辑规则： 房价只要有变化及时推送（任何房型的房价） 房量是房量从多变为1通知，从1变为0会通知，从0变为多会通知 实际情况： 在半夜时分，房量比较低是很正常的事情，因为变化比较多，推送数据会比较多 系统推送则会存在缓存，可能存在延迟几个小时才能推送过去，比如0到1 |
| 违约金规则 | 1、提前离店： 举例：会员价是300元/晚，连住两天活动价是200元/晚；预订了两晚付了400元，现在要退一晚，你们是会退给我们200元还是100元呢？ 2、Noshow 首晚担保和全额担保如何收取违约金？ | 1、提前离店：会员价-每晚300；连住活动价，每晚200；提前一天离店，价格恢复会员价300；所以退款是100元；实际操作中还需要注意税点差和税率 2、noshow：首晚担保订单收取首晚房费，全额担保订单收取整单房费 |
| 凌晨房截止时间 | 1、目前凌晨房的接口凌晨房传值是当天日期到当天日期吗，还是前一天日期到当天日期？ 2、凌晨房截止时间是什么时候？ | 1、从当日的0点到早上6点，用前一天的日期到当天的日期 2、凌晨房到早上6点结束 |
| 预订规则场景 | 房量房价中接口返回的getRoomPrice或getTMCRoomPrice中的BookDTO（预订规则）预订规则场景解释 | 第一、特殊场景描述： 1、支持当日预订 minBookUnit(最小提前预订):等于0 maxBookUnit(最大提前预订):null或者大于0 2、仅支持当日预订 minBookUnit(最小提前预订):等于0 maxBookUnit(最大提前预订):等于0 第二、案例分析 接口参数如下： "minBookUnit":1---提前一天预订 "minCheckInUnit":2---连续预订两晚 "beginBookDate":"2024-01-31",--开始预订日期 "endBookDate":"2024-02-28"-----结束预订日期 "firstCheckInDate":"2024-02-01",-----开始入住日期 lastCheckOutDate":"2024-02-29"-----结束入住日期 举例：活连住动（活动ID13135）,新春优惠-提前1天连住2晚折上9折 条件今天是2月27日 场景1：2月27日-03月02日；不满足提前一天预订的条件，不满足3月1日入住条件，不能支持预订 场景2：2月28日-03月02日；3月1日的入住日期不满足在开始入住日期和结束入住日期范围内，不能支持预订 场景3：2月28日-03月01日；满足提前一天预订，2月28日和2月29日均在入住日期范围内，此场景可以支持预订 第三、如何判断连住活动： 通过拉取房量房价接口判断 1、activityId不为空 2、minCheckInUnit>1 满足上述两个条件可判断为连住优惠活动 |
| 税点差房价计算 | 门市价和平台价的税点差计算关系 | 税点差价格计算逻辑： 小规模纳税人结算价：门市价 x 企业会员折扣 x 活动价折上折（如有活动价）x（1+5.23%） 一般纳税人门店结算价：门市价 x 企业会员折扣 x 活动价折上折（如有活动价） 注意：每一次乘法后都向上取整一次 举例： 门市价是289元，企业会员折扣是85折 企业会员价：289 x 0.85 = 245.65向上取整246 一般纳税人结算价：246 小规模纳税人结算价：246 x（1+5.23%）= 258.8658 ≈ 258.87 |
| 周末连住活动价格 | 周末连住两晚或者周末连住三晚价格返回情况 | 周末连住两晚或者周末连住三晚返回房价情况如下： 第一、周末连住两晚的情况 1、周六，周日的两天价格 2、周日，周一的两天价格 不显示周二，周三，周四，周五的价格 第二、周末连住三晚的情况 1、周五，周六，周日的三天价格 2、周六，周日，周一的三天价格 3、周日，周一，周二的三天价格 不显示周三，周四的价格 连住活动按照此规律做价格输出 |
| 连住活动价规则 | 连住活动是5天，但预订日期超过连住活动天数；比如入住日期选了6天，最后一天的房价是需要判断还是接口会返回？ | 1、活动价格是按照房价，房量，销售限制（bookInfo）共同规范的 如果这个活动是连住5天，客户选择日期为6天，应该要屏蔽这个活动不要再展示给客户 若不做限屏蔽，下单是房量房价的销售规则（BookDTO）会判定超过连住天数，导致下单出现失败 2、判断连住优惠活动规则：活动ID不为空，minCheckInUnit天数大于1 |
| 房价码为空 | 客户方收到返回结果：价格和库存列表都返回空 | 房价码返回为空的情况 1、此酒店已下架此房价码（需重新拉取房价码信息） 2、没有匹配房价码的售卖规则（如连住时间、售卖时间等），查看房量房价的销售规则（BookDTO） 举例：12360活动（夜宵房活动），需要晚上20点才能预订，在每天20点之前返回数据都是NULL |
| 区分到付或预付 | 如何看房价码是否支持到付？ | 房量房价接口中，guaranteeMode 是 NONE，则允许到付或者预订 是 FIRST_NIGHT或者FULL_AMOUNT，则必须预付 |
| RFP对接 | API接口如何对接RFP | 1、华住商旅一般性返回三种价格类型：企业会员价，活动价格，门店一口价（RFP），调用接口/hotel/getTMCRoomPrice，房量房价返回，可以查看tagList的返回内容：企业会员价是Base，活动价是Standard，门店一口价（RFP）是RFPNegotiation，门市价是RackRate； 2、按照/member/getCardInfo，可以查出每个卡的等级，按照企业卡等级直接匹配对应的级别企业会员价，比如企业是K级，就是用K级别的会员价下单; 3、关于活动价和RFP，房价码中会展示托管企业可使用的房价码，RoomDTO这里面返回的房价码中，会有rfpCardIdList，activityControlInfo，rateCodeControl (房价码关联的可使用的企业卡号会展示出来) |
| RFP房价缓存 | RFP房价缓存解释 | 1、接口/hotel/getTMCRoomPrice 不存缓存，可以使用此接口刷新一下价格； 2、接口/hotel/getCustomerRFP 存在缓存，缓存时间是1天 |
| 如何接入海外酒店的房量房价 | 如何接入海外酒店的房量房价 | 1、通过酒店详情接口字段isInternational判断，是否是海外酒店 2、如果查询海外酒店房量房价，则下面是这样的 afterTaxPrice 是本地币种下单接口（如果是新加坡就是新币，是德国就是欧元） afterTaxCNYPrice是人民币下单价格 companyToGroupPrice 本币总对总结算价格 companyToGroupCNYPrice 人民币总对总结算价格 |
| 退改签对接相关事项 | 退改签对接相关事项 | 1.连住优惠判断：活动ID不为空，minCheckInUnit天数大于1 2.退款金额确认：预审接口的金额与查询离店详情接口实际金额一致（含税差，另不排除门店特殊操作会产生不一致），以退款金额计算公式为准；会员价系统自动计算 3.接口发起与回传：离店截止时间前半小时内不支持接口发起，如果店长不回复或拒绝，可线下致电门店；华住建议回调和推送均对接，避免卡点情况产生的不一致 PS:离店截止时间前半小时的具体时间根据各企业会员等级的不同有所不同 企业铂金/金等级离店时间14点，建议申请时间在13点30分之前 企业玫瑰金/银会员离店时间13点，建议申请时间在12点30分之前 非托管卡（TMC客户使用卡）离店时间为12点，建议申请时间在11点30分之前 如门店30分钟不回复默认拒绝（PS: 申请原因必传，一般使用中文，描述越准确门店审批效率越高），华住系统同意后不支持修改 4. 提前离店对订单要求：一单一房支持提前离店，一单多房不支持提前离店 5.特殊场景：客人提前多天离店，建议在客人确认离店的前一天再与客人确认后再由接口发起，避免客人后续保持原行程要重新下单 6.超时取消场景：首晚担保订单，门店夜审后，订单状态变更为noshow，无异常，不支持在线发起 全额担保订单，订单状态截止预订离店日前均为预订中，用户/预订平台可在线发起，但若门店已进行首晚夜审加收，则结果返回为拒绝；针对此场景，建议全额担保订单在线发起时间预订平台进行限制，华住门店最晚夜审时间为4点，为客户体验降低差异率，建议申请时间早于预订入住日次日3:30 |
接口性能及安全
| 问题 | 问题描述 | 解决方案 |
|---|---|---|
| 限流处理 | 出现限流提示：{"code":"430","message":"请求被限流"} 说明企业拉取数据频率及流量过大，触发华住限流机制 请按照华住商旅限流方案执行 | 关于拉取房价房量接口接入方案 1、接入方每天不超过三次拉取全量房价房量，每次间隔建议6小时以上 2、接入方每次拉取全量房价房量，时间范围是1-90天 3、接入方使用验单接口发现房价房量变更，及时拉一次当前酒店的房价房量 4、接入方可以接入房价房量变更通知接口，若有房量房价变更，华住商旅系统会及时通知 限流整改通知 1、若监测到接入方收到整改通知后，依然存在频繁拉取房价房量，会做一定限流甚至关停IP处理 |
| 接口调用 | 接口调用支持频率 | 目前不能超过QPS4 |
| IP白名单 | 如有接入客户需新增IP到华住白名单，如何处理？ | 需要提供clientid和白名单ip，发送邮件至商旅运营进行添加 |
| IP访问被阻断 | 接口返回错误码是501，返回内容是"您的访问请求可能对网站造成安全威胁, 请求已被阻断” | 由于接入方非法访问华住对外接口，触发华住集团安全防护机制，自动将访问IP加入华住黑名单 联系华住商旅销售及运营，与华住商旅产研反馈，确认信息安全影响后果再执行相关方案 |
结算付款
| 问题 | 问题描述 | 解决方案 |
|---|---|---|
| API下单接口的结算字段 | 下单接口什么时候使用字段companyToGroupPrice？ | 因公总对总模式下，企业结算价格，涉及总对总开票： 使用companyToGroupPrice =afterTaxPrice +税差点（酒店是小规模纳税人，一般性是加afterTaxPrice 的5.23%），因私出现或者因公现付，使用afterTaxPrice ，员工在门店开发票，不涉及总对总集团开票 注意： 1、验价及下单使用afterTaxPrice 2、结算价格使用 companyToGroupPrice |
| 价格代码解释 | 接待单推送相关接口中的价格代码解释 | 接待单推送相关费用的价格代码解释 totalPrice 预订单价格（整单） realCheckInAmount 当前房间的不含税点差的房费（房间） settleShiftTaxDiffAmount 结算金额不含税点差额（整单） settleContainTaxDiffAmount 结算金额含税点差额（整单） taxDiffAmount 税点差额（整单） |
订单相关
| 问题 | 问题描述 | 问题回复 |
|---|---|---|
| 早餐 | 这个订单我看日志返回是双早，酒店前台说只有一份早餐，打华住会电话说没有早餐，能看下是啥问题吗？ | 根据企业等级接口推送赠送早餐，赠送的早餐份数以实际入住人数为准，每间客房最多不超过2份 注： 1、海友酒店及怡莱酒店不含早，华住会权益适用酒店以华住会官网不定期更新的内容为准 2、根据酒店详情接口(hotel/getHotelComplexList)中酒店公告（hotelNotice）也会有相关信息提供 |
| 担保模式 | 担保模式匹配不正确 | 活动价按照房价码担保模式 会员价按照企业卡的担保模式 （注：活动价下单时，验价及下单接口必须要传 activityId，否则会视为会员价） |
| 退改签 | 退改签相关概念解释 | 第一、退改签申请后会产生一个新的退改签申请单（这不是酒店预订单） 1、order/discrepantReservationDetail做查询 退款金额等于=totalAdjustedRoomTaxPrice-totalOriginalRoomTaxPrice 第二、超时取消和提前离店解释 1、订单超时取消：超过最晚取消时间还未入住订单，可以申请超时取消（若：退改签不支持修改行程，订单未入住若修改行程只能取消重新预订。） 2、订单提前离店，已经入住还未离店订单，可以申请提前离店 第三、查询取消/提前离店申请单详情接口order/discrepantReservationDetail，什么情况下会有多条记录？ 1、同一订单，提交申请后被拒绝，可以支持再次申请。若再次提交成功，就会存在多个申请单。 |
| 退改签 | 退改签提前离店接口中如何计算，实际退款金额？ 实际案例： 订单是连住三晚88折，每晚164，总房费是492，加税点差后结算费用是517.74 客人入住一晚后想提前离店，申请成功后 查询提前离店申请单接口返回数据如下： discrepancyInfo :{ totalOriginalRoomNights : 3 totalAdjustedRoomNights : 2 total0riginalRoomPrice : 492 total0riginalRoomTaxPrice : 517.74 totalAdiustedRoomPrice : 372 3 totalAdjustedRoomTaxPrice : 391.78 dailyDiscrepancyList{...} } | 实际案例： 条件1：申请提前一天离店，并且申请成功 条件2：酒店是小规模纳税人 订单情况：订单是连住三晚88折，每晚164，总房费是492，加税点差后结算费用是517.74 订单中PMS房费： 1、第一天房费164（已出房费） 2、第二天房费164（还未过夜，房费还未出） 3、活动价恢复会员价价差费44.3（自动收取三天的房费差价） 总计房费：372.3，加税点差后结算费用是 391.78 实际退款费用 517.74-391.78=125.96 |
| 订单取消失败 | 取消订单接口，如超时或返回500，我们还需要重试或者反查订单详情吗，还是直接当失败处理？ | 需要继续查询，直到返回正确结果 |
| 未查询到的订单 | 使用我们的下单号反查订单详情时，如未查询到订单，接口是怎么返回的？ | 若下单未成功，使用下单号查询应该会返回NOT_EXISTS_ORDER_ERROR("3007", "订单不存在") 要求查询三次，若都是此结果，则当失败处理 |
| 订单状态推送 | 客户反馈：通过接口观察，订单状态出现推送离店状态，又推送了入住状态，又推离店状态，如下图 | 一般性都是酒店前台在PMS中操作了换单续住造成的状态频繁变更 联系华住运营查看PMS订单状态变化情况 |
| 会员积分和间夜规则 | 累计积分和间夜情况说明，是否有接口可以查询? | 可通过订单相关接口查询 根据订单查询积分间夜赠送情况（/order/getOrderScoreNightInfo） |
| 非大陆手机号 | 华住支持非大陆手机号下单吗？ | 可以传海外手机号 手机号限制长度，32位，不限制格式 积分政策，海外手机号已经注册过会员，维护过证件类型，比如护照 入住会判断是否本人入住，是本人则会赠送积分 |
| 自付订单 | 自付的需要担保吗？ | 订单担保 会员价是按照企业卡担保模式 活动价按照房价码的担保模式 |
| 自付订单 | 自付的订单酒店一般留房到几点？客人晚到店要怎么处理？ | 如果客人晚到，酒店一般性会电话联系客人 保留时间规则 1、企业等级 KCIB，传20点 2、企业等级JDUA，传19点 3、其他等级都是传18点 4、不管几点下单都是按照上述逻辑传值，如当晚21点下单，传值也是上述规则 |
| 自付订单 | 价格查询中除了自付价格使用“AfterTaxPrice”，早餐，取消规则，活动价这些有变化吗？ | 早餐不会受到影响； 活动价由于未支付会被自动取消 个人自付订单请使用企业会员价，由于活动价需要支付，API模式上不支持在线现付，会在15分钟后系统自动取消 |
| 多人多间订单 | 多人多间订单，客人反馈到店找不到预订姓名，LINKNAME传多人姓名拼接是否可以解决这个问题？是否会影响预订人累积积分？传多个人姓名拼接，前台可以模糊搜索到客人订单吗？ | 可以传多个联系人姓名，联系人姓名的长度不能大于100 |
| 长住下单规则 | "3010\",\"message\":\"最大入住天数不能超过60天 | 一单最大入住天数不能超过60天，如果客户有需求，可以让客户下多个订单 |
| 一单多房信息显示 | 一单多房间，可以支持显示房间号和入住人姓名么？ | 查询实际入住信息(/order/queryOrderCheckInInfo) 其中receptionOrderId（接待单id），就是房单号 如果一个订单有多个房间，那么checkInInfoList会返回多条 由于华住信息安全，房间号和入住人姓名是不能对外的，只能显示房单号 |
酒店基础数据
1. 酒店品牌
| 品牌ID | 品牌名称 |
|---|---|
| 0001 | 全季 |
| 0002 | 汉庭 |
| 0003 | 海友 |
| 0004 | 星程 |
| 0005 | 禧玥 |
| 0006 | 漫心 |
| 0007 | 怡莱 |
| 0008 | 城家公寓 |
| 0009 | 宜必思 |
| 0010 | 美居 |
| 0011 | 宜必思尚品 |
| 0012 | 诺富特 |
| 0013 | 美爵 |
| 0014 | CitiGO |
| 0015 | 桔子水晶 |
| 0016 | 汉庭优佳 |
| 0017 | 桔子酒店（旧） |
| 0018 | 桔子酒店 |
| 0019 | 乐程 |
| 0020 | 城家精选公寓 |
| 0021 | VUE |
| 0022 | VIEHouse |
| 0023 | 禾之汤 |
| 0024 | 員宿 |
| 0025 | 客听 |
| 0026 | 馨乐庭公寓酒店 |
| 0027 | 花间堂 |
| 0028 | 美仑 |
| 0029 | 美仑国际 |
| 0030 | 索菲特 |
| 0031 | 铂尔曼 |
| 0032 | 精选酒店 |
| 0033 | niiice café |
| 0034 | 城家高级公寓 |
| 0035 | 城家奢华公寓 |
| 0036 | CitiGO HOUSE |
| 0037 | 施柏阁 |
| 0038 | 城际 |
| 0039 | 美仑美奂 |
| 0040 | Jaz in the city |
| 0041 | Zleep |
| 0042 | 你好 |
| 0043 | 施柏阁大观 |
| 0044 | 青果公寓 |
| 0045 | 宋品 |
| 0046 | 堇悦 |
| 0047 | 堇山 |
| 0048 | 永乐半山 |
| 0049 | 凤栖桃源 |
| 0050 | 花间系列 |
| 0051 | 励业公寓 |
| 0052 | CitiGO欢阁臻选 |
| 0053 | 城家公寓酒店 |
| 0054 | HOB |
| 0056 | 华飨 |
| 0057 | 瑞贝庭公寓酒店 |
| 0058 | 城际服务公寓酒店 |
| 0059 | costa |
| 0500 | 美居-海外 |
| 0502 | 诺富特-海外 |
| 0503 | 铂尔曼-海外 |
| 0504 | 索菲特-海外 |
| 0506 | 美爵-海外 |
| 0507 | 悉本-海外 |
| 0514 | 宜必思尚品-海外 |
酒店设施分类
| typeCode(分类code) | typeName(分类名称) | serviceCode(设施code) | serviceName(设施名称) |
|---|---|---|---|
| Comp_Service | 综合服务 | IssueInvoice | 开发票 |
| Comp_Service | 综合服务 | LuggageStorage | 行李寄存 |
| Comp_Service | 综合服务 | BellBoy | 专职门童/行李员 |
| Comp_Service | 综合服务 | InnerShuttle | 酒店内部接驳车 |
| Comp_Service | 综合服务 | ExpressColletion | 快递代收 |
| Comp_Service | 综合服务 | ExpressDelivery | 快递代寄 |
| Comp_Service | 综合服务 | TakeoutColletion | 外卖代收 |
| Comp_Service | 综合服务 | TakeoutColletion | 外卖代收 |
| Comp_Service | 综合服务 | RobotService | 机器人服务 |
| Comp_Service | 综合服务 | Laundromat | 自助洗衣 |
| Comp_Service | 综合服务 | LaundrySerivice | 衣物送洗 |
| Comp_Service | 综合服务 | IroningServices | 衣物熨烫 |
| Comp_Service | 综合服务 | MendingServices | 衣物修补 |
| Comp_Service | 综合服务 | Borrowing | 暖心借物 |
| Comp_Service | 综合服务 | BottleWater | 免费瓶装水 |
| Comp_Service | 综合服务 | WelcomeDrink | 欢迎饮品 |
| Comp_Service | 综合服务 | Souvenir | 伴手礼 |
| Comp_Service | 综合服务 | ProtectiveSupplies | 免费防疫用品 |
| Comp_Service | 综合服务 | MorningCall | 叫醒服务 |
| Comp_Service | 综合服务 | MultilingualService | 多语种服务 |
| Comp_Service | 综合服务 | POS | POS机支付 |
| Comp_Service | 综合服务 | ChildCare | 儿童托管服务 |
| DiningFac | 餐饮设施 | HotelRestaurant | 餐厅 |
| DiningFac | 餐饮设施 | LobbyLounge | 大堂吧 |
| DiningFac | 餐饮设施 | HotelLounge | 酒吧/酒廊 |
| DiningFac | 餐饮设施 | HotelCafe | 咖啡厅 |
| DiningFac | 餐饮设施 | CapsuleCafe | 胶囊咖啡机 |
| DiningFac | 餐饮设施 | TeaHouse | 茶室 |
| DiningFac | 餐饮设施 | ConvenienceStore | 便利店 |
| DiningFac | 餐饮设施 | Oven | 烤箱 |
| DiningFac | 餐饮设施 | MicroWaveOven | 微波炉 |
| DiningFac | 餐饮设施 | InductionCooker | 电磁炉 |
| DiningFac | 餐饮设施 | SharedKitchen | 开放式厨房 |
| DiningFac | 餐饮设施 | BBQFac | 烧烤设施 |
| DiningFac | 餐饮设施 | HotelBreakfast | 早餐 |
| DiningFac | 餐饮设施 | HotelAfternoonTea | 下午茶 |
| DiningFac | 餐饮设施 | LateNightSnack | 夜宵 |
| DiningFac | 餐饮设施 | BoilingTea | 围炉煮茶 |
| BusinessServices | 商务服务 | DocCopy | 文件复印 |
| BusinessServices | 商务服务 | FaxPrint | 传真/打印 |
| BusinessServices | 商务服务 | MeetingRoom | 会议室 |
| BusinessServices | 商务服务 | BanquetHall | 宴会厅 |
| BusinessServices | 商务服务 | BusinessArea | 商务休息区 |
| BusinessServices | 商务服务 | MultimediaPresent | 多媒体演示 |
| Transportation | 交通旅游 | ParkingLot | 停车场 |
| Transportation | 交通旅游 | ShuttleBus | 班车服务 |
| Transportation | 交通旅游 | TravelService | 旅游服务 |
| Transportation | 交通旅游 | ValetParking | 代客泊车 |
| Transportation | 交通旅游 | TaxiService | 叫车服务 |
| Amenities | 便利设施 | PowerBank | 借充电宝 |
| Amenities | 便利设施 | ATM | 自助取款机 |
| Amenities | 便利设施 | VendingM | 自助售货机 |
| Amenities | 便利设施 | CurrencyExchange | 外币兑换 |
| Amenities | 便利设施 | CHindications | 中文指示（境外酒店填写） |
| Amenities | 便利设施 | SafeBox | 前台保险箱 |
| Amenities | 便利设施 | Clinic | 医务室 |
| Amenities | 便利设施 | PostalService | 邮政服务 |
| Amenities | 便利设施 | BikeRent | 自行车出租 |
| PublicAreaFac | 公区设施 | Reception | 前台 |
| PublicAreaFac | 公区设施 | Wifi | Wifi网络 |
| PublicAreaFac | 公区设施 | AdslNet | 宽带上网 |
| PublicAreaFac | 公区设施 | GiftStore | 礼品/纪念品店 |
| PublicAreaFac | 公区设施 | SmokingPoint | 吸烟点 |
| PublicAreaFac | 公区设施 | FreshAir | 新风系统 |
| PublicAreaFac | 公区设施 | AromaDiffuser | 香氛机 |
| PublicAreaFac | 公区设施 | SmartToilet | 智能马桶 |
| PublicAreaFac | 公区设施 | LuggageTrolley | 行李推车 |
| PublicAreaFac | 公区设施 | Nursery | 母婴室 |
| PublicAreaFac | 公区设施 | PetFriendlyFac | 宠物友好设施 |
| PublicAreaFac | 公区设施 | Elevator | 电梯/滚梯 |
| FitnessFac | 康养设施 | HotelGym | 健身房 |
| FitnessFac | 康养设施 | HotelPool | 游泳池 |
| FitnessFac | 康养设施 | HotelBeach | 自有海滩 |
| FitnessFac | 康养设施 | HotelSpring | 温泉汤池 |
| FitnessFac | 康养设施 | Pedicure | 足疗/按摩 |
| FitnessFac | 康养设施 | SaunaBath | 汗蒸/桑拿 |
| FitnessFac | 康养设施 | HotelSpa | Spa水疗 |
| FitnessFac | 康养设施 | HotelSalon | 美容理发 |
| HotelENTFac | 休闲娱乐 | HotelNetBar | 网吧 |
| HotelENTFac | 休闲娱乐 | ChessRoom | 棋牌室 |
| HotelENTFac | 休闲娱乐 | HotelMovie | 电影院 |
| HotelENTFac | 休闲娱乐 | HotelKTV | KTV |
| HotelENTFac | 休闲娱乐 | ResidentSinger | 歌手驻唱 |
| HotelENTFac | 休闲娱乐 | BonfireParty | 篝火晚会 |
| HotelENTFac | 休闲娱乐 | HotelLibrary | 图书借阅 |
| HotelENTFac | 休闲娱乐 | BookStore | 书店 |
| HotelENTFac | 休闲娱乐 | BoardGame | 桌游电玩 |
| HotelENTFac | 休闲娱乐 | WaterEnt | 水上娱乐 |
| HotelENTFac | 休闲娱乐 | OutdoorSports | 户外运动 |
| HotelENTFac | 休闲娱乐 | IndoorSports | 室内运动 |
| HotelENTFac | 休闲娱乐 | HandmadeExp | 手工体验 |
| HotelENTFac | 休闲娱乐 | NatureExp | 自然体验 |
| HotelENTFac | 休闲娱乐 | KidsPlayground | 儿童乐园 |
| HotelENTFac | 休闲娱乐 | FireworkShow | 烟花表演 |
| HotelENTFac | 休闲娱乐 | CostumeRental | 汉服/民族服饰租赁 |
| HotelENTFac | 休闲娱乐 | TripPhotography | 旅拍服务 |
| HotelENTFac | 休闲娱乐 | CampSite | 露营场地 |
| BarrierFreeFac | 无障碍设施 | BarrierFreeLift | 无障碍电梯 |
| BarrierFreeFac | 无障碍设施 | BrailleSignage | 盲文标牌 |
| BarrierFreeFac | 无障碍设施 | HearingAids | 助听设备 |
| BarrierFreeFac | 无障碍设施 | StairRailing | 楼梯扶手 |
| BarrierFreeFac | 无障碍设施 | CorridorHandrail | 走廊扶手 |
| BarrierFreeFac | 无障碍设施 | PoolRamp | 提供泳池坡道 |
| BarrierFreeFac | 无障碍设施 | PoolElevator | 提供泳池升降机 |
| BarrierFreeFac | 无障碍设施 | SignLanguage | 手语能力强的员工 |
| BarrierFreeFac | 无障碍设施 | ServiceAnimals | 允许服务性动物 |
| BarrierFreeFac | 无障碍设施 | VisualAlarm | 走廊的视觉警报 |
| BarrierFreeFac | 无障碍设施 | Barrier-freePath | 无障碍通道 |
| BarrierFreeFac | 无障碍设施 | Wheelchair | 现场提供轮椅 |
| SafeFac | 安保设施 | CCTV | 公共区域闭路电视监控系统 |
| SafeFac | 安保设施 | AccessControl | 门禁系统 |
| SafeFac | 安保设施 | SafetyAlarm | 安全报警器 |
| SafeFac | 安保设施 | SmokeAlarm | 烟雾报警器 |
| SafeFac | 安保设施 | FireExtinguisher | 灭火器 |
| SafeFac | 安保设施 | FirstAidKit | 急救包 |
| SafeFac | 安保设施 | SecurityStaff | 保安人员 |
| SafeFac | 安保设施 | CCTV | 公共区域闭路电视监控系统 |
| SafeFac | 安保设施 | COAlarm | 一氧化碳报警器 |