如何将 MerchantPro 与 easySales 连接：完整集成指南

由 easySales 团队撰写 · 更新于 6 Jun 2026 · 阅读 1 分钟

使用 API 凭证将你的 MerchantPro 商店与 easySales 连接——无需安装模块。在 MerchantPro 中创建一个 API 用户，在 easySales 中启动向导，然后粘贴合并后的令牌。集中管理订单、同步库存和价格、自动生成发票和运单，并将同一目录作为报价上架到每个销售平台。

为什么要将 MerchantPro 与 easySales 连接

你在 MerchantPro 上销售，并希望有一个地方来管理订单、生成发票、向快递公司推送运单，并将相同的产品作为报价重新用于各平台？easySales 在一个仪表板中为你搞定这一切。

连接后，easySales 从 MerchantPro 拉取产品、变体和价格，并集中处理进来的订单。在这里，你可以生成发票、用任何支持的快递创建运单，并将这些产品转化为 eMAG、Allegro、Kaufland、Trendyol 以及 80+ 其他渠道的报价。库存和订单状态在双向上保持同步。

MerchantPro 通过 API 凭证连接，而不是通过可下载的插件。你在 MerchantPro 内部创建一个 API 用户——它会给你一个 API User 字符串和一个 API 密码——在 easySales 中启动向导，然后将它们作为单个令牌粘贴进去——无需安装模块、无需 FTP 访问、无需主题更改。

MerchantPro 连接器如何工作

easySales 通过 API 连接到你的 MerchantPro 商店，使用你在 MerchantPro 中创建并作为一个合并令牌粘贴到 easySales 的 API 用户和密码进行身份验证。easySales 使用该令牌读取你的目录和订单，而 MerchantPro 在订单或库存水平发生变化时通知 easySales——因此新订单和库存变动近乎实时到达 easySales。

就凭证而言，连接是单向的：easySales 调用 MerchantPro，从不反过来。你的 MerchantPro 管理员密码和店铺数据保留在 MerchantPro 中。你可以随时通过在 MerchantPro 中重新生成 API 凭证来撤销访问。

互动导览

不想阅读？体验互动导览。

互动演示——将 MerchantPro 与 easySales 连接

开始之前的准备

几项要求可防止产品在导入时被跳过。

✓

MerchantPro 管理员访问

你需要店铺的管理员权限以创建用于 easySales 身份验证的 API 用户和密码。

✓

运行中、可公开访问的商店

easySales 调用你的 MerchantPro 商店以读取目录和订单，因此店铺必须可从公共互联网访问——不要置于 HTTP basic auth、IP 允许列表或维护模式页面之后。

✓

每个产品和变体唯一的 SKU

两个具有相同 SKU 的产品或变体会冲突——只有一个会被导入。在连接前进行审核和去重，包括单独销售的变体组合。

✓

每个产品的数字库存

每个产品的库存必须是数字值。库存为空或非数字的产品在导入时会被跳过。

✓

easySales 账户

试用账户也可以。你从集成 → 在线商店连接商店。

第 1 步 — 在 MerchantPro 中创建 API 用户

在 MerchantPro 后台，打开 API users 页面并点击 Add API user。给它一个易于识别的内部引用（例如 easySales），授予读/写权限，并确保已启用。MerchantPro 然后为该用户显示两个值：API User（作为密钥的长字符串）和 API 密码（密钥）。两个都复制——你将在第 3 步在 easySales 中将它们合并为一个令牌。

MerchantPro 后台 API users 页面，已创建 easySales API 用户，显示 API User 字符串和被遮罩的 API 密码
在 MerchantPro 后台，打开 API users 并点击 Add API user——MerchantPro 显示 API User（密钥）和 API 密码（密钥）。

如果你的商店启用了可选的 MerchantPro 服务——例如 Multiple categories per product——记下是哪些，以便你可以在 easySales 中声明它们，并正确导入数据。

第 2 步 — 在 easySales 中启动向导并配置站点

在 easySales 中，进入 集成 → 在线商店，然后从平台网格中选择 MerchantPro 并确认版本。填写站点详细信息——表单收集 easySales 驱动集成所需的一切。

easySales 集成 → 在线商店界面，已选择 MerchantPro，显示可选服务下拉菜单和 Website Token 字段
在 easySales 中，打开集成 → 在线商店并选择 MerchantPro——然后填写站点详细信息、可选服务和 Website Token。

网站名称和 URL

  • 网站名称 — 你选择的标签。仅在 easySales 内可见。
  • 网站 URL — 你的 MerchantPro 商店。使用商店运行的确切 URL，包括 https://，如果你的域名使用 www 前缀也要加上。

增值税和运费增值税

如果你是增值税纳税人，输入适用于你产品的税率和单独的运费税率（例如对应罗马尼亚当前标准税率的 21）。如果你不是增值税纳税人，请留空。你在此处设置的税率正是 easySales 在发票和发送到平台的报价中使用的值，也应用于导入订单的运费和折扣行——设置两个字段以使订单合计能够对账。

语言和货币

选择商店语言和货币（RON、BGN、HUF、PLN 或 EUR）。它们作为导入产品的默认值，以及当订单未携带明确货币时的回退。它们从不覆盖单个订单——每个订单保留 MerchantPro 报告的货币。

产品库存来源

表单上最重要的决定。它告诉 easySales 权威库存值在哪里：

  • 网站 — MerchantPro 是事实来源。easySales 从 MerchantPro 读取库存且从不覆盖它。
  • easySales — easySales 是事实来源。easySales 内的库存变更（销售、手动编辑、平台扣减）会推送到 MerchantPro。
  • 已连接的集成 — 你的库存位于已与 easySales 连接的第三方系统中（开票软件、ERP、履行合作伙伴）。easySales 从该集成读取库存并推送到 MerchantPro。先连接集成并声明其仓库——否则无法选择此选项。

经营多仓库业务？切换到 高级仓库 模式。不是将商店绑定到一个库存来源，而是选择一个或多个 easySales 仓库，并定义它们的库存如何按渠道聚合、优先排序或拆分。

第 3 步 — 添加可选服务并粘贴令牌

向导的 MerchantPro 步骤收集两件事：你的商店已启用的可选服务，以及 easySales 用于身份验证的令牌。

在 MerchantPro 中启用的可选服务

选择你的商店使用的额外 MerchantPro 选项。今天唯一可用的是 Multiple categories per product — 如果你已在 MerchantPro 中启用它，请在此处启用，以便产品将所有类别带入 easySales，而不仅仅是主类别。

Website Token

按照这个确切的格式将第 1 步的凭证合并为一个令牌：

将结果粘贴到 Website Token 字段中并继续。easySales 在保存前会实时对 MerchantPro 验证令牌——如果 API 用户、密码或商店 URL 错误，你将在此步骤看到错误，而不是静默损坏的连接。验证通过后，保存以完成。

连接后会自动发生什么

保存连接会启动初始导入并开启持续同步。

  1. 你的产品目录被导入——产品及其变体出现在 在线商店 → 产品 中，你可以在此浏览、编辑并将它们变成各平台的报价。
  2. 进来的 MerchantPro 订单出现在 订单 界面中，你可以在此生成发票、运单并运行自动化流程。
  3. 来自 MerchantPro 的订单和库存变更近乎实时到达 easySales，因此两个系统无需手动刷新即可保持对齐。
  4. 库存根据你选择的来源同步。如果你选择了 easySales，库存推送持续运行，你的 MerchantPro 商店反映集中化的库存。
从 MerchantPro → easySales 从 easySales → MerchantPro
订单（创建、更新、取消） 库存更新
产品和变体 订单状态变更
库存水平 已交付状态（可选）
产品价格 运单和快递详情
类别 —
订单折扣 —
客户详情和地址 —
订单中的自提柜 ID —
双向同步——订单入站，库存/状态/履行/运单详情出站。

微调 MerchantPro 连接

保存后，打开 MerchantPro 网站的 偏好设置 标签页。三组设置值得快速过一遍。

Order Behavior

  • Allow reopening completed orders — 默认情况下，终态状态无法返回到活动状态。如果你需要重新打开订单，请启用。
  • Allow reopening cancelled orders — 对已取消订单的相同逻辑（当临时取消的未付款订单最终被支付时很有用）。

Synchronization

  • Fetch orders — 自动导入新的 MerchantPro 订单。
  • Update order status on MerchantPro — 将状态变更从 easySales 推送回 MerchantPro，使两个系统保持同步。
  • Update product stock on MerchantPro — 将 easySales 库存水平推送到你的 MerchantPro 商店。如果 MerchantPro 是你的库存来源，请关闭。

MerchantPro 特有选项

  • Fetch variant options as product properties — 将每个变体的选项值（尺寸、颜色等）作为 easySales 中的产品属性导入，以便它们传递到平台报价。
  • Fetch custom data as product properties — 将 MerchantPro 自定义字段作为额外的产品属性导入。
  • Discount items as individual lines — 将订单级折扣作为单独的行导入，而不是将其折算入产品价格。如果你的折扣到达时归属于错误的行，请启用。
  • Send delivered status — 当快递员确认交付时，将 已交付 状态推送回 MerchantPro 中的订单，使你的商店无需手动更新即可反映履行。

点击页面底部的 保存 以应用更改。

你已连接——下一步是什么

订单开始到达后，下一步是自动化。设置流程以生成发票、创建运单和发送跟踪通知。如果你也在各平台销售，将你的 MerchantPro 目录转化为报价，让 easySales 帮你推送出去。

无需信用卡
14 天免费
您可以随时取消

几分钟内连接你的 MerchantPro 商店

免费试用 easySales 14 天。无需信用卡，无需代码更改。

开始免费试用

常见问题

这是最常见的 MerchantPro 问题，几乎总是归结于产品数据。首先，SKU：没有 SKU 的产品或变体，或与另一个产品共享 SKU 的产品，在导入时会冲突——easySales 按 SKU 跟踪产品，因此重复意味着只有一个存活下来。其次，库存：库存为空或非数字的产品会被跳过。第三，可访问性：如果商店置于 HTTP basic auth、IP 允许列表或维护模式之后，easySales 根本无法读取目录。在 MerchantPro 中审核 SKU 和库存，然后在 easySales 中触发手动产品重新抓取。如果特定产品仍未出现，请打开 easySales 中的错误页面以查看哪些产品验证失败以及原因。

在网站的偏好设置选项卡中检查三件事。首先，库存来源：如果将 MerchantPro 设置为事实来源，easySales 从中读取库存且从不写回——要让 easySales 将库存推送到 MerchantPro，来源必须是 easySales 或已连接的集成。其次，Synchronization 开关：「Update product stock on MerchantPro」必须开启才能进行库存推送，并且库存和价格更新仅在连接处于活动状态时流动。第三，变体必须在 MerchantPro 端被识别——MerchantPro 报告为未同步的变体的库存更新会被拒绝。如果一切设置都正确而更新仍未到达，easySales 中的错误页面会显示 MerchantPro 返回的拒绝原因。

easySales 将每个可售 MerchantPro 变体作为单独的变体导入，并与父产品绑定。父产品提供标题、描述、图片和类别；每个变体携带自己的 SKU、价格、库存和选项值。要将每个变体的选项值（尺寸、颜色等）作为产品属性带入 easySales——以便它们传递到平台报价——在网站的偏好设置选项卡中启用「Fetch variant options as product properties」。当 MerchantPro 提供 EAN 时，按变体导入；如果变体在 MerchantPro 中没有 EAN，easySales 会无 EAN 导入它，你可以稍后添加。

从 Synchronization 选项卡开始：「Fetch orders」必须开启。接下来，确认连接令牌仍然有效——如果 API 用户或密码在 MerchantPro 中被轮换而未在 easySales 中更新令牌，连接会静默停止。除了配置之外，单个订单在导入时可能验证失败：缺失或未映射的地址字段（例如无法解析的县）会停止该特定订单，而其他订单则正常通过。easySales 中的错误页面列出每个失败的订单和原因，以便你可以在 MerchantPro 中修复源数据并让它重新导入。

默认情况下，MerchantPro 折扣应用于订单合计中。如果你的折扣到达时附加到错误的行——例如折扣显示为产品而不是减免——在网站的偏好设置选项卡中启用「Discount items as individual lines」。然后 easySales 将每个折扣作为自己的行导入，从而保持订单合计和增值税细分准确。每当导入订单的合计与客户在 MerchantPro 上支付的金额不匹配时，这就是要使用的设置。

连接表单上有两个字段驱动它：产品增值税税率和单独的运费增值税税率。easySales 将它们应用于导入订单的相应行和发出的平台报价，因此如果其中任何一个为空或设置为错误的值，运费或折扣行可能携带错误的增值税并且订单总额无法对账。设置这两个字段以匹配你的 MerchantPro 商店收取增值税的方式。如果折扣特别看起来不对，还要打开「Discount items as individual lines」，以便折扣作为自己的行进行税务处理，而不是混入产品价格中。

你可以为 easySales 中支持的任何快递生成运单，运单和快递详细信息会被推送回 MerchantPro 订单，因此你的商店显示正确的承运人和跟踪信息。如果你的商店使用受支持的自提柜网络（Sameday、DPD 等），easySales 会自动从订单中读取自提柜 ID，并在生成运单时将其用作交付点。要关闭履行循环，请在网站的偏好设置选项卡中启用「Send delivered status」——当快递员确认交付时，easySales 会将已交付状态推送到 MerchantPro 中的订单。

本指南对你有帮助吗?