Notion 与 Odoo / ERPNext 开源 ERP 供应链协同、采购请购单审批与安全库存补货闭环实战

2026 年 11 月 21 日

一、为什么供应链与制造团队需要将 Odoo / ERPNext 与 Notion 打通? #

对于成长型跨境电商、消费电子制造与新零售团队而言,Odoo 与 ERPNext 承担着库存总账、采购订单(PO)、应付账款及 BOM 物料清单的严谨核算;然而业务一线的采购需求发起、供应商比价谈判与滞销复盘却往往发生在跨部门协同场景中。若完全依赖 ERP 后台界面协作,团队常面临三类效率瓶颈:

  1. 请购需求与供应商比价割裂:运营或研发在 Notion 编写新品立项与打样清单后,仍需手工抄录物料编码与数量到 ERP 创建采购请购单(Purchase Requisition),极易因版本号错位下错单;
  2. 安全库存预警与采购协同脱节:当 Odoo 或 ERPNext 触发低库存阈值时,告警往往停留在邮件或系统日志中,采购专员无法在日常工作台直观感知“当前在途数量、预计交期(Lead Time)与关联促销活动”;
  3. 跨部门权限与账套成本过高:让市场、品控或外部代工厂人员直接登录 ERP 后台不仅增加了并发席位与安全管控成本,也容易因误操作污染正式财务凭证明细。

下表清晰界定了专业开源 ERP 与 Notion 供应链协同中枢的职责边界及单一真实数据源(SSOT)分工(采购资产基础配置可参考 Notion 采购与 IT 资产管理深度实战):

协同维度 Odoo / ERPNext(ERP 账务主系统) Notion(请购协同、供应商档案与补货预警中枢) 集成后的职责边界(SSOT)
核心管理对象 仓库实时可用库存、正式 PO 单据、收货质检凭证(GRN)与财务应付总账 采购请购审批流、供应商报价对比档案、SKU 安全库存看板与异常复盘 ERP 管“仓存实物账与财务凭证”,Notion 管“请购协同与补货决策”
库存与金额主权 唯一主权方(SSOT):以 ERP 出入库过账后的 Actual_Qty 与 On_Order_Qty 为准 只读镜像同步 ERP 库存水位与在途量,禁止手工覆盖实时库龄与可用量 仅允许 ERP Webhook 单向同步库存快照至 Notion,审批通过后再反向生成 PO 草稿
权限与角色隔离 仅财务、仓管与专职采购员持有 ERP 操作账号 产品、运营与供应链主管通过团队空间查阅看板并审批请购单 遵循 Notion 权限组精细化管控指南 锁定成本底价字段
电商前端联动 承接各渠道订单扣减与仓库调拨 与前端独立站订单台账联动核对毛利(参阅 WooCommerce 订单与库存同步实战) 形成“前端销量预测 → Notion 补货审批 → ERP 正式下采”闭环

二、四步搭建 ERP × Notion 采购请购审批与补货闭环架构 #

参照 Notion 企业级数据库架构设计规范,建议构建 “SKU 库存水位镜像库(DB_ERP_SKU_Stock)+ 采购请购与补货审批库(DB_Purchase_Requests)+ 供应商准入台账(DB_Suppliers)” 三表关联模型。

步骤 1:设计三库核心属性与 Relation 关联 #

利用 Relation 将请购单、SKU 主档与供应商资质串联(基础设置请参阅 关系和汇总官方指南),核心字段规范如下:

所属数据库 属性名称 属性类型 同步来源与工程规范
DB_ERP_SKU_Stock SKU_Code Title 全球唯一物料编码(与 Odoo default_code / ERPNext item_code 严格一致)
DB_ERP_SKU_Stock External_ERP_Key Rich Text 幂等主键,如 odoo:wh_main:SKU-1042 或 erpnext:main:ITEM-889
DB_ERP_SKU_Stock Available_Qty Number 当前仓库可售可用库存(由 ERP 实时增量写入)
DB_ERP_SKU_Stock On_Order_Qty Number ERP 中已审核尚未入库的采购在途数量
DB_ERP_SKU_Stock Safety_Stock Number 安全库存阈值(按日均销量 × 供货周期 × 安全系数核定)
DB_ERP_SKU_Stock Daily_Burn_Rate Number 近 30 天日均消耗/销量,用于 Formula 2.0 推算可售天数(DOI)
DB_ERP_SKU_Stock Lead_Time_Days Number 供应商标准采购交期(天)
DB_ERP_SKU_Stock Unit_Cost_CNY Number 最近一次核准采购单价(人民币元)
DB_Purchase_Requests PR_Title Title 请购单标题(如 [补货] SKU-1042 铝合金外壳 500 件)
DB_Purchase_Requests Target_SKU Relation 双向关联 DB_ERP_SKU_Stock(限制单选 1 Page)
DB_Purchase_Requests Supplier Relation 双向关联 DB_Suppliers(限制单选 1 Page)
DB_Purchase_Requests Request_Qty Number 本次申请采购数量(须大于等于供应商 MOQ 最小起订量)
DB_Purchase_Requests Approval_Status Select Draft、Pending Finance、Approved、Synced to ERP、Rejected
DB_Purchase_Requests ERP_PO_Ref Text ERP 创建采购单后回写的正式单号(如 PO202611084)
DB_Suppliers Supplier_Name Title 供应商全称及结算币种、账期(如 月结 30 天)

步骤 2:配置 Odoo Automated Action 与 ERPNext Webhook #

  1. Odoo 自动化规则(Automated Actions):进入 Settings → Technical → Automation → Automated Actions,针对 stock.quant 与 purchase.order 模型配置触发器;当库存数量变动或采购单状态变更为 purchase(已确认)时,向中转网关发送 JSON 载荷并附带 X-ERP-Signature HMAC 签名头。
  2. ERPNext Webhook 配置:在 Integrations → Webhook 中针对 Bin(仓库实时库存节点)的 on_update 事件以及 Purchase Order 的 on_submit 事件创建 Webhook,仅透传 item_code、warehouse、actual_qty、ordered_qty 与 valuation_rate,避免传输无关日志造成流量浪费。

步骤 3:构建 Notion 审批通过反向写回 ERP 通道 #

在 DB_Purchase_Requests 中配置 Notion 官方集成或按钮工作流:当财务与供应链负责人在 Notion 将 Approval_Status 改为 Approved 且 ERP_PO_Ref 为空时,由 Notion Integration Webhooks 推送 page.properties_updated 事件至中转网关;网关校验权限与预算无误后调用 Odoo XML-RPC/JSON-RPC 或 ERPNext REST API 创建采购订单草稿,并将生成的 ERP_PO_Ref 回写至 Notion,状态锁定为 Synced to ERP。

步骤 4:配置数据库属性锁与 3 RPS 速率限制队列 #

针对多仓库并发盘点场景,短时间内可能涌入上百条 SKU 库存变更事件。中转网关务必对同一 External_ERP_Key 实施 3 秒窗口合并去重,并遵循 Notion API 速率限制与生产级容错架构 将写入并发控制在每秒 3 次以内,同时在 Notion 视图中对 Available_Qty 与 ERP_PO_Ref 开启属性编辑锁,防止人工误改。


三、Node.js 工程实战:Webhook 验签与 Notion API 2026-03-11 幂等同步 #

以下示例基于 Node.js 20+ 原生 fetch 与 Notion-Version: 2026-03-11 Data Sources API(集成配置流程参见 创建 Notion API 集成指南),实现 ERP Webhook HMAC-SHA256 签名校验、按 External_ERP_Key 幂等更新 SKU 水位,并在可用库存跌破安全库存且无在途补货时,在页面顶部置顶插入红色断货预警块:

// erpStockSyncToNotion.mjs — Node.js 20+ 原生实现
import crypto from "node:crypto";

const NOTION_TOKEN = process.env.NOTION_TOKEN;
const SKU_STOCK_DS_ID = process.env.NOTION_ERP_SKU_DS_ID;
const ERP_WEBHOOK_SECRET = process.env.ERP_WEBHOOK_SECRET;

const NOTION_HEADERS = {
  Authorization: `Bearer ${NOTION_TOKEN}`,
  "Notion-Version": "2026-03-11",
  "Content-Type": "application/json",
};

/** 1. 校验 Odoo / ERPNext Webhook HMAC-SHA256 签名 */
export function verifyErpWebhookSignature(rawBodyBuffer, signatureHeader) {
  if (!signatureHeader || !ERP_WEBHOOK_SECRET) return false;
  const expected = crypto
    .createHmac("sha256", ERP_WEBHOOK_SECRET)
    .update(rawBodyBuffer)
    .digest("hex");
  const normalized = String(signatureHeader).replace(/^sha256=/i, "").trim();
  const a = Buffer.from(expected, "utf8");
  const b = Buffer.from(normalized, "utf8");
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}

async function notionReq(path, method = "GET", body = null) {
  const res = await fetch(`https://api.notion.com/v1${path}`, {
    method,
    headers: NOTION_HEADERS,
    body: body ? JSON.stringify(body) : undefined,
  });
  if (!res.ok) {
    const errText = await res.text();
    throw new Error(`Notion API ${res.status} on ${path}: ${errText}`);
  }
  return res.json();
}

/** 2. 基于 2026-03-11 Data Sources Query 查找既有 SKU 页面 */
async function findSkuPage(externalErpKey) {
  const res = await notionReq(`/data_sources/${SKU_STOCK_DS_ID}/query`, "POST", {
    filter: { property: "External_ERP_Key", rich_text: { equals: externalErpKey } },
    page_size: 1,
  });
  return res.results?.[0] || null;
}

/** 3. 同步 ERP 实时库存快照并触发断货置顶告警 */
export async function syncErpSkuSnapshot(event) {
  const externalKey = `${event.erp_provider}:${event.warehouse_code}:${event.sku_code}`;
  const available = Number(event.available_qty ?? 0);
  const onOrder = Number(event.on_order_qty ?? 0);
  const safety = Number(event.safety_stock ?? 0);

  const properties = {
    SKU_Code: { title: [{ text: { content: event.sku_code } }] },
    External_ERP_Key: { rich_text: [{ text: { content: externalKey } }] },
    Available_Qty: { number: available },
    On_Order_Qty: { number: onOrder },
    Safety_Stock: { number: safety },
    Unit_Cost_CNY: { number: Number(event.unit_cost_cny ?? 0) },
  };

  const existing = await findSkuPage(externalKey);
  if (!existing) {
    const created = await notionReq("/pages", "POST", {
      parent: { type: "data_source_id", data_source_id: SKU_STOCK_DS_ID },
      properties,
    });
    return { action: "CREATED", pageId: created.id, externalKey };
  }

  const prevAvailable = existing.properties?.Available_Qty?.number ?? Infinity;
  await notionReq(`/pages/${existing.id}`, "PATCH", { properties });

  // 仅当库存首次跌破安全库存且无在途采购单时,在页首插入红色补货警示块
  const crossedBelowSafety = prevAvailable >= safety && available < safety;
  if (crossedBelowSafety && onOrder === 0) {
    await notionReq(`/blocks/${existing.id}/children`, "PATCH", {
      position: { type: "start" },
      children: [
        {
          object: "block",
          type: "callout",
          callout: {
            icon: { type: "emoji", emoji: "📦" },
            color: "red_background",
            rich_text: [
              {
                type: "text",
                text: {
                  content: `低库存断货警报:${event.sku_code} 当前可用库存降至 ${available} 件(低于安全库存 ${safety} 件),且 ERP 尚无在途采购单,请立即发起补货请购。`,
                },
              },
            ],
          },
        },
      ],
    });
  }

  return { action: "UPDATED", pageId: existing.id, externalKey };
}

四、Formula 2.0 实战:安全库存水位、补货采购建议与超预算门禁 #

在 DB_ERP_SKU_Stock 中添加公式属性 补货决策与断货门禁(完整语法请参阅 Notion Formula 2.0 速查手册 与 官方公式语法指南),自动结合可用库存、在途数量、日均消耗、交期与关联中的待审批请购数量,实时输出标准化补货指令:

lets(
  avail, if(empty(prop("Available_Qty")), 0, prop("Available_Qty")),
  onOrder, if(empty(prop("On_Order_Qty")), 0, prop("On_Order_Qty")),
  safety, if(empty(prop("Safety_Stock")), 0, prop("Safety_Stock")),
  burn, if(empty(prop("Daily_Burn_Rate")), 0, prop("Daily_Burn_Rate")),
  leadDays, if(empty(prop("Lead_Time_Days")), 14, prop("Lead_Time_Days")),
  cost, if(empty(prop("Unit_Cost_CNY")), 0, prop("Unit_Cost_CNY")),
  pendingPrQty, prop("Purchase_Requests (关联请购)")
    .filter(current.prop("Approval_Status") == "Pending Finance" || current.prop("Approval_Status") == "Approved")
    .map(current.prop("Request_Qty"))
    .sum(),
  doi, if(burn > 0, floor(avail / burn), 999),
  reorderPoint, ceil(burn * leadDays + safety),
  suggestedQty, max(0, reorderPoint - avail - onOrder - pendingPrQty),

  ifs(
    avail <= 0 && onOrder == 0,
      style("🚨 严重断货:可用库存归零且无在途单(建议补货 " + format(suggestedQty) + " 件)", "red", "bold", "red_background"),
    avail < safety && (onOrder + pendingPrQty) == 0,
      style("🔴 跌破安全库存(仅剩 " + format(doi) + " 天可售):建议下单 " + format(suggestedQty) + " 件 / 约 ¥" + format(round(suggestedQty * cost)), "red", "bold"),
    avail + onOrder + pendingPrQty < reorderPoint,
      style("🟠 触及补货点(含在途仍缺口 " + format(suggestedQty) + " 件):待补充请购", "orange", "bold"),
    pendingPrQty > 0,
      style("🟡 补货审批/在途推进中(请购待发 " + format(pendingPrQty) + " 件 · 在途 " + format(onOrder) + " 件)", "yellow"),
    style("🟢 库存健康(可售约 " + format(doi) + " 天)", "green")
  )
)

五、常见 ERP 集成故障排查清单 #

在生产环境运维 Odoo / ERPNext 与 Notion 供应链协同管道时,重点排查以下四类高频异常(通用错误诊断请查阅 Notion 常见报错与故障诊断手册):

  1. 大促或盘点期间库存震荡触发重复预警:多笔出库单与退货单在 1 分钟内连续调整库存,导致页面顶部反复插入红色告警块。解法:仅当库存从“高于等于安全库存”首次跌破“低于安全库存”且 onOrder === 0 时写块,并在网关按 External_ERP_Key 聚合 3 秒内事件。
  2. ERP 多计量单位(UoM)换算错位:ERPNext 采购按“箱(Box = 24 件)”下采而仓库按“件(PCS)”入库,直接同步原数值导致 Notion 补货量放大 24 倍。解法:在 ERP Webhook 导出脚本统一换算为最小基础库存单位(Stock UoM)后再写入 Notion。
  3. 审批状态回写死循环:Notion 审批通过后触发网关在 ERP 生成 PO,若网关回写 ERP_PO_Ref 时又再次触发 Notion 属性更新 Webhook,易造成重复建单。解法:回写之前严格判定 ERP_PO_Ref 为空才建单,建单成功后原子锁定状态为 Synced to ERP。
  4. SKU 成本单价跨部门越权可见:运营与外部外协加工厂只需查看可用库存与交期,却能通过全局搜索看到 Unit_Cost_CNY 采购底价。解法:将含成本单价的主表存放于受控的供应链 Teamspace(参阅 Notion 数据库性能与权限架构规范),仅对外协开放脱敏后的库存水位同步表。

❓ 常见问题与答疑 (FAQ)

高频疑难解析与避坑指南
A

完全不需要。绝大多数核心功能在免费 Free 计划中均可完整体验与实操练习,无需额外付费购买 Plus 或团队版。