第一步:先区分店铺、商品和流程的权威来源

发布问题经常来自同一个字段在多个地方重复维护。店铺决定发布平台、站点、货币和授权状态;内部商品资产决定可发布内容;发布运行只负责冻结执行上下文和记录结果。

业务对象正式职责不应承担的职责
目标店铺平台、站点、货币、授权不重复保存商品标题或变体SKU
内部商品资产商品内容、媒体、SKU和变体上下文不保存某一次批次的执行状态
发布运行目标快照、阶段、重试和平台结果不成为商品内容的长期来源

第二步:准备四类正式发布资产

在进入发布批次前,至少需要确认以下资产已经归属于同一个内部商品和具体变体。

  • 商品内容:目标平台与语言下完整的标题和描述,并处于已审批状态。
  • 商品媒体:由生产阶段同步、可以通过HTTP(S)访问的商品图片地址。
  • SKU与条码:具体产品变体对应的有效SKU资产,而不是发布表中的临时值。
  • 产品上下文:产品蓝图和变体提供平台属性、型号、容量、尺寸或颜色等标签。
正式资产缺失时应返回明确的缺项,让运营人员补齐后再发布。静默回退到历史字段会让批次结果难以解释。

第三步:理解多变体商品的展开方式

生产模板先生成商品图,生产模板的适用变体再展开为商品组和变体骨架。这样同一份商品媒体可以服务多个具体销售选项,避免每个变体重复执行PSD合成。

发布适配器读取已经建立的变体骨架和内部资产,按平台要求组装属性和值。平台返回的校验错误属于发布结果,应保留在对应批次和商品项中。

第四步:让发布批次可追踪、可恢复

开始批次时冻结目标店铺快照、来源项目和商品组上下文。运行中的配置变化不应改变已经开始的执行。

  1. 批量读取来源商品和目标店铺上下文。
  2. 为每个商品项记录执行状态和当前阶段。
  3. 临时网络、超时、限流和平台5xx按延迟策略重试。
  4. 业务校验失败保持终态,人工修正资产后再重试。
  5. 已经进入平台创建阶段的任务保留幂等检查,避免重复创建。

上线前检查清单

  • 店铺授权有效,平台和站点与业务目标一致。
  • 每个商品有已审批的目标语言内容。
  • 商品媒体地址可被平台访问,且顺序已确认。
  • 每个销售变体有有效SKU、条码和必要属性。
  • 发布批次能够显示目标店铺、当前阶段和平台返回信息。

查看Mercado Libre商品发布方案 →