物流商

01 功能介绍：查询物流商同步资料

进入「仓储物流 → TMS → 物流商」，核对平台范围内的物流商名称、代码、状态、联系资料和授权信息。当前页面以查询同步结果为主；Amazon 资料来自领星头程物流商列表，不是在 Tower 表格中手工建立的通讯录。

本页没有新增、编辑、启停、删除、导入或导出入口。行尾「详情」尚未接入打开逻辑；「操作」菜单仅有不可用的「只读结果」。不要把可见按钮或“管理”名称理解为已支持维护，也不要把物流商主数据同步当作物流单或轨迹同步。

截图为虚构示例资料，仅用于说明操作。实际同步与资料修改未演示。

02 使用前：确认平台、权限与身份

1. 确认账号有物流商查看权限，准备目标平台、物流商名称或代码。默认选择 Amazon；平台选项从平台配置读取，Amazon 会作为兜底选项保留。
2. 核对平台后再核对代码和来源身份。同名、简称相近或跨平台同代码，都不能直接认定同一主体。
3. 需要比较授权信息时，同时查看「API对接」「授权状态」「授权方」，不要只看其中一个字段。

系统按租户、平台和来源键识别一条物流商资料。来源键优先使用上游物流商 ID，其次代码，最后才用名称兜底；同一键重复返回会归并处理。名称不是始终可靠的唯一键，代码或 ID 变化也可能形成不同来源身份，需要带上平台及来源证据核对。

当前表格不展示全部内部身份与来源追溯字段。遇到重名或代码变化，应保留可见名称、代码和平台，请有权限的负责人核对来源 ID/来源键；不能自行合并或删除记录。

03 查询定位：先选平台，再缩小结果

1. 在左上平台框选择平台。切换后重新读取该平台资料，其他筛选会保留，页码回到第一页；其他平台只展示已有只读资料，不提供领星物流商同步源。
2. 按需要选择「状态」中的启用/禁用、「API对接」中的是/否，以及「结算方式」中的现结/月结。默认标题表示该项不限。
3. 在「物流商」右侧搜索框输入关键词。查询实际匹配物流商名称、代码和授权方名称，前后空格会去掉；不支持按联系人或电话搜索，也无需再点查询按钮。
4. 查看右下「共…条」和页码，用数字或前后箭头翻页；页容量可选 20、50、100。改变页容量回到第一页，「前往页码」框当前只读，不能输入跳页。
5. 条件过多时点击「重置」：保留当前平台，清空其他条件，恢复每页 20 条和第一页。右上图标「刷新」只重新读取当前筛选结果。

当前页面默认只读取当前记录。没有“当前/全部/旧记录”切换，也没有物流类型或独立授权状态筛选控件。类型可在列表阅读，授权状态可在对应列核对；请求代码或后端存在相关参数，不表示页面已提供操作入口。筛选不保存为个人方案，重新进入页面按默认条件开始。

列表由服务端按当前标记、名称、代码排序，表头不提供用户排序。总条数是当前平台和筛选条件下的记录数，不是本次同步新增数。

04 阅读字段：分开看状态与授权

• 物流商、代码：来自上游资料；名称缺失时后台可能以代码或 ID 作为展示名称，不宜仅凭展示文字判定正式公司名称。
• 状态：对应来源启用标记。禁用不等于旧记录、不等于删除，也不表示历史单据失效。
• 类型：0 为 API物流，1 为自定义物流，2 为第三方仓物流，3 为头程物流，4 为平台物流。未知枚举会显示原数值，不要自行套用已有类型。
• 结算方式：1 为现结、2 为月结。它是来源主数据标签，不等于本次运输费用已付款。
• API对接：对应来源 isAuth；「授权状态」另取来源状态，0 为未授权、1 为已授权。两者独立展示，API 对接为“是”不能证明当前凭据可用或已完成接口连通验证。
• 授权方、联系人、联系电话、备注、创建人、创建时间：均来自上游提取字段。创建时间是来源记录的创建时间，不是 Tower 最近同步时间；表格会缩略部分文本和时间，不能把截断部分当成完整值。

普通文本、类型、结算方式及授权状态缺失时通常显示“-”。但当前表格把空的启用标记显示为「禁用」，空的 API 对接标记显示为「否」；这两列不能仅凭显示值区分明确为否和来源缺失。筛选「禁用」或 API「否」只匹配明确的 false，缺失项可能从结果中消失，这不代表资料已被修改。

联系电话和授权方用于核对资料，页面不展示密钥输入框，也没有联系方式导出功能。分享截图时应使用虚构资料或按组织要求处理敏感信息。

05 区分当前、旧记录与历史版本

「当前」是系统按来源同步集合维护的标记：一次有效刷新中返回的来源键会更新资料并标为当前；此前当前、这次未返回的键可被标为旧记录。旧记录仍保留在数据表中，不能直接推断为物流商停业、上游删除或禁用。

本页固定查询当前记录，因此旧记录不会出现在默认结果里；「重置」也不会切换到全部记录。查不到原来的一条资料时，先核对筛选与身份，再请负责人检查本次来源是否返回该键以及当前标记，不要反复同步或用同名记录替代。

同一个来源键再次出现会恢复当前并更新字段；本页保留的是该键的最近资料，不提供逐次字段变更历史或按日期还原版本。来源追溯信息不等于完整历史快照。

06 同步 Amazon：先看运行任务，再判断完成

1. 需要更新 Amazon 主数据时，先确认平台为 Amazon，并具备物流商查看、同步及提取器写入权限。仅查看权限也可以读取任务状态。
2. 进入页面后，系统自动查询运行中任务和最近任务；提示区优先展示运行中的任务，否则展示最近一条任务。本页没有“任务列表”或“查看最近任务”的独立按钮。
3. 没有运行中任务且按钮可用时，点击「同步 Amazon」。收到「同步任务已提交」只表示接受了请求，不表示列表已经更新完成。
4. 观察「排队中」「提取中」「写入中」，等待最终「已完成」或「失败」。发现运行中任务后页面约每 5 秒查询该任务；任务结束会重新读取当前列表。
5. 完成后核对提示区时间、raw/valid 数量，再在列表按代码或名称查目标资料。必要时使用「刷新」重读列表；它不会启动新的同步，也不会主动重新获取完整任务历史。

最近任务读取的是当前租户的 Amazon 同步任务，与列表中的平台筛选不是同一范围。切到其他平台后若仍看到“最近同步”，不能解释成该平台刚完成了同步。没有活动任务时页面不会持续轮询别人稍后新建的任务，需要重新进入页面再查询状态。

同步任务会遍历来源支持的启用、API 对接、现结/月结组合，按来源键去重，不只拉取当前页面筛选出的记录。系统有活动任务冲突防护；同一请求幂等键可复用原任务，但每次点击会生成新键，不能靠连续点击代替结果核查。

07 核对同步结果：完成不等于新增

• 已完成：提取结束并完成主数据刷新。raw 是本次读取的原始记录数，valid 是校验和去重后的有效条数，不是新增物流商数，也不是当前页面条数。
• 无新增：已有来源键仍可更新联系方式、标记等字段；即使有效条数与上次相同，也不能只凭数量判断没有变化。
• 部分记录异常：同步状态没有单独的「部分成功」枚举。无效身份或重复行可能被跳过，raw 与 valid 不同应核对任务指标与来源；已完成也不能单独证明上游所有资料均完整。
• 提取或写入失败：先记录任务状态、提示时间和筛选范围，交由负责人查具体任务错误与来源。当前提示区不展示完整错误详情，不提供失败行下载或一键重试入口。
• 来源突然为空：已有当前资料时，原始数和有效数均为 0 会触发保护，避免清空原资料；空源不等于全部已删除。没有既有资料时空结果可以正常结束。
• 有原始记录但有效数为 0：没有有效键时不执行旧记录标记，不能解释为已确认全量替换完成；应核对无效身份和提取保存异常。

任务超过后台允许的运行时限，可在任务查询时被标记失败。遇到超时、连接中断或提交结果不明，先重新进入页面查询活动/最近任务，再由负责人决定是否重提；不要在未知状态下连续点击。任务完成提示与列表查询各有自己的请求结果，列表加载错误时不能用上一次显示的数据充当本次验收结果。

08 权限与操作边界

没有物流商查看权限时，页面显示「当前账号没有物流商查看权限」。同步需要同时具备物流商查看、物流商同步及提取器写入权限，并选中 Amazon；提交中或已有运行任务也会禁用「同步 Amazon」。按钮不可点应先区分权限、平台和任务状态。

上游的「启用/禁用」「API对接」「授权状态」不是 Tower 账号权限，也不是「物流分析」中是否参与统计的配置。修改外部资料、配置物流单连接或更改分析范围，不能通过本页完成。

行选择框与全选框不可用；行尾「详情」没有打开内容的回调；「操作 → 只读结果」不可用；右上小帮助图标也处于禁用状态。页面没有新增、编辑、启停、删除、导出或同步计划配置表单。代码中存在同步源配置接口，不代表已经接入当前页面。

本次只演示查询、筛选、分页及预置任务状态；同步提交、资料修改、后台任务重试和同步配置均未演示。

09 与渠道、物流单交接核对

1. 记录平台、物流商名称与代码；名称重复、编码变化或授权方不一致时，补核对来源 ID，而不是直接选择第一个同名项。
2. 需要核对服务渠道，另到物流渠道查看该渠道的来源物流商 ID、名称与渠道身份。渠道数据有自己的同步链路，本页更新不等于渠道列表已同步。
3. 需要核对运输单据，另到物流单按单号与来源物流商代码查证。物流单使用自己的来源分类、代码和单据身份，不能把本页同名记录当作已建立唯一关联。
4. 需要解释统计差异，可参考物流分析的样本范围与来源说明。本页没有逐行直达渠道、物流单或分析明细的联动入口。

当前物流商同步链只更新物流商资料及其当前标记，没有沿此链自动重写既有物流单、渠道事实或历史分析结果。反过来也不能保证所有历史报表永远不变：相关页面若重新读取其他当前来源，仍须按各自规则核对。不要把主数据已更新写成单据已修复、运输已完成或历史结果已重算。

10 常见异常处理

• 暂无物流商数据：确认权限、平台和当前条件；点击重置后仍无结果，核对是否未同步、来源未返回、仅剩旧记录或该平台本来没有资料。空列表不是同步成功证明。
• 搜索联系人没有结果：关键词只匹配名称、代码、授权方，改用这三类字段定位。
• 看到禁用，筛选禁用后却消失：可能原字段为空，表格当前显示为禁用，而筛选只匹配明确 false。保留代码交负责人核对原始字段。
• 资料未更新：先查最近任务是否结束，再刷新列表并核对来源身份；“创建时间”不是最后同步时间。正在看其他平台时不要用 Amazon 任务解释资料。
• 详情按钮无反应：当前页面未实现详情打开逻辑，不是已成功进入详情但没有内容。可横向滚动查看已有列，不要期待隐藏编辑入口。
• 部分列看不全：表格是宽表，可横向滚动；姓名、备注及创建时间存在缩略展示。没有详情与导出入口时，不应据截断文本补写完整值。
• 任务失败或数量异常：记录状态、时间、raw/valid、平台和目标代码，让负责人核对任务错误及来源采集；不要把 raw−valid 直接称作“同步失败物流商数”。

11 常见问题