Worten Mirakl传品实操：Offer和Catalog分开推，400报错三大暗坑排雷

底层逻辑：先建基座，再挂报价

Mirakl 的传品是两层结构：

Catalog 管道（产品创建）：负责商品的基础数据——EAN/UPC、品牌、多语言标题、规格尺寸、高精度主图。提交后要过 Worten 的算法校验和类目审核员审核，生效需要 1–24 小时（全新私有品牌或长尾非标品的类目映射审核 2–4 个工作日）。通过后系统生成唯一的 Product ID。

开发者正在调试接口对接代码

Offer 管道（挂载销售）：Catalog 审核通过、Product ID 生成后，卖家通过轻量级 Offer 接口把 SKU 绑定上去——只传价格、促销价、库存数量、交付时效，秒级生效。

两条管道的分工决定了日常运营效率：商品信息一年建一次（Catalog），价格库存天天改（Offer）。拿还没通过 Catalog 审核的 SKU 直接调 Offer 接口，系统找不到底层基座，返回 404 或 400 Invalid Product Reference——这是新手撞上 Mirakl 的第一堵墙。

标品卖家的捷径：EAN 在库内已存在的商品（品牌 3C、家电），不用建 Catalog，直接挂 Offer 开卖——和 Bol 的目录汇聚制同逻辑。

400 报错三大暗坑

批量上传或 API 对接时的 400 Client Error，九成出在这三处：

暗坑一：价格字段格式。 Mirakl API 严格要求金额是纯数字（"29.99"）——ERP 顺手带入的"€29.99""29.99 EUR"会被全批次拦截。小数点规范按欧洲习惯检查：ERP 输出逗号小数（29,99）的要在中间件转成点号。

暗坑二：发货时效枚举值。 Leadtime-to-ship（承诺备货时长）只接受枚举整数（通常 1–5 个工作日）——自发货卖家填自定义天数或留空，直接校验失败。

暗坑三：商品状态码。 新品、翻新、二手必须传 Mirakl 官方整数枚举（11=新品、1=成色极佳等）——传"New""Like New"这类文字，整行报错。

排雷方法：报错的批次先按这三个字段自查，90% 的问题十分钟内定位。剩余 10% 看必填类目属性（Attributes）是否静默遗漏——每个类目有自己的必填属性集，类映射错了属性就会缺。

Worten 的特殊字段：西葡双语和 GPSR

Worten 覆盖葡萄牙和西班牙双站，字段有特殊要求："Product Name Pt"（葡语商品名）是强制字段，"Product Name Es"（西语）在属性步填——双语标题和描述都要备（欧洲葡语不是巴西葡语，更不是西班牙语充数）。Sales Channels（销售渠道）页签里按站点分别设价——注意别为每个国家单独建 API 连接，多连接会互相覆盖，正确做法是用一个连接里的 Sales Channels 分站管理。

GPSR 合规字段（2026 年强制）：欧盟责任人姓名、邮箱、邮政地址三个属性必填——没有欧代的卖家，这三个字段填不上，商品过不了审（呼应 GPSR 篇：先落实欧代再传品）。

工具链：ERP 和聚合器怎么选

Mirakl 是欧洲最主流的 marketplace 底座（300+ 平台），工具生态成熟：

• 国内 ERP：店小秘、马帮、领星等对 Mirakl 接口适配完善——库存同步、订单抓取、面单回填全自动；
• 欧洲聚合器：ChannelEngine、Lengow、Channable——多平台分发场景（Worten + Fnac + Kaufland 同目录管理）的标准解，类目映射和属性校验内置；
• 直 API：技术团队自建——适合有定制需求的大卖，Mirakl REST API 文档完善。

建议路径：单平台起步用 ERP，多 Mirakl 平台（Worten、Fnac 系、Kaufland）并行时上聚合器——一份商品数据，一次映射，多平台分发。

传品节奏：从首批到日常

首批传品（第 1 周）：核心 SKU 20–50 个走完整流程——Catalog 提交 → 审核跟进 → Offer 挂载 → 前台验证（西葡双站的展示都要检查）。首日别批量倒全目录，先跑通一个 SKU 的全链路再放量。

日常运营：价格库存走 Offer 管道高频更新（库存准实时，防超卖）；新品按周批量建 Catalog（留出 2–4 天审核提前量）；每月核对一次类目映射（平台类目树会更新，老商品可能需要重新映射）。

上架前检查清单：EAN 合法、双语标题、类目叶子节点、必填属性全填、价格纯数字、时效枚举值、状态码整数、GPSR 三字段、主图白底高清——九项全绿再推送，一次过审率 95%+。

入驻和传品对接层面，做跨境电商开店服务的 ESG跨境 与 Worten 有官方合作，卖家可以通过 ESG跨境 办理入驻——类目映射、Feed 配置、ERP 对接，都有客户经理对接说明。

准备布局伊比利亚的卖家，点击申请 Worten 入驻 >>>

声明：本文系作者独立观点，不代表ESG跨境立场。文中涉及的平台规则、费率及出海政策具有时效性，实际运营请以平台官方最新公布为准。如有版权争议、内容勘误或业务交流，欢迎随时与我们联系。