用户手册
帮助中心/用户手册/产品同步拆成四个节点:库存 / 价格 / 图片 / 档案

产品同步拆成四个节点:库存 / 价格 / 图片 / 档案

最后更新 2026-10-16

原来"库存+产品"两个节点一肩挑,节奏对不上。现在拆成四个独立节点:库存建议每 15 分钟同步,价格每天同步,图片和档案按需同步。

以前把产品信息推到电商平台,用的是两个节点:channel.push_inventory(推库存)和 channel.push_products(推产品)。一个管"还剩多少",一个管"卖的是什么",听起来分工明确,实际用起来很别扭:库存 15 分钟就得推一次,产品信息(标题、图片、价格)一天推一次都嫌多——两种节奏的东西绑在两个节点里,要么库存推慢了导致超卖,要么图片价格被反复推、浪费平台 API 额度。

拆分前:价格、图片、档案绑在一个节点里,和库存一个节奏推。拆分后:四个节点,各按各的节奏同步。

为什么拆成四个#

拆分的逻辑只有一句话:变化频率不同的东西,就该分开同步。

  • 库存:卖出一件就少一件,大促时几分钟就变一次 → 每 15 分钟推一次。
  • 价格:调价是人工决策,一天最多几次 → 每天一次,或调价后手动推一次。
  • 图片:只有上新、换图时才变 → 按需推,不用定时。
  • 档案(标题 / 描述 / 重量 / 条码):只有建档或改信息时才变 → 按需推,不用定时。

四个节点各是干嘛的#

channel.push_product_inventory —— 产品库存同步

把 OMS / WMS 里的可售库存推到平台——就是买家看到的"还剩 X 件"那个数字。四个节点里它最忙,也是唯一需要掐着表跑的。

  • 必开:每 15 分钟定时跑一次(模板默认值)。
  • 大促 / 秒杀期间可以加密到 5–10 分钟一次——注意平台 API 限流。
  • 只推数量,不碰价格和图片,所以跑得快、额度省。

channel.push_product_price —— 产品价格同步

把售价推到平台。价格是人工定的,变了才需要推。

  • 每天定时跑一次(模板默认值),兜底。
  • 每次调价后手动触发一次,新价格立刻生效,不用等到明天。
  • 建议和库存节点分开跑,别绑在一起。

channel.push_product_images —— 产品图片同步

把主图和细节图推到平台。图片最占流量、平台审核也最慢,没必要定时跑。

  • 上新、换主图、补细节图时手动触发一次。
  • 一次推全套图;只换了一张的话,多数连接器支持只推那一张。
  • 推完去平台前台看一眼:图片有缓存,生效可能要几分钟。

channel.push_product_profile —— 产品档案同步

把标题、描述、重量、尺寸、条码这些"档案信息"推到平台。

  • 建档、改标题 / 描述 / 重量时手动触发一次。
  • 条码、重量这类影响履约的信息,改完立刻推一次。
  • 不需要定时跑。

「产品全量同步」模板怎么用#

Flow 模板库里新增了「产品全量同步」模板:点一次,四个节点按 库存 → 价格 → 图片 → 档案 的顺序跑完。新品上架、listing 大改之后,用它一次把所有信息推到平台,最快。

  1. 进 Integration → Flow → 从模板新建,找到「产品全量同步」。
  2. 选连接:这次同步推到哪个平台(一个平台建一个 Flow)。
  3. 检查一遍字段映射:SKU、价格、图片字段跟平台要求的对齐。映射错一个,四个节点一起报错。
  4. 点"运行"手动跑一遍:确认产品在平台前台显示正常,再放心用。
  5. 每次上新或改产品信息时来点一次——它是手工触发的,别挂定时器。
这个模板是给"现在全推一遍"的场景用的。日常的库存推送,请单独建一个只有库存节点、每 15 分钟的定时 Flow。价格一般也不用定时——每次调价后手动触发价格节点就行。

从老节点迁过来#

老的 channel.push_inventory 和 channel.push_products 已废除,不能再用;已有 Flow 请改用四个新节点。对照关系:

  • push_inventory(库存)→ push_product_inventory
  • push_products(产品)→ 拆成三个:push_product_price(价格)+ push_product_images(图片)+ push_product_profile(档案)
同一个 SKU 不要新老节点混着推:老 push_products 会连价格带图片一起推,和新节点打架,以哪个为准说不清。迁就迁彻底。

常见问题#

库存还是推不准、超卖了怎么办?

先看两点:① 库存节点的 15 分钟节拍对您的店铺够不够,爆款大促时考虑加密;② 平台有没有 API 限流,限流会导致某次推送被跳过。两个都没问题再查 Mapping。

四个节点的频率能改吗?

能。每个节点独立定时,互不影响。改之前想清楚:加密意味着更多的 API 调用次数。

图片推了,平台前台没变化?

节点显示成功只代表"推过去了"。平台侧还有图片审核和 CDN 缓存,前台生效慢几分钟到几小时都正常——先去平台后台看图片是否已经更新。