产品映射：渠道 SKU ↔ 内部产品

把每个渠道 SKU 配到内部产品，拉回来的订单才能自动建 OMS 单。含 Client、Channel Product ID、Channel Inventory Item ID 字段说明。

产品映射是共享主数据：把外部渠道 SKU（平台上叫的名字）和内部产品（仓库实际发的货）配成一对。OMS、WMS、TMS 读同一张表，配一次、各流程通用。

什么时候需要配#

• 拉回来的订单里有没配对的 SKU：建不了 OMS 单，会卡在待处理页。
• 新渠道上线：第一次拉单前先把它的商品 SKU 配好，订单进来直接跑通。
• 产品换代/改名：改一处映射就行，不用每个 Flow 都去改。

字段说明#

• External SKU（必填）：渠道上报的 SKU，如 "AMZ-B08XYZ"。匹配不区分大小写。
• External Title：渠道侧商品名，只给您看，不参与匹配。
• Channel：这条映射属于哪个渠道代码（如 shopify）。"通用"表示所有渠道都用。
• Client：这条映射归属哪个客户。空=全部客户共用——自有品牌商品用这个；同一个渠道 SKU 在不同客户那里是不同产品时（3PL 场景），选具体客户。
• Channel Product ID：渠道侧非 SKU 的产品标识——如 Shopify 的 product_id、Amazon 的内部 listing ID。渠道 API 用产品 ID 而不是 SKU 对话时用（产品同步、库存推送）。
• Channel Inventory Item ID：渠道侧库存项标识，库存推送成功后渠道会缓存（如 Shopify 的 inventory_item_id）。填上后下次推送少一次查询往返。留空也行，第一次推送成功后系统会自动回填。
• Product ID：这个渠道 SKU 对到的内部产品。
• Active：启用开关。关掉即停用，不删除（历史记录照常可查）。

匹配优先级#

1. 先看有没有绑到具体连接的映射（最精确）。
2. 再看渠道代码的通用映射（该渠道所有连接共用）。
3. Client 范围叠加在上面：某客户的订单优先用配给该客户的映射，再用全部客户共用的。

配置步骤#

1. 打开 Master Data → 产品映射。
2. 点"新建"。选渠道（只对某个连接有效就再选连接），External SKU 照渠道上报的一字不差填。
3. 选内部产品。只有"同一渠道 SKU 在不同客户那里是不同产品"时才填 Client。
4. 可选填 Channel Product ID（从渠道后台 / API 抄），产品同步和库存推送就能直接定位商品。
5. 保存后拉一单测试——SKU 应该直接配上，不再进待处理。

常见问题#

• SKU 显示未映射：去产品映射的待处理页逐个配对——多半是 External SKU 拼写跟渠道对不上。
• 一个渠道 SKU 在不同客户那里是不同产品：给每个客户各建一条（填 Client），不要共用一条。
• 某个 SKU 库存推送慢：看 Channel Inventory Item ID 有没有填——空着的话每次推送都要多查一次。