# ARR 手工样本导出要求

2026-09-16。本文保留第一轮最小采样要求；用户随后已提供 `res_detail_71050118.XML`，结构和本地处理验证通过，
详见 [样本结果](../../.project-docs/50-evidence/topics/2026-09-16-manual-arr-xml-baseline.md)。参数截图及环境/导出信息仍待补充。
以下具体日期是本轮采样建议，不改变日常下载 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、排序/分组选项保留平时实际导出时的状态，通过截图记录；不为这次采样额外补选。
完整日常口径见 [源报表契约](../../.project-docs/40-domain/arr-source-report-contract.md)。

## 一并提供

1. **原始 XML。** 下载后原样交付，不经 Excel 另存或修改内容。可保留默认文件名；如需区分，建议
   `ARR_2026-09-15_manual.xml`，只改文件名。
2. **完整参数截图。** 可以分几张，覆盖日期、筛选、全部 Display、内部备注和 Note Types，以及页面存在的
   分组/排序项。保留勾选与未勾选状态，便于复现；不要求重新填写已经提供的参数清单。
3. **导出信息。** 一行文字即可，例如：酒店名称/代码、正式或测试环境、导出日期时间及所用时区。
   如果页面显示 Opera 营业日，可以一并记录；没有显示则不必额外查找。

先导出日常能够进入的环境。正式酒店 XML 可用于结构和本地处理基准；当前 OHIPSB02 是标准测试环境，
不能拿两个不同环境的数据作逐笔一致性结论。接口逐笔对比需要另行取得同一环境、同一酒店、同一到店日和
相同参数的两个来源，并记录采集时间，排查两次导出之间正常发生的预订变更。

如果这一天没有数据，保留空文件及参数信息并说明；不为填满样本修改预订。接收后再判断是否需要另补一个
有数据的单日，不预先要求多天样本或不同备注设置的多份导出。

## 收到后执行的检查

- 保存文件来源、大小和 SHA-256，确认真实文件格式、XML 编码、根节点和单日分组；不按扩展名猜格式。
- 检查所有源行与现有字段契约，统计未分房、重复房号/到店日、备注条数及顺序、备注类型标记和可空字段。
  日志/项目文档只记录汇总和问题定位，不复制完整客人资料或备注内容。
- 在隔离输出目录使用现有处理器及独立验证器，核对费率筛选、去重、间夜、金额及价格待审情况。
  本轮样本检查不需要调用会提交 Finance 的上传入口。
- 固定这份手工样本和实际选项作为基准。单个样本只能证明其中出现的情况，不能证明 ALL 状态、空 ETA、
  多条内部备注、共享房等全部边界均已覆盖；先检查，再按实际缺口提出最少补样。

## 当前进度

准备要求时只读搜索 ARR2.0 工作区未找到 XML；用户随后提供 Downloads 中的原始文件。已按既有程序验证：
72源行、11费率排除、61保留行、125间夜、零价格待审。源文件没有修改，也没有提交 Finance。
58条备注实际代码为 CAS、描述 GENERAL；与页面 Resv. - GEN 的关系仍需确认，不能直接改写业务要求。

平台执行/下载接口仍按 [平台对接清单](arr-report-platform-handoff.md)继续确认；用户手工样本用于准备验收，
不代表接口下载已经可用。先补齐实际页面参数/环境对应，再决定有针对性的补样和同环境接口比对步骤。