库存管理
接入 WMS、同步商品与映射仓库
开启库存管理，连接 WMS，统一库存商品，并把店铺仓库映射到真实仓库。
#库存管理先建立可信的数据关系
库存管理不是把几个库存数字放进同一张表。一个商家可能同时有多个店铺、多个 WMS 账号、平台官方仓和第三方海外仓；同一个 SKU 还可能在不同店铺重复出现。如果没有先建立统一商品和仓库关系，库存会被重复计算，AI 也无法判断某个店铺看到的数量对应哪个真实仓库。
TK Copilot 因此把接入过程分成四层：
- WMS 账号：告诉系统去哪里读取仓库和商品；
- 库存商品：用 Seller SKU 建立可跨仓库、跨店铺识别的统一商品档案；
- 统一仓库：保存从 WMS 或平台同步得到的真实仓库档案；
- 店铺仓库映射：把 TikTok Shop 中的销售仓、退货仓或履约仓连接到正确的统一仓库。
完成这四层后，系统才能把 WMS 实际库存、平台显示库存和店铺销售需求放在同一条分析链路中。
APP CAPTURE中文浅色界面的库存管理页，显示 WMS 账号、仓库和库存商品。
#第一步：为店铺开启库存管理
进入 店铺管理，打开目标店铺，在 概览 中开启 库存管理。开启后，店铺详情会出现 店铺仓库映射 标签。
这个开关决定该店铺是否参加库存同步、映射和 AI 库存分析。客服或达人业务并不强制要求开启库存管理；只有需要统一库存事实或后续库存操作的店铺才需要开启。
如果还没有连接店铺，先完成店铺管理中的授权。
#第二步：添加 WMS 账号
进入主导航中的 库存管理，点击 新增仓库管理系统账号。按照所选服务商填写：
- 服务商：选择页面中已经支持的 WMS 或 ERP；
- 标签：使用团队能识别的名称，例如“美国西仓”或“主易境通账号”；
- 接口地址：填写服务商提供的 API 地址，而不是普通后台登录页；
- 币种：当 WMS 商品没有返回货值币种时，作为同步商品的默认币种；
- 授权信息：不同服务商可能要求 API Token、Client ID / Secret，或者一次性 OMS 授权；
- 备注：记录账号所属主体、地区或负责人，方便以后排查。
授权字段会根据服务商变化。凭证保存后不会再次显示；编辑已有账号时，把凭证字段留空会保留原值，只有需要轮换凭证时才重新填写。
保存新账号时，系统会立即验证连接并同步仓库。若首次验证失败，新连接不会作为可用生产连接继续存在；若是编辑已有账号，失败的凭证不会替代原先可以工作的连接。
#第三步：确认 WMS 仓库已经同步
保存后展开 WMS 账号，检查：
- 同步到的仓库数量；
- 仓库名称、代码、地区和类型；
- 最近同步时间；
- 是否出现同步错误。
以后 WMS 新增仓库或仓库资料发生变化时，点击 同步仓库。这一步只负责把 WMS 中的仓库更新到 TK Copilot 的统一仓库档案，还没有决定哪个店铺使用哪个仓库。
#第四步：同步库存商品
新增 WMS 账号并同步仓库后，系统会进入 同步库存商品 流程。它会先做一次只读检查，将 WMS 商品分成：
- 已匹配：相同 Seller SKU 已经存在于统一库存商品中；
- 待同步：WMS 中存在，但系统内还没有相同 Seller SKU 的有效商品。
你可以选择两种同步方式：
- 同步新增库存商品：只创建待同步商品，保留已有统一商品的名称、规格和货值；
- 同步所有库存商品：WMS 返回的属性会覆盖相同 SKU 的已有商品。只有在确认 WMS 是这些商品资料的权威来源时才使用。
库存商品会保存名称、SKU、图片、条码、GTIN、HS 编码、原产国、重量、尺寸、申报货值、电池和危险品标记等资料。这些字段服务于仓库识别和履约，不等于当前可售数量。
同步完成后，在库存商品表中使用搜索、列设置和分页进行检查。也可以手动新增或编辑商品，但同一个业务商品必须保持稳定且一致的 Seller SKU，否则平台商品、WMS 商品和历史销量无法可靠关联。
#第五步：同步店铺仓库
回到 店铺管理，打开目标店铺的 店铺仓库映射。点击 同步店铺仓库，系统会从 TikTok Shop 读取该店铺实际存在的仓库行。
店铺仓库可能承担不同角色：
- 销售仓：店铺对外展示和扣减库存的仓库；
- 退货仓：买家退货进入的仓库；
- 履约仓：负责订单出库和发货的仓库。
先同步真实仓库行，再做映射，可以避免凭名称猜测或为不存在的平台仓库创建错误关系。
#第六步：完成仓库映射
页面把仓库分成两类：
- 官方仓：由平台确认并自动映射，例如平台官方履约仓。这些关系是只读的；
- 三方仓库：需要你从下拉列表中选择正确的 WMS 统一仓库。
映射回答的是：“TikTok Shop 里的这个仓库，现实中对应哪个 WMS 仓库？”同一个海外仓为多个店铺履约时，可以把这些店铺各自的平台仓库都映射到同一个统一仓库。这样 AI 能看到共享库存池，又不会把同一批实物库存按店铺重复相加。
映射前核对仓库代码、地区和用途，不要只看相似名称。如果选错，可以清除映射后重新选择。
#为什么商品同步和仓库映射缺一不可
商品同步解决“这是什么货”，仓库映射解决“这批货在哪里”。只完成其中一步，会产生不同的问题：
| 缺少的关系 | 结果 |
|---|---|
| 没有统一库存商品 | WMS 数量无法稳定关联到店铺 Seller SKU 和销售记录 |
| 没有仓库映射 | 系统只能看到平台显示数量，不能确认它对应哪个第三方仓库的实际库存 |
| 两者都完成 | AI 可以按 SKU、仓库、店铺和时间连接当前库存与历史需求 |
#上线检查
- 目标店铺已经授权，并开启库存管理；
- 每个 WMS 账号连接正常，最近同步没有错误；
- WMS 仓库数量和地区符合预期；
- 待同步商品已经处理，Seller SKU 没有重复或错拼；
- 每个三方店铺仓库都映射到正确的 WMS 仓库；
- 官方仓保持平台管理的只读映射；
- 再进入库存分析与 AI 运营验证数量和需求。