市场平台集成

如何将 Compari 接入 easySales：完整集成指南

由 easySales 团队撰写 · 更新于 14 九月 2026 · 阅读 1 分钟

如何将 Compari 接入 easySales：完整集成指南

把 Compari 接入 easySales：API 令牌、增值税与发票设置、Compari 用于订单与库存的两个地址、分类映射，以及每一种报价错误的含义。

接入 Compari 能带来什么

Compari 是罗马尼亚的比价类平台。接入 easySales 后，你的商品会从你已经在用的同一份商品目录发布到那里，价格和库存保持同步，Compari 转来的订单会和其他所有渠道一样进入订单。

连接本身只需要几分钟。真正需要留心的是分类映射 —— 它是「账户已连接」和「商品真的出现」之间的那一步。

开始之前

✓

一个 Compari 商家账户

已在 compari.ro 注册并处于启用状态。连接由你这边发起，使用该账户签发的令牌。

✓

你的 API 令牌

在 Compari 平台中生成。这是连接唯一需要的凭证。

✓

easySales 中的商品

Compari 报价由你目录中已有的商品构建，带上它们的图片、品牌、EAN 和分类。

第 1 步 — 找到 Compari 卡片

进入整合方式 → 交易市场，搜索 compari。

easySales 的交易市场页面筛选到 Compari，显示已连接的 Compari 卡片。
整合方式 → 交易市场，按 `compari` 筛选。

在卡片上点击连接；如果之前已经接入过，点击 Edit。

第 2 步 — 为连接命名并设置加价

Compari 表单顶部，显示连接名称、新订单自定义状态和价格加成。
价格加成在创建报价时生效。
字段 作用
连接名称 仅在 easySales 内部使用，用来区分不同连接。
新订单自定义状态 Compari 订单进来时被赋予的状态。可选，列表里是你在「订单 → 设置」中定义的自定义状态。
价格加成 创建报价时在商品价格之上加的百分比 —— 100 RON 的商品加 10% 就以 110 RON 上架。它作用于新添加的报价；修改它不会重写已上架报价的价格。
前三个字段

第 3 步 — 增值税

Compari 表单中的默认税率、默认运费和纳税国家。
三个增值税字段。
字段 作用
默认税率 应用于报价的增值税百分比。如果你不是增值税纳税人，请设为 0。
默认运费 应用于订单运费的增值税百分比。
纳税国家 上架按哪个国家的增值税规则执行。Compari 提供的范围是罗马尼亚、匈牙利、保加利亚、希腊和斯洛伐克。
增值税字段

第 4 步 — 发票系列、API 令牌与库存行为

Compari 表单中的发票系列、API 令牌，以及有库存时自动启用报价的选项。
API 令牌是这条连接唯一的凭证。
字段 作用
发票系列 为 Compari 订单开具发票时使用的系列。这是默认值；在单笔订单上仍可更改。
API 令牌 来自你的 Compari 账户。加密存储，easySales 发送的所有内容都由它授权。
当产品有库存时自动启用报价 选「是」时，因商品售罄而被关闭的报价会在库存恢复后自动重新上架。
最后三个字段

第 5 步 — 把两个地址交给 Compari

保存连接后会生成两个地址，显示在 Compari 卡片上。它们不是需要你上传到别处的文件 —— 而是 Compari 主动访问的地址，每个都带有你这条连接专属的密钥。把两个都复制到 Compari 中，一次即可。

Compari 卡片上为该连接生成的订单 URL 和产品可用性 URL。
两个地址各复制到 Compari 一次即可。
地址 方向
订单 URL Compari 通过它把每一笔新订单发给你。这是 Compari 订单进入 easySales 的唯一通道。
URL 产品可用性 Compari 通过它逐个商品询问当前库存，以便展示给买家的可售状态与你实际持有的一致。
两个地址

第 6 步 — 映射你的分类

这一步决定了到底会不会有商品被发布出去。

easySales 的分类目录页面，已映射列在五个分类旁显示 Compari，另外三个为空。
已映射列可以看出还缺什么。

进入虚拟商店 → 分类目录。你的每个分类都要映射到一个 Compari 分类；已映射列会显示某个分类已经为哪些平台完成映射。在某一行点击映射分类即可设置或修改。

第 7 步 — 添加商品

打开虚拟商店 → 产品，用未在以下平台上架筛选器找出尚未发布到 Compari 的商品，并从那里添加。每个商品会变成一条 Compari 报价，带上它的名称、描述、品牌、图片、价格、EAN、保修和分类。

如何跟踪报价

优惠 → Compari 是发布之后的去处：什么已经发出、Compari 接受了什么、什么被拦下了。

优惠页面的 Compari 标签页，显示带有 8121 Missing category、8113 Invalid image url 和 8114 Invalid EAN 错误的报价。
这一列里带错误的报价从未被发送到 Compari。

最有用的是错误列。其中的每一项都在报价离开 easySales 之前完成校验，所以在那里带错误的商品根本没有被发送过：

错误 如何处理
8121 Missing category 商品所在分类没有映射到 Compari 分类。请在「虚拟商店 → 分类目录」中映射。
8113 Invalid image url 图片地址不是 HTTPS，或不以 .jpg、.jpeg、.png、.webp 结尾。提示会指出是哪一张图。
8112 Missing images 商品完全没有图片。
8114 Invalid EAN EAN 不在 8 到 13 位数字之间。
8118 Missing brand / 8120 Missing product name / 8119 Missing SKU 商品缺少该字段。请在商品上补齐，而不是在报价上。
8111 Invalid price 计算出的价格低于 0.1。
8110 Product rejected by compari.ro 是 Compari 自己拒绝的，下面会写明它的原话。这里出现 Invalid ApiKey! 说明连接里的令牌已经失效。
错误列在告诉你什么

这个集成不做的事

实际情况
Compari 上已有的上架商品 你已经在 Compari 上的报价不会被导入 easySales。easySales 管理的是它根据你自己的商品创建的那份目录。
价格 每条报价只发送一个价格 —— 售价。没有单独的划线价。
发票与运单 不会发送给 Compari。你照常在 easySales 中开票和创建运单；回传给 Compari 的是订单状态。
必填属性 Compari 不要求任何属性，因此在报价上架前没有分类专属的参数需要填写。
需要了解

常见问题

在你的 Compari 账户里。这是连接唯一需要的凭证 —— 没有用户名和密码 —— easySales 会加密保存它。

检查 Compari 卡片上的订单 URL 是否已经保存到 Compari。Compari 会在订单产生时把它发到那个地址；之后无法再补取更早的订单，因此在地址配置好之前下的单，从来就没有被发送过。

Compari 会访问它，逐个商品询问你当前的库存，好让你上架商品旁显示的可售状态与真实库存一致。和订单地址一样，它只需要复制到 Compari 一次。

打开优惠 → Compari，看错误列。那里列出的每一项都在报价发送前完成校验，所以带错误的报价从未到达 Compari。8121 Missing category 最常见，意思是该商品的分类没有映射到 Compari 分类。

意思是商品所在的分类没有被映射到某个 Compari 分类。进入虚拟商店 → 分类目录，找到该分类并点击映射分类。映射之后重新发送报价，下一次运行时就会发出去。

地址本身必须以 .jpg、.jpeg、.png 或 .webp 结尾，并通过 HTTPS 提供。那些不带文件扩展名却能返回图片的地址 —— 在内容分发网络上很常见 —— 即使图片能加载也会被拒绝。错误提示会指出是商品的哪一张图有问题。

8 到 13 位数字。更短、更长或含有数字以外字符的，都会以 8114 Invalid EAN 返回。

没有影响。它在创建报价时生效，因此只作用于新添加的报价。要改动已上架报价的价格，请修改商品价格或使用价格规则。

不会。easySales 不会读取 Compari 上已存在的报价；它管理的上架内容是根据你自己的商品构建的。

不能。你照常在 easySales 中开票和创建运单 —— 回传给 Compari 的是订单状态。

不需要。Compari 不要求属性，所以分类一旦映射完成，报价就带着商品自身的字段发送，无需再补充其他内容。

因商品售罄而被关闭的报价，会在商品重新有库存时自动恢复销售，而不必等你手动启用。

本指南对你有帮助吗?