物流渠道

01 功能介绍：查询已同步的物流渠道

从 仓储物流 → TMS → 物流渠道 进入。本页展示领星头程物流渠道在 Tower 中保存的当前资料，帮助你查方案代码、所属物流商、服务范围、来源状态和运费规则。它不是本地渠道报价编辑器，也不是物流单或运输路线配置页。

一行以 租户＋平台＋渠道 ID 区分。列表的“物流方案代码”就是渠道 ID；物流渠道名称、物流商 ID/名称和运输方式是不同字段，同名渠道不等于同一条记录。当前平台仅支持 Amazon。列名中的“授权名称/授权方”沿用业务显示名称，不表示本页核验了授权有效期。

本文图片来自真实前端与本机只读内存 Mock。账号、渠道、价格、日期和任务状态均为预置样例；同步、调整渠道、配置提取器及定时任务均未演示，不把预置记录当作本次同步成功证据。

02 使用前确认身份、权限与时间

1. 准备渠道 ID，或渠道名称、物流商名称等可搜索信息。核对当前租户与平台，不能仅按名称将不同渠道合并。
2. 需要物流渠道读取权限才能查看列表与本地详情。同步还需要渠道同步和提取器写权限，具体见权限章节。
3. 默认展示全部状态、全部包税状态，无预设日期范围，固定 20 条/页。本页没有日期筛选或历史版本选择。
4. 打开详情后核对 来源更新时间 和 最后同步时间：前者是领星提供的更新时间文本，后者是 Tower 最近写入/标记此渠道的时间。不能将同步时间当作渠道业务变更发生时间。

本页读取当前渠道事实；来源缺失时可能继续显示旧名称、规则和启停值。刷新只能重读本地数据，不能证明外部平台现在仍提供这些服务。

03 查询定位：按真实字段筛选

1. 在 物流渠道 输入名称关键字，按包含关系匹配渠道名称。
2. 已知物流商 ID 时填 物流商；此处实际是 ID 精确匹配，直接填写显示名称可能查不到。只有名称时，可改用 搜索物流方案代码：它实际同时搜索渠道代码、渠道名称、物流商名称、运输方式和备注，采用不区分大小写的包含匹配。
3. 运输方式 按来源名称精确匹配；提货地 和 目的国家 按来源代码数组中的完整代码匹配，不是城市名称或自由地名搜索。目的国家输入会转为大写，例如 us → US。
4. 按需选择 状态 的全部状态/启用/停用，以及 包税状态 的是否包税/包税/不包税。多个字段组合使用，结果需同时满足。
5. 输入或选择变化后自动查询并回到第一页，不需要另找“查询”按钮。等待加载结束再核对结果；快速连续修改时，确认最终条件后可点 刷新 再核对。
6. 使用底部分页翻页，每页固定20条。点击 重置 清空条件、回到第一页并保留当前平台。

没有结果时先重置，再只用渠道代码定位；物流商 ID、运输方式名称、提货地代码精确条件尤其容易填错。本页没有商品、店铺或发货日期筛选，也没有按选中行批量处理。

04 读懂列表与渠道详情

列表包括物流方案代码、物流渠道（授权名称）、物流商（授权方）、提货地、目的国家、是否包税、预计整体时效、材积参数、分抛计算、分抛系数、来源、备注、运输方式、计费规则和状态。

1. 找到目标行，横向滚动到操作区域，点击 详情。
2. 先核对详情标题和“物流方案代码”，再看基本信息、运费规则、其他费用及操作日志。
3. 点击 返回物流渠道列表 回到原筛选和页码。本次打开详情不会另发详情查询，而是展示刚才加载的整行资料；这也不是一份独立实时详情快照。
4. 要核对新的同步结果，先返回列表，点 刷新，再重新打开详情。浏览器整页刷新可能重置页面内查询状态，不等同于这个返回按钮。

列宽可拖动表头边界调整，双击调整手柄恢复；设置保存在浏览器本地。列表默认先按来源启用值降序、空值最后，再按渠道 ID 排序；当前没有用户切换列排序、列显隐或冻结配置入口。全选和行复选框禁用，不能拿它们解释成已经选中待维护渠道。

05 时效与运费规则：资料不等于承诺报价

详情的 单票最低计费量 显示“未同步”；其他费用、操作日志 明确提示当前同步范围未提供。这些是范围限制，不是费用为0、从未修改或日志被删除。没有运价规则显示“暂无运价规则”，不能据此认为免费。

数字0会显示0，未知通常显示“-”。展示的小数最多保留四位，不应拿显示舍入结果代替外部完整报价。材积与分抛的实际公式、币种及报价有效期无法由当前调用链确认，需要向资料维护方核实。

06 区分启停、来源缺失和授权

• 启用/停用：来自领星保存的 enabled 值，不是在本页切换的开关。
• 来源缺失：该渠道在一次成功全量来源结果中未再出现；系统保留旧行，将来源状态标记为缺失。状态展示优先显示“来源缺失”，并未自动把旧 enabled 改为0。
• “-”：未拿到可解释的状态值，不能当作已启用或停用。

因此，筛选“启用”后仍可能看到“来源缺失”：筛选检查保存的 enabled 值，显示优先检查来源缺失标志。缺失可能需要核对来源范围、授权或配置，但本页不能直接证明哪一种原因，也没有独立的“授权有效”状态或授权到期日期。

同步按租户、平台和渠道 ID 更新当前资料；同一批重复身份取较新的来源行。再次出现的渠道可恢复来源在场标志；旧行不会因为本次未出现就从列表删除。本页没有历史版本回放，不能把保留旧字段当作可选择的历史快照。

07 刷新、同步和任务结果如何核对

刷新 重新读取当前筛选的列表和活动同步任务，不启动领星提取。进入页面也会读取这两部分；只有点击 同步领星 才请求新同步任务。本次同步未演示。

正式操作前先确认权限、租户和平台，以及提取器配置和外部授权。同步按当前租户/平台发起领星渠道全量任务，不以页面关键字、启停筛选、当前页或所选渠道为同步范围，也没有本页可选时间窗口。

1. 点击 同步领星，出现“同步任务已提交”只表示请求已受理；不是全部渠道已成功写入。
2. 观察状态：排队中 → 提取中 → 写入中 → 已完成，失败时显示失败及错误信息。排队、提取、写入期间按钮为“同步中”并禁用；后台也防止同租户/平台/来源重复活动任务。
3. 页面对正在跟踪的活动任务约每4秒查询状态；没有百分比或逐条失败明细。轮询请求失败可能暂时保留旧状态，应点刷新或交维护人员按任务 ID 查日志，不反复点击同步。
4. 任务显示已完成后，仍应点击 刷新 重新读取列表，再核对具体渠道、来源更新时间、最后同步时间、状态和规则。任务轮询本身不会自动重新查询列表。
5. 空闲 只表示活动任务查询没有返回正在运行的任务。重新进入或刷新后，已成功/失败任务不属于活动任务，可能只见空闲；本页没有完整任务历史列表，不能把空闲当作上次成功。

提取部分成功并不是渠道同步“部分完成”：当前任务状态只有上述五种，提取器非完全成功会将同步任务标为失败，不把这批当作成功全量刷新。事实写入与缺失标记在同一事务中执行；失败时可能继续看到旧事实。若成功返回空来源集，旧渠道可能被标记来源缺失，而不是列表必然变空。此时必须核对来源覆盖与任务证据。

同步来源与调度配置虽有独立后端接口和权限，但当前页面没有配置、定时设置或重试专用面板；不能把接口存在当作本页提供了配置能力。

08 权限与不可操作边界

查看需要 logistics_channels:read。从本页启动同步同时需要 读取权限＋logistics_channels:sync＋extractors:write：前端据此禁用按钮，后端同步路由也同时校验这些权限。仅有提取器写权限、仅有渠道同步权限或只有读取权限都不足以同步。

权限满足也不保证任务启动成功：活动任务冲突、配置或提取器创建失败、执行器提交失败仍会报错。同步配置维护另需读取与 logistics_channels:sync_manage，不是同步权限本身，也不能从本页直接维护。

当前支持查询、详情、列表刷新、当前页导出及授权后的同步。新建、编辑、启停、删除、批量处理未接入：详情里的按钮禁用，列表“操作”和复选框也禁用；无论提高哪项权限，都不能把这些占位控件当作可用维护流程。

本次所有真实写操作未演示，Mock 对业务 POST/PUT/PATCH/DELETE 明确拒绝；权限完整的演示账号仅用于查看按钮状态，不用于模拟同步成功。

09 导出：只拿当前页五个字段

列表有数据时，点工具栏 导出当前页，下载 tms_logistics_channels.csv。它直接由浏览器中当前页行数据生成，不请求全量导出接口。

导出包含渠道 ID、渠道名称、物流商名称、运输方式、展示状态五列；不包含完整运费规则、地区、同步时间或其他页面可见字段。第一页20条时文件只有这20条，不能把它称为全部筛选结果。切到第二页后导出的是第二页，禁用的复选框不参与导出选择。

此控件没有额外独立导出权限检查，前提是能够读取页面且当前页非空。读取失败但旧行仍在时，旧行也可能仍可导出；先确认错误已恢复和查询条件对应正确结果，再使用文件。界面无数据时按钮禁用，不说明你已查完所有外部渠道。

10 核对关联页面与下游影响

1. 物流商、渠道、运输方式 分别是服务方、方案和运输方式资料。对照 物流商管理 与 物流单 时带上渠道代码、物流商和来源时间，不能仅凭同名自动认定同一历史方案。
2. 网络节点 和 运输路线 是另外的页面/配置对象，分别有独立读写权限。它们的深链存在不表示物流渠道页提供节点、线路编辑入口；当前渠道页面没有这些配置按钮。
3. 已核实的读取链路中，海外仓备货单会关联渠道资料；物流异常可用当前在场的匹配渠道时效作为部分预计时效的回退；物流分析按物流商/渠道名称匹配当前在场渠道中的正时效值，并有自己的统计策略。规则不同，不能用某个渠道启停字段概括全部下游。
4. 渠道同步更新的是渠道事实，未发现该同步链路自动改写旧物流单、运输事件、历史账单或分析策略的动作。下游重新查询时可能按自己的当前关联逻辑显示不同名称或目标值，这也不等于旧单据已重算。

复核 物流分析 或 物流异常 时同时记录样本、渠道来源时间与策略范围；不能把今天的渠道预计值直接当作旧业务发生时的承诺。实际物流履约与费用结算还要回到对应单据核证。

11 常见异常处理

• 渠道查不到：重置后用代码或综合关键字查；核对物流商是否填了ID，提货地/国家是否为来源代码，运输方式是否完全一致。
• 状态筛选与标签不同：先检查是否“来源缺失”覆盖了旧启停值，别直接认定筛选错误。
• 详情数据还是旧的：详情来自已经加载的行。返回列表刷新后重新打开，并核对来源与同步时间。
• 顶部报错但仍有行：列表失败可能保留旧数据，活动任务失败也可单独出现错误；不要把旧行、旧导出或旧任务状态当成最新成功。
• 同步按钮灰色：确认读取、渠道同步、extractors:write三项完整；有活动任务或正在提交也会禁用。
• 资料为空或显示“-”：区分真实0、来源未填、范围未提供及来源缺失；币种、最低计费量、其他费用和操作日志不能用猜测补齐。
• 无查看权限：核对账号租户和渠道读取授权，深链不能绕过权限；不要反复尝试同步。

12 常见问题

为何叫渠道资料，却不能编辑或停用？

当前页面主要读取领星同步结果。编辑、删除和启停按钮是未接入的禁用占位，不是等待提高权限就能使用。

详情是否重新查询了领星？

没有。点击详情展示当前列表已加载的渠道行；刷新列表也只读本地事实。只有授权后的同步才启动外部提取，本次未演示。

运费价格可以直接当报价吗？

不能。当前同步未提供币种、完整附加费用、最低计费量和完整计价公式，预计时效也不是妥投承诺。

空闲是不是同步成功？

不是。空闲只表示没有活动任务，成功/失败任务可能已不在活动查询内。按具体任务和渠道时间核对。

停用是否立刻改变所有旧订单或分析结果？

不能这样理解。本页不能执行停用，来源值由同步读取；各下游按自身关联与策略消费当前资料，不存在本页一键重写所有历史单据的能力。

导出为什么只有20条？

导出范围就是当前页，固定五个字段。要核查其他页需分别翻页，不能把当前文件解释成全量渠道清单。