如何连接 Erli 与 easySales：完整设置指南
将 Erli 连接到 easySales：来自 moje Erli 的 API 密钥、增值税设置、关联已有报价、发送新产品，以及 Erli 返回的拒绝原因。
连接 Erli 能为你带来什么
Erli 是波兰的交易市场，如果你面向波兰市场做跨境销售，这个集成才有意义。连接 easySales 后，它会把你的 Erli 订单导入 easySales，把你的产品作为报价上架到 Erli，并让它们的价格和库存保持最新。你在 Erli 上已有的报价也会一并导入。
开始之前，有两点需要了解：
- 你在 Erli 上已有的报价必须关联到你的产品。 它们导入时是未关联的。在你关联之前，它们不会从 easySales 获得价格或库存，针对它们的订单进入时也没有产品，因此不会预留库存。
- 默认税率就是每笔 Erli 订单的增值税。 easySales 用它拆分每笔 Erli 订单的每一行，因此请把它设为你实际的增值税税率——在波兰，大多数商品为 23。
开始之前
一个 Erli 卖家账户
能够访问 moje Erli，你将在那里生成 API 密钥。
能够匹配的 SKU 或 EAN
自动链接按 SKU、EAN 或名称在你的产品中找到你现有的 Erli 报价。
你的增值税税率
默认税率会应用到每笔 Erli 订单，因此你需要清楚自己销售时适用的税率。
第 1 步 — 在 moje Erli 中生成 API 密钥
- 登录 moje Erli，也就是你的 Erli 卖家后台。
- 打开 Ustawienia sklepu，再在左侧菜单中打开 Metoda Integracji。
- 选择 Własna integracja po API 卡片。
- 在 Opis klucza 中为密钥输入一个描述——例如
easySales——然后点击 Wygeneruj nowy klucz。 - 复制密钥。这就是 easySales 要求填写的 应用令牌。
第 2 步 — 在 easySales 中连接 Erli
进入 整合方式 → 交易市场，搜索 erli，在 Erli 卡片上点击 连接——如果之前连接过，则点击 编辑。
在 主要设置 标签页中填写表单：
| 字段 | 填写内容 |
|---|---|
| 连接名称 |
一个便于你在 easySales 中识别的名称，例如 Erli Demo Store。
|
| 新订单自定义状态 | 可选。新的 Erli 订单导入时获得的、你自己创建的自定义状态。 |
| 价格加成 | 在产品价格基础上为 Erli 增加的百分比。 |
| 默认税率 | 你的 Erli 订单中每一个产品行的增值税税率——波兰增值税纳税人为 23。 |
| 默认运费 | 你的 Erli 订单中运费的增值税税率。 |
| 发票系列 | 开具发票时 Erli 订单使用的发票系列。 |
| 应用令牌 | 来自 moje Erli 的 API 密钥。 |
点击 保存。easySales 会向 Erli 校验应用令牌，并在首次保存时开始导入你的 Erli 报价和订单。
第 3 步 — 附加设置
表单上方的 附加设置 标签页里还有三个开关。
| 设置 | 作用 |
|---|---|
| 向市场平台发送报价价格 | 设为「是的」时，Erli 上的价格与 easySales 保持同步。设为「不」时，报价首次发送后不再更新价格。 |
| 向市场平台发送报价库存 | 设为「是的」时，Erli 上的库存与 easySales 保持同步。设为「不」时，报价首次发送后不再更新库存。 |
| 当产品有库存时自动启用报价 | 产品重新有库存时，重新启用它的报价。 |
第 4 步 — 关联你在 Erli 上已有的报价
你现有的 Erli 报价会被导入到 交易市场 → 优惠 的 Erli 标签页。导入的报价显示为灰色，并标记为未关联，直到你把它绑定到 easySales 中的某个产品。
- 报价行上的 关联 会把这一条报价绑定到你选择的产品。
- 链接到产品 对你选中的报价执行同样的操作。
- 交易市场 → 自动链接 按 SKU、EAN 或名称把你的 Erli 报价与产品批量匹配。
关联不会改动 Erli 上的报价。报价关联后，easySales 会向它发送产品的库存，之后针对它的新订单也会带上产品。
第 5 步 — 把产品发送到 Erli
打开 产品 → 虚拟商店 → 产品，按 没有优惠 → Erli 筛选，只显示尚未上架 Erli 的产品。然后在某个产品下点击 添加报价，或选择多个产品后使用 在...上添加优惠。
easySales 会把产品连同名称、描述、图片、EAN、SKU、价格、库存和重量发送到 Erli，放在你为它选择的 Erli 分类中。请先在 分类目录 中把你的分类映射到 Erli 的分类，并填写 Erli 在该分类中要求的属性。在发送任何内容之前，easySales 会检查产品是否有名称（3101 Missing name）以及至少一张图片（3102 Missing images）。
来自 Erli 的订单
- 新订单 每分钟抓取一次，连接上的 同步订单 可以按需抓取最近最多 30 天的订单。
- 每笔订单都会导入：已被 Erli 取消的订单以「已取消」进入，已退货的订单变为「退回」，已在 Erli 上发货的订单以「已完成」进入。
- 客户：公司订单会带有公司名称及其 NIP；买家的留言在订单的备注中。
- 包裹柜：寄往包裹柜的订单会带有买家选择的包裹柜。
- 增值税：订单中的产品按连接上的 默认税率 拆分增值税，运费按 默认运费 拆分。
报价被拒绝时
Erli 的答复显示在报价的 错误 列中，位于 3100 Product reject by Erli 之下，使用波兰语。你最可能看到的是以下几条：
| Erli 消息的结尾 | 处理方法 |
|---|---|
| externalCategories[0].breadcrumb[0].id must be a string | 产品没有 Erli 分类。请在 分类目录 中映射它的分类，或在报价上选择一个 Erli 分类，然后重新发送。 |
| externalVariantGroup.attributes must contain at least 1 items | 该产品是一个变体，Erli 需要其各变体之间不同的那个属性，例如颜色或尺码。请在报价上填写后重新发送。 |
| description must be one of [object, string] | 产品没有描述。添加描述后重新发送报价。 |