Notion 与 Odoo / ERPNext 开源 ERP 供应链协同、采购请购单审批与安全库存补货闭环实战
一、为什么供应链与制造团队需要将 Odoo / ERPNext 与 Notion 打通? #
对于成长型跨境电商、消费电子制造与新零售团队而言,Odoo 与 ERPNext 承担着库存总账、采购订单(PO)、应付账款及 BOM 物料清单的严谨核算;然而业务一线的采购需求发起、供应商比价谈判与滞销复盘却往往发生在跨部门协同场景中。若完全依赖 ERP 后台界面协作,团队常面临三类效率瓶颈:
- 请购需求与供应商比价割裂:运营或研发在 Notion 编写新品立项与打样清单后,仍需手工抄录物料编码与数量到 ERP 创建采购请购单(Purchase Requisition),极易因版本号错位下错单;
- 安全库存预警与采购协同脱节:当 Odoo 或 ERPNext 触发低库存阈值时,告警往往停留在邮件或系统日志中,采购专员无法在日常工作台直观感知“当前在途数量、预计交期(Lead Time)与关联促销活动”;
- 跨部门权限与账套成本过高:让市场、品控或外部代工厂人员直接登录 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 #
- Odoo 自动化规则(Automated Actions):进入 Settings → Technical → Automation → Automated Actions,针对
stock.quant与purchase.order模型配置触发器;当库存数量变动或采购单状态变更为purchase(已确认)时,向中转网关发送 JSON 载荷并附带X-ERP-SignatureHMAC 签名头。 - 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 分钟内连续调整库存,导致页面顶部反复插入红色告警块。解法:仅当库存从“高于等于安全库存”首次跌破“低于安全库存”且
onOrder === 0时写块,并在网关按External_ERP_Key聚合 3 秒内事件。 - ERP 多计量单位(UoM)换算错位:ERPNext 采购按“箱(Box = 24 件)”下采而仓库按“件(PCS)”入库,直接同步原数值导致 Notion 补货量放大 24 倍。解法:在 ERP Webhook 导出脚本统一换算为最小基础库存单位(Stock UoM)后再写入 Notion。
- 审批状态回写死循环:Notion 审批通过后触发网关在 ERP 生成 PO,若网关回写
ERP_PO_Ref时又再次触发 Notion 属性更新 Webhook,易造成重复建单。解法:回写之前严格判定ERP_PO_Ref为空才建单,建单成功后原子锁定状态为Synced to ERP。 - SKU 成本单价跨部门越权可见:运营与外部外协加工厂只需查看可用库存与交期,却能通过全局搜索看到
Unit_Cost_CNY采购底价。解法:将含成本单价的主表存放于受控的供应链 Teamspace(参阅 Notion 数据库性能与权限架构规范),仅对外协开放脱敏后的库存水位同步表。
核心手册与速查工具矩阵
高频速查手册与生产力工具直达常见问题与答疑 (FAQ)
高频疑难解析与避坑指南完全不需要。绝大多数核心功能在免费 Free 计划中均可完整体验与实操练习,无需额外付费购买 Plus 或团队版。