4.2 KiB
4.2 KiB
ARR 手工样本导出要求
2026-09-16。本文保留第一轮最小采样要求；用户随后已提供 res_detail_71050118.XML，结构和本地处理验证通过，
详见 样本结果。参数截图及环境/导出信息仍待补充。
以下具体日期是本轮采样建议，不改变日常下载 T-1 的业务规则。
本轮导出
| 项目 | 要求 |
|---|---|
| 报表 | Report Name 查找 ARR，实际选择 Arrivals: Detailed |
| From Date / To Date | 都填 2026-09-15；按本轮讨论日期 2026-09-16 的 T-1 固定，稍后导出也保留这个样本日期 |
| Arrival Time | 00:00 至 23:59 |
| Reservations / Room Assignment | 两项均为 ALL Reservations |
| 七项代码筛选 | Room Type、Membership Type、Preferences、Rate Code、Inventory Items、Source Code、Market Code 均为 ALL CODES |
| Display | 勾选 Room Number、Notes |
| 备注范围 | 勾选 Include Internal Notes，Note Types 只选择 Resv. - GEN |
| 格式 | Download As XML，保留下载得到的原始文件内容 |
其余 Display、Trace、排序/分组选项保留平时实际导出时的状态，通过截图记录；不为这次采样额外补选。 完整日常口径见 源报表契约。
一并提供
- 原始 XML。 下载后原样交付，不经 Excel 另存或修改内容。可保留默认文件名；如需区分，建议
ARR_2026-09-15_manual.xml，只改文件名。 - 完整参数截图。 可以分几张，覆盖日期、筛选、全部 Display、内部备注和 Note Types，以及页面存在的 分组/排序项。保留勾选与未勾选状态，便于复现；不要求重新填写已经提供的参数清单。
- 导出信息。 一行文字即可，例如：酒店名称/代码、正式或测试环境、导出日期时间及所用时区。 如果页面显示 Opera 营业日，可以一并记录；没有显示则不必额外查找。
先导出日常能够进入的环境。正式酒店 XML 可用于结构和本地处理基准；当前 OHIPSB02 是标准测试环境， 不能拿两个不同环境的数据作逐笔一致性结论。接口逐笔对比需要另行取得同一环境、同一酒店、同一到店日和 相同参数的两个来源，并记录采集时间，排查两次导出之间正常发生的预订变更。
如果这一天没有数据，保留空文件及参数信息并说明；不为填满样本修改预订。接收后再判断是否需要另补一个 有数据的单日，不预先要求多天样本或不同备注设置的多份导出。
收到后执行的检查
- 保存文件来源、大小和 SHA-256，确认真实文件格式、XML 编码、根节点和单日分组；不按扩展名猜格式。
- 检查所有源行与现有字段契约，统计未分房、重复房号/到店日、备注条数及顺序、备注类型标记和可空字段。 日志/项目文档只记录汇总和问题定位，不复制完整客人资料或备注内容。
- 在隔离输出目录使用现有处理器及独立验证器，核对费率筛选、去重、间夜、金额及价格待审情况。 本轮样本检查不需要调用会提交 Finance 的上传入口。
- 固定这份手工样本和实际选项作为基准。单个样本只能证明其中出现的情况，不能证明 ALL 状态、空 ETA、 多条内部备注、共享房等全部边界均已覆盖；先检查，再按实际缺口提出最少补样。
当前进度
准备要求时只读搜索 ARR2.0 工作区未找到 XML；用户随后提供 Downloads 中的原始文件。已按既有程序验证： 72源行、11费率排除、61保留行、125间夜、零价格待审。源文件没有修改，也没有提交 Finance。 58条备注实际代码为 CAS、描述 GENERAL；与页面 Resv. - GEN 的关系仍需确认，不能直接改写业务要求。
平台执行/下载接口仍按 平台对接清单继续确认；用户手工样本用于准备验收， 不代表接口下载已经可用。先补齐实际页面参数/环境对应，再决定有针对性的补样和同环境接口比对步骤。