连接 Opera，
贯通酒店业务。

• 按客人中英文姓名、确认号、房号、住期和状态检索预定，按酒店营业日查询应到、应离客人。
• 查询普通、Share、Party 和团队预定；完整信息可包含客人及商务档案、陪同、逐晚房价、付款窗口和费用 Routing。
• 使用已有个人档案创建预定；支持的创建流程可联动新增个人档案，并核对销售限制和每日房价。
• 支持指定确认号及单房房号，以酒店实际房价和销售条件形成预定。
• 修改日期、房型、房价代码、房数、成人儿童人数、客人或商务档案关联、市场来源、外部参考及是否允许消费记账。
• 修改前读取版本与目标住期逐晚报价；按修改情形保留已订价格、计算延住新增夜晚，或明确刷新整个住期的报价。
• 补全实际团队 Pick Up 客人的资料及到店扩展信息，保留原有团队和价格关联；读取保存结果及原请求回执。
• 新增普通 Alert 或 Task 类型提醒，让预定承接到店、离店等环节的业务提示。

适用范围原生创建和完整修改各有明确范围；完整修改主要覆盖未入住、未分房的普通预定，团队资料补全保留原住期、房型和价格。Share、Party、复杂付款及既有账务通过相应业务接口处理；散客取消与恢复未提供现有 API 入口。

• 按完整住期检查客房占用、维修、Hold、容量和固定房限制，返回全部合格候选及推荐依据。
• 优先推荐客人实际入住过且本次可用的历史客房，再匹配 Room Features 偏好；偏好不能满足时明确说明回退。
• 对普通预定、已拆单房 Party 成员及实际 Block Pick Up 客人执行原生分房，按真实业务保留关联。
• 全部未入住的 Share 按服务端读取的真实成员同步同房，保留原有付款、Routing、押金、预授权和每人逐晚房费。
• 指定升级目标房型并查询该房型的可用客房，执行免费升级；保留原计费房型、原价及付款账务，不重新分摊 Share 房费。
• 升级后重新查询候选，再独立分房和入住预检；候选查询本身不占房、不改变入住状态。

适用范围候选、分房和入住默认采用 IP 已验房、FO/HK 空房，并核验完整住期。已有在住 Share、固定房限制和已有付费 Upsell 等不适用场景转前台处理，不能以分房或免费升级绕过酒店规则。

• 核查酒店营业日、应到预定、客人档案、必填资料、已分房客房、房态、人数容量及实际付款条件，返回具体阻断原因。
• 可组合换卡、收押金和登记预授权，再办理 Opera 原生入住；支持的付款准备与入住在同一次事务中完成。
• 办理普通单房、已拆单房 Party 成员、实际 Block Pick Up 客人及合法 Routing 场景的当前客人入住。
• 全部未入住且完整统一分房的 Share，可办理当前一个客人，保留其他成员状态、原有价格和付款配置。
• 回读实际入住结果，按原请求查询已提交回执，核对重复请求或超时后的办理结果。

适用范围需按酒店启用并满足原生身份、权限、付款及房态条件。已有任何在住成员的 Share，包括首位客人刚入住后的其余成员，交前台处理；日用、多房、真正陪同及其他特殊分支不由此入口自动办理。

• 预检正常到期的普通退房，办理现金结清、生成账单、关闭 Folio 和离店，并查询实际结果。
• 执行原生退房试算，预览窗口余额、账单与关联影响；确认后实际办理付款、结账和退房。
• 扩展方案覆盖适用的提前离店、套餐、AG 附属客人、日用房、Share 单人离店和 PM 场景。
• 按窗口处理已收款登记、现金收款或退款、既有零余额和 AR 挂账，核对账户、金额及真实账务结果。
• 支持结清关闭、Open Folio 保留开放账单、Post Stay 离店后继续入账，并对尚未关闭的已离店客账后续结清关账。
• 查询已提交的退房回执，按确认号下载客人账单 PDF。

适用范围扩展方案需按酒店启用并满足权限、收银员和功能配置；原生试算后回滚，正式执行才提交。卡及电子支付登记不等于外部网关扣款或退款；外币、财政设备和整团批量退房不属于这些单预定入口。

• 以已有客人档案新建合住成员，或把已有预定加入 Share，按真实重叠住期和逐日成员执行原生 Combine。
• 可仅加入合住、不额外调价；也可按日使用 Entire 指定房费承担者、Split 原生分摊、Full 各成员计费。
• 合住核验成员的 Block、Party、Routing 和付款关联，保留已有在住成员原房与既有账务。
• 通过 Party Split 拆出一间，或 SplitAll 全部拆为单房，保留原预定并生成新成员预定、确认号和 Party 关联。
• 明确各成员成人、儿童及年龄档人数和付款窗口；拆房承接原住期、房型及业务关联，按原生规则处理实际房价变化。
• 保留来源客人的既有付款、押金和授权，按配置维护新成员付款资料；卡片关联复制不等于复制已收款或已刷预授权。
• 查询已提交的成员与逐晚价格快照，核对原请求回执；再次查询预定可了解拆分或合住后的当前状态。

适用范围Party 拆房面向未入住的独立多房客人预定，不拆已有 Share 或实际 Block 团队资源。合住和拆房成功不代表已经分房、入住或收款；房费及成员条件按酒店原生规则核验。

• 按 Block 编号、代码、到店日期或截房日期查询团队，读取关联客人预定；原生建立 Group 和 Block，修改团队头信息。
• 维护 Company、Travel Agent、Source 与 Contact 关联，设置主次房价代码和房型优先级。
• 按日期和房型保存团队房量与价格 Grid，支持日期范围内配额调整，核对实际可提取房量。
• 按酒店配置执行合法 Block 状态转换，创建或复用默认 PM。
• 每次从团队配额 Pick Up 一间客房预定，核对截房、库存、逐日合同价格及已提取房量。
• 执行 Cutoff，释放整个 Block 尚未提取的房量；满足条件后取消团队，并对已取消团队执行原生失效及明细清理。
• 读取团队版本快照及业务回执，核对并发修改和重复提交的实际结果。

适用范围Pick Up 使用已有个人档案，每次一间普通客房；Cutoff 不接受任意日期段。有活动客人预定不能直接取消 Block；删除仅面向已取消且相关预定符合条件的团队，不是物理删除主表。

• 查询、创建和更新个人、公司、来源、旅行社及联系人档案，读取完整客户资料。
• 按中英文姓名、公司名称、企业编号、通讯方式和创建日期等条件检索，提供快速客人及企业查找。
• 维护适用的主证件、生日、国籍、语言、地址、手机、电话、电邮及网址；保留证件历史。
• 按分类同步或清除客人偏好，保留未指定分类，为服务及选房提供依据。
• 查询企业账户与联系人，建立或改绑联系人的所属账户关系。
• 读取企业协商房价及关联应收账户，同步支持的协议房价，新增档案跟进任务备注。
• 查询教学班级和学员关联档案并统计数量，回读实际保存结果。

适用范围原生更新保留未提供字段，不能任意转换档案类型；关系改绑与解绑有不同范围。档案维护与 AR 开户是不同业务。

• 按房号读取清洁状态和前台入住状态，按房型汇总；原生查询纳入营业日期、组合房及维修停用状态。
• 批量设置脏房、净房、已验房或需拂尘状态，整批校验并回读修改结果。
• 按起止日期、维修原因和恢复房态设置 Out Of Order 或 Out Of Service。
• 查询酒店或指定客房的维修记录，按日期及停用类型筛选，并查看完成历史。
• 解除指定维修停用并保留历史；在酒店配置允许时修改有效维修记录的恢复房态。
• 区分 OOO 扣减可售库存与 OOS 保留可售库存，库存和房态联动由 Opera 原生业务处理。

适用范围停用房需先解除维修再改普通清洁状态；操作受酒店开关、权限及业务条件限制。未提供自动解决房态差异的接口。

• 新建和修改房价代码，维护中英文描述、适用房型、基础价、佣金及预订日期等配置。
• 按日期、星期和房型维护一至五位成人房价、额外成人及儿童价格，保留未配置与零价的区别。
• 新增房价明细或整批替换同步；任一明细失败时回滚，避免留下部分价格。
• 按房型、日期及成人儿童人数查询标准基础价，或调用 Opera 原生单晚计价。
• 查询适用的公共或企业协议房价代码，并同步档案关联的协商房价。
• 读取套餐产品、有效价格段、计价规则及入账节奏，维护房价头和明细的套餐关联。

适用范围标准基础价与原生计价的金额口径可能不同；套餐查询和关联维护不等于完整套餐配置增删改。儿童年龄等复杂计价条件需按接口范围验证。

• 设置开放或关闭售卖，允许或禁止指定日期到店、离店。
• 维护最短和最长住期，包括到店住期及住宿期间条件。
• 设置最短或最长提前预订天数，按日期区间和选定星期生效。
• 批量维护多个房价与房型的限制；提供原版同步及 Opera 原生保存路径。
• 查询适用的公共或企业协议房价，核对住宿期间的价格配置和销售限制。
• 返回各适用房型的价格、套餐配置，以及整个住期的最小普通和含超售可售量。

适用范围查价不占用或保证库存，也不授予超售权限；当前区间查价按一位成人、无儿童报价。返回价格不能直接当整段住宿总额，原版与原生口径须分别核对。

• 查询酒店有效付款方式、信用卡类型及 AR 收款交易代码。
• 登记预订押金、在住客账付款及 AR 账户收款，核对原生交易和余额。
• 登记已取得的信用卡授权回执，核对重复授权码及累计金额。
• 维护适用的卡资料、换卡及电子付款默认资料，衔接后续付款和入住准备。
• 将卡片维护、押金和授权准备放在同一事务，任一步失败整体回滚；此步骤不改变入住状态。
• 查询消费交易代码和商品，按单价、数量入账，支持商品默认价及酒店原生税费、服务费、窗口和 Routing。
• 按原消费请求查询账项并识别重复提交；在酒店启用相应功能时补记未关闭离店账单的消费或付款。

适用范围登记付款和授权不代替银行扣款或授权；独立收款登记没有持久请求幂等键，超时须先核账。消费不支持入住前入账、No Post 强制覆盖或负数冲销。

• 按确认号读取客账摘要或完整账务，查看各窗口交易、消费、付款、余额及实际逐日房费。
• 分别保留 Guest、Deposit 和 AR 借贷明细、未分配窗口账项，以及退款、冲正和转账关系证据。
• 读取授权记录，区分当前卡有效累计授权与历史记录；提供原生余额和授权资格核对。
• 创建和查询 AR 应收账户及账单地址、额度等资料，查询酒店交易代码。
• 完整读取各窗口付款配置、出向和入向 Routing、付款人、日期、费用代码、限额及解析状态。
• 在支持的未入住预订范围内，整单重设现金、信用卡、AR 或其他预订房间的付款与费用路由方案。
• 按确认号下载中英客人账单 PDF，各窗口及账单分别分页，包含交易、消费、付款、税费及余额。

适用范围Routing 重设不转移历史消费；查询到退款、冲销或转账记录不等于开放对应写入。PDF 读取已有客账，不创建正式账单号、不结算或退房。

• 读取历史每日经营统计，以及当前和未来的预订预测、房费和餐饮收入数据。
• 查询当日前台报表，汇总应到实到、应离实离、续住、早退、延住、日用、Walk-in、取消及 VIP 信息。
• 查看散客、团队及 Block Pickup 数据，结合房态汇总核对酒店当日运营。
• 按日期区间查询指定房型的总房量、维修停售、普通可售及含超售可售量。
• 按日期列表查询售出房量、房晚、成人儿童人数、OCC、ADR及收入。
• 按市场、来源、渠道、账户和预订提前期查看销售分布，提供图表及 Excel 分析所需数据。

适用范围未来收入来自预测统计，不能当已收款。OCC 按当前总物理房数口径计算；统计接口提供数据，不等于直接导出图表或 Excel 文件。

• 新建 PMS 用户，重置密码、解锁账号、修改支持的用户权限，并创建接入所需的默认操作员。
• 通过 Opera 原生账号验证员工登录，查询当前身份及权限，支持退出和会话过期处理。
• 读取指定用户的直接、组、继承和代理授权，识别 Supervisor 及指定酒店的访问状态。
• 读取交易码、报表模块和 Hold Code 等资源限制相关信息。
• 按名称、业务分组或类型分页查询 Application Settings，说明酒店及全局配置的值、来源和解析状态。
• 获取预定、入住、客账退房、房务、档案、房价、团队、应收及系统配置九类业务视图的前置条件和阻止原因。

适用范围登录支持非 ASP 本地 Opera 员工；权限和存储配置快照是前置条件，不能替代调用身份、许可及业务执行授权。

• 新建 Opera Schema 连接配置，查询配置列表，执行激活、停用和数据库连接状态检测。
• 读取数据中心及旗下酒店列表、酒店信息和营业日期，按数据库及酒店定位具体业务。
• 初始化项目所需的默认操作员、任务备注类型、实体配置及提醒配置。
• 按内置 25 项标准单据补齐报表定义及分组关联，保留已有配置并支持重复调用。
• 维护教学班级代码，读取市场、来源、渠道、地区、国家及省州代码。
• 读取房型、房价类别、套餐产品及价格规则、佣金和 AR 账户类型，供业务采用酒店真实参数。

适用范围初始化提供本项目支持的接入配置，不代表自动建立全部酒店房间、房价及产品主数据。