产品同步拆成四个节点:库存 / 价格 / 图片 / 档案
原来"库存+产品"两个节点一肩挑,节奏对不上。现在拆成四个独立节点:库存建议每 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 大改之后,用它一次把所有信息推到平台,最快。
- 进 Integration → Flow → 从模板新建,找到「产品全量同步」。
- 选连接:这次同步推到哪个平台(一个平台建一个 Flow)。
- 检查一遍字段映射:SKU、价格、图片字段跟平台要求的对齐。映射错一个,四个节点一起报错。
- 点"运行"手动跑一遍:确认产品在平台前台显示正常,再放心用。
- 每次上新或改产品信息时来点一次——它是手工触发的,别挂定时器。
从老节点迁过来#
老的 channel.push_inventory 和 channel.push_products 已废除,不能再用;已有 Flow 请改用四个新节点。对照关系:
- push_inventory(库存)→ push_product_inventory
- push_products(产品)→ 拆成三个:push_product_price(价格)+ push_product_images(图片)+ push_product_profile(档案)
常见问题#
库存还是推不准、超卖了怎么办?
先看两点:① 库存节点的 15 分钟节拍对您的店铺够不够,爆款大促时考虑加密;② 平台有没有 API 限流,限流会导致某次推送被跳过。两个都没问题再查 Mapping。
四个节点的频率能改吗?
能。每个节点独立定时,互不影响。改之前想清楚:加密意味着更多的 API 调用次数。
图片推了,平台前台没变化?
节点显示成功只代表"推过去了"。平台侧还有图片审核和 CDN 缓存,前台生效慢几分钟到几小时都正常——先去平台后台看图片是否已经更新。