73 lines
6.7 KiB
Markdown
73 lines
6.7 KiB
Markdown
# ARR 自动取数字段对接表
|
||
|
||
核对日期：2026-09-18。
|
||
|
||
每个接口实际传什么参数、参数来源和补查条件，见[接口与传参确认单](ARR_OHIP_REQUEST_PARAMETERS.md)。
|
||
|
||
实施进展：用户随后要求直接接接口、跳过实际取数验证。现已完成 [按日期取数入口](integrations/ohip/DATA_SOURCE.md)，
|
||
覆盖本表 15 个字段及必要的关联查询。41 项新增本机检查及相关回归共 150 项通过，未查询沙箱订单。
|
||
页面日期按钮、直接数据处理、日报、缺价复核和月报均已衔接；人工XML上传入口继续保留。
|
||
所需平台权限已核对齐全。用户确认测试环境目前没有可用于核对的数据，当前状态为“接入完成，待有数据后验收”。
|
||
下方“本次确认结果”和逐字段表保留接口目录核对时的判断，当前实现细节以链接说明为准。
|
||
|
||
当前目标：用户选一天，系统通过 OHIP 平台取得该日到店预订所需的数据，直接交给数据处理入口，沿用现有筛选、去重、定价、复核和报表规则。人工 XML 上传入口保留。自动取数不以取得或重建 XML 为前提。
|
||
|
||
字段范围来自 [ARR XML 加工前字段清单](ARR_XML_RAW_FIELDS.md)。自动取数需要其中 15 个业务字段；Trace 沿用已确认的“不获取”。字段允许为空的规则保持不变。
|
||
|
||
## 本次确认结果
|
||
|
||
已实时读取 OHIP 平台接口目录及接口说明：版本 **0.11.0，共 184 项操作**。下面涉及的查询入口均已列出。
|
||
这次确认的是平台提供了哪些接口；没有重新查询沙箱订单。因此，下面的“已有取值”来自当前代码和历史采集记录，不表示今天已经完成全部字段的实际取数验收。
|
||
|
||
## 逐字段对接
|
||
|
||
| 业务字段 | 从哪里取得 | 目前已有成果 | 接下来核实什么 |
|
||
|---|---|---|---|
|
||
| 团队 Block 代码 | 预订详情中的团队资料；必要时补查团队详情 | 已能读取明确标为 Block 代码的值 | 区分没有团队与资料未返回；不把团队编号或名称当成代码 |
|
||
| 成人数 | 预订详情、所选日的入住资料 | 已有取值和一致性检查 | 实际样本中的共享房、多房人数含义 |
|
||
| 儿童数 | 预订详情、所选日的入住资料 | 已有取值和一致性检查 | 零儿童与字段未返回的区别 |
|
||
| 公司／旅行社名称 | 预订关联的公司、旅行社资料；必要时补查相应档案 | 已能识别关联角色和名称 | 同一预订存在多个关联对象时，哪个名称进入既有定价流程 |
|
||
| 预订确认号 | 预订详情 | 已有取值 | 与同一笔预订准确对应，保留原始文字 |
|
||
| 房号 | 预订详情；换房、退房等情况补查房间历史 | 已能读取多处一致的房号；已有历史资料检查 | 取得与这笔预订及目标日期对应的房号，区分未分房与未取得资料 |
|
||
| 有效房价 | 对指定预订查询指定日期的房价 | 已有独立查询和金额检查 | 返回有效房价及币种；隐藏价格、缺失价格不能作为零价 |
|
||
| 住客姓名 | 预订主客资料、对应客人档案 | 已有主客关联和姓名补查 | 实际取到该主客的完整显示姓名；历史部分查询失败需要新一轮验证 |
|
||
| 预订备注 | 预订详情中的 GEN 预订备注，包含内部备注 | 已有提取，并保留多条内容及顺序 | 多条备注进入既有处理规则后，团号是否正确 |
|
||
| 房间数 | 所选日对应的预订入住资料 | 已有取值 | 不把不同日期重复出现的房间数累加 |
|
||
| 套餐／附加产品 | 预订详情中的套餐清单；需要补充时再查对应套餐 | 已保留套餐代码和适用日期等资料 | 多个套餐的适用范围，以及如何呈现在结果中 |
|
||
| 费率代码 | 所选日对应的预订房价资料 | 已有取值 | 取得目标日期的代码；取得后才交由原有白名单处理 |
|
||
| 房型 | 预订详情中的房型代码 | 已有取值和一致性检查 | 房型变更时采用哪个日期对应的值；不以计价房型替换 |
|
||
| 入住日期 | 预订入住资料 | 已有取值 | 与用户选择的到店日期一致 |
|
||
| 离店日期 | 同一预订入住资料 | 已有取值 | 不早于入住日，并保留当天离店情况 |
|
||
|
||
同一接口可以提供多个字段，不需要为 15 个字段各找一个独立接口。
|
||
套餐补查接口需要已经知道套餐代码，因此应先读取预订中已有的套餐清单；它不是一次返回全部未知套餐的入口。
|
||
团队代码和房型在预订资料已经足够时，不必额外查询团队或房型资料。
|
||
|
||
## 接通后的判断标准
|
||
|
||
- 用户选择的日期用于查找当日到店预订，并用于取得相应日价等资料。
|
||
- 先保留完整预订及其关联资料，再交给原有规则处理；取数阶段不预先删除非白名单或重复记录。
|
||
- 每个值都能对应到同一酒店、同一预订及适用日期。原始取数结果及顺序可追溯。
|
||
- 正常为空、接口没有返回、查询失败分别记录；不能用空值或零掩盖未取得的数据。
|
||
- 公司、房价、房号等会影响结果的字段先验证业务含义。相同业务输入应得到与既有规则一致的处理结果。
|
||
- 原生 XML 是否可下载、XML 字节或显示格式是否相同，不作为新数据入口接通的前提。
|
||
|
||
## 本次查询依据
|
||
|
||
来源：[OHIP 平台接口说明](https://ohip.nianxx.cn/developer/v1/openapi)。本次公开查询无酒店业务数据、无权限修改。
|
||
|
||
| 查询 | 返回 | 查询编号 |
|
||
|---|---|---|
|
||
| 完整接口目录 | 0.11.0，184 项操作 | `9f9ee152-f97d-45ad-b672-cd3e3d1da749` |
|
||
| 完整接口说明 | 0.11.0，包含参数及返回资料说明 | `0968f5e3-dbbf-42f8-aee1-60ff9ff2d855` |
|
||
|
||
开发定位保留在现有 [接口对应资料](integrations/ohip/arr-api-mapping.md)、[字段提取](integrations/ohip/source_fields.py)、[房价查询](integrations/ohip/rate_info.py)、[姓名补查](integrations/ohip/profile_reader.py)和[房间历史检查](integrations/ohip/room_calendar_evidence.py)中。
|
||
历史资料中以“生成 XML、证明原生报表显示一致”为条件的部分，仅说明当时的路线；当前重点以本页和用户本轮明确的数据入口方向为准。
|
||
|
||
字段对应阶段只核对目录，后续已按用户要求直接完成取数代码和本机检查，跳过实际订单验证。
|
||
后续直接处理衔接和本机OHIP配置已完成，见下节。实际字段返回和业务报表结果待有数据后验收，不主动补做取数。
|
||
|
||
## 2026-09-18 直接处理衔接
|
||
|
||
15字段数据现已直接衔接页面、日报、缺价复核和月报；不再需要XML适配。备注取第一条非空，套餐按代码顺序显示，原始多值完整保留。详见[入口说明](arr_web/DIRECT_DATA_ENTRY.md)。开发和本机模拟已验证，实际订单未验证。
|