发货单

01 功能介绍：查发货单，核对运输证据

从 仓储物流 → TMS → 发货单 进入，按来源单号查找领星发货记录，再查看商品、装箱及物流资料。本页读取本地已采集的 AMAZON 发货单，不是新建入库单、执行收货或实时查询领星的操作台。

发货单号标识来源发货单；商品行中的货件单号用于关联 FBA 货件；头程物流单号和追踪号描述运输资料。它们不是同一种单号，一张发货单可以包含多个商品和货件，不能拿 SKU 或货件号代替发货单身份。整体分工参阅 物流协同，运输执行与 FBA 结果分别参阅 物流单说明 和 FBA 货件。

发货单存在、来源状态“已发货”或同步任务成功，都不证明货物已签收、完成入库或库存已更新。 这些结论必须有对应运输和仓库证据。

本文截图使用真实业务前端连接本机只读内存 Mock；所有单号、日期、金额及数量都是预置演示样例。领星同步、创建、修改、删除、发货及导入操作均 未演示。

02 使用前：确认权限、来源与时间

1. 准备发货单号，或明确要查的货件单号、SKU，以及所属租户、国家、店铺。读取按租户和 AMAZON 平台隔离；本页没有业务视图或平台切换器。
2. 确认具有发货单读取权限。看得到页面不表示可以同步；同步另需发货单同步权限和提取器写入权限。
3. 核对日期范围。首次打开默认从当天往前 365 天至当天；界面时间类型虽写着 创建时间，实际请求过滤的是 来源更新时间，不是创建日、计划发货日或到货日。开始日包含当日零点，结束日包含整天。
4. 先确认列表能正常返回，再判断有没有目标单据。错误提示与正常空表不同；某次读取失败后可能仍留着之前的列表，不能把残留数据当作新查询结果。

来源创建时间、来源更新时间、实际发货时间、本地采集时间和写入读模型时间各有用途。当前列表没有完整展示所有采集时间，也没有历史版本选择；不要把查询日期当作数据截止日或快照版本。本轮上游未返回的旧单或旧商品行不会因此自动从本地删除，完整性需结合来源核对。

03 查询定位：选字段、筛状态、翻页

1. 在搜索字段选择 发货单号、货件单号或 SKU，输入关键字。输入变化会重新查询，不需要额外点击“搜索”。匹配为文本包含、不区分大小写；SKU 搜索查的是 SKU 字段，不是同时搜索 MSKU、FNSKU 和 ASIN。
2. 按需要选择 国家、店铺、发货仓库、运输方式、物流商、物流渠道，并调整日期。国家和店铺依据商品明细匹配，其他四项依据单头匹配。候选随其他条件联动，最多 120 项；候选缺失不能直接认定该值在全部历史中不存在。
3. 点击 全部、待配货、待发货、已发货、已作废 缩小来源状态范围。页签数字保留其他筛选、只移除状态限制后统计发货单头，不是商品数、箱数或件数。
4. 核对发货单号、仓库、店铺和商品身份。按 SKU 或国家找到一张单后，仍展示该单的全部商品行，不能把所有子行都当作命中商品。每单先显示 5 行；有更多时点击 展开剩余 N 个商品，完成后可 收起商品。
5. 用底部页码或左右箭头翻页。每页按 20 张发货单分页，一张单的商品不另占单头名额；当前“20条/页”和“前往”控件不能修改页大小或输入跳页。变更筛选回到第 1 页。
6. 找不到时点击 重置 恢复默认范围，再逐个加入条件。刷新只重读本地列表，并回到第 1 页，不会拉取领星数据。

默认按来源更新时间倒序，同时间按发货单号倒序；没有列头排序操作。“更多筛选”“常用筛选”目前未接入实际行为，不作为查询步骤使用。

04 阅读列表：数量、粒度与展示限制

单头展示发货仓库、物流中心编码、运输方式、物流商、渠道、发货量及来源状态。商品行展示货件号、MSKU/FNSKU、ASIN、父 ASIN、品名/SKU、店铺、国家及数量；标识缺失不等于这些商品已建立或失去关联。

当前列表的数字缺失也可能显示 0，因此零值需要回查来源字段；不能只凭页面区分真实零与默认零。本页没有收货数量列，不应把发货量解释为仓库已收到的数量。Mock 第三张单数量缺失、第四张单记录为零，列表都可能显示零，正用于展示这一限制。

05 打开详情：商品、箱件与返回列表

1. 在目标单头右侧点击 详情；宽表需要横向滚动到操作列。先核对详情标题的发货单号，避免把商品货件号当成详情身份。
2. 默认 发货商品 页签可核对品名/SKU、MSKU/FNSKU、店铺、国家、发货计划号、货件号及包装重量。单品净/毛重单位为 g，总净/毛重为 kg，包装规格为 cm。该表没有逐行展示全部数量字段，不要把表尾汇总摆放的位置当作一个新的指标列。
3. 切到 装箱信息，核对箱规、箱数、单箱数量、发货量（已装箱）、重量和体积。一个箱规行可包含多款 SKU，商品身份取箱内首款展示；不是每行只有一种商品。箱数乘单箱数量得到装箱件数，两侧括号内外当前都显示同一个装箱数量，不是“计划量与实发量”的对比。
4. 切到 关联辅料 核对已有辅料与费用；切到 关联单据，查看从本单商品按货件号分组得到的条目及数量。缺货件号会落入短横线分组；这不是采购单、物流单等所有关联关系的完整清单，分组数量也不等于唯一 SKU 数。
5. 完成后点击左上角 返回列表。本次页面会保留原筛选与页码；重新加载浏览器会恢复默认条件。详情是页内切换，当前没有可复制到另一浏览器直接打开指定单据的独立详情地址。

装箱体积使用 m³，重量使用 kg；来源尺寸、箱数或材积参数缺失时，部分计算结果也会回落为零，不能当作“没有箱体积”。装箱表总件数取详情单头数量，箱数、重量、体积则按箱规行汇总；差异应回查来源，不能自行补齐。

详情只读本地已采集内容，与列表不是同一次原子快照。若出现 inbound shipment detail has not been synchronized，说明本地详情尚未采集；点 重试只重读详情，不会在线访问领星补齐。先返回列表保留单号，再交由数据维护人员核对详情采集链路。

06 核对物流资料：日期、费用与记录

在详情点击 物流信息，先看头程物流单号，再核对物流商、渠道、费用明细和“单号追踪”。追踪列表中的状态、更新时间和位置来自已采集轨迹；空表只说明当前详情没有轨迹，不能推断物流未下单或已经结束。

请注意当前展示边界：

• “轨迹时间”区的 物流状态“待下单” 和多项时间短横线是固定展示，不能覆盖真实追踪结果。单头“物流状态详情”和“VAT税号”目前复用备注，“工厂直发”复用发货方；这些位置不用于确认真实运输状态、税号或是否工厂直发。
• 计划发货日期优先取来源预计发货日期，缺失会回退发货时间；预计到货取来源预计到货或 ETA。计划和预计都不是实际签收时间；部分标有“人/时间”的格子只展示时间，并未完整提供人员信息。
• 单头预计费用取头程预估总费用；单头实际费用来自物流明细的运输费加其他费，而物流页签“实际”行取头程实际费用资料。来源不同，不能要求二者必然相等。
• 页面金额固定加 ¥，没有在该读取链路做币种换算。缺失费用也可能显示 ¥0.00；不能据此认定已折算人民币、无费用或已经结算。核账应带原币种、来源费用项和采集时间交财务确认。
• 操作记录当前可由来源创建时间、创建人及单号生成一条“保存”，不是完整审计历史，也不是你刚刚在 Tower 保存成功的凭证。

库存短缺提示按详情发货数量与可用数量计算；可用数量缺失也可能按零计算。它反映已采集样本，不能据此认定实时库存不足，更不能把提示当作自动分配库存的结果。

07 刷新与领星同步：确认提交和完成的区别

领星同步未演示。 如确需补采，先由有权限的维护人员确认租户和任务范围；普通查询无需触发同步。

1. 列表工具栏的 更新分摊信息（辅助名称“同步近一年”）实际调用领星发货单同步，不是只计算所选行费用。
2. 操作只提交 AMAZON 平台参数；日期、状态、关键词、国家等当前筛选不会缩小同步范围。后端按近一年来源更新时间提取，不能用页面日期框指定任意历史补采范围。
3. 返回“同步任务已提交：任务标识”表示任务被接受或复用了活动任务；随后页面刷新本地列表，不代表所有订单已同步完成。页面没有任务进度列表，也不会持续轮询最终状态。
4. 保存任务标识和提交时间，交维护人员核查 pending、extracting、syncing、success 或 failed 状态，以及完成时间、错误和处理统计。确认 success 后再刷新列表核对目标单号与数据；详情仍可能需要独立采集。
5. 提交失败时保留错误内容；403 先核对授权，其他错误由维护人员按任务日志排查。不要连续点击来替代任务状态核查，不用已有旧行证明本次成功。

列表同步采用更新或插入，不会把本轮未出现的旧记录全部删除。因此成功也不等于“本地与外部完整镜像一致”；需要核实遗漏、作废或删除时，应对照具体单号和来源更新时间。

08 权限与状态边界：可看不等于可操作

读取使用发货单读取权限；同步同时要求发货单同步权限和提取器写入权限，前端还要求可读取。缺少读取权限可能被系统导航拦截或显示“当前账号没有发货单查看权限”。同步按钮不可用不妨碍已有授权的只读查询。

待配货、待发货、已发货、已作废分别对应来源状态 -1、0、1、3。它们描述来源发货单阶段，不是运输状态；同步状态则描述采集任务阶段。三类状态不能互换，也不应根据一项推断另一项。

当前实际可用的操作是筛选、展开商品、分页、刷新、打开/返回详情和详情页签，以及有权限的同步提交。列表的分配库存、发货、下单至三方仓、上传总费用、导入头程物流单、打印、生成资料、更多、下载和设置等控件未接入处理；详情的编辑、删除、分配库存、更多操作、同步至货件、导出装箱清单及模板文字同样未接入。

因此本页没有已实现的创建、编辑、审批或导出流程，不能把可见按钮或外部领星能力当作 Tower 当前功能，也不能承诺下载完整筛选结果。本次 Mock 只授予读取权限，所有业务写请求拒绝；以上未接入功能不进行成功演示。

09 交接核验：带身份和证据回责任页面

1. 留下租户、发货单号、查询范围、来源状态、目标商品 SKU、店铺、国家，以及关联货件号或追踪号。记录错误和核查时间，不仅截取一个状态标签。
2. 运输异常到 TMS → 物流单 或 物流异常 按已有物流身份核对。这里展示关联信息，不会因为查看详情而创建物流单或处理异常。
3. FBA 接收问题到 TMS → FBA 货件核对同一货件与接收证据；库存变化到 库存操作总览 所述责任页面核对日期和版本。不要用发货量代替收货量。
4. 单据与明细不一致时，分别确认列表采集和详情采集是否完成；金额对不上先确认费用来源和币种。不能拿更新较新的一个来源填补另一个来源。

这些是人工交接路径，不是本页自动跳转、自动同步库存或自动完成运输的承诺。分析和留存证据也不等于业务动作完成。

10 常见异常处理：范围、缺失与失败

• 查不到单据：先确认发货单号与货件号没选反，SKU 没误用 MSKU；清空状态及其他筛选，核对来源更新时间范围，再翻页。仍无结果时核查租户、来源采集和本地记录，不能直接认定未发货。
• 选了一个 SKU 却出现其他商品：筛选命中的是单头，返回该单全部子行，这是当前查询规则；只对照目标商品，不把全单数量当作该 SKU 数量。
• 详情打不开：本地详情未同步与网络/服务失败不同。保留发货单号和错误；“重试”不负责补采，列表同步成功也不保证详情已有。
• 空表、字段短横线或零值：空表可能是范围无记录，短横线可能是缺字段或占位；列表零值和费用零值还可能是默认值。逐项核对来源，不用零填补缺失。
• 读取失败或服务未准备好：保留异常信息。返回 503 与正常空列表不同；失败后留存的旧结果不是新查询成功，关闭提示也不会修复数据。
• 来源状态与物流追踪冲突：区分发货单状态、固定标签与真实轨迹字段，再比较采集时点；不要依据固定“待下单”推翻已存在的轨迹。
• 按钮点了无反应：先看本篇权限与功能边界。未接入按钮没有完成凭证，不重复点击或假定权限开通后即可使用。

11 常见问题