帮助文档商品运营运营Amazon Listing 管理

功能指南

Amazon Listing 管理

按店铺与国家定位 MSKU、ASIN 和本地 SKU，核对列表状态、Excel 预检差异与同步治理边界。

  • 适用：运营与产品人员
  • 约 14 分钟
进入 Amazon Listing
本文目录12 个章节

从「商品运营 → 运营 → Amazon Listing」查找店铺商品，核对 MSKU、ASIN 与本地 SKU，再按需要进行表格预检或检查同步治理。先确认店铺和国家，再判断是否为同一条记录。

本文截图来自真实前端连接本机内存 Mock，商品、店铺、人员、金额均为演示数据。已演示列表查询、固定工作簿预检和配置查看；确认导入、保存同步配置、手动同步及自动调度均未演示。演示环境不连接数据库或外部服务。

01 功能介绍

Amazon Listing 页面展示当前租户的 Amazon 店铺商品数据，供运营核对身份、状态、本地产品信息、价格、库存和销量字段。

  • 查询列表：组合国家、店铺、状态等条件，用关键词定位记录。
  • 表格导入：上传 Excel，先看新增、更新、未变与错误，再决定是否提交到系统的 Listing 数据。
  • 同步治理：查看当前同步任务，维护每日调度配置，或在具备权限时发起手动同步。

这里的导入是系统内数据维护，不是向 Amazon 发布商品或修改平台售价的入口。页面没有单条详情抽屉、行内编辑、手工关联弹窗、导出或历史版本查看入口。行首复选框也没有接入批量业务操作。

02 先分清店铺与商品标识

标识在本页如何理解与核对
店铺筛选项展示店铺名称及 SID 等辅助信息，列表优先显示店铺编码；无法取得编码时显示 SID。名称与编码不同不等于串店。
国家 / 站点列表「国家」展示来源的 marketplace；筛选中先选北美、欧洲等区域，再选国家。它是核对范围，不能替代店铺身份。
MSKU / Seller SKU「MSKU/FNSKU」第一行是卖家 SKU。系统按当前租户、Amazon 平台、店铺 SID 与 MSKU 区分 Listing；同名 MSKU 可以出现在不同店铺。
FNSKU同一单元格第二行的独立标识，不等于本地 SKU，也不在本页关键词匹配范围内。
ASINAmazon 商品标识；相同 ASIN 可对应不同店铺或 MSKU，仍要结合店铺、国家核对。
父 ASIN来源和导入合同包含的父级标识，不是本地产品 ID。本页未单列展示，也没有父子树或按父 ASIN 搜索入口。
本地 SKU「品名/SKU」中的本地商品编码，与 MSKU 分开保存。若有本地品名则上方显示品名、下方显示 SKU；只有 SKU 时直接显示 SKU。

使用前准备目标店铺、国家及至少一个可搜索标识，并确认拥有读取权限。需要核对本地产品主数据时，另开本地产品管理，按本地 SKU 查询；不要把 Listing 中出现 SKU 文本当作已经验证了完整产品关系。

03 查询与定位记录

  1. 进入「商品运营 → 运营 → Amazon Listing」。打开「店铺」，可用「搜索店铺」缩小候选范围，勾选后点「确定」；只查一家时用该项旁的「仅筛选此项」。
  2. 打开「国家」，选择区域，再勾选国家并点「确定」。国家选项来自启用的国家主数据，出现某国并不代表该国一定有 Listing。
  3. 在「关键词筛选」输入 MSKU、ASIN、本地 SKU 或商品标题的一部分。页面随输入查询，不需要另点搜索按钮；关键词不匹配父 ASIN、FNSKU、本地品名或负责人。
  4. 按需组合「Listing状态」「配送方式」「标签」「品牌」。同一条件可多选，不同条件共同限制结果；选择后检查下方条件标签，避免遗漏旧条件。
  5. 查看底部总数和目标行的店铺、国家、MSKU。若结果为空，先点「重置」清除所有筛选及关键词，再逐项加回；也可点击「清除筛选 店铺」等条件标签仅移除该项。

品牌、配送方式、标签的候选项从当前页已返回的记录收集，不是全库字典。目标品牌未出现在下拉框时，先重置并用 MSKU 或 ASIN 查询，不要据此判断商品不存在。「品牌」对应的是亚马逊品牌，尽管下拉搜索框写着「搜索本地品牌」。

Amazon Listing 实际列表：同名 MSKU 分属美国和德国店，列表包含在售、下架与已删除演示记录
图 1：实际前端的 Mock 列表。同名 DEMO-BAG-BLACK 在两家店分别占一行。查看原图

04 阅读列表与本地产品信息

列表包含图片、MSKU/FNSKU、状态、ASIN、标题、店铺、国家、配送方式、亚马逊品牌、变体属性、品名/SKU、价格、List Price、FBA可售、昨日销量、7|14|30天销量、大类排名和负责人。

  • 横向滚动可查看右侧字段，图片和 MSKU 区域固定。拖动表头右边缘可调整列宽，宽度保存在当前浏览器；没有列隐藏配置或点击表头排序功能。
  • 当前固定 50 条/页，可点击页码、「上一页」「下一页」。每页条数不可更改，当前页码框只读；修改条件后回到第 1 页。
  • 默认顺序是更新时间倒序，再按店铺 SID、MSKU 排序。页面没有日期筛选或自定义排序控件。
  • 「价格」与「List Price」是两个来源字段；金额按各行币种显示，不做跨币种换算。「7|14|30天销量」按该顺序展示三个来源数值，不是累计总销量。
  • 字段缺失通常显示 -，不能当作零；图片缺失显示占位图。变体属性最多展示前两项，不能据此断定来源只有两项属性。
  • 「品名/SKU」是 Listing 携带的本地信息，单元格没有详情链接。缺少关联信息时，先记录店铺＋MSKU＋ASIN，再去本地产品核对 SKU；本页不支持手工选择产品完成关联。

列表数据来自同步或系统内导入，并非实时向 Amazon 查询。库存、销量和在售状态分别表达不同事实：FBA可售为 0 不等于已下架，在售也不保证当前可售库存大于 0。

05 按一次核对任务操作

以核对两家店的同名 MSKU 为例：

  1. 点「重置」，搜索 DEMO-BAG-BLACK。演示列表应返回美国店、德国店各一行。
  2. 选择「店铺 → 演示美国店 → 确定」，结果应只剩美国店记录。核对国家为美国、MSKU 与 ASIN 符合目标。
  3. 横向滚动到「品名/SKU」，记录本地 SKU，再对照本地产品资料；不要用显示相同的商品标题代替 SKU 核对。
  4. 点击工具栏「刷新」重新读取当前条件下的列表。若在后续页，刷新会先回第 1 页；它不会启动来源同步。
  5. 若字段仍旧，打开「同步治理」检查任务与配置；若要修正系统内数据，先按下节准备工作簿并预检。
按 DEMO-BAG-BLACK 关键词和演示美国店筛选，只剩一条 Listing，并横向查看本地品名与 SKU
图 2：关键词与店铺共同定位，横向核对本地 SKU。演示结果应为 1 条。查看原图

06 准备表格并预检

前提：拥有 Listing 写入权限，准备 .xlsx 文件。本页没有模板下载或导出按钮；导入读取第一个工作表，首行是表头，后续行是数据。文件大小受部署的上传上限约束，超限时按错误提示缩小文件。

至少填好「店铺」「MSKU」。店铺可通过已启用店铺的名称、编码或来源店铺别名解析，但必须唯一定位一个 SID；同名店铺歧义、未匹配或缺少 SID 都会失败。文件中的「国家」不能消除这种歧义，也不会作为匹配键。

常用表头包括「ASIN」「父ASIN」「FNSKU」「SKU」「品名」「状态」「价格」「售价(总价)」「币种」「FBA可售」「昨日销量」「7日销量」「14日销量」「30日销量」「商品标签」和「负责人1（业绩归属人）」。其中「SKU」写入本地 SKU 文本，「品名」写入 Listing 标题，「售价(总价)」对应列表 List Price，不能与「价格」混用。它们不会自动建立或修复本地产品主数据。

  1. 点击「表格导入」，打开「Excel 导入」。
  2. 在「导入文件」选择工作簿，点击「预检导入」。只有选择文件后才能预检。
  3. 核对总计、匹配、新增、更新、未变、错误六项计数，再逐行看行号、店铺、MSKU 和「变更字段 / 错误」。匹配数包含可新增行，不等于现有记录命中数。
  4. 「新增」表示店铺已识别但该店铺下没有对应 MSKU；「更新」只写入非空且有变化的支持字段；「未变」表示没有可写入变化。空单元格不会清空旧值，不能用留空删除 ASIN 或 SKU。
  5. 遇到 seller_sku required 补齐 MSKU；遇到 store not matched 核对店铺名称、编码、启用状态、SID 和重名情况。状态仅接受「在售」「停售」「已删除」，不要填写列表显示的「下架」；不支持的状态可能使整次预检报错。
  6. 修改文件后重新「预检导入」，确认看到的是新结果。为避免误用旧预检，换文件或预检失败后可先关闭弹窗再重新打开。
真实 Excel 导入预检界面：更新、未变和错误各一行，错误为店铺未匹配；没有执行确认导入
图 3：配套固定演示工作簿的只读预检。结果由真实解析函数配合内存记录生成；未提交任何变更。查看原图

07 确认导入与结果边界

以下提交操作未演示，Mock 会拒绝写入。 在实际业务环境，应先修正全部错误行，并逐项确认店铺、MSKU 和变更字段后再点击「确认导入」。

当前只要预检存在新增或更新，确认按钮就可能可用，错误行不一定会让按钮禁用。服务会对草稿中可处理的行执行动作并统计错误，并不承诺“一行出错就全部不导入”。不要在仍有错误时依赖按钮自动拦截。

提交成功后页面提示「导入完成：新增…，更新…，未变…，错误…」，关闭弹窗并刷新列表；在后续页时返回第 1 页。随后用同样的店铺＋MSKU 重新查询，核对实际变更的字段。若提示请求失败，保留错误信息，先查现状再决定是否重新预检。

全部未变且没有错误时，「确认导入」禁用并提示未发现可写入变更；重复预检已导入文件出现这一结果可能是正常情况。后端虽记录导入版本事件，当前页面没有版本列表、差异比较或回滚操作。导入后的字段也可能被后续来源同步更新，不能将导入视作永久覆盖规则。

08 检查同步与调度配置

先点击「同步治理」，查看「当前同步状态」和「下次自动调度」。无活动任务时显示「暂无任务」，这不代表从未同步，也不是最近一次成功时间。列表没有展示逐行同步时间，不能把店铺 SID 的更新时间当作 Listing 数据新鲜度证明。

有任务时，状态可能是排队中、提取中、写入中、已完成、失败；前三种表示仍在进行。任务创建成功只代表进入执行流程，页面会轮询状态，不承诺固定几秒完成。

以下维护与执行操作未演示：

  1. 需要调整调度时，填写「同步优先级」（正整数，数值越小越先执行）、「每日执行时间」（24 小时制 HH:mm）和「调度时区」（如 Asia/Shanghai）。按需要勾选「启用自动调度」。
  2. 点击「保存同步配置」，看到「同步配置已更新」后重新打开核对。当前弹窗虽提示关闭自动调度后仍可手动同步，但后端会拒绝已禁用的同步来源，可能返回 amazon listing sync source is disabled；不要依赖该提示绕过来源启用限制。配置保存不等于立即完成数据同步。
  3. 具备 Listing 写入与提取器写入权限时，点击「手动同步（amazon_listing）」。该操作使用当前租户的同步来源范围，不是只同步当前筛选出来的一行或一家店。
  4. 已有活动任务时等待现有任务，不连续点击重复创建。遇到缺少来源 SID、活动任务冲突或提取失败，记录任务标识和异常信息，交给有权限的管理员检查店铺来源配置与任务执行状态。
  5. 收到「Amazon Listing 同步完成」后，重新按店铺＋MSKU 查询目标字段；收到失败提示时，不以旧列表仍有数据推断本次同步成功。
同步治理实际弹窗：暂无任务、自动调度关闭，仅查看优先级、时间与时区，没有执行同步
图 4：只读查看同步配置。演示自动调度关闭，未启动提取任务。查看原图

09 权限与状态边界

操作所需权限与边界
查询 Listing、读取店铺/国家选项、查看同步治理erp_amazon_listing:read。缺少权限可能被路由拦截，页面自身也会提示没有治理读取权限。
打开表格导入、预检和确认导入erp_amazon_listing:write；没有单独的导入权限开关。进入本页仍需读取权限。
修改并保存同步配置erp_amazon_listing:write；只读账号可查看弹窗，但不能编辑或保存配置。
手动同步同时具有 erp_amazon_listing:write 和 extractors:write。仅有 Listing 写入权限仍不能启动同步。

Listing 状态与同步任务状态不同：

  • isDelete=1 优先显示「已删除」；否则 status=1 显示「在售」，status=0 显示「下架」。筛选中的「停售」对应未删除的 status=0。
  • 未知或缺少状态显示 -，不要归为在售或停售。来源的「已删除」记录仍可能在列表中供核对，不意味着本页提供删除按钮。
  • 没有平台上架、下架、审批、发布或手动改关联的操作；更改导入表中的状态只影响本系统记录，不代表已经操作 Amazon 平台。

10 操作后核对

每次查询或维护后，按同一顺序核对：

  1. 范围：当前租户、店铺、国家及筛选标签是否正确；相同 MSKU 的其他店铺记录是否被误当作目标。
  2. 身份：MSKU、ASIN、本地 SKU 是否各自一致；本地 SKU 缺失时不自行推断对应产品。
  3. 字段：区分价格与 List Price、空值与零、状态与库存、Listing 标题与本地品名。
  4. 结果：导入看最终计数并重新查询，同步看任务终态并复查目标字段；不要仅以 HTTP 200、按钮点击或任务创建提示作为业务成功依据。

11 常见异常处理

现象排查顺序
搜不到商品或显示空列表先看页面顶部「异常信息」；请求失败也可能留下空列表。再重置条件，按 MSKU/ASIN 搜索，核对店铺与国家。不要用父 ASIN 或 FNSKU 代替关键词支持字段。
找不到目标店铺 / 选店后无记录检查当前租户、店铺是否启用及来源 SID 是否齐全。候选店铺由独立选项接口提供，不能按当前列表是否有记录反推店铺不存在。
同一个 MSKU 出现两行对比店铺 SID 与国家；跨店同名是允许的。导入也要逐行填对店铺，不要按 MSKU 单独去重。
本地品名或 SKU 显示 -先确认来源或导入是否提供该字段，再在本地产品页核对主数据；Listing 页面不提供一键自动关联。
预检报错或确认按钮不可点检查文件类型、首张表、表头、MSKU、店铺唯一匹配及状态值。全部未变时无需再次提交。
刷新后仍是旧数据刷新只读系统数据；检查同步治理任务及调度，必要时由管理员查看来源和执行异常。没有固定同步时延承诺。
异常信息与部分数据同时存在列表、选项、配置分别请求，某个接口失败时其他数据可能仍显示；先处理对应异常，不能将部分加载视作完整成功。

12 常见问题

为什么同一 ASIN 有多条 Listing？

不同店铺或 MSKU 可以形成不同记录。先看店铺、国家和 MSKU；父 ASIN 也不是本页记录的唯一标识。

能点击 MSKU 或 ASIN 打开详情吗？

当前这些单元格展示文本，没有单条详情或平台商品跳转链接。需要更多本地资料时另开本地产品管理按本地 SKU 查找。

表格里把某个字段留空，为什么没有删掉旧内容？

导入只更新非空且变化的支持字段。留空保留旧值，本页没有用空单元格清空字段的流程。

预检有错误，为什么仍能点击确认？

按钮按是否存在新增或更新判断；错误行不一定阻止提交。先修正文件并重新预检，避免只写入有效行后遗漏错误记录。

在演示环境可以验收什么？

可以核对真实页面查询、筛选、字段、固定样例预检和配置弹窗。配套工作簿模拟两家店同名 MSKU，以及一行店铺未匹配；Mock 仅识别这份固定文件。其他文件解析、真实数据权限隔离、业务写入、外部提取和调度执行均未演示，不能据此认定生产链路已验收。