docs/头程到尾程流程节点梳理.md

头程到尾程流程节点梳理

当前用途：全流程收尾变更的流程入口。 F01-F40 的业务基线已经确认，报关协同代码已接入并通过测试环境验收；本文件只保留三大业务块、关键节点和节点之间的关系，便于查找和修改。报关实现细节请看报关代码开发交接清单，历史开发规划、进度、门禁和评审不在这里继续维护。

维护原则： 客户看到的是进度投影，后台看到的是业务对象节点，明细节点记录真实操作和结果。三者使用同一组业务事实，不另建一套客户状态。

一、三大业务块

业务块	覆盖范围	对外主要进度	后台主要对象	分段详情
头程下单	客户下单、审核、国内到仓、测量、计费、确认、组托	待下单 → 审核中 → 待到仓/测量 → 待分柜	订单、入仓单、测量记录、费用记录、托盘	阶段一、阶段二
海运（货柜）	分柜、订舱、拖车、拣货、装柜、报关协同、待发区、送港、进港、甩柜、实际开船、目的港和尾程计划	待分柜 → 装柜中 → 报关中 → 待发区 → 送港/待开船 → 海运中 → 待入仓	柜次、装柜任务、报关批次、待发区、送港任务、船次、尾程入仓计划	阶段三、阶段四、报关专题
尾程入库和派送	海外接柜、拆柜实收、入库、库存服务、排车、出库、派送、签收、异常回写	待接柜 → 入库中 → 待派送 → 出库/派送中 → 已签收/异常	接柜任务、入库单、库存、出库单、派送单、异常单	阶段五、阶段六

三大块是客户和产品的展示分组；F01～F40 是后台查找和验收用的内部编号，不代表客户必须看到 40 个节点，也不代表所有动作严格串行。

二、主流程

头程下单
  客户下单 → 订单审核 → 国内到仓 → 测量/计费 → 费用确认（不阻断）→ 组托/待分柜
        ↓
海运（货柜）
  分柜/订舱/拖车 → 拣货 → 装柜完成（LOADED）
        └─ 报关协同：客户资料 → 报关行回执 → 客户确认/打回重做 → 全部客户通过
                       → 整柜资料交报关行 → 正式申报 → 查验或不查验放行
                                      ↓ 报关完成
                                  进入待发区
        送港运输：待发区 → 离仓 → 送港 → 进港 → （容量不足时）甩柜/改配
                         ↓
                    船舶实际开航后进入海运节点
        ↓
  目的港清关/提柜 → 尾程入仓计划
        ↓
尾程入库和派送
  海外接柜 → 拆柜实收 → 入库/库存 → 排车 → 出库 → 派送 → 签收/异常回写

三、关键节点总表

编号	业务块	客户进度节点	后台管理节点	真实明细节点	完成结果或分支
F01-F07	头程下单	待下单、审核中、已审核	企业、订单、审核任务	填写、提交、补件、审核、生成入仓单	审核通过后进入国内履约
F08-F10	头程下单	待到仓、测量中、待确认	入仓单、测量记录	到仓收货、扫码、称重、测量、审核	形成可排柜的实测数据
F11-F13	头程下单	费用待确认、国内扣货/解除、待组托、待分柜	费用版本、确认记录、HOLD 记录、托盘	计费、推送、客户确认、国内扣货/解除、组托/封托	费用确认不阻断主链；国内扣货单独控制作业门禁；装柜不能代替客户确认费用
F14-F20	海运（货柜）	待分柜、订舱中、装柜准备/进行中	柜次、装柜计划、拖车任务、拣货任务	分柜、订舱、排车、拣货、拍照、铅封、数量核对	通过装柜门禁后才能完成装柜
F21	海运（货柜）	国内已装柜	装柜任务已完成	实际柜号、实装数量、装柜证据确认	产生 LOADED；完成报关后才进入待发区
F22	海运（货柜）	报关确认中、待补资料、已提交报关	客户报关案例、报关批次	收集资料、发报关行、接收回执、客户确认或打回、重新上传和重发	已实现并通过真实 HTTP 验收；柜内所有客户确认后，才能提交整柜资料并正式申报；客户确认不等于海关放行
F23	海运（货柜）	待发区、送港中、已进港、待开船、已甩柜	待发区、送港/拖车任务、港口和船次事实	报关完成后入待发区、离仓、送港、进港、甩柜、改配	报关完成是进入待发区的门槛；甩柜/改配只改变运输船期，不重做已完成报关
F24	海运（货柜）	海运中	船次实际状态	承运船舶实际开航、船期回写	只有实际开航后进入海运节点
F25-F27	海运（货柜）	目的港处理中、待海外接柜	目的港清关/提柜、尾程订单、入仓计划	清关、提柜、创建尾程计划	形成海外接柜输入，不等于已经入库
F28-F33	尾程入库和派送	待接柜、入库中、库存可用	接柜任务、入库单、库存	接柜、拆柜、收货核对、上架、盘点及库内服务	实收核平并入账后形成可用库存
F34-F37	尾程入库和派送	待派送、出库处理中、已出库	排车、出库单、派送单	生成出库/派送单、拣货、复核、发车	出库和签收分开记录
F38-F40	尾程入库和派送	派送中、已签收、异常	派送单、签收和异常单	送达、签收、拒收/部分拒收、退回、最终回写	异常保留原事实和恢复结果；全部有效分片完成后订单收口

四、必须保持的流程关系

1. 报关完成后进入待发区，船期单独推进

LOADED 只表示货物已经实际装入集装箱并完成装柜记录。之后先完成报关协同，报关完成后货物进入待发区：

• 报关协同线：通知报关行，按客户/入仓码收集资料；报关行生成回执后发客户确认。客户打回时，只重做对应客户的资料、发送和回执，直到柜内所有客户都确认。全部确认后，将整柜资料交报关行确认，再记录正式申报和海关结果。
• 待发区与船期线：报关完成后进入待发区，再安排离仓、送港和进港；船舱不足时记录甩柜和改配。甩柜/改配只人工修改原柜的船名、航次和船期，不影响已完成的报关资料、回执和客户确认。

报关行回执、客户确认、正式申报、海关放行、进入待发区、进港、甩柜和实际开船是不同事实，不能合并成一个“报关完成”或“海运中”。

2. 费用确认不阻断装柜主链

费用确认是头程下单块中的并行事项。客户未确认时可以继续排柜、拣货和装柜。按阶段二及 Firstleg 当前服务指引，装柜完成可以触发平台费用确认与发布，但不能代替客户主动确认；客户已确认且本票装柜完成时才最终冻结。费用确认与报关资料的客户确认分别记录。

3. 异常附着在主节点上

查验、扣货、资料打回、甩柜、拒收和跨区回写失败都应保留发生在哪个主节点、责任人、处理结果和恢复时间。异常可以阻断对应分支，但不要用“异常”覆盖主流程已经发生的事实。

五、三层节点的使用口径

层级	解决的问题	示例
客户进度节点	客户现在处于哪一段、下一步做什么	报关确认中、送港中、海运中、入库中
后台管理节点	哪个业务对象正在处理、由谁处理	报关批次待客户确认、送港任务已进港、派送单已出库
真实明细节点	事实何时发生、凭什么证明	上传资料、回执版本、客户确认、离仓时间、进港记录、签收凭证

客户页面只展示与自身相关的进度和资料；后台详情保留完整明细；异常作为附加状态展示，不另建一条互相矛盾的主流程。

六、查找和修改规则

1. 改流程关系或客户节点：先改本文件，再检查对应阶段文档的名称和链接。
2. 改单个阶段的字段、页面操作或权限：只改对应的六份阶段文档和实际契约，不回写历史开发规划。
3. 改报关资料、回执确认或船期价格：以报关资料与船期价格接入梳理为专题入口，同时核对本文件中的 F22/F23 关系。
4. 开发规划、进度、开工门禁、验收任务、旧审计和优化方案：保留原文作为追溯资料，标记为冻结，不作为当前流程入口。
5. 新增或调整节点时：先判断它属于客户进度、后台对象还是明细事实；只有确实改变三大块关系时才改总表，避免在多份文档复制同一段流程。