供应商接入

商品源字段清单

真实飞书货源 Base 已确认，当前清单用于约束自动同步需要的字段、派生规则和异常隔离。

中文
报价模板
FeishuProductSourceChecklist

用字段清单约束自动同步，正常库存和价格变化不进人工确认

按四张真实货源表接 Feishu 事件订阅和 Shopify 写入 adapter，默认正常变更全自动同步。

返回供应商管理下载模板 CSV查看字段映射草稿
字段总数12

ADkabWtH...FId3nbd / 4 tables / auto sync

必填字段8

缺少时不能报价

建议字段2

用于交期、国家和履约边界

可选字段2

Shopify 映射和审核备注可后置

hard stops

必须停下来的条件

01
商品源字段缺失

稳定 SKU 无法派生时，隔离该记录，不写 Shopify。

自动隔离
02
商品源字段缺失

USD价格或库存不是合法数字时，隔离该记录，不写 Shopify。

自动隔离
03
Shopify 映射缺失

Shopify API 返回 userErrors、限流或权限不足时，自动重试并记录日志；连续失败后隔离该 SKU。

自动隔离
硬停

必填字段

缺少这些字段时，商品不能进入报价、同步或自动销售。

SKUsku / 商品规格

由栏目、机型、Version、容量、卡槽规格、状态和颜色/货号自动派生，每行必须稳定唯一。

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

由品牌、机型和栏目自动生成，用于平台商品和 Shopify 商品标题。

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

由 Version、容量、卡槽规格、状态和颜色/货号自动生成，承载手机行业规格差异。

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

当前新货源 Base 固定进入 3C 手机行业包，后续其他行业仍要有品类字段。

手机
基础价格base_price / 商品规格

优先使用 USD价格作为国际报价基础价；必须为数字，异常波动进入隔离。

632
币种currency / 商品规格

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

USD
起订量moq / 商品规格

当前货源表缺 MOQ，自动同步先采用默认 1；后续如供应商提供 MOQ 字段再覆盖。

1
可售库存quantity_available / 库存快照

来自库存字段，必须为非负整数；变化后自动同步 Shopify 库存。

1
可默认

建议字段

用于交期、国家价格和履约承诺，缺失时按默认规则运行并写入日志。

仓库/发货地warehouse / 库存快照

当前由供应商货源口径默认派生，后续可拆成真实仓库或发货地字段。

香港
目标国家target_country / 价格规则

当前货源表提供通用 USD/HKD 价格，不按国家分价；国家价格规则后续单独叠加。

global
可后置

可选字段

用于 Shopify 映射、审核备注和后续自动化优化。

Shopify 商品句柄shopify_handle / 结账映射

由商品拆分规则自动派生；映射 ID 存在独立映射层，不写回原货源表。

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

用于记录自动隔离原因，如错价、缺字段、库存异常或 Shopify API 失败。

price_spike_gt_20_percent
接入边界

当前只做本地清单，不访问真实云端

  • 飞书四张源表已确认；状态表用于映射、日志、异常和订单占用。
  • Shopify缺少映射时自动创建商品和规格，写入失败进入异常隔离。
  • 异常隔离SKU、价格、库存或 API 错误只隔离单条记录，不阻塞其他 SKU。