第一步：创建飞书自建应用，获取 App ID 和 App Secret
- 打开 飞书开放平台：
open.feishu.cn → 登录后进入「开发者后台」
- 点击「创建企业自建应用」，填写应用名称和描述
- 进入应用 → 「凭证与基础信息」，复制 App ID 和 App Secret
- 进入「权限管理」，搜索并开启以下权限：
- 发布应用（企业自建应用无需审核，直接发版即可）
第二步：获取多维表格的 App Token 和 Table ID
- 打开你的飞书多维表格，复制浏览器地址栏的链接
- 链接格式如下：
https://xxx.feishu.cn/base/XONsxxxxxxxxxxxxxxx?table=tblxxxxxxxxxxxxxxx
- 高亮部分即 App Token，table= 后面的部分即 Table ID
- 也可以直接把完整链接粘贴到配置页「多维表格链接」输入框，系统会自动解析
第三步：给应用添加多维表格访问权限
- 打开多维表格 → 右上角「···」→「更多」→「添加文档应用」
- 搜索并添加你创建的应用，权限选择「可编辑」
- 不添加此权限会导致「Forbidden」错误，无法读写数据
第四步：配置字段映射
点击「读取字段」按钮，系统会自动拉取多维表格中所有字段，然后将以下字段对应选择：
| 字段 | 说明 | 必填 |
|---|
| 名称字段 | 制品/商品名称 | ✅ |
| 条码字段 | 用于扫码枪识别的条形码 | ✅ |
| 售价字段 | 单价，用于计算订单金额 | ✅ |
| 剩余数量字段 | 结算时自动扣减 | ✅ |
| 已售数量字段 | 结算时自动累加 | ✅ |
| 备货量字段 | 总库存，仅展示 | — |
| 图片字段 | 商品封面图 | — |
| 类型 / IP 字段 | 商品标签，用于筛选 | — |
常见问题
- 报错「Forbidden」：第三步没有给应用加编辑权限
- 商品列表为空：检查 Table ID 是否正确，或字段名称映射是否匹配
- 扫码没反应：确认条码字段映射正确，且多维表格中有对应条形码数据
- 配置丢失：配置保存在浏览器本地，换浏览器或清除缓存后需重新填写