Shopify 库存 CSV 安全导入：当前量校验与失败行处理

Shopify 批量盘点后，要按地点更新库存，可以先导出库存 CSV，保留当前数量作为核对基线，再填写新的在手数量并导入。多地点库存应使用库存 CSV；商品 CSV 中的库存数量列只适用于单地点商店，两类文件不能混用。本文按 2026 年 10 月 11 日核验的官方帮助说明，讲解原生后台的安全导入流程。商品 CSV 与库存 CSV 的适用范围

从库存页导出，选准地点和数量状态

先确定这次要改哪些变体、哪个地点，以及盘点记录的时间。建议把原始导出文件单独保存，另建编辑副本；文件名写明地点和导出时间，避免把昨天的库存快照当成今天的底数。

1. 在后台进入 Products > Inventory，点击 Export。
2. 在 Export from 选择目标地点；确实需要跨地点处理时，才选 All locations。
3. 在 Inventory states shown 选择 All states，保留防止意外覆盖的数量校验。该格式把不同地点放在不同的行中。
4. 在导出范围中选择当前页、全部变体、已选变体或搜索匹配项，再选择导出格式，点击 Export inventory。

Available 格式则把地点名称放在列头，只导出可售数量，也没有上述防覆盖校验。本文后续步骤使用 All states，不把两种格式的数量列互换。导出后先检查目标商品和地点是否齐全；“当前页”不会自动等于全部变体。官方库存导出步骤与格式区别

用变体和地点定位，只填写本次要改的数量

用刚导出的表头和识别信息编辑，避免手工重建模板。库存 CSV 需要 Handle、Location 和识别变体的选项值；使用第二、第三选项的变体还需要对应的选项值。没有商品选项时，第一选项值是 Default Title。SKU 并非必填，也不会通过库存 CSV 修改变体 SKU。地点名称区分大小写，必须与后台完全一致。库存 CSV 的识别字段与地点规则

• 保留识别字段：核对商品、颜色或尺码、地点；只留下本次要更新的地点行，不把相邻地点顺手一起改掉。
• 保留当前数量：On hand (current) 是导出时的在手数量，作为导入校验基线，不能用目标数替换它。
• 填写目标数量：在 On hand (new) 写要设定的完整数量。例如要把 40 件设成 42 件，应填 42，不能填差额 2。
• 区分不改、零和未备货：新数量留空表示不改数量；填 0 表示目标数量为零；Not stocked 用于该地点从未备货的商品，不能拿它代替缺失数据或“不改”。数量须为整数，官方允许正数、负数和零，负数仍应有明确业务依据。

All states 文件中的 Incoming、Unavailable、Committed 和 Available 带有 not editable 标记，是核对信息。此次设置数量应编辑新在手数量列；需要处理损坏、质检或安全库存时，应按后台相应的库存调整流程操作。可编辑数量及留空规则；不可用库存的调整方法

保留当前量比较，理解它保护的范围

下面是假设示例：同一变体、同一地点，导出时在手数量为 40，复核后准备设为 42。它只说明数量校验的判断，不代表在真实商店做过导入测试。

同时保留当前量和新量时，导入会比较后台在手数量与文件基线；不一致的行会失败，并通过邮件提供详情。清空当前量、只保留新量会取消这项保护，不应作为日常重试办法。官方数量比较与失败行处理说明

这项比较针对在手数量，不能当作所有状态的锁。新订单可能只是让 Available 减少、Committed 增加，在手总量仍相同。因此，比较通过也不能替代对盘点时点、订单占用和目标数量来源的复核。官方订单占用示例与在手数量关系

保存 CSV，检查编码和其他空白列

编辑后保存为 UTF-8 编码的 CSV，不要把电子表格工作簿只改扩展名后上传。检查是否仍以逗号分隔，重新打开保存的文件，确认中文地点、选项值以及列的位置没有变化。使用 Google Sheets 时，可从 File > Download > Comma-separated values (.csv, current sheet) 下载当前工作表。每个库存 CSV 文件不能超过 15 MB；大文件应分批导入。官方 CSV 编码、保存和大小要求

“新数量留空不改数量”只适用于该数量列。若文件含包装长、宽、高和单位四列，四列皆空会清除已保存的包装尺寸；同一变体在不同地点或货位行中出现时，四列值还须一致。空白与已填值混用也属于不一致，会导致该变体的所有行不导入。仅改数量时，保留这些原有值并逐项检查，避免一次清空整个区域。库存 CSV 包装尺寸列的空白与一致性规则

先审阅导入摘要，再核对实际结果

1. 回到 Products > Inventory，点击 Import，用 Add file 选择编辑后的库存 CSV，再点击 Upload file。
2. 审阅导入摘要，把它与编辑副本的目标范围对照。若商品、地点或数量范围不符合预期，先停下来检查文件；确认后才点击 Start import。上传文件与开始导入是两个步骤。
3. 记录文件名、导出时间、导入时间及处理范围。留存失败行邮件，不能把“开始导入”当作每一行均已成功。
4. 导入后按相同地点和变体重新导出 All states，比较实际在手数量与目标值，同时检查没有计划改动的地点。若导入后又有履约或人工调整，先解释这段时间的变化，再判断差异。

前两步及失败行邮件来自官方库存导入流程；留档和再次导出是建议的结果复核方法。追查后续变化时，可进入商品、具体变体的 Inventory 区域，点击 View adjustment history，按日期和 Created by 核对是谁或哪个应用改了数量。历史中的调整量与调整后总量含义不同，不应只看其中一个数字。库存调整历史的入口与字段说明

按失败原因重做，纠正数量时使用新基线

文件或字段错误：先按上传提示、摘要或失败邮件定位行，检查 UTF-8、逗号分列、整数数量、必需选项值、地点拼写和包装尺寸一致性。对照刚导出的同一变体行修正识别信息，避免从商品 CSV 借一套列头过来。修正格式不会自动解决数量过期，两类问题要分别核对。

当前量比较失败：保留邮件中的失败行，重新导出这些变体和地点。依据最新盘点与导出后的实际变化确认新的目标数量，再用新文件中的当前量提交。不要为了通过校验，把旧文件当前量随手改成页面上的数字，也不要把已经成功的行和失败行不加区分地整批重传。官方过期基线保护与重新导入要求

如果发现已导入错误数量，把纠正作为一次新调整：重新导出最新基线，记录错误行、正确数量的依据和期间库存变化，核对后再提交。原始导出文件用于追溯，不宜原样回灌覆盖后来发生的变化。完成标志是目标变体、地点和实际数量已对齐，所有失败行已有处理结果，且未计划修改的字段也通过复核。