本地产品查询、详情与 Listing 对应关系

01 功能介绍

本地产品页面用于查询产品主数据、查看产品详情，并在具备权限时维护已有记录及同步配置。页面当前使用 Amazon 产品范围。

• 产品列表：查看品名/SKU、型号、分类、品牌、采购交期等信息。
• 产品详情：按本地产品 ID 读取基础、采购、供应商报价、物流等资料。
• 同步配置：分别查看 local_product（本地产品）和 local_product_detail（本地产品详情）两条同步链路。

列表有数据不代表详情来源也已更新；本地产品资料与 Amazon 店铺 Listing 也不是同一张清单。需要了解其他 Product 页面时，参阅产品管理总览。

02 先分清商品标识

• 本地产品 ID（localSkuId）：打开详情使用的产品标识，不要与 SKU 文本混淆。
• 本地 SKU：本地产品的商品标识；列表中的 SKU 链接可以打开产品详情。
• 识别码（skuIdentifier）：独立的识别字段，不应直接当作 MSKU 或 ASIN。
• MSKU / Seller SKU：店铺商品标识，核对时必须同时确认店铺 SID 和站点。
• ASIN：Amazon 商品标识，对比时仍需核对市场与店铺范围。
• 父 ASIN：用于理解父子商品关系或相应汇总，不等于某一条可直接对应的店铺商品明细。

同一本地产品可能关联多条 Listing，同名 MSKU 也不能跨店铺直接当作同一条记录。查错商品会影响后续销量、库存、策略与利润的解释。

03 查询与定位产品

1. 进入「商品运营 → Product → 本地产品」，在搜索框输入 SKU、识别码或品名关键词。页面随输入查询，修改关键词后回到第 1 页。虽然搜索字段显示「SKU」，当前接口还会匹配品名、识别码、品牌名和分类名。
2. 用「开启状态」选择「启用」或「停用」，需要恢复完整范围时选择默认项或点击「重置」。这里控制的是记录启用状态，不是 Amazon Listing 的在售状态。
3. 必要时选择「普通产品」或「组合产品」。这两项只过滤当前页已返回的记录，不会重新计算全库总数；找不到目标时先回到「全部」，再用关键词定位。
4. 用「上一页」「下一页」翻页。当前每页固定 20 条；「每页条数」不可更改，「跳转页码」只读，不能通过页码数字直接跳页。
5. 修改条件后核对目标 SKU 和品名，再打开详情。点击「刷新」只重新读取数据，不会发起来源同步。

04 阅读列表与调整字段

横向滚动可查看型号、单位、分类、品牌、采购交期、采购成本、供应商报价、组合情况、默认头程费用等列。右侧操作区保留「详情」「操作」入口。

1. 点击表格右上角「字段设置」。
2. 勾选或取消可操作字段，观察对应列显示或隐藏；「图片」「品名/SKU」保留显示。
3. 将鼠标移到列头调整柄并拖动，可调整列宽。

字段设置中的灰色字段尚不支持切换；「全选」「取消」标题按钮没有接入批量切换动作。列显示和列宽是当前页面状态，不应承诺刷新后永久保留。列表勾选框当前没有连接批量业务操作，也不能当作批量导出入口。

供应商报价列只显示首条报价中的供应商名称；完整报价请打开详情。列表「创建时间」当前取记录更新时间，缺失时取来源同步时间，不能据此认定产品最初创建时间。

金额列也不能单独作为缺失值判断依据：当前展示可能把缺失的金额转换为零值。遇到疑似异常的成本或头程费，请对照详情和来源资料，不要直接断定真实成本为零。

05 查看产品详情

1. 点击 SKU 链接，或行右侧的「详情」。
2. 核对左侧商品名和 SKU，确认没有打开相似商品。
3. 切换左侧栏目，按当前任务核对资料。

• 基本信息：品名、SKU、识别码、分类、品牌等基础资料。
• 采购信息：采购交期、采购成本、材质及包装/箱规等；缺失字段不等于零。
• 供应商报价：来源返回的供应商、币制、税率、报价和交期；采购记录当前未接入展示。
• 关联辅料：来源中的辅料及组合产品关系；空表只表示此处未返回记录。
• 物流报关清关：物流、报关、清关资料；部分字段是尚未接入的占位项。
• 图片信息：来源返回的图片；没有图片时显示空状态。
• 质检信息：已返回的质检方式、模板和标准项；不是质检任务执行结果。
• 自定义资料：已返回的自定义字段。
• 操作日志：当前详情接口未返回操作日志，不展示伪数据。

详情「复制」用于复制品名、SKU 和识别码，不是复制完整资料或新建产品；「关闭」返回列表。供应商报价里的「刷新配对」目前没有接入动作，不能用它完成配对或同步。

详情没有关联 Listing 列表。要查看店铺商品对应关系，请记录本地 SKU，再按下文进入 Amazon Listing。详情加载失败时先查看错误并「重试」；不要为解决查看错误直接编辑或删除产品。

06 维护已有本地产品

本节业务写入未演示。 操作前先确认目标 SKU、字段来源、负责人员及写入权限。

1. 在目标行打开「操作 → 编辑」，或从详情点击「编辑」。
2. 核对本地产品 ID、SKU、识别码、品名、分类 ID/名称、品牌 ID/名称、来源状态和开启状态等已有表单字段。不要把一个商品改成另一个商品来修正显示差异。
3. 检查必填及数值格式，再点击「保存产品」。没有写入权限时不可保存。
4. 保存成功后重新查询同一 SKU、打开详情核对结果；列表与详情来源不同，不能把一次主数据保存当作详情来源也已刷新。

行菜单还提供「启用/停用」和「删除」。启停改变本地记录开启状态；删除会出现确认提示，按当前实现执行软删除，不能当作普通排查手段。

当前列表工具栏没有独立的「新增产品」、产品文件导入或导出入口，不应套用其他页面的操作步骤。下文的 XLSX 补丁导入属于 Amazon Listing 页面，不是本地产品导入。

07 到 Amazon Listing 核对对应关系

从「商品运营 → 运营 → Amazon Listing」进入，也可打开Amazon Listing 工作台或阅读Amazon Listing 管理说明。

1. 先按店铺和市场缩小范围。
2. 使用 Seller SKU、ASIN、本地 SKU 或品名定位商品。
3. 核对店铺 SID、商品标识、本地 SKU 和当前状态。
4. 跨页面比较时，保持同一店铺、站点及商品粒度；不能只凭商品名称认定是同一条记录。

“在售”“停售”“已删除”是来源业务状态。“已删除”状态的记录仍可通过对应状态条件查询，不等同于本地数据被彻底删除。商品找不到时应检查状态筛选，不能只查询在售商品。此处也不要混用本地产品的「开启状态」。

08 Listing 导入的预览与提交

本轮未演示。 Listing 补丁导入接受 XLSX，读取第一张工作表，按“预览 → 提交”处理。它不是本地产品、销售目标或备货策略的导入模板。

1. 在 Amazon Listing 页面按要求准备店铺和商品识别字段，以及本次确需维护的内容。
2. 上传后检查预览中的匹配、插入、更新、不变和错误统计。
3. 修正识别错误，确认目标店铺与商品无误后再提交。
4. 提交成功后重新查询目标 Listing，核对字段与版本事件。

版本事件用于审计，不是可以切换或恢复的 Listing 历史快照。

09 同步配置与商品缺失排查

本地产品：先区分列表来源与详情来源。

1. 点击「同步配置」，查看「同步源」。local_product 对应本地产品，local_product_detail 对应详情资料。
2. 检查同步优先级、执行时间、时区和「启用该来源」，以及调度任务、下一次执行、活动任务信息。
3. 如获准修改配置，先核对来源再「保存配置」；如获准执行同步，确认权限后「立即同步」。保存配置和执行同步本轮均未演示。
4. 用「刷新状态」检查结果，再刷新列表及重新打开详情。配置存在不等于任务已成功执行；刷新页面也不等于触发同步。

Amazon Listing：检查店铺与来源配对。

手工同步需要相应写入与提取器权限。开始前确认已配置启用的 Amazon 店铺及来源 SID；当前领星同步只获取已配对的 Listing。

1. 提交后检查任务状态；待处理、提取中和同步中均不是完成。
2. 等待成功或失败结果，再读取列表并核对目标商品。
3. 商品仍缺失时，检查店铺是否启用、SID 是否正确、来源是否已配对，以及查询条件。
4. 需要更新本地产品资料时，确认操作的是本地产品来源，而不是只同步 Listing。

本轮同步未返回某条旧 Listing，不会自动把它删除。默认同步配置也不能证明实际已经按时成功运行，应以任务结果为准。上述同步执行均未演示。

10 权限与状态边界

• 读取：本地产品页面需要 erp_local_product:read。
• 维护：编辑、启停、删除及本页保存同步配置需要 erp_local_product:write。详情中能看到「编辑」不代表可以保存，仍以写入权限为准。
• 发起同步：同时具备本地产品写入权限与 extractors:write；权限不足或操作处理中按钮可能不可用。
• 状态区别：本地记录的启用/停用、来源业务状态、同步任务状态是三件不同的事，不能互相替代。
• 范围区别：普通/组合筛选仅作用于当前页；按 SPU 不产生聚合；分页总数不能当作筛选后组合产品总数。
• 验证边界：本篇截图仅验证只读展示，不验证写入、同步调度、导入提交或真实店铺数据。

11 常见问题