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

本轮结论

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

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

FIT的TA Record Locator

Oracle将它定义为旅行社或来源方提供的辅助预订编号，业务需求仍是填写Tour Code。官方说明

OPERA Cloud 26.3控制项列出TA_RECORD_LOCATOR用于预订录入和查找；26.2发布说明说明该字段可以受Reservation Protection保护。是否已开启以及当前预订是否被保护，必须在目标环境核验，不能在消费程序内假定或自动修改这些设置。

公开Oracle仓库main仍为提交dd631fbd5d0fce74a7dbdf96b43f07ce587211f2（2026-09-04），即既有26.3契约，没有新版本可据以补齐字段。沿官方RSV规范解析引用链：

操作	根结构	可达定义	核对结果
新建	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的同义证据。业务事件文档也将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迁移、锁等待及停机恢复。

最小联调验证顺序

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

本轮没有新的产品待确认问题。技术查证尚未完成的TA字段不会被伪造示例、相似字段或临时默认值替代。证据、复核与产物见CP26证据。

6.4 KiB Raw Permalink Blame History Unescape Escape