3. 飞书建表
1.1 所需地址
1.2 数据表怎么分
- 分开管理：发圈、发箍、发夹各建一张数据表。
- 合在一起：都放在一张表里，用类目字段区分。
- 文件夹分组：把同一类的表放进一个文件夹，比如“饰品”下放发圈、发箍、发夹。
数据表名称按自己的习惯起。自带的仪表盘、工作流用不到，可以删除。
1.3 建表字段清单
一行填写一个 SKU，同一货号有几个 SKU，就填写几行。 同一货号各行的标题、货号、类目等商品信息保持一致，规格、售价、库存和编码按 SKU 分别填写。
下表覆盖店智效的基础字段与按配置使用的字段。表头可以自定义，建好后在店智效里选择对应列；“按需建列”的项目如果在店智效中统一填写固定值，就不用另外建飞书列。
| 字段 | 建议类型 | 何时需要 | 填写要求 |
|---|---|---|---|
| 货号 | 文本 | 必填 | 例如 YW-121；同款各行相同，必须与素材货号文件夹名称完全一致；保留字母、连接符和前导 0 |
| 标题 | 文本 | 必填 | 完整商品标题；同一货号各行保持一致 |
| 类目 | 单选 | 必填 | 与店智效中已配置的类目名称对应；同款不能混入不同类目 |
| 售价 | 数字 | 必填 | 每个 SKU 的售价，必须大于 0；只填数值，不加“元” |
| SKU 命名 | 文本 | 使用单层自定义规格时必填 | 每个 SKU 一个名称；已按类目配置颜色、尺码等多项规格时，分别使用下面的规格列，不必再重复建这一列 |
| 颜色／颜色分类 | 单选或文本 | 类目有该规格且从飞书取值时 | 一行填当前 SKU 的一种颜色；有固定选项时优先单选，名称与后台选项一致 |
| 尺码 | 单选或文本 | 类目有该规格且从飞书取值时 | 一行填当前 SKU 的一个尺码；淘宝、天猫的尺码须属于同一原生尺码组 |
| 容量、个数等其他销售规格 | 按平台选项建单选或文本 | 类目要求或主动启用该规格时 | 每个规格单独建列，一行对应一组真实可售组合，不把几种规格混在一个单元格 |
| 库存／可售数量 | 数字 | 库存选择“飞书字段”时 | 每行填可售整数数量；1688 必须为正整数；统一库存可在店智效里填写固定值 |
| SKU 编码／商家编码 | 文本 | 选填；一旦绑定就逐行填写 | 保留前导 0；同款 SKU 编码不得重复，编码和 SKU 图片的对应关系保持一致 |
| 品牌 | 单选或文本 | 选择从飞书读取品牌时 | 填当前店铺、当前类目可用的真实品牌；使用店智效固定品牌时不用建列 |
| 店铺分类 | 文本；多分类按配置使用多选 | 选择从飞书读取店铺分类时 | 一级填分类名，二级填“父分类 / 子分类”；按店智效已启用的分类方式填写 |
| 材质、风格等单值商品属性 | 单选或文本 | 类目要求且从飞书读取时 | 每项属性各建一列；有平台固定选项时按原选项创建单选列 |
| 适用季节等多值商品属性 | 多选 | 平台允许多选且从飞书读取时 | 一格可以选多个合法选项；只有平台支持多选的属性才建多选列 |
| 条码、等级等 SKU 参数 | 文本、数字或单选，按该参数要求 | 当前类目出现该参数且选择飞书取值时 | 每项参数单独建列，逐 SKU 填写；条码用文本保留前导 0；没有该参数就不用建列 |
| 物流重量（kg） | 数字 | 淘宝运费模板要求重量且选择飞书取值时 | 含包装重量，单位千克；允许 0.001～9999.999，例如 0.5；统一填写时在店智效运费设置里填固定值 |
| 长（cm） | 数字 | 1688 件尺寸选择飞书取值且需要长宽高时 | 单位厘米；长、宽、高一起填写，不能只填其中一项 |
| 宽（cm） | 数字 | 同上 | 单位厘米，填写正数 |
| 高（cm） | 数字 | 同上 | 单位厘米，填写正数 |
| 重量（g） | 数字 | 1688 从飞书读取重量时；计重运费必须提供重量 | 单位克，每条 SKU 填正数；与淘宝的千克列分开，500 g = 0.5 kg；件尺寸统一填写时可用店智效固定值 |
类目不同，完整的属性和 SKU 参数也不同。 在店智效读取并打开目标类目后，把该类目中选择“飞书字段”的项目逐项对应到上表；带必填标记的项目必须有有效值。属性名旁有“写入表格”入口的，可以一次创建带完整平台选项的单选或多选列，再回到表里填写商品数据。
运费／物流模板、计量单位、发货时效、上架位置、1688 阶梯数量与价格运算在店智效里配置，不需要为这些固定设置另建飞书列。图片和视频按第 4 课放在本地素材文件夹或平台素材库，不放进上述数据列。
1.4 开通权限
打开飞书开发者后台，进入自己的应用，在“权限管理 → 开通权限”选择应用身份权限，按下表开通。应用权限和目标表授权都要完成。
| 设置位置 | 权限名称 | 权限标识 | 用途与要求 |
|---|---|---|---|
| 应用身份权限 | 查看、评论和导出多维表格 | bitable:app:readonly |
读取数据表、字段和商品记录；正常读取与上新需要 |
| 应用身份权限 | 新增字段 | base:field:create |
使用店智效“写入表格”创建属性列和完整选项时需要 |
| 多维表格右上角“更多 → 添加文档应用” | 可阅读 | 无需搜索权限标识 | 把自己的应用加入目标多维表格；只读取商品资料时至少需要这一授权 |
| 同一多维表格的应用授权／高级权限 | 可编辑，并允许管理字段 | 无需搜索权限标识 | 使用“写入表格”时需要；若开启高级权限，还要允许应用访问目标数据表、记录和字段 |
| 开发者后台“版本管理与发布” | 创建版本并发布生效 | 无需搜索权限标识 | 应用权限变更后发布版本；如组织要求审批，完成审批后再回店智效重试 |
如果应用已经开通“查看、评论、编辑和管理多维表格”（bitable:app），可使用它覆盖上述读取及新增字段能力，无须再重复申请同类权限。店智效“写入表格”只新增属性列，不修改商品记录，也不覆盖已有同名列。
1.5 连到店智效
- 回到表格，点右上角“更多”，选“添加文档应用”，搜到应用，权限选“可编辑”，点添加。
- 选中要用的数据表，复制地址栏链接，粘贴到店智效自动上新配置的多维表格链接里。
- 在应用的“凭证与基础信息”页面复制 App ID 和 App Secret，粘贴到店智效里，点“读取飞书字段”，提示“已读取”就连上了。
- 在固定配置里，把标题、货号和类目分别选到表里对应的字段，点“保存配置”。