TMS 物流、货件与异常管理

01 功能介绍与 TMS 功能地图

• 物流单：进入物流单，查询系统已收录的物流商订单与轨迹。「系统单」是该来源的运单标识；「客户单」、转单号和包裹号是不同字段，不能相互替代。
• 发货单、海外仓备货单、FBA 货件：分别进入发货单、海外仓备货单、FBA 货件说明。它们拥有各自身份和状态；物流单已有记录，不代表另一个页面必然有同名记录。
• 物流分析与异常：物流分析用于核对时效，物流异常用于跟进问题，均须按各自范围和权限使用。
• 物流商与物流渠道：分别核对物流商和物流渠道基础资料，不能用名称相似推断账号、服务或来源已关联。

正式列表按当前租户、平台和当前有效记录查询。「待创建」读的是独立草稿，并非正式物流单的一个运输状态，也不是在本页任意新增一张空白订单。

02 查询定位：先核对平台与单号类型

1. 确认具备物流单查看权限，打开「仓储物流 → TMS → 物流单」。在「平台」选择 Amazon 或 TikTok，再选「物流商」「下单主体」「承运商」。未指定物流商时可以跨物流商查询，但不能直接执行某家物流商同步。
2. 检查上方「全部物流单」「已创建」「运输中」「已签收」「已取消」页签。切换到凯琦会默认选「已创建」；切换到万方、华升、新飞凡、锐通、美通会默认选「运输中」；跨境通默认不限定状态。切换物流商还会清空下单主体和承运商。
3. 在「搜索字段」选「系统单」「客户单」「转单号」或「包裹号」，输入对应关键词。不同字段查询不同列；用 FBA 货件号查不到时，先核对它是否存于客户单字段，而不是直接断定订单丢失。
4. 按页浏览结果，必要时使用列表刷新按钮回到第一页并重读本地记录。本页没有正式物流单日期范围、店铺、站点或服务渠道筛选，也没有可点选的表头排序；不要照其他 TMS 页面的筛选方式操作。

正式列表的筛选、关键词和页码会保存在当前浏览器。重新打开页面会恢复这些条件；点击筛选区「重置」恢复默认 Amazon、全部物流商、全部状态及空关键词。切换平台不会自动清掉全部其他条件，空结果时应继续检查主体、承运商和关键词。

列表按来源更新时间降序，其后按最后同步时间降序和系统单号排序。状态页签计数保留平台、物流商、主体、承运商和搜索条件，但不受当前所选状态限制；底部总数对应当前完整筛选。「待创建」数量来自另一套草稿查询，不能和正式页签相加作为物流商订单总量。

03 核对身份、列表字段和来源时间

• 身份组合：先记录平台、物流商、下单主体，再核对系统单、客户单和转单号。不同来源的唯一键规则并不完全相同；凯琦、华升等来源包含账号维度，不能只凭相同单号跨主体认定同一单。页面内部订单 ID 才用于打开对应轨迹。
• 服务与承运商：服务列展示渠道名称或代码；承运商与转单号列用于核对后续运输标识。没有代码或尚未回传时可能显示横线，不代表已经取消。
• 箱数与重量：箱数不是商品件数。重量列展示客户重量与计费重量，材积重另列，单位为 kg；申报摘要中的数量也不是箱数。费用、箱件、申报字段可能因来源不同而缺失。
• 状态与时间：列表状态、运单明细中的来源状态、轨迹节点和实际交接凭据应分别核对。「最后同步」表示本地收录时间，不是揽收、发货或签收时间。
• 空值与零：横线表示没有可显示的值，不能补成零重量、零费用或零风险。地址「已校验」也不能证明货物已到达或 FBA 已接收。

列表没有自动跳转到所有关联发货单、海外仓单或 FBA 货件的统一入口。需要交叉核对时，带上客户单、FBA 货件号或 Reference ID，进入对应模块查询并确认身份；本页显示相似标识不等于系统已经建立可靠关联。

04 查看轨迹与明细

1. 在目标行「轨迹」列打开「查看轨迹」，确认抽屉顶部系统单与客户单与所选记录一致。
2. 在「轨迹与明细」中检查状态、承运商、转单号和包裹号；继续查看运单明细的揽收、发货、签收、预计到达等已返回字段。
3. 查看箱明细、轨迹节点、费用和附件。轨迹节点的发生时间、地点及说明用于解释运输进度；明细同步时间说明这份数据何时被获取。
4. 如果已有信息过旧，由有同步权限的人员核对来源后使用抽屉中的「刷新」。这个按钮会调用物流商轨迹/明细接口并更新本地记录，不是单纯刷新显示。

打开抽屉只读取本地已保存的轨迹；没有节点可能是尚未拉取、来源未返回或接口失败，不能直接等同于未发货。不同物流商返回的箱明细、费用和附件不保证齐全。刷新失败时保留单号、主体与错误信息，核对授权、来源接口和最后成功时间，不能把旧节点当作本次刷新成功。

「已签收」是系统当前展示的运输状态。交接时还应核对节点、签收时间及来源凭据；预计到达时间不是确定到货承诺，物流签收也不是 FBA 上架或库存可售的证明。

05 待创建：定位货件草稿并补齐资料

前提是上游调拨计划已有发布结果，并通过发布物流草稿的入口选择货件分组与 FBA 货件。后端按发布结果和货件身份防止重复生成；上游发布、草稿保存、物流商下单是不同步骤。本页草稿按货件组织，下层为箱和箱内申报商品，不能按表格视觉行数理解为订单票数。

1. 点击「待创建」。按状态、站点、店铺、业务渠道、供应商、品牌、物流商、下单账号、物流渠道或必填状态缩小范围；搜索字段可选 FBA货件号、Reference ID、货件分组、箱号、本地 SKU 等，再点击「查询」。
2. 核对货件、箱码、箱内总件数、长宽高（cm）、单箱毛重（kg）与申报商品。待创建的「重置筛选」只清下拉条件，关键词应另行清空并重新搜索；不要套用正式列表的持久化规则。
3. 点击货件分组右侧「编辑下单信息」打开「配置待创建物流单」，有草稿维护权限时，依次检查物流商、下单账号、物流渠道、拆单方式、收发地址、箱件和申报资料，以及该物流商专属参数。
4. 按页面必填提示补齐，点击「保存草稿」后检查保存反馈与最新记录。草稿修改只写本地草稿，不覆盖调拨计划或领星 FBA 源数据；保存不等于已向物流商提交。

当前新下单按 FBA 货件创建，箱码由箱级回执分别记录。「一箱一单」只作为历史配置提示，需调整，不应当作当前可正常提交的选项。切换物流商会联动重新选择账号、渠道及专属参数，不能保留旧来源配置直接下单。

可以编辑的行内单元格在 Enter 或失焦时保存，Esc 取消；数量要求正整数，相关数值要求大于零，必填值不能清空。批量维护先勾选本页箱，再点「批量调整箱信息」，确认选中箱和申报商品范围；它不修改整票下单配置，跨页会清除原页选择。提交带版本号，遇到“已被其他人更新”应刷新核对，不能反复覆盖。

06 提交物流商：核对排队、成功与未知结果

1. 前提是具备下单权限、草稿处于允许提交的状态、必填检查通过，且物流商下单执行器已启用。未保存修改应先保存，再按最新版本核对。
2. 在配置抽屉点击「提交物流商」。出现“已进入物流商下单队列”仅表示提交任务建立，不能马上认定物流商已创建订单。
3. 查看「下单进度」及各单元：等待发送、正在发送、正在查单、部分完成、创建成功、创建失败或需要人工核对。成功后继续核对外部订单标识和箱回执；回执还有待补查、补查中、已就绪、需人工核对等独立状态。
4. 失败时阅读具体原因。草稿版本过期、资料不全、已有任务或执行器未启用都应先解决原因；已有失败提交还需按界面限制维护并保存新版本，不能原样连点。

「已取消」等状态的存在不代表本页提供撤销物流商订单的动作。当前页面没有统一删除、取消或正式物流单导出按钮；不得用草稿保存或列表刷新替代这些操作。

07 分清列表刷新、来源同步与定时队列

• 列表刷新：重读本地正式列表，必要时回第一页；不访问物流商，也不创建订单。
• 物流单同步：选择具体物流商后使用对应拉取按钮，获取该来源订单或已知单信息，属于业务写入。正式列表筛选出的主体、状态或关键词，不会自动限制普通手动拉取的范围。
• 轨迹同步：目标行抽屉中的「刷新」按这一单访问对应物流商，更新轨迹与明细。
• 定时队列：顶部显示启用信息、批次和各物流商执行状态；「刷新定时拉取状态」只读状态。「触发定时拉取」会按后端已启用配置入队，不能按当前列表筛选猜测触发范围。

手动任务区有运行中、成功、失败状态和主体进度；页面运行中轮询任务，任务完成后重新读列表。定时队列另有排队、运行、成功、失败、跳过，批次可为部分失败；默认支持万方、凯琦、华升、新飞凡、锐通、美通的配置队列，不能据此认为跨境通也已接入定时队列。

先查看 raw（来源返回量）、valid（有效量）、upsert（写入/更新量）及错误提示，再抽查订单。统计不是新增订单数，也不是全部轨迹完整率。某家失败时，页面对有同步权限的人员显示该家「重试」；先修复授权或来源问题，再按状态执行，不能对运行中任务连续触发。系统还会阻止同租户、平台、物流商存在活动同步任务时重复启动。

“下一次 07:00 北京时间”也可能只是无时间数据时的页面占位。应结合是否启用、实际配置与任务记录判断，不能承诺每天必定同步成功。

08 按物流商核对同步范围与历史导入

• 万方、新飞凡：按钮为「全量拉取万方」「全量拉取新飞凡」，按来源分页收录；完整同步链路会把本次范围未返回的旧记录标为非当前。来源缺失后列表不再出现，不等于物理删除所有历史证据。
• 华升、锐通：按配置主体分页拉取，并对失败主体、页数上限等情况限制旧记录失效处理。不能仅看总提示就认定每个主体覆盖完整。
• 美通：前端仅对 Amazon 开放同步；按主体处理完整结果，完整性不足时不应把缺失记录理解为已取消。
• 凯琦：「拉取凯琦单号」使用后端配置的回溯窗口，默认 30 天，再补充单号详情；页面没有日期窗口输入。超出窗口的旧单不能指望每次按钮自动重拉全部历史。
• 跨境通：前端仅对 Amazon 开放「同步跨境通渠道/已知单」，不等于抓取所有历史订单。历史补录使用「导入历史单」提供已知单号。

历史导入前准备跨境通 orderNo / outOrderNo（订单号或客户单号），核对平台和下单主体。选定主体时只查该主体；不选时依次查询已配置账号。

1. 选择 Amazon、跨境通，点击「导入历史单」。可输入多个单号后点击「按输入单号拉取」，或选择 .xlsx、.csv、.txt 文件后点击「上传文件并拉取」。选中文件本身不会启动拉取。
2. 单号按空白、换行、逗号或分号切分并去重，单次最多 1000 个，单号最长 128 字符。XLSX 读取首个工作表；CSV/XLSX 识别 orderNo、outOrderNo、订单号、运单号、跨境通单号、客户单号等表头，无识别表头时读第一列。不要把完整订单资料表当成通用导入模板。
3. 格式、空输入或数量超限时先修复提示，不继续提交。这里不是先预览全量订单、再离线写入的两阶段导入；点击拉取会访问来源并写入本地。
4. 任务返回后核对基础单匹配/请求数、未匹配数、箱明细和无箱数据、轨迹成功/失败、转单号统计，再用单号查询。未匹配单号不阻断其他匹配结果；基础单成功也可能没有箱数据或轨迹。

历史导入仅为上述来源提供，本页没有所有物流商共用的文件导入或导出能力。

09 权限与状态边界

• 查看：需要物流单读取权限，才能加载正式列表、草稿、轨迹与任务状态；只能查看不代表可以发起同步。
• 同步：需要物流单同步权限，涵盖来源拉取、跨境通历史导入、轨迹刷新及定时队列动作；按钮还受平台、所选物流商、任务运行状态限制。
• 草稿维护：读取加草稿写权限用于配置、行内和批量修改。后端只允许待处理或失败草稿继续修改，并校验版本、箱与申报商品归属；已进入提交或创建状态不能随意修改。
• 物流商下单：读取加下单权限，另受资料、草稿版本、执行器和已有提交状态限制。具备同步权限不等于具备下单权限。

权限不足时页面会提示无查看权限，或隐藏、禁用对应动作；状态禁用与接口失败也不能一概归为权限问题。

10 物流商、渠道与配置核对

正式列表里的「服务」是该单的来源服务信息，待创建配置里的账号与渠道按物流商联动选择。没有候选时先确认选对物流商、账号及其已收录服务目录，交由管理员核对授权和来源配置，不要以自由文本冒充有效服务。

物流商、渠道基础资料在各自独立页面维护。健康检查、接口目录可用和业务同步成功属于不同层次，参阅数据治理与 API 管理。这里不承诺修改基础资料会重写已有订单或重新发送历史货件。

11 异常排查与执行交接

• 查不到：先确认对象入口，再查平台、主体、状态自动切换、关键词字段与浏览器记忆；对照来源最后成功任务。部分来源完整同步会将缺失记录标为非当前，不能继续沿用“同步只 upsert、旧记录永远不消失”的判断。
• 数量或状态不符：分开核对正式列表总量、状态页签、待创建草稿数、箱数和申报件数；检查更新时间，不把旧轨迹当作最新运输事实。
• 来源延迟或部分失败：记录物流商、下单主体、任务时间、错误与统计，再核对具体单号；成功状态不能替代箱明细和轨迹检查。
• 重复标识：先比较平台、来源、主体和客户单，不按展示名称直接合并或删除。来源键规则不同，发现疑似错误应交给维护人员核查。
• 下单结果未知：保留提交进度、稳定客户单号和外部标识，按允许的查单或人工核对路径处理；不删除重建、不重复创建。

12 执行交接与核对

交接至少提供对象类型、平台、物流商、主体、系统单、客户单/FBA 货件号、转单号、箱数、来源状态、轨迹时间和待处理异常。需要时进入物流分析或物流异常继续核对，不能用异常关闭代替签收。

调拨正式计划发布后仍需出库、物流与 FBA 执行，参阅调拨决策与调拨计划；箱级核验参阅QA 出货验箱。草稿发布、物流商订单创建、物流签收、仓库入库和 FBA 接收分别核对，不合并成一个“完成”。

13 常见问题