如何将 eMAG(罗马尼亚、保加利亚和匈牙利)与 easySales 连接:完整跨境集成指南
通过三步将你的 eMAG 卖家账户与 easySales 连接起来——在 eMAG 账户中将 easySales 加入白名单并复制 API 凭据,在 easySales 中打开连接表单,然后填入凭据和账户设置。集中管理来自罗马尼亚、保加利亚和匈牙利的 eMAG 订单,生成运单和发票,并将目录作为商品上架;将商品与目录关联后,库存和价格会自动同步。
为什么将 eMAG 与 easySales 连接
你在 eMAG 上销售,并希望在一个地方管理订单、生成发票、向快递公司推送运单,并保持商品列表同步?easySales 在一个仪表板中处理所有这些——覆盖 eMAG 罗马尼亚、eMAG 保加利亚和 eMAG 匈牙利。
连接后,eMAG 订单会自动流入 easySales。从这里,你可以生成发票、使用任何受支持的快递创建运单,并运行自动化流程。你的目录则沿相反方向流动:easySales 将你的产品作为 eMAG 商品发布,并持续更新库存和价格,因此你只需管理一份目录,而无需手动编辑每个列表。
你使用 eMAG 账户中的 API 凭据进行连接——无需安装插件,也无需开发人员访问权限。整个流程是:在 eMAG 中将 easySales 加入白名单并复制 API 凭据,在 easySales 中打开连接表单,粘贴凭据,然后保存。
eMAG 连接器的工作方式
easySales 通过 eMAG 的 Marketplace API 与 eMAG 通信,使用你卖家账户中的凭据进行身份验证。eMAG 仅接受来自你明确批准的 IP 地址的 API 调用,因此你要做的第一件事就是将 easySales 添加到 eMAG 账户的允许 IP 列表中。没有这一步,每次调用都会被拒绝,任何内容都不会同步。
同步大多是单向的,在开始之前理解这种分工很有价值:
- 订单流入。 easySales 大约每分钟检查一次 eMAG 是否有新订单和更新订单,因此它们会出现在你的订单屏幕上,可用于开票、运单和流程。
- 商品、库存和价格流出——一旦商品已关联。 easySales 是它所发布的库存和价格的真相来源。同步在连接的那一刻并不会自动进行:每个 eMAG 商品必须先关联到你 easySales 目录中的一个产品(下文详述)。eMAG 自己报告的库存会被读回以供参考,但 easySales 始终是它所推送数值的真相来源。
前置条件——开始前需要准备什么
几个要求可防止连接在首次同步时失败。
活跃的 eMAG 卖家账户
你需要一个具有 API 访问权限的有效 eMAG Marketplace 卖家账户。买家账户或仍在入驻中的账户无法连接。
在 eMAG 中将 easySales 加入白名单
eMAG 仅接受来自已批准 IP 地址的 API 调用。你需要在连接之前在 eMAG 中将 easySales 添加到账户的允许 IP 列表——否则调用会被拒绝。
手头备好你的 API 凭据
来自你 eMAG 账户 Technical details 标签页的用户名、密码和 API Code。你将把这三项全部填入 easySales。
干净的产品标识符
easySales 通过 SKU 跟踪产品,并通过零件编号 / EAN 将商品与 eMAG 匹配。在发布商品之前去重并验证标识符。
第 1 步——在 eMAG 中将 easySales 加入白名单并复制 API 凭据
eMAG 会拒绝来自任何无法识别的 IP 的 API 调用,因此请从 eMAG 一侧开始。
在你的 eMAG 卖家账户中,转到 My account → Technical details。在 Add new IP Address 下,添加 easySales 用于连接的两个 IP 地址——51.158.174.60 和 3.124.61.144——并逐个保存。(请始终将这些值与 easySales 在连接说明中显示的值进行核对,以防它们将来发生变化。)
在 Technical details 标签页上,复制你的 API Code 并记下你的 用户名 和 密码——你将在第 3 步将这三项全部填入 easySales。
第 2 步——在 easySales 中打开连接表单
在 easySales 中,转到 整合方式 → 交易市场。找到你要连接的国家对应的 eMAG——eMAG(罗马尼亚)、eMAG 保加利亚或 eMAG 匈牙利——并点击其卡片上的 连接。(如果你已经在另一个 eMAG 账户上销售,请打开卡片的 ⋮ 菜单并选择 添加账户。)
eMAG 设置表单会打开,包含两个标签页:主要设置(凭据和核心配置)和 附加设置(同步行为和可选功能)。你将首先在主要设置中操作。
第 3 步——填入凭据和账户设置
在 主要设置 标签页上,填写 easySales 驱动集成所需的凭据和配置。
凭据
- 用户名 和 密码——你 eMAG 卖家账户的登录信息。两者均为必填。
- 应用程序接口代码-可选(API Code)——你从 eMAG Technical details 标签页复制的 API 代码。该字段标记为可选,但请填入:它是 eMAG 识别你集成方式的一部分,可避免不必要的身份验证问题。
账户配置
- 连接名称——你选择的标签(例如 "eMAG RO")。仅在 easySales 内部可见,在你运行多个 eMAG 连接时很方便。
- 纳税国家——其增值税规则适用于你订单的国家(RO、HU、BG、GR 或 SK)。
- 增值税付款人(仅限 eMAG 罗马尼亚)——如果你已注册增值税,选择 "是";否则选择 "否"。在 eMAG 匈牙利和保加利亚的表单中,你改为通过默认税率字段设置增值税。
- 默认税率——应用于你商品和订单的默认增值税百分比。如果你不是增值税付款人,设为 0。(这是在 eMAG 匈牙利和保加利亚表单中显示的增值税字段。)
- 发票系列——导入的 eMAG 订单被分配的默认开票系列,与你在开票软件中使用的系列一致。
- 价格加成——在向 eMAG 发布商品时,可选地在你的产品价格之上添加的百分比。
- 隐式封装类型——为 eMAG 订单生成运单时使用的默认包裹(信封或包裹)。
- 交货天数——随你的商品发布的处理时间。从下拉列表中选择一个值(默认为 0)。
点击 保存 完成。
保存后会自动发生什么
连接测试通过后,easySales 会无需你进一步操作即设置好集成。
- 初始同步被安排——easySales 开始导入你最近的 eMAG 订单,以便你立即有可处理的内容。
- 从此时起,新的 eMAG 订单会在一两分钟内到达你的 订单 屏幕,可用于发票、运单和自动化流程。
- 你已经在 eMAG 上销售的任何商品都会被导入到 交易市场 → 商品(eMAG 标签页)——但它们 尚未同步。每个导入的商品必须先关联到你 easySales 目录中匹配的产品;只有关联的商品才会向 eMAG 发送库存、价格和内容更新。
订单是唯一自行流入的内容。你的列表是有意为之的第二步:将你导入的 eMAG 商品关联到你的目录(easySales 可以为你自动关联其中许多),对于你尚未在 eMAG 上销售的产品,映射它们的类别并将其作为新商品发布。一旦商品关联完成,easySales 从此持续更新其库存和价格。
| 从 eMAG → easySales | 从 easySales → eMAG |
|---|---|
| 订单(新建和更新) | 商品 / 列表 |
| 来自 eMAG 的订单状态变化 | 库存水平 |
| 报价状态、审核结果、Buy Button 排名和最优报价价格 | 价格 |
| — | 发票(启用时) |
| — | 订单状态——在你生成运单时最终确定 |
RO vs BG vs HU——每个国家连接一次
连接步骤对全部三个 eMAG 市场都相同。不同之处在于按国家区分的部分,而 easySales 在你选择正确的市场后就会处理好:
- API 端点(eMAG 罗马尼亚、保加利亚或匈牙利)。
- 默认货币——RO 为 RON,BG 为 BGN,HU 为 HUF。
- 账户本身——每个国家都是一个单独的 eMAG 卖家账户,因此每个在 easySales 中都有自己的连接。
在每个国家的 eMAG 账户中分别将 easySales 加入白名单并复制凭据,然后在 整合方式 → 交易市场 中为每个国家添加一个单独的连接。
微调你的 eMAG 连接
附加设置 标签页控制连接上线后 easySales 如何与 eMAG 同步。
日常最重要的选项:
- 向市场平台发送报价价格——将价格变化从 easySales 推送到你的 eMAG 商品。如果你直接在 eMAG 中管理价格,请关闭。
- 向市场平台发送报价库存——将库存水平推送到 eMAG。如果 eMAG 不从 easySales 读取库存,请关闭。
- 覆盖报价图片——用 easySales 中的图片替换现有 eMAG 商品上的图片。
- 从带自提柜配送的发票中排除运费——对配送到自提柜的订单,在发票上去掉运费行。
- 生成后向市场平台发送发票——easySales 生成每张发票后自动将其发送到 eMAG。
此标签页还涵盖可选的自动定价规则以及 eMAG 对某些产品类别要求的 GPSR 产品安全详情(欧盟代表和制造商信息)。设置一次,easySales 就会将其应用到你的商品上。
你已连接——下一步是什么
随着订单到达,下一步是自动化:设置流程来生成发票、创建运单并通知客户。
要将你的目录上架到 eMAG,请先将你的类别映射到 eMAG 的类别——在你的产品与正确的 eMAG 类别和特性匹配之前,商品无法发布。映射完成后,将你的产品转化为商品,让 easySales 发布并维护它们。