57 lines
4.2 KiB
Markdown
57 lines
4.2 KiB
Markdown
# 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)继续确认；用户手工样本用于准备验收，
|
||
不代表接口下载已经可用。先补齐实际页面参数/环境对应，再决定有针对性的补样和同环境接口比对步骤。
|