海外仓备货单

01 功能介绍：查备货单，核对来源事实

从 仓储物流 → TMS → 海外仓备货单 进入，查找领星来源的海外仓备货单，核对目的仓、商品数量和物流资料。页面读取本地已采集的来源列表，不是新建备货计划、修改订单或办理海外仓入库的工作台。

备货单号用于识别当前租户的一张来源单据；详情中的入库单号、客户参考号、物流单号和追踪号是不同资料，不能互相替代。备货单也不是采购单、调拨计划或 FBA 货件。采购与运输分工分别参阅 采购订单、调拨计划、发货单 和 物流协同。

单据存在、状态“已完成”或同步成功，都不证明目的仓已签收、已入库或可用库存已经增加。 判断这些结果，需要继续核对运输及仓库证据。

本文截图为真实业务前端连接本机只读内存 Mock，单号、日期、数量及物流资料均为预置样例。启动领星同步、保存定时配置、创建或修改单据均 未演示；演示没有连接真实数据库或外部服务。

02 使用前：确认权限、日期与数据范围

1. 准备备货单号，或明确 SKU、FNSKU、发货仓和收货仓。数据按当前租户隔离；本页没有业务视图或平台切换器。
2. 确认具有海外仓备货单读取权限。同步和定时配置另有权限，能看到单据并不表示能执行这些操作。
3. 首次打开默认 创建时间，范围从当天往前 365 天至当天。开始日和结束日都包含整天；切换日期类型后，原日期边界保留，但筛选依据变了。
4. 先确认查询正常返回，再判断有没有目标记录。错误提示不是正常空表；读取失败后可能还显示之前的数据，不能拿残留列表当作本次查询成功的结果。

日期类型 创建时间、更新时间、发货时间、收货时间 分别对应来源单据的这些时间，不是本地同步时间。某条记录缺少所选日期，即使它有创建日期，也可能被发货或收货日期范围排除。详情日期按来源返回内容展示，不提供明确的时区换算标识；跨系统核对时应先对齐来源时区。

这里展示当前本地事实，没有历史快照或版本选择器。日期筛选不等于“查看某天当时的订单状态”，也不能单凭日期范围判断本地数据是否新鲜。

03 查询定位：选字段、仓库、状态并翻页

1. 在搜索字段中选择 备货单号、SKU、FNSKU或全部字段，输入关键字。输入变化即发起查询；匹配为文本包含、不区分大小写，无需另找“搜索”按钮。
2. 全部字段 只在备货单号、SKU、FNSKU 三者中匹配，不包含入库单号、客户参考号、ASIN 或备注。已知客户参考号时，应先从来源确认备货单号。
3. 按需选择 发货仓库、收货仓库、运输方式、物流商、物流渠道。候选会随其他筛选联动，最多返回 200 项；候选中没有某项，不证明全部历史中都没有它。
4. 选择日期类型及开始、结束日期，再点击 全部、待审核、待配货、待发货、待收货、已完成、已驳回或已撤销 页签。页签数字按其他条件统计单据数，不是商品件数；切换页签后确认条件仍正确。
5. 使用底部 上一页、下一页 或页码，必要时调整每页条数或输入跳转页码并按 Enter。默认每页 20 单，可选 50、100；条件或条数变化会回到第一页。
6. 需要重新读取同一筛选范围时点击 刷新，会回到第一页；需要恢复初始条件时点击 重置，日期也会恢复到默认创建时间范围。

列表按来源创建时间从新到旧排列，不因切换日期类型改成对应时间排序，也没有列头排序入口。搜索 SKU 命中一单后，返回的是这张单的全部当前商品，不只显示命中的 SKU。不同商品行可有相同 SKU，不能据此认定重复导入或自行合并。

04 阅读列表：分清商品粒度、数量与缺失

一组对应一张备货单，组头展示单号、仓库、运输及状态。组内展示品名/SKU、FNSKU/店铺标识和数量；默认只展开前 5 个商品，点击 展开剩余 N 个商品 查看其余行，点击 收起商品 恢复折叠。

本页没有箱件换算控件，也没有单独的“实际发货数量”列。备货量或收货量显示 0 时，需结合来源明细判断是真零还是未返回；不要用另一个数量字段补填。可用量可能重复出现在同 SKU 的不同来源商品行，不能简单相加后拿去更新库存。

物流商和物流渠道来自本地渠道资料的匹配，来源“物流方案”只是原始描述。匹配不上时可能仅显示物流方案；这类单据可能无法被指定物流商或渠道筛选命中，应先清除两项筛选，用备货单号定位。名称出现也不代表渠道当前仍有效。

05 打开详情：核对身份、全部商品与物流资料

1. 点击组头 备货单号 或商品行 详情。两者都打开整单详情抽屉，不是只查看当前商品。
2. 在 单据信息 对照备货单号、入库单号、客户参考号、发货仓、收货仓、运输方式、物流商、渠道和来源物流方案，再核对创建、预计到货、发货、收货时间以及备注。
3. 在 商品明细 查看全部当前商品。先对 SKU、FNSKU、店铺 ID，再对数量；同名或同 SKU 不保证是同一商品行或同一店铺库存。
4. 在 物流信息 核对物流单号、追踪号及明细类型。来源列表可同时带回追踪信息、预估费用、实际费用和其他费；这不表示每一行都是一张独立运输单。
5. 查看完成点击 关闭详情，保留底层列表的筛选与页码。浏览器重新加载页面则恢复初始查询，不承诺保存此前筛选。

抽屉明确说明 来自本地列表快照；未额外请求领星详情接口。这里的“快照”指已采集列表资料，不是可选择的历史版本，也没有额外调用领星详情来补齐字段。

物流费、关税、其他费及计费单价分别附带各自币种；没有跨币种折算、统一费用合计或财务结算确认。追踪行、预估行、实际行不要直接累加。计费重与运输类型码按来源资料核对，页面没有完整运输轨迹或装箱清单。来源列表未返回物流明细 只说明本地没有这些资料，不证明未发运。

06 刷新与同步：先确认提交，再判断完成

刷新 只重新读取本地数据；同步领星 会创建采集任务。手动同步使用固定的最近 365 天来源更新时间窗口，与当前列表选了哪个仓、状态、单号或日期类型无关，不能通过缩小列表条件来缩小同步范围。

以下是真实操作路径与核对方式，启动同步 未演示：

1. 确认具备读取、海外仓备货单同步及提取器写入权限，再点击 同步领星。
2. 看到 同步任务已提交 及任务标识，仅说明任务已受理。页面继续查询任务，后台阶段为等待、提取、写入本地事实，最终成功或失败；当前页没有独立任务历史表或百分比进度条。
3. 看到 同步完成，列表已刷新 后，再按目标单号检查商品、数量及来源日期。成功不是“全部历史订单已同步”，也不是只新增了列表中这些单据。
4. 出现失败信息时保存任务标识和错误，交由数据维护人员核对。已有任务运行时再次启动可能返回冲突；不要连续点击制造重复任务。
5. 看到 同步仍在后台执行，请稍后刷新页面查看，表示前端有限轮询结束，不表示后台必然失败。刷新只读本地结果；重新进入页面也不会自动恢复之前任务的轮询。可将原任务标识交给维护人员查询。

上游提取报告部分失败时，本次任务按失败处理，不应把已提取部分当作已完整发布的业务事实。页面没有逐条失败重试入口或自动重试成功承诺；排除问题、确认没有进行中任务后，再由有权限人员决定重试。

07 定时同步：查看数据拉取计划

具有同步配置管理权限时，工具栏出现 定时同步。它维护当前租户的数据采集计划，不是业务备货计划、采购排程或物流发运计划。

1. 点击 定时同步，等待现有配置读取完成。对照 执行时间、时区、启用自动拉取，并查看已启用/已停用及下次执行时间。
2. 没有配置时，表单提供 03:40、Asia/Shanghai、未启用等初始值，并提示 尚未配置；保存后才会创建租户级排程。看到这些值不代表已经存在排程。
3. 仅查看时点击 取消 或关闭按钮，不产生保存。若加载失败，先处理错误；不要把出现的默认值当作已读取的现有配置。
4. 正式维护时需有效的 24 小时时分与 IANA 时区，点击 保存配置 后重新打开核对保存值和运行状态。该写入 未演示，本演示服务拒绝保存请求。

配置按每日执行，来源更新时间窗口固定为 365 天。保存配置不等于立即执行同步，启用也不证明任务已经跑过；调度进程需要正常运行并成功加载配置。下次执行显示 待调度器回写 时，不应自行推断一个已生效的运行时间。保存报错后应重新读取确认，避免假设所有配置都已回滚。

按页面提示到 数据质量 查看业务数据新鲜度，相关说明见 数据治理与排障。API 健康与最近一次业务数据成功更新是两件事。

08 权限与状态边界：可看不等于可同步

• 读取：需要海外仓备货单读取权限；无权限应联系管理员核对租户及授权，不能将页面缺内容解释成没有业务单据。
• 同步领星：除读取权限，还需本模块同步权限和提取器写入权限。权限不足按钮不可用；服务器仍会校验，按钮可见不是授权保证。
• 定时同步：读取基础上另需同步配置管理权限；该权限与手动同步权限不同。配置管理员不一定能手动同步。
• 单据状态：待审核、待配货、待发货、待收货、已完成、已驳回、已撤销来自来源状态映射。未知状态可能显示数字，可在“全部”查看；本页不能据此执行审核、撤销、发货或收货。
• 任务状态：描述数据采集和写入过程，与单据履约状态不同。任务成功不会将单据自动改成已完成。

当前页面提供查询、详情、同步与定时同步配置，没有订单创建、编辑、审批、删除、导入或导出入口。不能把领星平台具备的能力当作本页支持的功能；页面也不提供完整筛选结果下载。

09 结果核对：保留旧单不等于历史版本

同步按租户和备货单号更新本地单据；同一单号再次采集不会单纯追加成另一张单。商品使用来源商品、店铺及 SKU/FNSKU 等身份组合，并保留重复来源行的区别，不是按 SKU 唯一合并。

本轮未返回的旧单不会因而自动清空，成功但没有数据的批次也不等于删除原有单据。对某张已更新单据，读取商品和物流资料时，只取与该单最新同步批次一致的行，避免把旧明细混到当前结果中。这些保留规则不等于提供历史版本回看或保证旧单仍在上游有效。

处理差异时，记录租户、备货单号、来源日期、所用筛选、SKU/FNSKU/店铺 ID 及缺失字段：

1. 单据与数量问题先回来源单据核对，涉及采购再到 采购订单 查对应证据，不能只按同名 SKU 直接认定关联。
2. 运输与追踪问题交给物流人员，在 物流单 或对应承运资料核验单号与事件。
3. 入库和可用库存问题交给目的仓核对接收、上架与库存记录；使用 库存快照 时先对齐仓库、商品和数据日期。

本页未提供自动生成采购单、调整调拨计划或更新海外仓可用库存的操作。看到备货单或同步结果，并不表示这些下游动作已完成。

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

• 查不到备货单：核对租户与搜索字段；恢复“全部”状态，清除物流商/渠道筛选，检查日期类型。尤其不要拿收货日期查询尚无收货时间的单。必要时重置后按准确备货单号查，再请维护人员核对同步覆盖。
• 正常空表：显示“当前筛选条件下暂无海外仓备货单”时，表示当前本地查询没有命中，不等于外部平台没有此单。
• 读取报错：先处理权限、服务或请求错误；保留旧数据时不要继续以它确认新查询结果。恢复后点击“刷新”核验。
• 详情失败：确认当前单号，使用抽屉“重试”重新读取本地详情；持续不存在或失败时保留单号反馈，重试不会额外拉取领星详情。
• 数量显示 0 或“-”：按第四节逐字段核对；备货/收货的 0 可能由缺失兜底，可用量“-”是缺失。不要以其他字段或另一张单补值。
• 物流方案有文字，但物流商/渠道为空：可能是本地渠道未匹配；保留来源物流方案与单号交给维护人员，不自行拆分文本充当权威渠道。
• 同步后仍是旧单、数量未变：先确认任务最终状态和窗口，再核对来源更新日期与数据质量；旧单保留或空批次都可能使列表仍有数据。不能仅以列表非空或 API 正常证明新鲜。

11 常见问题

已发货为什么海外仓库存还没有增加？

备货、运输、收货和库存入账是不同环节。本页的来源状态与收货数量不能代替目的仓的入库和库存证据。

搜索某个 SKU，为什么出现其他 SKU？

筛选定位的是包含该商品的备货单，列表随后展示整单当前商品。核对时保留单号和商品身份，不要将其他行误判为搜索失效。

计划数量与实际发货不同怎么办？

先确认比较的是哪两个系统、单据和时间点。本页只有来源备货数量、可用量与收货数量，没有独立的实际发货数量列；不能拿收货数量代替实际发货量。

只筛选美国仓再点同步，会只同步美国仓吗？

不会。当前同步不接收页面筛选，按固定的最近 365 天来源更新时间窗口拉取。查询范围与同步范围应分别核对。

保存定时同步是不是提交了一张备货计划？

不是。保存的是租户的数据拉取配置，不创建备货单、不立即证明同步成功，也不表示库存已更新。本文只查看了配置，保存及执行未演示。

能按历史日期还原当时的状态，或导出全部筛选结果吗？

不能。日期过滤当前已采集记录，没有历史版本选择和导出入口。需要历史证据时，应由维护人员确认来源记录与可用留存资料。