优化
This commit is contained in:
@@ -16,6 +16,10 @@
|
||||
|
||||
## 全流程公共契约
|
||||
|
||||
- [头程到尾程顺序回路流程图](头程到尾程流程/头程到尾程顺序回路流程图.md)：按“主线节点→完成判定→下一节点；异常→处理→回到原节点复核”建模，提供节点卡模板，适合继续画泳道流程图；附[可编辑示例](头程到尾程流程/头程到尾程顺序回路流程图.drawio)。
|
||||
- [头程到尾程流程节点梳理](头程到尾程流程/头程到尾程流程节点梳理.docx)：可直接分发和打印的 Word 文档，按四段流程整理 27 个节点、负责人、正常下一步、异常处理和回流节点。
|
||||
- [头程到尾程逐节点思维导图](头程到尾程流程/头程到尾程逐节点思维导图.md)：按实际节点编号，保留建议负责人、正常去向及异常分支，供人工填写和增删；附[可编辑思维导图源文件](头程到尾程流程/头程到尾程逐节点思维导图.mm)。
|
||||
- [头程柜级履约尾程流程节点责任与异常梳理](头程到尾程流程/头程柜级履约尾程流程节点责任与异常梳理.md)：按 H/G/W/Z 分解现有流程节点，列出执行岗位、前置、交接、异常和负责人填写栏，附人工待确认问题及[可编辑浏览打印版](头程到尾程流程/头程柜级履约尾程流程节点责任与异常梳理.html)。
|
||||
- [头程下单到尾程出库全流程操作手册](头程下单到尾程出库全流程操作手册.md)：从客户头程下单、国内收货测量、分柜装柜和国内出仓，贯通跨区尾程建单、海外接柜入仓、排车、PDA 拣货与尾程出库的角色、操作、状态、编号、门禁和异常处理。
|
||||
- [头程下单到尾程出库现状流程全景清单](头程下单到尾程出库现状流程全景清单.md)：以 F01～F40 盘点现有主链、并行流程、条件分支和异常流，明确操作人、入口/出口状态、单据、编号、数据交接和评审项；应先评审本清单，再进入优化。
|
||||
- [头程到尾程分阶段流程](头程到尾程分阶段流程/README.md)：F01～F40 六个阶段现状文档已全部完成，逐阶段记录操作、字段、状态、数据流、异常、完成判定和上下游交接条件，可按阶段评审并进入优化。
|
||||
|
||||
Binary file not shown.
@@ -0,0 +1,172 @@
|
||||
# 头程到尾程逐节点思维导图
|
||||
|
||||
2026年9月22日 · 人工梳理与分工版
|
||||
|
||||
按实际业务节点编号，不限定阶段或步数。展开每个节点查看负责人、正常去向、异常处理和特殊分支。
|
||||
|
||||
岗位为建议分工，姓名留空待填；异常转交路径供人工确认。编号用于讨论定位，可并行或提前的动作以节点说明为准。
|
||||
|
||||
标记“待确认”的处理入口或完结规则，需要人工补充，不能当作已具备的系统能力。
|
||||
|
||||
思维导图源文件：[头程到尾程逐节点思维导图.mm](头程到尾程逐节点思维导图.mm)。可在支持 FreeMind 格式的软件中导入，填写姓名、增删节点。
|
||||
|
||||
新增步骤可沿用相邻编号加字母，例如 04A。详细依据保留在[原梳理文档](头程柜级履约尾程流程节点责任与异常梳理.md)。
|
||||
|
||||
- **01 客户下单**
|
||||
- 负责人：客户下单员 · 姓名____
|
||||
- 正常：提交订单 → 02 审核；同时安排 03 送仓。
|
||||
- 异常：资料缺失／下单失败 → 客服协助客户补正 → 重新提交。
|
||||
|
||||
- **02 订单审核**
|
||||
- 负责人：订单审核员 · 姓名____
|
||||
- 正常：审核通过；与 03—05 可并行，06 测量审核通过前须完成本步。
|
||||
- 异常：申报／渠道有误 → 审核员联系客户补正 → 重新审核。
|
||||
|
||||
- **03 拉货／客户送仓**
|
||||
- 负责人：国内提货跟单 · 姓名____
|
||||
- 正常：上门拉货或客户自送 → 04 到仓收货。
|
||||
- 异常：未备货／迟到／运输破损 → 提货跟单联系客户、司机 → 改约或补交接记录。
|
||||
- 说明：拉货执行、司机交接的现场规则待补充；当前系统主要记录预约信息。
|
||||
|
||||
- **04 国内到仓收货**
|
||||
- 负责人：国内收货员 · 姓名____
|
||||
- 正常：核对订单、箱数、外包装 → 05 称重测量。
|
||||
- 异常：无单／少件／多件／破损 → 收货员留证，仓库主管与客服核对 → 明确收货处理后交测量。
|
||||
|
||||
- **05 称重测量**
|
||||
- 负责人：国内测量员 · 姓名____
|
||||
- 正常：采集重量、尺寸、箱数和图片 → 06 测量审核；称重确认时开始分配库位。
|
||||
- 异常：漏测／错码／读数异常 → 测量员复测补证 → 重新提交审核。
|
||||
|
||||
- **06 测量审核**
|
||||
- 负责人：测量审核员 · 姓名____
|
||||
- 正常：普通货审核通过 → 07 在库交接 → 08 排柜；一件代发另走下方分支。
|
||||
- 异常：数据／证据存疑 → 审核员联系测量员复核 → 再审；退回修改入口待确认。
|
||||
- **06A 一件代发拆箱清点**
|
||||
- 负责人：国内清点员 · 姓名____
|
||||
- 正常：按箱核对 SKU 与数量 → 06B 归托封托。
|
||||
- 异常：差异 → 仓库主管、客服核对；接受差异须留原因，接受权限待定。
|
||||
- **06B 打托／归托／封托**
|
||||
- 负责人：国内打托员 · 姓名____
|
||||
- 正常：清点完成、封托完成 → 08 排柜；封托托盘作为不可拆分单元。
|
||||
- 异常：漏清点／托盘未封 → 国内仓主管安排补作业 → 封托后继续。
|
||||
|
||||
- **07 国内入库／库位确认**
|
||||
- 负责人：国内仓管 · 姓名____
|
||||
- 正常：确认货物所在库位和交接信息 → 08 排柜；库位安排随 05 开始，本步核对在库结果。
|
||||
- 异常：库位不足／货位不符 → 国内仓主管落实存放位置并核对记录 → 交接后继续。
|
||||
|
||||
- **08 排柜／分柜**
|
||||
- 负责人：柜务 · 姓名____
|
||||
- 正常：确定本柜装哪些货 → 11 国内拣货；可与 09 订舱准备并行。
|
||||
- 异常：超容／扣货／审核未完成 → 柜务协调仓库、审核员 → 调整计划或解除阻断后再拣货。
|
||||
- 说明：待审核、待测量可先占位；实物作业须满足审核、清点封托等条件。
|
||||
|
||||
- **09 订舱／放舱**
|
||||
- 负责人：船务 · 姓名____
|
||||
- 正常：确认舱位、船期和放舱资料 → 10 国内拖柜。
|
||||
- 异常：无舱／甩柜／船期调整 → 船务协调船司、柜务 → 确认新船期及装柜安排。
|
||||
|
||||
- **10 国内拖柜：预约、提柜到仓**
|
||||
- 负责人：国内运输跟单 · 姓名____
|
||||
- 正常：订舱已放舱、资料齐全后预约；司机提空柜到国内仓 → 12 装柜。
|
||||
- 异常：车不到／柜不可用／资料缺失 → 运输跟单联络车队、船务 → 补资料或重新安排。
|
||||
|
||||
- **11 国内拣货**
|
||||
- 负责人：国内拣货员 · 姓名____
|
||||
- 正常：按装柜计划找到货物、扫码核对 → 12 装柜。
|
||||
- 异常：找不到／错货／少件／扣货 → 国内仓主管与柜务核对 → 补拣、调整计划或解除阻断。
|
||||
|
||||
- **12 装柜完成**
|
||||
- 负责人：国内装柜主管 · 姓名____
|
||||
- 正常：核对实装、柜号和装柜证据 → 13 出口报关；同时开始海外接柜准备。
|
||||
- 异常：实装不符／装不下／证据缺失 → 装柜主管与柜务核实 → 调整、补证后确认完成。
|
||||
- **12A 海外接柜准备**
|
||||
- 负责人：海外计划员 · 姓名____
|
||||
- 正常：装柜完成后系统生成尾程订单 → 人工准备入仓计划、托盘与库位 → 18 拆柜收货。
|
||||
- 异常：订单未同步／计划或资源缺失 → 计划员联系履约运营、仓库主管补齐；系统失败转技术处理。
|
||||
|
||||
- **13 出口报关**
|
||||
- 负责人：出口报关专员 · 姓名____
|
||||
- 正常：装柜完成后处理整柜报关、收齐完成资料 → 14 国内出仓。
|
||||
- 异常：资料缺失／退单／查验 → 报关专员联系客户、代理 → 补正或配合查验，完成后继续。
|
||||
|
||||
- **14 国内出仓**
|
||||
- 负责人：国内出仓员 · 姓名____
|
||||
- 正常：报关完成且出仓条件齐备 → 确认离仓，交 15 海运跟踪。
|
||||
- 异常：报关未完成／扣货／交接不符 → 出仓员暂停放行，联系对应主责 → 条件满足后出仓。
|
||||
|
||||
- **15 海运／到港跟踪**
|
||||
- 负责人：船务 · 姓名____
|
||||
- 正常：跟踪开船、到港、卸船 → 与 16 清关、17 提柜衔接。
|
||||
- 异常：延误／改港／节点未更新 → 船务核实船司消息 → 更新计划并交客服通知客户。
|
||||
|
||||
- **16 目的港清关**
|
||||
- 负责人：海外清关专员 · 姓名____
|
||||
- 正常：可提前备资料；确认清关放行和提柜条件 → 17 海外提柜。
|
||||
- 异常：补件／查验／未放行 → 清关专员联系代理、客户 → 处理并确认可提柜后继续。
|
||||
|
||||
- **17 海外提柜／送仓**
|
||||
- 负责人：海外运输跟单 · 姓名____
|
||||
- 正常：预约港口提柜、协调海外仓接收 → 18 拆柜收货。
|
||||
- 异常：无车／提柜失败／仓库约不上 → 海外运输跟单协调港口、车队、仓库 → 改约并跟进额外费用。
|
||||
|
||||
- **18 海外拆柜收货**
|
||||
- 负责人：海外收货员 · 姓名____
|
||||
- 正常：按入仓计划扫描、清点、记录实收 → 无差异时交 19 入库。
|
||||
- 异常：短收／超收 → 海外仓主管登记差异、留证 → 待核平；可结束卸柜，但不能直接成为可用库存，核平入口待确认。
|
||||
- **18A 卸柜后还空柜**
|
||||
- 负责人：海外运输跟单 · 姓名____
|
||||
- 正常：卸柜结束 → 安排还空并记录凭证；与后续库存、出库流程并行。
|
||||
- 异常：还空受阻／临近截止 → 海外运输跟单联系车队、堆场 → 调整还空安排并跟进费用。
|
||||
|
||||
- **19 海外入库／库位确认**
|
||||
- 负责人：海外仓管 · 姓名____
|
||||
- 正常：正常收货形成库存，核对真实托盘、库位和可用数量 → 20 排车。
|
||||
- 异常：库位不符／暂扣／数量仍有差异 → 海外仓主管核实 → 满足可用条件后再交拣货。
|
||||
- **19A 一件代发独立出库**
|
||||
- 负责人：一件代发运营 · 姓名____
|
||||
- 正常：按独立出库单逐箱或整托拣货，核对 SKU 与数量后出库；签收、回访和整单完结衔接待确认。
|
||||
- 异常：缺货／错 SKU／数量不符 → 代发运营与海外仓核对 → 补货或调整后再出库。
|
||||
|
||||
- **20 海外排车**
|
||||
- 负责人：海外调度 · 姓名____
|
||||
- 正常：确定车辆、路线、目的地与货物 → 21 转派送、22 拣货；可提前预排，实际拣货须有可用库存。
|
||||
- 异常：无车／预约冲突／库存不足 → 海外调度协调仓库、车队 → 调整排车与交付安排。
|
||||
|
||||
- **21 转派送／生成待出库单**
|
||||
- 负责人：海外调度 · 姓名____
|
||||
- 正常：生成派送关联和待出库单 → 23 发车前核对；可在 22 拣货前或过程中进行，必须早于 24 发车。
|
||||
- 异常：资料缺失／生成失败 → 海外调度补齐资料、核实关联 → 成功后才能发车。
|
||||
|
||||
- **22 按排车拣货**
|
||||
- 负责人：海外拣货员 · 姓名____
|
||||
- 正常：按排车任务、托盘与库位扫描拣货 → 23 核平复核。
|
||||
- 异常：少货／错托／暂扣／货位不符 → 海外仓主管核查 → 补拣或协调调度调整。
|
||||
|
||||
- **23 拣货核平／发车前复核**
|
||||
- 负责人：海外仓主管 · 姓名____
|
||||
- 正常：核对实拣、出库单、车辆及必需资料 → 条件齐备交 24 发车。
|
||||
- 异常：数量未核平／单据缺失 → 海外仓主管联系拣货员、调度补齐 → 复核无误后继续。
|
||||
- 说明：此处是作业检查节点，不表示另设一项系统审批。
|
||||
|
||||
- **24 发车／确认出库**
|
||||
- 负责人：海外出库员 · 姓名____
|
||||
- 正常：按系统可发车条件确认发车、完成出库 → 25 派送签收；调度负责车辆交接。
|
||||
- 异常：系统阻断／司机未到／交接不符 → 出库员暂停，海外调度协调处理 → 满足条件后发车。
|
||||
|
||||
- **25 派送／签收**
|
||||
- 负责人：派送运营 · 姓名____
|
||||
- 正常：送达、保存有效签收资料 → 26 整单完结核对；同时进入 27 客户回访。
|
||||
- 异常：拒签／送达失败 → 派送运营登记异常 → 退回时按实收恢复到真实托盘、库位 → 另行安排后续；不按正常签收完结。
|
||||
|
||||
- **26 整单完结**
|
||||
- 负责人：履约运营 · 姓名____
|
||||
- 正常：全部有效履约片段完成后，系统汇总整单完结；履约运营核对结果。
|
||||
- 异常：还有余货／其他柜未完成／回传失败 → 履约运营追踪对应环节，系统故障转技术 → 齐备后完结。
|
||||
- 说明：27 回访独立进行；财务结清另行核对。
|
||||
|
||||
- **27 客户回访**
|
||||
- 负责人：客服 · 姓名____
|
||||
- 正常：普通派送签收后回访，记录反馈、处理结果和附件；与 26 整单完结核对并行。
|
||||
- 异常：联系不上／投诉／索赔 → 客服持续跟进，交对应业务主管处理 → 反馈客户并补回访记录。
|
||||
@@ -0,0 +1,178 @@
|
||||
<?xml version='1.0' encoding='utf-8'?>
|
||||
<map version="1.0.1">
|
||||
<node TEXT="头程 → 柜子 → 尾程｜逐节点流程" ID="logistics-process" FOLDED="false">
|
||||
<richcontent TYPE="NOTE">
|
||||
<html>
|
||||
<body>
|
||||
<p>按实际业务节点编号，不限定阶段或步数。展开每个节点查看负责人、正常去向、异常处理和特殊分支。</p>
|
||||
<p>岗位为建议分工，姓名留空待填；异常转交路径供人工确认。编号用于讨论定位，可并行或提前的动作以节点说明为准。</p>
|
||||
<p>标记“待确认”的处理入口或完结规则，需要人工补充，不能当作已具备的系统能力。</p>
|
||||
</body>
|
||||
</html>
|
||||
</richcontent>
|
||||
<node TEXT="01 客户下单｜客户下单员" ID="step-01" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：客户下单员 · 姓名____" />
|
||||
<node TEXT="正常：提交订单 → 02 审核；同时安排 03 送仓。" />
|
||||
<node TEXT="异常：资料缺失／下单失败 → 客服协助客户补正 → 重新提交。" />
|
||||
</node>
|
||||
<node TEXT="02 订单审核｜订单审核员" ID="step-02" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：订单审核员 · 姓名____" />
|
||||
<node TEXT="正常：审核通过；与 03—05 可并行，06 测量审核通过前须完成本步。" />
|
||||
<node TEXT="异常：申报／渠道有误 → 审核员联系客户补正 → 重新审核。" />
|
||||
</node>
|
||||
<node TEXT="03 拉货／客户送仓｜国内提货跟单" ID="step-03" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：国内提货跟单 · 姓名____" />
|
||||
<node TEXT="正常：上门拉货或客户自送 → 04 到仓收货。" />
|
||||
<node TEXT="异常：未备货／迟到／运输破损 → 提货跟单联系客户、司机 → 改约或补交接记录。" />
|
||||
<node TEXT="说明：拉货执行、司机交接的现场规则待补充；当前系统主要记录预约信息。" />
|
||||
</node>
|
||||
<node TEXT="04 国内到仓收货｜国内收货员" ID="step-04" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：国内收货员 · 姓名____" />
|
||||
<node TEXT="正常：核对订单、箱数、外包装 → 05 称重测量。" />
|
||||
<node TEXT="异常：无单／少件／多件／破损 → 收货员留证，仓库主管与客服核对 → 明确收货处理后交测量。" />
|
||||
</node>
|
||||
<node TEXT="05 称重测量｜国内测量员" ID="step-05" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：国内测量员 · 姓名____" />
|
||||
<node TEXT="正常：采集重量、尺寸、箱数和图片 → 06 测量审核；称重确认时开始分配库位。" />
|
||||
<node TEXT="异常：漏测／错码／读数异常 → 测量员复测补证 → 重新提交审核。" />
|
||||
</node>
|
||||
<node TEXT="06 测量审核｜测量审核员" ID="step-06" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：测量审核员 · 姓名____" />
|
||||
<node TEXT="正常：普通货审核通过 → 07 在库交接 → 08 排柜；一件代发另走下方分支。" />
|
||||
<node TEXT="异常：数据／证据存疑 → 审核员联系测量员复核 → 再审；退回修改入口待确认。" />
|
||||
<node TEXT="06A 一件代发拆箱清点｜国内清点员" ID="step-06A" FOLDED="true">
|
||||
<node TEXT="负责人：国内清点员 · 姓名____" />
|
||||
<node TEXT="正常：按箱核对 SKU 与数量 → 06B 归托封托。" />
|
||||
<node TEXT="异常：差异 → 仓库主管、客服核对；接受差异须留原因，接受权限待定。" />
|
||||
</node>
|
||||
<node TEXT="06B 打托／归托／封托｜国内打托员" ID="step-06B" FOLDED="true">
|
||||
<node TEXT="负责人：国内打托员 · 姓名____" />
|
||||
<node TEXT="正常：清点完成、封托完成 → 08 排柜；封托托盘作为不可拆分单元。" />
|
||||
<node TEXT="异常：漏清点／托盘未封 → 国内仓主管安排补作业 → 封托后继续。" />
|
||||
</node>
|
||||
</node>
|
||||
<node TEXT="07 国内入库／库位确认｜国内仓管" ID="step-07" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：国内仓管 · 姓名____" />
|
||||
<node TEXT="正常：确认货物所在库位和交接信息 → 08 排柜；库位安排随 05 开始，本步核对在库结果。" />
|
||||
<node TEXT="异常：库位不足／货位不符 → 国内仓主管落实存放位置并核对记录 → 交接后继续。" />
|
||||
</node>
|
||||
<node TEXT="08 排柜／分柜｜柜务" ID="step-08" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：柜务 · 姓名____" />
|
||||
<node TEXT="正常：确定本柜装哪些货 → 11 国内拣货；可与 09 订舱准备并行。" />
|
||||
<node TEXT="异常：超容／扣货／审核未完成 → 柜务协调仓库、审核员 → 调整计划或解除阻断后再拣货。" />
|
||||
<node TEXT="说明：待审核、待测量可先占位；实物作业须满足审核、清点封托等条件。" />
|
||||
</node>
|
||||
<node TEXT="09 订舱／放舱｜船务" ID="step-09" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：船务 · 姓名____" />
|
||||
<node TEXT="正常：确认舱位、船期和放舱资料 → 10 国内拖柜。" />
|
||||
<node TEXT="异常：无舱／甩柜／船期调整 → 船务协调船司、柜务 → 确认新船期及装柜安排。" />
|
||||
</node>
|
||||
<node TEXT="10 国内拖柜：预约、提柜到仓｜国内运输跟单" ID="step-10" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：国内运输跟单 · 姓名____" />
|
||||
<node TEXT="正常：订舱已放舱、资料齐全后预约；司机提空柜到国内仓 → 12 装柜。" />
|
||||
<node TEXT="异常：车不到／柜不可用／资料缺失 → 运输跟单联络车队、船务 → 补资料或重新安排。" />
|
||||
</node>
|
||||
<node TEXT="11 国内拣货｜国内拣货员" ID="step-11" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：国内拣货员 · 姓名____" />
|
||||
<node TEXT="正常：按装柜计划找到货物、扫码核对 → 12 装柜。" />
|
||||
<node TEXT="异常：找不到／错货／少件／扣货 → 国内仓主管与柜务核对 → 补拣、调整计划或解除阻断。" />
|
||||
</node>
|
||||
<node TEXT="12 装柜完成｜国内装柜主管" ID="step-12" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：国内装柜主管 · 姓名____" />
|
||||
<node TEXT="正常：核对实装、柜号和装柜证据 → 13 出口报关；同时开始海外接柜准备。" />
|
||||
<node TEXT="异常：实装不符／装不下／证据缺失 → 装柜主管与柜务核实 → 调整、补证后确认完成。" />
|
||||
<node TEXT="12A 海外接柜准备｜海外计划员" ID="step-12A" FOLDED="true">
|
||||
<node TEXT="负责人：海外计划员 · 姓名____" />
|
||||
<node TEXT="正常：装柜完成后系统生成尾程订单 → 人工准备入仓计划、托盘与库位 → 18 拆柜收货。" />
|
||||
<node TEXT="异常：订单未同步／计划或资源缺失 → 计划员联系履约运营、仓库主管补齐；系统失败转技术处理。" />
|
||||
</node>
|
||||
</node>
|
||||
<node TEXT="13 出口报关｜出口报关专员" ID="step-13" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：出口报关专员 · 姓名____" />
|
||||
<node TEXT="正常：装柜完成后处理整柜报关、收齐完成资料 → 14 国内出仓。" />
|
||||
<node TEXT="异常：资料缺失／退单／查验 → 报关专员联系客户、代理 → 补正或配合查验，完成后继续。" />
|
||||
</node>
|
||||
<node TEXT="14 国内出仓｜国内出仓员" ID="step-14" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：国内出仓员 · 姓名____" />
|
||||
<node TEXT="正常：报关完成且出仓条件齐备 → 确认离仓，交 15 海运跟踪。" />
|
||||
<node TEXT="异常：报关未完成／扣货／交接不符 → 出仓员暂停放行，联系对应主责 → 条件满足后出仓。" />
|
||||
</node>
|
||||
<node TEXT="15 海运／到港跟踪｜船务" ID="step-15" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：船务 · 姓名____" />
|
||||
<node TEXT="正常：跟踪开船、到港、卸船 → 与 16 清关、17 提柜衔接。" />
|
||||
<node TEXT="异常：延误／改港／节点未更新 → 船务核实船司消息 → 更新计划并交客服通知客户。" />
|
||||
</node>
|
||||
<node TEXT="16 目的港清关｜海外清关专员" ID="step-16" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：海外清关专员 · 姓名____" />
|
||||
<node TEXT="正常：可提前备资料；确认清关放行和提柜条件 → 17 海外提柜。" />
|
||||
<node TEXT="异常：补件／查验／未放行 → 清关专员联系代理、客户 → 处理并确认可提柜后继续。" />
|
||||
</node>
|
||||
<node TEXT="17 海外提柜／送仓｜海外运输跟单" ID="step-17" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：海外运输跟单 · 姓名____" />
|
||||
<node TEXT="正常：预约港口提柜、协调海外仓接收 → 18 拆柜收货。" />
|
||||
<node TEXT="异常：无车／提柜失败／仓库约不上 → 海外运输跟单协调港口、车队、仓库 → 改约并跟进额外费用。" />
|
||||
</node>
|
||||
<node TEXT="18 海外拆柜收货｜海外收货员" ID="step-18" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：海外收货员 · 姓名____" />
|
||||
<node TEXT="正常：按入仓计划扫描、清点、记录实收 → 无差异时交 19 入库。" />
|
||||
<node TEXT="异常：短收／超收 → 海外仓主管登记差异、留证 → 待核平；可结束卸柜，但不能直接成为可用库存，核平入口待确认。" />
|
||||
<node TEXT="18A 卸柜后还空柜｜海外运输跟单" ID="step-18A" FOLDED="true">
|
||||
<node TEXT="负责人：海外运输跟单 · 姓名____" />
|
||||
<node TEXT="正常：卸柜结束 → 安排还空并记录凭证；与后续库存、出库流程并行。" />
|
||||
<node TEXT="异常：还空受阻／临近截止 → 海外运输跟单联系车队、堆场 → 调整还空安排并跟进费用。" />
|
||||
</node>
|
||||
</node>
|
||||
<node TEXT="19 海外入库／库位确认｜海外仓管" ID="step-19" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：海外仓管 · 姓名____" />
|
||||
<node TEXT="正常：正常收货形成库存，核对真实托盘、库位和可用数量 → 20 排车。" />
|
||||
<node TEXT="异常：库位不符／暂扣／数量仍有差异 → 海外仓主管核实 → 满足可用条件后再交拣货。" />
|
||||
<node TEXT="19A 一件代发独立出库｜一件代发运营" ID="step-19A" FOLDED="true">
|
||||
<node TEXT="负责人：一件代发运营 · 姓名____" />
|
||||
<node TEXT="正常：按独立出库单逐箱或整托拣货，核对 SKU 与数量后出库；签收、回访和整单完结衔接待确认。" />
|
||||
<node TEXT="异常：缺货／错 SKU／数量不符 → 代发运营与海外仓核对 → 补货或调整后再出库。" />
|
||||
</node>
|
||||
</node>
|
||||
<node TEXT="20 海外排车｜海外调度" ID="step-20" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：海外调度 · 姓名____" />
|
||||
<node TEXT="正常：确定车辆、路线、目的地与货物 → 21 转派送、22 拣货；可提前预排，实际拣货须有可用库存。" />
|
||||
<node TEXT="异常：无车／预约冲突／库存不足 → 海外调度协调仓库、车队 → 调整排车与交付安排。" />
|
||||
</node>
|
||||
<node TEXT="21 转派送／生成待出库单｜海外调度" ID="step-21" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：海外调度 · 姓名____" />
|
||||
<node TEXT="正常：生成派送关联和待出库单 → 23 发车前核对；可在 22 拣货前或过程中进行，必须早于 24 发车。" />
|
||||
<node TEXT="异常：资料缺失／生成失败 → 海外调度补齐资料、核实关联 → 成功后才能发车。" />
|
||||
</node>
|
||||
<node TEXT="22 按排车拣货｜海外拣货员" ID="step-22" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：海外拣货员 · 姓名____" />
|
||||
<node TEXT="正常：按排车任务、托盘与库位扫描拣货 → 23 核平复核。" />
|
||||
<node TEXT="异常：少货／错托／暂扣／货位不符 → 海外仓主管核查 → 补拣或协调调度调整。" />
|
||||
</node>
|
||||
<node TEXT="23 拣货核平／发车前复核｜海外仓主管" ID="step-23" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：海外仓主管 · 姓名____" />
|
||||
<node TEXT="正常：核对实拣、出库单、车辆及必需资料 → 条件齐备交 24 发车。" />
|
||||
<node TEXT="异常：数量未核平／单据缺失 → 海外仓主管联系拣货员、调度补齐 → 复核无误后继续。" />
|
||||
<node TEXT="说明：此处是作业检查节点，不表示另设一项系统审批。" />
|
||||
</node>
|
||||
<node TEXT="24 发车／确认出库｜海外出库员" ID="step-24" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：海外出库员 · 姓名____" />
|
||||
<node TEXT="正常：按系统可发车条件确认发车、完成出库 → 25 派送签收；调度负责车辆交接。" />
|
||||
<node TEXT="异常：系统阻断／司机未到／交接不符 → 出库员暂停，海外调度协调处理 → 满足条件后发车。" />
|
||||
</node>
|
||||
<node TEXT="25 派送／签收｜派送运营" ID="step-25" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：派送运营 · 姓名____" />
|
||||
<node TEXT="正常：送达、保存有效签收资料 → 26 整单完结核对；同时进入 27 客户回访。" />
|
||||
<node TEXT="异常：拒签／送达失败 → 派送运营登记异常 → 退回时按实收恢复到真实托盘、库位 → 另行安排后续；不按正常签收完结。" />
|
||||
</node>
|
||||
<node TEXT="26 整单完结｜履约运营" ID="step-26" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：履约运营 · 姓名____" />
|
||||
<node TEXT="正常：全部有效履约片段完成后，系统汇总整单完结；履约运营核对结果。" />
|
||||
<node TEXT="异常：还有余货／其他柜未完成／回传失败 → 履约运营追踪对应环节，系统故障转技术 → 齐备后完结。" />
|
||||
<node TEXT="说明：27 回访独立进行；财务结清另行核对。" />
|
||||
</node>
|
||||
<node TEXT="27 客户回访｜客服" ID="step-27" FOLDED="true" POSITION="right">
|
||||
<node TEXT="负责人：客服 · 姓名____" />
|
||||
<node TEXT="正常：普通派送签收后回访，记录反馈、处理结果和附件；与 26 整单完结核对并行。" />
|
||||
<node TEXT="异常：联系不上／投诉／索赔 → 客服持续跟进，交对应业务主管处理 → 反馈客户并补回访记录。" />
|
||||
</node>
|
||||
</node>
|
||||
</map>
|
||||
@@ -0,0 +1,63 @@
|
||||
<mxfile host="app.diagrams.net" modified="2026-09-22T00:00:00.000Z" agent="Codex" version="24.7.17">
|
||||
<diagram id="sequential-loop-flow" name="顺序回路示例">
|
||||
<mxGraphModel dx="1200" dy="900" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1169" pageHeight="827" math="0" shadow="0">
|
||||
<root>
|
||||
<mxCell id="0" />
|
||||
<mxCell id="1" parent="0" />
|
||||
<mxCell id="n01" value="01 客户下单 负责人：客户下单员 通过→下一节点 异常：资料补正" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=14;" vertex="1" parent="1">
|
||||
<mxGeometry x="60" y="40" width="270" height="90" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e01" value="异常处理 客服协助补正后回 01" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=12;" vertex="1" parent="1">
|
||||
<mxGeometry x="420" y="45" width="260" height="80" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="bad-01" value="异常" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;dashed=1;strokeColor=#b85450;endArrow=block;html=1;" edge="1" parent="1" source="n01" target="e01" />
|
||||
<mxCell id="back-01" value="处理完成，回本节点复核" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;dashed=1;strokeColor=#b85450;endArrow=block;html=1;" edge="1" parent="1" source="e01" target="n01" />
|
||||
<mxCell id="next-01" value="通过" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;strokeColor=#6c8ebf;endArrow=block;html=1;" edge="1" parent="1" source="n01" target="n02" />
|
||||
<mxCell id="n02" value="02 订单审核 负责人：订单审核员 通过→下一节点 异常：申报／渠道有误" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=14;" vertex="1" parent="1">
|
||||
<mxGeometry x="60" y="180" width="270" height="90" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e02" value="异常处理 补正后回 02" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=12;" vertex="1" parent="1">
|
||||
<mxGeometry x="420" y="185" width="260" height="80" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="bad-02" value="异常" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;dashed=1;strokeColor=#b85450;endArrow=block;html=1;" edge="1" parent="1" source="n02" target="e02" />
|
||||
<mxCell id="back-02" value="处理完成，回本节点复核" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;dashed=1;strokeColor=#b85450;endArrow=block;html=1;" edge="1" parent="1" source="e02" target="n02" />
|
||||
<mxCell id="next-02" value="通过" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;strokeColor=#6c8ebf;endArrow=block;html=1;" edge="1" parent="1" source="n02" target="n03" />
|
||||
<mxCell id="n03" value="03 拉货／客户送仓 负责人：国内提货跟单 通过→下一节点 异常：未备货／迟到／破损" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=14;" vertex="1" parent="1">
|
||||
<mxGeometry x="60" y="320" width="270" height="90" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e03" value="异常处理 改约或补交接后回 03" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=12;" vertex="1" parent="1">
|
||||
<mxGeometry x="420" y="325" width="260" height="80" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="bad-03" value="异常" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;dashed=1;strokeColor=#b85450;endArrow=block;html=1;" edge="1" parent="1" source="n03" target="e03" />
|
||||
<mxCell id="back-03" value="处理完成，回本节点复核" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;dashed=1;strokeColor=#b85450;endArrow=block;html=1;" edge="1" parent="1" source="e03" target="n03" />
|
||||
<mxCell id="next-03" value="通过" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;strokeColor=#6c8ebf;endArrow=block;html=1;" edge="1" parent="1" source="n03" target="n04" />
|
||||
<mxCell id="n04" value="04 到仓验收与测量 负责人：收货员／测量员 通过→下一节点 异常：差异／漏测／错码" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=14;" vertex="1" parent="1">
|
||||
<mxGeometry x="60" y="460" width="270" height="90" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e04" value="异常处理 补收或复测后回 04" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=12;" vertex="1" parent="1">
|
||||
<mxGeometry x="420" y="465" width="260" height="80" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="bad-04" value="异常" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;dashed=1;strokeColor=#b85450;endArrow=block;html=1;" edge="1" parent="1" source="n04" target="e04" />
|
||||
<mxCell id="back-04" value="处理完成，回本节点复核" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;dashed=1;strokeColor=#b85450;endArrow=block;html=1;" edge="1" parent="1" source="e04" target="n04" />
|
||||
<mxCell id="next-04" value="通过" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;strokeColor=#6c8ebf;endArrow=block;html=1;" edge="1" parent="1" source="n04" target="n05" />
|
||||
<mxCell id="n05" value="05 测量审核 负责人：测量审核员 通过→下一节点 异常：数据或证据存疑" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=14;" vertex="1" parent="1">
|
||||
<mxGeometry x="60" y="600" width="270" height="90" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e05" value="异常处理 复测补证后回 05；订单门禁回 02" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=12;" vertex="1" parent="1">
|
||||
<mxGeometry x="420" y="605" width="260" height="80" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="bad-05" value="异常" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;dashed=1;strokeColor=#b85450;endArrow=block;html=1;" edge="1" parent="1" source="n05" target="e05" />
|
||||
<mxCell id="back-05" value="处理完成，回本节点复核" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;dashed=1;strokeColor=#b85450;endArrow=block;html=1;" edge="1" parent="1" source="e05" target="n05" />
|
||||
<mxCell id="next-05" value="通过" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;strokeColor=#6c8ebf;endArrow=block;html=1;" edge="1" parent="1" source="n05" target="n06" />
|
||||
<mxCell id="n06" value="06 入库／库位确认 负责人：国内仓管 通过→下一节点 异常：库位不足／货位不符" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=14;" vertex="1" parent="1">
|
||||
<mxGeometry x="60" y="740" width="270" height="90" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="e06" value="异常处理 落实位置并修正后回 06" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=12;" vertex="1" parent="1">
|
||||
<mxGeometry x="420" y="745" width="260" height="80" as="geometry" />
|
||||
</mxCell>
|
||||
<mxCell id="bad-06" value="异常" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;dashed=1;strokeColor=#b85450;endArrow=block;html=1;" edge="1" parent="1" source="n06" target="e06" />
|
||||
<mxCell id="back-06" value="处理完成，回本节点复核" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;dashed=1;strokeColor=#b85450;endArrow=block;html=1;" edge="1" parent="1" source="e06" target="n06" />
|
||||
</root>
|
||||
</mxGraphModel>
|
||||
</diagram>
|
||||
</mxfile>
|
||||
@@ -0,0 +1,52 @@
|
||||
# 头程到尾程流程节点清单
|
||||
|
||||
填写规则：`节点｜负责人｜完成后进入｜异常处理后回到`。姓名、时限和凭证由现场补充。
|
||||
|
||||
## 主流程
|
||||
|
||||
| 编号 | 节点 | 负责人 | 完成后进入 | 异常处理后回到 |
|
||||
|---|---|---|---|---|
|
||||
| 01 | 客户下单 | 客户下单员：____ | 02 订单审核 | 资料补正后回 01 |
|
||||
| 02 | 订单审核 | 订单审核员：____ | 03 拉货／送仓 | 补正后回 02 |
|
||||
| 03 | 拉货／客户送仓 | 国内提货跟单：____ | 04 到仓收货 | 改约或补交接后回 03 |
|
||||
| 04 | 到仓收货 | 国内收货员：____ | 05 称重测量 | 差异确认后回 04 |
|
||||
| 05 | 称重测量 | 国内测量员：____ | 06 测量审核 | 补测补证后回 05 |
|
||||
| 06 | 测量审核 | 测量审核员：____ | 07 入库／库位 | 数据问题回 05；订单门禁回 02 后再回 06 |
|
||||
| 07 | 国内入库／库位 | 国内仓管：____ | 08 排柜 | 修正库位后回 07 |
|
||||
| 08 | 排柜／分柜 | 柜务：____ | 09 订舱／放舱 | 调整计划后回 08 |
|
||||
| 09 | 订舱／放舱 | 船务：____ | 10 国内拖柜 | 新船期或资料确认后回 09 |
|
||||
| 10 | 国内拖柜：预约、提柜到仓 | 国内运输跟单：____ | 11 国内拣货 | 改约或补资料后回 10 |
|
||||
| 11 | 国内拣货 | 国内拣货员：____ | 12 装柜完成 | 补拣或调整后回 11 |
|
||||
| 12 | 装柜完成 | 国内装柜主管：____ | 13 出口报关 | 调整或补证后回 12 |
|
||||
| 13 | 出口报关 | 报关专员：____ | 14 国内出仓 | 补正或查验后回 13 |
|
||||
| 14 | 国内出仓 | 国内出仓员：____ | 15 海运跟踪 | 解除阻断后回 14 |
|
||||
| 15 | 海运／到港跟踪 | 船务：____ | 16 目的港清关 | 核实船期后回 15 |
|
||||
| 16 | 目的港清关 | 海外清关专员：____ | 17 海外提柜 | 补件、查验或放行后回 16 |
|
||||
| 17 | 海外提柜／送仓 | 海外运输跟单：____ | 18 海外拆柜收货 | 改约后回 17 |
|
||||
| 18 | 海外拆柜收货 | 海外收货员：____ | 19 海外入库 | 短收／超收先待核平，完成后回 19 |
|
||||
| 19 | 海外入库／库位 | 海外仓管：____ | 20 海外排车 | 满足可用库存条件后回 19 |
|
||||
| 20 | 海外排车 | 海外调度：____ | 21 转派送、22 拣货 | 调整车辆或预约后回 20 |
|
||||
| 21 | 转派送／生成待出库单 | 海外调度：____ | 23 发车前复核 | 补齐资料后回 21 |
|
||||
| 22 | 按排车拣货 | 海外拣货员：____ | 23 发车前复核 | 补拣或库存调整后回 22 |
|
||||
| 23 | 拣货核平／发车前复核 | 海外仓主管：____ | 24 发车／出库 | 补齐数量、单据、车辆后回 23 |
|
||||
| 24 | 发车／确认出库 | 海外出库员：____ | 25 派送签收 | 满足发车条件后回 24 |
|
||||
| 25 | 派送／签收 | 派送运营：____ | 26 整单完结；27 回访 | 拒签／失败：退回恢复库存，后续重新安排 |
|
||||
| 26 | 整单完结 | 履约运营：____ | 流程结束 | 还有未完成片段时回对应节点 |
|
||||
| 27 | 客户回访 | 客服：____ | 流程结束 | 投诉或联系不上时由客服继续跟进 |
|
||||
|
||||
## 特殊分支
|
||||
|
||||
| 分支 | 负责人 | 流程 | 异常回流 |
|
||||
|---|---|---|---|
|
||||
| 一件代发国内处理 | 国内清点员／打托员：____ | 06 测量审核 → 拆箱清点 → 归托封托 → 07 入库／库位 → 08 排柜 | 差异回清点；漏清点或未封托回打托 |
|
||||
| 海外接柜准备 | 海外计划员：____ | 12 装柜完成后提前准备入仓计划、托盘、库位 | 资料或资源缺失回计划准备 |
|
||||
| 卸柜后还空 | 海外运输跟单：____ | 18 拆柜完成 → 安排还空 | 还空受阻回运输跟单处理 |
|
||||
| 一件代发海外独立出库 | 一件代发运营：____ | 按独立出库单逐箱或整托拣货 → 复核 → 出库 | 缺货或错 SKU 回海外仓核对；签收和完结规则待确认 |
|
||||
|
||||
## 并行关系
|
||||
|
||||
- 02 审核与 03 拉货、04 收货、05 测量可以并行；06 测量审核前必须完成 02。
|
||||
- 08 排柜、09 订舱准备可以并行；10 拖柜预约须等订舱放舱和资料齐备。
|
||||
- 12 装柜完成后即可准备海外入仓计划，不必等待海运到港。
|
||||
- 21 转派送可以早于或晚于 22 拣货，但必须早于 24 发车。
|
||||
- 26 整单完结与 27 客户回访并行，回访不阻断整单完结。
|
||||
File diff suppressed because one or more lines are too long
File diff suppressed because it is too large
Load Diff
+123
@@ -0,0 +1,123 @@
|
||||
# 领星新品测量接口联调说明
|
||||
|
||||
## 范围
|
||||
|
||||
墨家上传的 `boxCode` 不包含 `#` 时，Firstleg 将它作为 SKU 测量收件记录保存；带 `#` 的箱唛继续使用原箱唛测量流程。SKU 记录默认只保存，不自动修改领星，是否自动推送由 Nacos 配置控制。
|
||||
|
||||
领星账号使用独立浏览器容器和独立 profile，不复用其他 Node.js 账号或浏览器会话。
|
||||
|
||||
## 领星查询
|
||||
|
||||
请求：
|
||||
|
||||
```http
|
||||
POST https://wms.xlwms.com/gateway/wms/newProduct/page
|
||||
Content-Type: application/json
|
||||
```
|
||||
|
||||
请求体：
|
||||
|
||||
```json
|
||||
{
|
||||
"barcode": "A120133-A-TK",
|
||||
"current": 1,
|
||||
"customerCode": "",
|
||||
"keyword": "A120133-A-TK",
|
||||
"multiKeyword": "",
|
||||
"searchType": "barcode",
|
||||
"size": 20,
|
||||
"whCode": "US01"
|
||||
}
|
||||
```
|
||||
|
||||
系统按 `US01`、`US02` 分别查询，并只接受 `productSku` 或 `barcode` 精确等于请求 SKU 的记录。查询结果中的 `maintained=1` 表示该仓库已经维护过，不能再次提交。
|
||||
|
||||
## 领星测量
|
||||
|
||||
请求：
|
||||
|
||||
```http
|
||||
POST https://wms.xlwms.com/gateway/wms/newProduct/measure
|
||||
Content-Type: application/json
|
||||
```
|
||||
|
||||
Java 会以查询返回的整条商品记录为基础，仅替换墨家测量值。请求中的单位字段必须区分：
|
||||
|
||||
| 字段 | 值 | 含义 |
|
||||
| --- | --- | --- |
|
||||
| `sizeUnit` | `in` | 领星原商品尺寸展示单位 |
|
||||
| `length`/`width`/`height` | 查询原值 | 原商品申报尺寸 |
|
||||
| `lengthBs`/`widthBs`/`heightBs` | 查询原值 | 原商品英寸换算值 |
|
||||
| `wmsSizeUnit` | `cm` | 本次维护尺寸单位 |
|
||||
| `wmsLength`/`wmsWidth`/`wmsHeight` | 墨家厘米值 | 本次维护尺寸 |
|
||||
| `wmsLengthBs`/`wmsWidthBs`/`wmsHeightBs` | 厘米 ÷ 2.54 | 本次维护英寸换算值 |
|
||||
| `weightUnit` | `lb` | 领星原商品重量展示单位 |
|
||||
| `wmsWeightUnit` | `kg` | 本次维护重量单位 |
|
||||
| `wmsWeight` | 墨家千克值 | 本次维护重量 |
|
||||
| `wmsWeightBs` | 千克 × 2.2046226218 | 本次维护磅换算值 |
|
||||
|
||||
示例中的维护字段如下：
|
||||
|
||||
```json
|
||||
{
|
||||
"wmsLength": "24.5",
|
||||
"wmsLengthBs": "9.646",
|
||||
"wmsWidth": "18.5",
|
||||
"wmsWidthBs": "7.283",
|
||||
"wmsHeight": "5",
|
||||
"wmsHeightBs": "1.969",
|
||||
"wmsSizeUnit": "cm",
|
||||
"wmsWeight": "0.15",
|
||||
"wmsWeightBs": "0.331",
|
||||
"wmsWeightUnit": "kg"
|
||||
}
|
||||
```
|
||||
|
||||
接口返回 `code=200` 才视为提交成功。HTTP 401 或领星业务码表示登录失效时，Java 清理缓存并自动重新登录后重试一次；其他失败记录为同步失败，不自动无限重试。
|
||||
|
||||
## 登录和二次验证
|
||||
|
||||
浏览器页地址为 `https://wms.xlwms.com/login`。Java 通过 CDP 操作独立浏览器页面：
|
||||
|
||||
- 账号：`input[name="username"]`
|
||||
- 密码：`input[name="password"]`
|
||||
- 登录：`.login-btn`
|
||||
- 腾讯安全验证容器：`#captchaId`（仅在可见挑战出现时转人工处理）
|
||||
- 短信/邮箱验证码：`input[placeholder="输入验证码"]`
|
||||
- TOTP 验证码：`input.verification-code-native`
|
||||
- 短信/邮箱获取验证码：`.verify-code-login .code-btn`
|
||||
- 验证登录：`.verify-code-login .login-btn`
|
||||
|
||||
检测到二次验证页面后，Java 立即为短信/邮箱渠道点击获取验证码；用户在后台输入收到的验证码后，Java 只提交验证码，不会再次发送。TOTP 由领星页面自动初始化。腾讯安全滑块属于人工安全验证，必须通过 noVNC 完成，Java 不绕过该验证。
|
||||
|
||||
账号、密码和主登录按钮选择器已根据 `https://wms.xlwms.com/login` 页面源码及登录脚本核对；短信/邮箱和 TOTP 二次验证输入选择器也已确认。验证码错误或过期等业务结果仍需以真实运行时返回为准。
|
||||
|
||||
## Nacos 配置
|
||||
|
||||
开发环境默认关闭自动推送：
|
||||
|
||||
```yaml
|
||||
firstleg:
|
||||
lingxing:
|
||||
auto-sync-enabled: false
|
||||
base-url: https://wms.xlwms.com
|
||||
login-origin: https://wms.xlwms.com
|
||||
browser-cdp-endpoint: http://lingxing-browser:9222
|
||||
username: ${LINGXING_USERNAME}
|
||||
password: ${LINGXING_PASSWORD}
|
||||
track-key-v2-secret-base64: ${LINGXING_TRACK_KEY_V2_SECRET_BASE64}
|
||||
warehouses: [US01, US02]
|
||||
```
|
||||
|
||||
`lingxing-browser` 和 Java Firstleg 必须加入同一个 Docker 网络（开发部署脚本默认是 `firstleg-development-network`）。noVNC 只绑定服务器回环地址，远程人工处理安全滑块时使用 SSH 本地端口转发。账号、密码、Cookie、Token 和 Track-Key 密钥不得写入仓库或提交到 Git。
|
||||
|
||||
Track-Key 密钥按参考实现只做一次 Base64 解码，Java 不限制解码后的固定字节长度；只要密钥非空且与 Node 实际使用的 keyBytes 相同即可。
|
||||
|
||||
## 验收步骤
|
||||
|
||||
1. 启动独立浏览器容器并确认 `http://lingxing-browser:9222/json/version` 可从 Java 容器访问。
|
||||
2. 保持 `auto-sync-enabled=false`，进入后台“SKU同步”页面，输入 SKU，点击“测试连接”。
|
||||
3. 首次触发二次验证时，在后台输入验证码，确认原查询自动继续，并返回 `US01`、`US02` 结果。
|
||||
4. 对 `maintained=0` 的记录点击“人工推送”，确认领星返回 `code=200`。
|
||||
5. 再次查询同一 SKU，确认已维护记录不会重复提交。
|
||||
6. 将 `auto-sync-enabled` 改为 `true` 后重新上传不带 `#` 的 SKU，确认入库后自动推送；失败记录可在页面人工重新推送。
|
||||
Reference in New Issue
Block a user