# CP26 FIT TA字段与联调准备核对

## 本轮结论

2026-09-16重新查询公开目录并逐项对照项目和平台候选。当前公开平台为0.7.0、115项；本地平台候选标记0.9.0。项目21项操作的method/path及已存在操作的查询白名单与候选一致，但公开目录尚缺8项。这个结果证明候选接口元数据已对齐，不证明已经发布、实际授权或酒店业务验收通过。

本轮没有业务代码修改、酒店调用、应用授权变更、实际迁移、启用或部署。四条流程继续保持本地候选状态，不能称已经在测试酒店全流程跑通。

## FIT的TA Record Locator

Oracle将它定义为旅行社或来源方提供的辅助预订编号，业务需求仍是填写Tour Code。[官方说明](https://docs.oracle.com/cd/E69137_01/1.20_oh/faq_what_is_a_ta_record_locator.htm)

[OPERA Cloud 26.3控制项](https://docs.oracle.com/en/industries/hospitality/opera-cloud/26.3/ocsuh/c_opera_controls_reservations.htm)列出TA_RECORD_LOCATOR用于预订录入和查找；[26.2发布说明](https://docs.oracle.com/en/industries/hospitality/opera-cloud/26.2/oprnc/c_feature_summary.htm)说明该字段可以受Reservation Protection保护。是否已开启以及当前预订是否被保护，必须在目标环境核验，不能在消费程序内假定或自动修改这些设置。

公开Oracle仓库main仍为提交dd631fbd5d0fce74a7dbdf96b43f07ce587211f2（2026-09-04），即既有26.3契约，没有新版本可据以补齐字段。沿[官方RSV规范](https://github.com/oracle/hospitality-api-docs/blob/dd631fbd5d0fce74a7dbdf96b43f07ce587211f2/rest-api-specs/property/v1/rsv.json)解析引用链：

| 操作 | 根结构 | 可达定义 | 核对结果 |
| --- | --- | ---: | --- |
| 新建 | createReservation.reservations.reservation[] | 394 | 未建立明确TA写入路径 |
| 修改 | changeReservation.reservations[] | 399 | 未建立明确TA写入路径 |
| 详情 | reservation.reservations.reservation[] | 387 | 未建立明确TA返回路径 |

这不是Oracle不支持TA的结论。它表示当前文档不足以确认可实施的REST映射，现有FIT TA未完成状态应保留。

同一个searchHotelReservationsRequest独立定义customReference、GDS recordLocator、externalReferenceIds和taRecordLocatorList。最后一项最多30个搜索值；不能以其他三个字段代写TA。locators是客人位置/时间，confirmationLetters是信件投递，均不是TA的同义证据。[业务事件文档](https://docs.oracle.com/en/industries/hospitality/opera-cloud/26.3/ocsuh/t_be_reservation_module.htm)也将TA与External Reference分列；事件XML或GraphQL字段不能直接充作REST JSON属性。GROUP已有reservationDetails.taRecordLocator映射不扩展套用到FIT。

## 平台待发布的8项

| 用途 | Operation ID | 影响流程 |
| --- | --- | --- |
| 建立共享客人档案 | postProfile | FIT NEW |
| 设置团队完整房量 | putBlockAllocation | GROUP NEW / UPDATE |
| 查询团队附件 | getBlockAttachments | GROUP NEW / UPDATE |
| 查询散客附件 | getReservationAttachments | FIT NEW / UPDATE |
| 读取指定附件内容核验 | getFileAttachment | 四流程 |
| 上传本次Excel | uploadFileAttachment | 四流程 |
| 删除已验证替换的指定团队旧附件 | deleteBlockAttachment | GROUP UPDATE |
| 删除已验证替换的指定散客旧附件 | deleteReservationAttachment | FIT UPDATE |

这8项在本地平台候选OpenAPI中均存在；未调用线上业务路由探测，也没有把目录存在当作能操作酒店的证明。发布准备须携带对应实现、迁移、契约及本地测试证据，发布后重新获取公开目录比对，再核对应用实际权限。可能涉及profiles.write、attachments.read、attachments.write等能力组；本轮没有读取或修改应用授权，不根据目录推断实际持有权限。

## 项目中已具备与尚待接入的部分

- 已具备：四流程执行Adapter、不可变原确认及计划、实际Block/Reservation绑定、逐次调用台账、Excel集合替换、当前结果核验、后台续期、员工结果回显。CP25已有完整本地回归证据。
- 已具备：HotelBookingAttachmentLoader已注册受控原件读取服务，核对同酒店/同来源/同次确认及Excel内容；无需另造邮件附件下载通道。
- 尚待装配：HotelBookingExecutionConfiguration默认Port仍为OhipPendingBookingExecutionAdapter；四个候选Adapter没有正式运行注册，也没有按酒店/环境/BookingKind/Action统一分派的运行配置。
- 尚待配置加载：OhipPlanningContext需要可信的环境、有效操作与权限、Account/Contact实际Profile ID、房型/Rate/Market/Source及固定值存在证据；目前依赖显式传入，不是已经从目标测试环境加载完成。输入仍采用员工已确认值，不重新推断业务参数。
- 尚待目标环境证据：GROUP房量类别/Occupancy Split/NonElastic、改日期旧格处理顺序；FIT最小PUT保留语义、同笔3→2房量、TA准确写读；附件linkType、Excel文件限制与整组替换；MySQL迁移、锁等待及停机恢复。

## 最小联调验证顺序

1. 先解决接口可用性：候选发布准备、公开目录复查、受信应用权限与指定测试酒店范围核验。业务写入前完成，不能边运行真实预订边猜配置。
2. 获取TA准确契约：要求Oracle给出新建/修改/详情的JSON路径、fetchInstructions、控制项/保护规则及脱敏样例。已起草英文查证材料，没有发送。
3. 在明确的测试酒店/测试预订范围核验TA：先记录人工界面TA值与精确Reservation详情的对应，再按权威路径进行新建和修改后的详情查询、TA搜索，验证多笔预订返回完整集合。不能只凭搜索有结果就通过写读验收。
4. 配置加载与四流程统一Port装配可以先做本地合成验证，仍默认Pending；只有该流程必需契约及环境证据齐备才能启用该范围。
5. 完整验收沿用户原流程：确认一次→处理中→查询实际值；房型房数按完整新结果，原文Note，Excel整组替换，失败保留已完成事实。每项均核验后才判整个办理成功。

本轮没有新的产品待确认问题。技术查证尚未完成的TA字段不会被伪造示例、相似字段或临时默认值替代。证据、复核与产物见[CP26证据](../../../.project-docs/50-evidence/topics/2026-09-16-ohip-fit-ta-readiness-cp26.md)。