3.2 KiB
CR：GROUP 新建不传 TA，FIT 新建按 Tour Code 条件传入
状态：业务规则 Approved；候选映射代码及模拟已完成，沙箱页面写入验收待用户执行。来源：2026-09-18 用户本轮明确指令。
已确认规则
| 创建类型 | Tour Code | TA Record Locator |
|---|---|---|
| GROUP NEW | 有或无 | 不提交此字段；GROUP Block Name 仍按已有规则处理 |
| FIT NEW | 有 | 将确认的 Tour Code 传入 TA Record Locator |
| FIT NEW | 无 | 不提交此字段，不发送空字符串或 null 代替 |
不生成 Tour Code，不用姓名、Oracle 编号、Custom Reference、其他外部参考号或 Note 替代 TA Record Locator。无 Tour Code 不应仅因 TA 缺值阻止 FIT 新建。
此次明确修改的是 NEW 规则，不由此推导 UPDATE 的 TA 写入/清空规则变化；修改、取消、目标编号定位及酒店附件规则沿用此前范围。
与前一版本的关系
本规则覆盖 暂停TA CR 中 FIT NEW 一律不提交TA的要求；GROUP NEW 继续不传。原无TA测试及交付包保留为旧版本证据，不能作为本次 FIT NEW 有 Tour Code 写入已实现的证明。
当前实现和后续验收
代码核对：OhipFitTaRecordLocatorContract 仍为 DEFERRED/no-op，OhipFitNewBookingConverter 默认使用它；GROUP 新建转换器不提交 TA。因此 GROUP NEW 已符合，FIT NEW 无 Tour Code 的省略行为已符合，FIT NEW 有 Tour Code 的实际写入尚未实现。以上为规则刚更新时的历史状态；随后用户要求立即接入，已按下节实现，当前交付见文末。
后续接入应分别验证上表三种情况；FIT有值时需证明创建请求的真实写入字段及同笔酒店结果。已知查询参数 taRecordLocatorList 仅用于查询，不能据此填造创建请求字段。现阶段不再表述为“没有TA查询接口”。实现/模拟修改由本项目完成，环境更新、上传及酒店操作仍由用户执行；不创建子智能体。
2026-09-18 用户要求立即接入：实现依据与证据界限
当前平台0.11.0再次公开查询确认postReservation和getReservation已封装，无新接口/权限需求。采用创建正文 reservations.reservation[].externalReferences，元素id=确认Tour Code、idContext=TA_RECORD_LOCATOR；只有逻辑FIT NEW写入，UPDATE新增房型不因此扩展TA行为。GET按同类型唯一元素核验，不以其他类型同值、请求值或搜索成功代替。GROUP→FIT实际按NEW办理时沿用FIT NEW规则。
这一路径由官方RSV创建/详情externalReferences结构与Oracle报表字典TA_RECORD_LOCATOR类型组合推导，并非新取得的官方TA专用REST样例；特殊类型是否映射到沙箱Stay Details输入框仍需用户环境验收。代码和模拟可验证请求/回查及缺值省略，不能宣称已完成页面落值验证。不使用customReference或普通其他reference类型替代。
实现与测试已完成：2714后端零失败/17跳过、页面42及类型、模拟70、47参数/3故障符合预期。无环境更新、业务调用、文件上传或子智能体。见交付及映射限制。