79 lines
6.3 KiB
Markdown
79 lines
6.3 KiB
Markdown
# ARR 测试环境技术资料补充
|
||
|
||
2026-09-17。供平台技术人员或有测试环境权限的人员处理。**用户已确认自行转交平台技术，等待回复。**
|
||
无需重复转发或逐字段人工确认；本任务没有代发消息，也未启动自动监控。
|
||
|
||
发出后的本地补充：已有原始响应中26笔明确携带`type=BlockCode`，ARR已核对并接入取值，
|
||
无需为这26笔再取团队代码或新增getBlock权限。其余113笔缺Block对象仍需缺省/显示语义依据；
|
||
姓名、历史房号、公司和报表规则的原请求继续有效。本补充仅更新本地说明，未向平台追加发送。
|
||
|
||
同日房型补充：官方字段定义与139笔三层一致的原始房型代码已支持ROOM_CATEGORY_LABEL取值，
|
||
ARR已接入并验证；这些记录无需额外查询房型描述或申请字典权限。套餐组合/日期口径和公司角色等剩余问题继续保留。
|
||
|
||
应用：`Wyndham-ARR2.0-Codex`；已有采集环境/酒店：`OHIPSB02`；到店及有效价日期：`2026-09-15`。
|
||
目标是核实API与`Arrivals: Detailed / res_detail`的对应关系。ARR开发负责转换代码、独立校验和按钮接入，
|
||
不要求财务用户逐字段判断。已确认的报表要求为单日From=To、Resv.-GEN及内部备注；接口输出不含Trace。
|
||
下列事实来自已归档请求，本说明没有发起新的业务请求。
|
||
|
||
## 1. 姓名查询的特定503：请给出可验证的处理结果
|
||
|
||
操作：`searchProfiles`，`POST /api/v1/profiles/searches`，按单个既有Profile ID查询摘要。
|
||
|
||
- 最近已记录的失败：Edge请求`5aa6a424-9de2-4b7c-a060-f1f13d21addf`，
|
||
`2026-09-17T02:51:36.218746Z`至`02:52:01.223527Z`，HTTP503 / `ohip_unavailable`。
|
||
- 请根据该编号定位具体对象及Oracle调用，说明失败原因/适用限制、修复情况和同对象的新验证结果。
|
||
“接口已上线”或另一个对象成功不能关闭此项。
|
||
- 完成条件：有对应对象可正常读取的证据或明确受支持的等价读取方式；ARR随后有限复验并补齐缺失姓名。
|
||
已有完整预订/日价主体会复用，无需重新采集全日。
|
||
|
||
## 2. 房间日历缺字段：请核对上游结果和参数语义
|
||
|
||
操作：`getRoomCalendar`，`GET /api/v1/reservations/room-calendar`，现有读取权限已覆盖。
|
||
已记录的三个请求都带`includeRoomMoveHistory=true`、`showRoomMoveSegments=true`：
|
||
|
||
| Edge请求编号 | 查询范围 | 已观察结果 |
|
||
|---|---|---|
|
||
| `e1c013af-733e-4b4a-a4c2-113e33ae9cec` | 9/15同日起止、不按房号过滤 | HTTP200；仅recordsPerPage |
|
||
| `a4113822-b74b-441b-92c7-5409ccf3c98a` | 9/15、一个已知正常住宿房号 | HTTP200；仅recordsPerPage |
|
||
| `11be2afc-add2-4094-a5b8-a69534e26fe2` | 同一房号、9/15至9/16诊断窗口 | HTTP200；仅recordsPerPage |
|
||
|
||
请返回对应Oracle原始结构及实际透传参数，说明同日起止、分页起点/结束条件、房号过滤和有关OPERA Control。
|
||
重点区分：确无数据、需要不同查询条件、响应省略字段或透传问题；目前尚未认定平台缺陷。
|
||
若有其他按预订关联的历史房号来源，请给出操作/字段和实例。
|
||
|
||
还需核对原两笔零晚CheckedOut的房号来源：摘要请求
|
||
`5481e954-6b3d-4147-9fd4-45bfac128b82`、`09d60817-6f30-486e-b86f-7ede0ce86091`均定位到对应预订，但没有roomId。
|
||
完成条件是取得能关联相应预订/日期的房间信息，或有依据解释其为何应为空，以及报告采用哪一段房间信息。
|
||
不能仅凭HTTP200、缺room集合或客人档案的lastRoom得出结论。
|
||
|
||
## 3. 提供可关联的报表/接口对照，或适用的权威规则
|
||
|
||
优先提供OHIPSB02 / 9月15日、固定报表参数下的原ARR内容与对应预订API响应，保留记录顺序与关联键。
|
||
若这一历史日期没有可取得的报告，可说明当前可提供的测试日期；新的对照双方须为同环境、同酒店、同日期，
|
||
单独注明，不能与旧批次混合对账。适用的报表配置/权威字段说明可以替代它实际证明的部分。
|
||
|
||
| 要核对的关系 | 所需对照或说明 |
|
||
|---|---|
|
||
| 主客姓名 | Profile ID与预订主客的关系、API显示名与报告FULL_NAME；有中间名/缺givenName时的实际表现 |
|
||
| 公司显示 | Company/TravelAgent/Source/Group角色、原始名称，报告COMPANY_NAME的取值、前缀/组合方式；该值参与定价 |
|
||
| 房号与行顺序 | 已退房/换房/未分房如何显示；同房号+到店日不同内容记录在报告中的原始顺序及配置；现有处理器保留首条 |
|
||
| 范围与备注 | ALL Reservations对状态/空ETA的纳入规则；多条GEN含内部备注时的原顺序，第一条非空影响Group Code |
|
||
| 数量与日价 | 多房/共享/零晚的行粒度、人数/房数；到店日有效价及隐藏/缺价表现，不以base/total替换 |
|
||
| 可空展示列 | 26笔BLOCK_CODE原值已核对，其余Block对象缺失含义仍待说明；139笔ROOM_CATEGORY_LABEL代码已取值，无需补房型描述。PRODUCTS的来源范围、组合/日期口径仍需依据；区分明确空值与未取得 |
|
||
|
||
按已有资料分项返回即可；某个场景暂无样本请注明，ARR会记录尚未覆盖的部分，不要求为此新增或修改酒店预订。
|
||
当前手工XML来自57106，与OHIPSB02不同源，重新提供同一57106文件或再次确认GEN选项不能关闭这些技术缺口。
|
||
getBlock/getRoomTypeInfo/getPackage的定义在上次目录核对中已经发布，此处不要求重复发布接口或先扩权限。
|
||
|
||
## 返回方式与ARR后续工作
|
||
|
||
每项请注明：环境/酒店/日期或适用版本、对应请求/预订关联、原始响应/报告/规则出处、解决结论或剩余缺口。
|
||
原件保留关联与顺序；只给汇总数字或说明“测试正常”不足以核对映射。
|
||
|
||
ARR开发收到资料后负责逐字段对照、差异定位、版本化转换和另一路原件验证，再做独立实例的完整链路验证。
|
||
现有139条沙箱记录为115条非白名单费率和24条缺费率；不能承诺该批次成功生成财务日报/月报。
|
||
会按原业务规则验证其确定失败路径，成功链路已有隔离模拟覆盖。真实成功正例另以适当数据验证，不改变白名单。
|
||
|
||
详细依据：[六次已审计请求](platform-recovery-check-20260917.md)、
|
||
[来源交接与责任划分](real-source-handoff.md)、[逐项验收矩阵](arr-api-acceptance-matrix.md)。
|