ERP 使用说明
本文说明 slcoolco.net ERP 各模块用途、标准作业流程，以及备货/挑货/报关中容易混淆的概念。
数据与 Listing Forge（LF）共用 PostgreSQL，库存来自通途同步的 inventory_stocks。
1. 系统概览与导航
左侧为固定导航栏，各入口含义如下：
| 菜单 | 用途 |
|---|---|
| 仪表盘 | 订单同步概况、异常与快捷入口 |
| 订单中心 / 订单仪表盘 | 通途订单查询、状态筛选、销量统计 |
| 切仓修正 | 缺货时自动/人工修正发货仓库记录 |
| 买家留言 | eBay 留言处理 |
| 海关编码 | HS 编码查询、法定计量单位回填 |
| 销量分析 | 按 SKU / 站点查看 order_stats |
| 备货建议 | 海外仓补货决策、AI 分析、创建挑货单 |
| 挑货单 | 国内仓拣货、装箱、生成报关 |
| 发货前综合处理 | 选仓比价审核、确认改单（详见第 5 节） |
| 报关单 | 报关/清关单证编辑与导出 |
| 使用说明 | 本页 |
页脚 「立即同步订单」 会从通途拉取最新订单，不单独同步库存；库存由 LF/通途库存同步任务写入 inventory_stocks。
2. 标准业务流程
- 备货建议：判断各 SKU 在各澳洲目的仓是否要补货（含 AI 结论）。
- 挑货单：从国内花都仓库*实际拣货发往所选目的仓。
- 报关单：基于已挑货明细生成装箱清单、报关单、发票、清关单等。
3. 备货建议
3.1 列表在算什么？
每一行 = 一个 SKU × 一个目的仓（橙联悉尼、墨尔本、万邑通、国内花都等）。系统按销量公式算出「建议备货量」，并与该仓库存、在途对比。
- 库存：该目的仓的
available_qty（上次点「重新计算」时的快照）。 - 在途（有效）：在途 + 同步在途。
- 可销天数 = (库存 + 在途) ÷ 修正日销。
挑货单上的「库存」固定是 国内花都仓库* 可拣数量（实时查询）。
备货表里 Orange Connex / 万邑通 一行显示 0，只表示该海外仓没货，不代表国内仓没货。
核对国内库存：仓库筛选项选 国内花都仓库*，或看挑货单明细。
3.2 筛选条件
- 仅显示有效仓行（默认开）：只显示「有库存/在途」「该仓近 30 天有销量」或「该仓有过有效发货」的行；过滤从未发过货的幽灵仓行。
- AI 建议：建议补货 / 少量试探 / 暂不补货 / 待 AI 分析 — 与 AI 缓存结论一致。
- 仅显示建议补货：公式层面
needs_replenish=true的行（与 AI 结论可能不同，以 AI 列为准）。
| SKU | 仓库 | 库存 | 在途 | 建议备货 | AI 建议 |
|---|---|---|---|---|---|
| 161NS202-2 | 国内花都仓库* | 10 | 0 | 3 | ⚡ 建议补3 |
| 161NS202-2 | 橙联一心-悉尼仓 | 2 | 8 | 5 | ⚡ 建议补5 |
| 101MP125 | 万邑通澳洲仓库 | 0 | 0 | 4 | 【暂不补货】 近30天无销量 |
| 163UN004-2 | Orange Connex… | 0 | 0 | 1 | 【暂不补货】 动销过低 |
3.3 按钮说明
- 重新计算：全量重算公式建议量，并从
inventory_stocks刷新各仓库存写入建议表；若关键数据变化会清空该行 AI 缓存。 - AI 批量分析：对当前筛选范围内「待 AI 分析」的行调用 DeepSeek，写入
ai_decision；表格标签、筛选、点击弹窗三者一致。不会在你每次筛选时自动跑 AI。 - 创建挑货单：勾选行 → 选目的仓 → 按建议量生成草稿挑货单（可再改数量）。
3.4 AI 建议类型
| 显示 | 含义 |
|---|---|
| 建议补 N | AI 认为应补货，N 为建议件数；可销 <7 天会有红框提示 |
| 少量试探 N | 可小批量试销 |
| 【暂不补货】 | 动销低、滞销风险、利润不足等 |
| 待 AI 分析 | 尚未跑 AI；点击该行或点「AI 批量分析」 |
点击 AI 列按钮可查看完整分析正文；单条分析也会写入缓存。
4. 挑货单
挑货单从国内花都仓库*出库，发往所选目的仓（澳洲海外仓）。
| SKU | 计划数量 | 单价 | 库存 | 货架位 |
|---|---|---|---|---|
| 161NS202-2 | 3 | ¥115 | 10 | HWD03-3 |
状态流转
- 草稿：可改 SKU、数量；库存为实时查询。
- 确认：预占国内仓
waiting_shipment_qty。 - 挑货 / 完成：扣减可用库存，可自动装箱。
- 生成报关单：完成后可一键生成报关资料。
库存不足时页面会黄色提示，可先挑有货的 SKU，其余采购到货后再挑。
5. 发货前综合处理（选仓比价）
此页面在订单发货前自动审核每笔待发货单的仓库 + 物流渠道组合，给出更优方案。 核心流程：定仓 → 定物流 → 人工确认 → 一次写回通途。
5.1 决策链是什么？
| 步骤 | 说明 |
|---|---|
| E1 选仓 | 三级优先：①退货仓有货→优先发 ②库龄久(FIFO)的仓优先 ③兜底选最经济物流对应的仓 |
| E2 比价 | 在选定仓库下，从所有可用物流渠道中选运费最低的（SpeedPAK/橙联/AUP/PFL/UBI 等） |
| E3 口径校验 | 检查最终(仓+渠道)是否与 SKU 的 item_location 口径一致（NSW→海外仓、Guangzhou→国内仓） |
| 写回 | 确认后通过通途 API 一次性修改订单的仓库和物流渠道 |
页面右上角显示「仅建议（安全默认）」时，系统只给出优化建议，不会自动改单。 需要操作员点「确认」按钮才会实际写回通途。
5.2 如何开始审核？
Step 1：点「立即扫描」
系统会扫描最近 48 小时内 AU 站点待发货订单（状态：payed / waitPrinting / waitingDespatching / unshipped），逐单跑决策链，结果写入审核列表。
Step 2：查看统计概览
Step 3：用筛选 Tab 聚焦
- 待确认：系统给出建议、等你操作的单
- 已处理：已确认并写回通途的单
- 失败：审核出错的单（鼠标悬停状态图标可看错误详情）
- 右侧下拉可按站点过滤
5.3 每列含义详解
| 列名 | 含义 |
|---|---|
| 订单 ID | 通途订单号后 8 位 |
| SKU | 订单对应的商品 SKU |
| 站点 | eBay 站点（AU / US / UK 等） |
| 口径 | SKU 的 item_location 归属：海外仓(NSW) / UBI直发 / 国内直发 |
| 原仓 → 推荐仓 | 左侧灰字 = 订单当前仓库，右侧绿字 = 系统推荐仓库。有箭头表示建议切仓，无箭头表示保持当前 |
| 推荐渠道 | 系统推荐的物流渠道及费用对比（如 推荐SpeedPAK(¥33.85) 当前标准） |
| 可省 ¥ | 切换到推荐渠道可节省的运费（人民币）。无省钱空间时显示 — |
| 置信度 | measured = 基于真实计费重量；estimated = 基于估算重量 |
| 状态 | 待确认 / 已处理 / 失败 |
| 选仓理由 | 点击可看完整决策理由弹窗 |
| 选渠道理由 | 点击可看完整渠道比价详情弹窗 |
5.4 如何读懂决策理由？
点击表格中「选仓理由」或「选渠道理由」列，弹出完整理由。格式为三段式：
| 段落 | 含义 | 常见值 |
|---|---|---|
| 选仓 | 仓库决策结果 |
保持XXX = 不换仓切仓 A→B = 建议换到 B 仓口径=海外仓(NSW) = E1 选仓结果
|
| 比价 | 物流渠道对比 |
推荐XXX(¥Y) 当前ZZZ = 推荐渠道+费用 vs 当前渠道当前X(¥Y)→推荐Z(¥W) 省¥V = 有明确省钱空间
|
| 动作 | 系统建议操作 |
保持当前 = 无需改动建议改单(人工确认) = 需要人工确认后点「确认」按钮异常需人工介入 = 比价过程有异常，需仔细检查
|
改单原因标签（出现在动作后面）：
| 标签 | 含义 |
|---|---|
| 渠道可省钱 | 推荐渠道比当前渠道运费更低，切换可节省费用 |
| 渠道可优化 | 推荐渠道与当前不同（不一定更便宜，但更合理） |
| 仓需切换 | 选仓算法(E1)建议换到另一个仓库发货 |
| 比价异常 | 比价过程出错（如无匹配路由规则），需人工判断 |
| 待人工审核 | 系统无法自动分类原因，请人工判断 |
5.5 确认后该怎么操作？
| 订单ID | 原仓→推荐仓 | 推荐渠道 | 可省¥ | 状态 | 操作 |
|---|---|---|---|---|---|
| …38291 | 国内花都仓库* → 橙联一心-悉尼仓 | 推荐SpeedPAK(¥33.85) | ¥12.30 | 待确认 | 确认 |
| …47102 | 海外仓退货仓 | 推荐AUP_eParcel(¥54.14) | — | 待确认 | 确认 |
| …55213 | 橙联一心-悉尼仓 | SpeedPAK | — | 已处理 | — |
逐单确认：
- 点击理由列，弹出完整决策理由
- 核实「原仓 → 推荐仓」是否合理（切仓会影响发货地）
- 核实「推荐渠道」费用是否正确（省钱多少、渠道是否可用）
- 确认无误 → 点「确认」按钮 → 系统调通途 API 写回
- 写回成功 → 状态变为「已处理」
批量确认：
- 勾选左侧复选框（可多选）
- 底部出现「已选 N 项」+ 「批量确认」按钮
- 点击后系统逐单写回通途，完成后显示成功/失败数量
- 状态为「异常需人工介入」且标签为「比价异常」— 说明比价过程出错（如无路由规则），需先排查
- 「无匹配路由规则」— 该站点/账号组合尚未在物流配置中注册路由，无法自动推荐渠道
- 切仓到一个没有库存的仓库 — 需先确认该仓确实有货
- 推荐渠道在该站点不可用（如某些渠道不支持特定国家）
5.6 典型场景速查
| 场景 | 理由显示 | 操作 |
|---|---|---|
| 当前物流非最优 | 比价:推荐SpeedPAK(¥33.85) 当前标准 | 建议改单[渠道可省钱] |
核实推荐渠道可用 → 确认 |
| 建议切仓（E1） | 选仓:切仓 国内花都→橙联悉尼 | 比价:... | 建议改单[仓需切换] |
确认目标仓有库存 → 确认 |
| 保持当前、无需改 | 选仓:保持橙联悉尼 | 比价:SpeedPAK | 保持当前 |
无需操作（无「确认」按钮） |
| 无路由规则 | 比价:无匹配路由规则（站点/账号未配置） | 异常需人工介入[比价异常] |
联系管理员补充路由配置，或手动在通途修改 |
| 口径不一致(E3拦截) | 口径=海外仓(NSW)但最终仓=国内花都 | 异常需人工介入 |
检查 SKU 的 item_location 配置，确认应走海外还是国内 |
6. 报关单与单证
在报关单模块管理。由已完成的挑货单生成，可编辑并导出：
- 装箱清单、中华人民共和国海关出口货物报关单
- 合同、发票、箱单、预报单
- 清关单（橙联商业发票导入模版；支持 AI 判断带电/液体/带磁）
海关编码模块可维护 HS 与法定第一计量单位；报关单的「数量及单位」会优先用法定单位（个/台/千克等），避免误用「套」。
清关申报单价默认按 LF live_listings 最低在线价 × 30% 估算，可点「同步 listing 价格」刷新。
7. 订单与其它模块
- 订单中心：查看/搜索通途同步订单，含仓库、物流、SKU 明细。
- 销量分析：基于
order_stats的趋势（备货销量已按目的仓归因，与全站汇总可能不同）。 - 海关编码：查询税则、一键回填
declare_unit到商品库。
8. 常见问题
备货表库存全是 0，挑货单却有库存？
你看的多半是海外仓行（海外仓确实为 0）。请筛「国内花都仓库*」或看挑货单；并点一次重新计算刷新快照。
公式建议补货，AI 却写暂不补货？
公式只看数量阈值；AI 会综合动销、滞销风险、利润。以 AI 建议列 + 筛选 为准；需先跑「AI 批量分析」。
筛选 AI 建议会不会很慢？
不会。筛选只读数据库缓存；只有「AI 批量分析」或点击单行才会调 DeepSeek API。
万邑通出现从未发过的 SKU？
勾选「仅显示有效仓行」可隐藏；重算后会删除无销量、无发货、无库存的无效行。
数据多久更新？
订单：点「立即同步」或后台定时任务。库存：依赖通途/LF 库存同步。备货数字：点「重新计算」后更新；列表库存列为重算快照，挑货单为实时国内库存。
「无匹配路由规则」是什么意思？
该订单的站点+账号组合尚未在物流路由配置中注册。系统不知道该站点/账号有哪些可用物流渠道，无法自动推荐。需联系管理员在 channel_selector 配置中补充路由规则。
确认后改单失败了怎么办？
可能原因：通途 API 超时、订单状态已变更（如已发货）、或缺少必要的 shipping_method_id/warehouse_id。可刷新页面看状态是否回退到「待确认」，重新确认；若反复失败需排查通途端订单状态。
选仓比价会自动改单吗？
当前 auto_apply=false，系统只生成建议，所有改单都需要人工点「确认」。将来数据验证充分后可开启自动模式。