供应商接入

飞书货源自动同步映射

把已确认的四张飞书货源表映射到平台对象，明确哪些字段自动生成商品、规格、库存、价格和 Shopify 映射。

中文
报价模板
真实货源表已确认

飞书货源自动同步映射

商品源表已确认；Shopify 写入前还缺 app 权限、location/publication、订单回流和异常通知配置。

返回字段清单查看映射 API
映射字段12

ADkabWtH...FId3nbd / Brand new + Asis + Asis+ + CPO

必填映射8

缺失时 hard stop

目标对象5

Product / Variant / Inventory / Price / Shopify

当前状态真实货源表已确认

等待真实商品源表

hard stops

映射前必须确认

01
缺少真实商品源表

稳定 SKU 无法派生时隔离该记录。

自动隔离
02
必填映射边界

库存、USD价格或 HKD价格不是合法数字时隔离该记录。

自动隔离
03
必填映射边界

Shopify 写入失败超过重试上限时隔离该 SKU，并写同步日志。

自动隔离
mapping rows

字段到平台对象的映射

template_sku栏目 + 机型 + Version + 容量 + 卡槽规格 + 状态 + 颜色/货号 / 栏目/机型/Version/容量/卡槽规格/状态/颜色/货号 / 自动派生

ProductVariant.sku / ProductVariant / 按稳定键规则自动 slug 化，每行对应一个 Shopify variant 映射。

必填
template_product_title品牌 + 机型 + 栏目 / 品牌/机型/栏目 / 已确认

Product.title / Product / 品牌 + 机型 + 栏目生成商品标题。

必填
template_variant_titleVersion + 容量 + 卡槽规格 + 状态 + 颜色/货号 / Version/容量/卡槽规格/状态/颜色/货号 / 已确认

ProductVariant.title / ProductVariant / Version + 容量 + 卡槽规格 + 状态 + 颜色/货号生成规格标题。

必填
template_category派生：手机 / derived_category / 自动派生

Product.category / Product / 当前 Base 固定映射为 3C 手机行业包。

必填
template_base_priceUSD价格 / USD价格 / 已确认

ProductVariant.basePrice / ProductVariant / 读取 USD价格；数值异常或波动超过阈值时隔离该 SKU。

必填
template_currency派生：USD / derived_currency / 自动派生

ProductVariant.currency / ProductVariant / 由 USD价格字段派生为 USD；HKD价格保留采购参考。

必填
template_moq派生：默认 MOQ / derived_moq / 自动派生

ProductVariant.moq / ProductVariant / 当前表无 MOQ，自动同步先默认 1；后续有 MOQ 字段再覆盖。

必填
template_quantity_available库存 / 库存 / 已确认

InventorySnapshot.quantityAvailable / InventorySnapshot / 读取库存；非负整数才进入 Shopify inventorySetQuantities。

必填
template_warehouse派生：香港 / derived_warehouse / 自动派生

InventorySnapshot.warehouse / InventorySnapshot / 当前按供应商货源口径默认香港，后续可接真实仓库字段。

建议
template_target_country派生：global / derived_target_country / 自动派生

PriceRule.targetCountry / PriceRule / 当前使用 global 通用价格；国家价格规则后续叠加。

建议
template_shopify_handle派生：Shopify handle / derived_shopify_handle / 自动派生

ShopifyProductMapping.shopifyHandle / ShopifyProductMapping / 按 Shopify Product 拆分规则自动 slug 化，不写回原货源表。

可选
template_review_note派生：sync_exception_reason / derived_exception_reason / 自动派生

PriceRule.reviewNote / PriceRule / 由自动同步异常生成，例如错价、缺字段、库存异常或 API 失败。

可选
sample row

样例行预览

SKUtemplate_sku / sku

ProductVariant.sku

brand-new-iphone-17e-a3634-b-a-256gb-1sim-esim-not-activate-rv4
商品名称template_product_title / product_title

Product.title

Apple iPhone 17e Brand new
规格名称template_variant_title / variant_title

ProductVariant.title

A3634-B/A / 256GB / 1 Sim+E Sim / Not Activate / Black-黑色-RV4
品类template_category / category

Product.category

手机
基础价格template_base_price / base_price

ProductVariant.basePrice

632
币种template_currency / currency

ProductVariant.currency

USD
起订量template_moq / moq

ProductVariant.moq

1
可售库存template_quantity_available / quantity_available

InventorySnapshot.quantityAvailable

1
仓库/发货地template_warehouse / warehouse

InventorySnapshot.warehouse

香港
目标国家template_target_country / target_country

PriceRule.targetCountry

global
Shopify 商品句柄template_shopify_handle / shopify_handle

ShopifyProductMapping.shopifyHandle

apple-iphone-17e-brand-new-a3634-b-a-256gb-1sim-esim-not-activate
审核备注template_review_note / review_note

PriceRule.reviewNote

price_spike_gt_20_percent
目标对象

映射会落到哪些平台对象

  • ProductVariant商品规格 / 5 个字段
  • Product商品主档 / 2 个字段
  • InventorySnapshot库存快照 / 2 个字段
  • PriceRule价格规则 / 2 个字段
  • ShopifyProductMapping结账映射 / 1 个字段