FBA 货件

01 功能介绍：核对货件，不代替库存确认

FBA 货件用于查看从领星采集的 Amazon 货件、货件产品、跟踪编号和装箱资料。进入「仓储物流 → TMS → FBA 货件」，先定位货件，再核对数量、来源状态和更新时间，最后带着单号到责任页面处理差异。

一行代表当前租户、Amazon 平台下的一张货件，以「货件单号」识别。店铺、国家、物流中心编码和 Reference ID 是核对身份的重要辅助信息，不能仅凭名称或跟踪号认定同一货件。

货件不是物流单，也不是发货单。本页不创建货件、不上传箱唛、不修改物流资料；来源显示已发货、接收或关闭，也不表示所有商品已经可售。物流运输证据到物流单核对，发货业务资料到发货单核对，实际可用库存还需另查库存页面。

截图为示例数据，仅用于说明操作。

02 使用前确认：准备身份和查询时间

• 准备货件单号、所属店铺、国家及目的物流中心；如只有 SKU、跟踪编号或发货单号，先确定搜索字段再输入。
• 确认账号具有 FBA 货件查看权限。列表固定读取 Amazon 平台当前记录，不提供平台切换或历史批次选择。
• 默认日期为打开页面时的过去 365 天至当天，筛选依据是来源「最后更新时间」，不是发货日期、接收日期或创建日期。找旧货件时应先扩大时间范围。
• 「国家」来自目的地址国家，「物流中心编码」是目的中心标识，「店铺」是货件所属店铺。它们不能替代本地仓库、区域库存或商品归属范围。

列表按来源最后更新时间倒序排列；来源时间缺失时，后端排序使用记录更新时间作为后备，但日期筛选仍检查来源更新时间。若扩大日期后仍无结果，可清空日期再查并核对来源是否缺字段。

03 查询定位：组合筛选并确认结果范围

1. 进入页面，按需要选择「国家」「店铺」「货件状态」「物流中心」，支持多选。不同条件同时生效；国家和状态按值匹配，店铺和物流中心按包含关系匹配，结果中仍须核对完整名称与编码。
2. 选择搜索字段后输入关键词。可选「物流中心编码」「Reference ID」「货件单号」「货件名称」「STA任务编号」「STA任务名称」「发货单号」「SKU」「跟踪编号」。SKU 搜索会匹配货件明细的 SKU、MSKU 和 FNSKU；发货单号从产品关联单号中匹配，不是在物流单表中搜索。
3. 设置「开始日期」「结束日期」，结束日包含当天。条件变化会回到第一页；查看筛选标签确认当前范围，移除标签可清除该组条件。
4. 用底部分页查看后续记录，页容量可选 20、50、100；「前往页码」输入后按回车或移出输入框。先看结果总条数，再核对当前页。

筛选候选来自满足其他条件的现有货件数据，每类最多返回 120 个值，并非平台全部状态或全部店铺字典。没有候选不代表外部平台不存在该对象。当前页面不保存筛选到下次访问；「重置」恢复默认日期、清空其他条件并回到第一页。

「更多筛选」目前仅展示面板，内部条件未接入查询；「导出」也未接入当前页面的导出动作。请使用上述实际有效的筛选和分页，不把点击这两个入口当作已完成筛选或导出。

04 读取数量：先看货件，再查产品明细

申报、发货和接收数量按产品件数读取，不是箱数。列表中「已发货」取本地已发数量，「签收量」取来源的接收数量；“签收”这一列名不等于承运商签收凭证，也不能直接当作上架数量。

• 申报量：货件产品的申报数量合计。
• 已发货：产品本地已发数量合计；全都未知时显示「-」，部分缺失时只加总已知值。
• 签收量：产品来源接收数量合计。
• 申收差异：申报量减签收量；申发差异：申报量减已发货；收发差异：已发货减签收量。本地已发未知时，后两项显示「-」。

例如图中 FBA-DEMO-001 的申报为 150、本地已发为 144、接收为 130，对应申收差异 20、申发差异 6、收发差异 14。差异正数表示前一个数更大，负数表示后一个数更大；数值本身不判定丢失、赔付或多收原因。

1. 定位目标货件，横向滚动核对「申报量」「已发货」「签收量」及三项差异，避免只看某一列。
2. 将鼠标移到「发货产品」查看明细卡片及产品级差异；卡片最多展示前 6 个产品，缩略图最多 3 个，不代表完整产品数。卡片较宽时可横向滚动。
3. 点击「货件单号」打开「FBA货件详情」，逐项核对全部产品的「申报 / 本地已发 / 签收」。保留有差异的商品标识和数量，回到来源核实。

底部「总计」只统计当前页，不是所有筛选结果。申报、接收在后端空合计会返回 0，因此合计零不一定证明每项都有明确零值；明细「-」表示缺失，明细 0 才是该字段返回零。产品缩略图旁的数量可能在本地已发缺失时回退为申报量，不能替代「已发货」列。

05 查看详情：核对箱号、发货单和跟踪编号

1. 点击货件单号，在「基础信息」核对店铺、国家、物流中心编码、Reference ID、运输方式、STA任务和创建人。
2. 在「物流跟踪」核对跟踪编号、箱号及「发货单」。发货单号来自货件产品关联单号，去重后展示；这里是文字资料，不是自动跳转或已完成关联核验的证明。
3. 在「装箱信息」逐箱核对箱号、箱内总数和箱内产品数量；标题中的箱数是已加载的箱明细行数。箱号优先显示来源箱号，其次箱名、本地箱号；不要只凭箱名识别物流主体。
4. 如需运输节点，带着跟踪编号和货件身份前往物流单；核对同一运输业务后再查看轨迹，不能按相似名称直接认定关联。

详情沿用当前列表已加载的数据。刷新后需关闭详情再重新打开，核对新结果。「箱明细同步」显示「已同步」「待补全」或「最近同步失败（保留上次成功数据）」；失败时仍显示箱号不代表本次成功，空装箱信息也不一定是实际零箱。

产品图片、名称可由同店铺的当前 Amazon Listing 补充，缺图或名称缺失不等于货件产品不存在，也不要把这些展示资料当作冻结的历史快照。

06 展开状态：分清来源时间与历史模板

点击「货件状态」标签可展开状态历史，再次点击、点击外部或按 Esc 关闭。当前状态直接展示来源值，筛选中实际有哪些状态取决于现有数据，不能把帮助中的示例当作固定枚举。

展开区固定列出 WORKING、SHIPPED、RECEIVING、CLOSED，时间分别读取来源对应时间字段。当前状态不在这四行中时会插入当前状态行，但没有对应事件时间便显示「-」。所以这不是完整状态变更日志：固定行出现不表示已经历该节点，空时间也不能用最近同步时间补成实际发生时间。

当前状态为 RECEIVING 时仍需核对接收数量；CLOSED 也不能证明已足量接收。IN_TRANSIT 等其他来源值仅反映来源报告，不能推导完整收货流程、丢失认定或自动业务审批。旁边的「进行中」由 STA任务名称或 STA 标记触发，与来源状态是两种信息，不能当作独立运输进度。

「创建时间」与「最后更新时间」分别来自来源创建、修改时间，不是本地页面刷新时间。状态节点缺时间、来源长时间未更新或数量不同步时，记录货件、店铺及所见时间，交由负责来源数据的人员核对。

07 刷新与同步：提交任务后再核对结果

1. 只需重新读取 Tower 已有货件时点击「刷新」；它保留当前条件读取列表，不向领星执行一次货件同步。
2. 确需更新来源且已获得权限时，点击「同步」。同步针对 Amazon 货件来源，不按当前列表关键词、店铺或日期条件缩小范围。
3. 出现「同步任务已提交」及任务编号后，记下编号；此时仅代表提交成功。页面会重新读取列表，但不会持续展示该任务最终状态。等待任务处理后再点击「刷新」，核对目标货件的来源更新时间、数量和箱明细。
4. 若提示失败或已有任务进行中，保留错误内容与任务编号，先请有权限的人员核对任务。不要连续点击同步，把每次提交都当作最终完成。

后端任务经历 pending、extracting、syncing 后才可能 success 或 failed；当前页不提供任务阶段面板。采集货件头与补充箱/跟踪详情并不保证同一时刻完成，详情补全存在单次范围限制，头信息更新也不能证明所有箱资料已经更新。

当前记录采用更新写入，来源某次未返回某张货件，不代表本地立即删除它。箱/跟踪详情失败时保留之前成功资料；因此应核对具体目标货件，而不是只看一次提交提示或列表条数。

08 权限与操作边界

查看页面需要 FBA 货件查看权限；「同步」还要求 FBA 货件同步权限和采集器写权限同时具备。按钮不可用时先确认权限和是否正在提交，不要换账号绕过授权。同步配置管理是另一项权限，本页不提供配置编辑入口。

页面支持筛选、分页、打开详情、查看状态历史、拖动列标题边界调整列宽及横向滚动。列宽调整仅保留在当前页面状态，不代表个人布局已永久保存。列表按更新时间排序，不提供点击列标题切换排序。

本页没有实际接入货件创建、编辑、删除、箱唛上传或导出操作。不能把外部 Amazon/领星的能力当作 Tower 此页已实现，也不能从货件接收量推断库存预留、可售或上架状态。

09 核对结果并交接异常

• 身份：同时记录货件单号、店铺、国家、目的中心、Reference ID；跟踪号和发货单号另列，不混作货件唯一标识。
• 数量：记录申报、本地已发、接收及差异，注明当前页合计还是单张货件，缺失项保留「-」。箱数与件数分别核对。
• 时效：记录来源最后更新时间、状态节点已有时间与箱明细同步状态；不要补写未知时间。
• 交接：发货数量及关联资料交发货单责任人核对，运输节点到物流单查证，有明确差异证据后再到物流异常跟进。

完成上述核对只说明货件资料已检查，不表示仓库已完成接收、入库或上架。库存是否可售应以相应库存来源与更新时间继续确认。

10 常见异常处理

• 查不到货件：检查搜索字段与单号，清除状态/店铺等条件，扩大或清空更新时间；再核对当前租户、来源是否已采集。空列表不证明外部货件不存在。
• 筛选候选不全：先移除其他条件；候选受结果范围和数量上限影响，可改用货件单号搜索。
• 签收量为 0：打开产品明细，区别明确 0、空字段和空合计；结合来源时间检查延迟。不要直接写成丢失或已申请赔付。
• 本地已发或差异为「-」：源本地已发缺失，不是零；部分产品缺失时合计只含已知值，不能当作完整发货数量。
• 箱明细失败但仍有数据：当前保留上次成功资料，记录失败状态并核对来源；不要因为箱号存在就宣布同步成功。
• 关闭仍有差异：分别核对来源状态与接收量；关闭不自动抹平差异，也不代表库存已可售。
• 列表请求失败：保留错误提示，先确认访问权限与服务状态；刷新读取失败不能通过反复发起同步解决。

11 常见问题