如何将 Selesto 连接到 easySales:网店设置指南
将你的 Selesto 店铺连接到 easySales:API 密钥、唯一商品编码、双向同步的内容(订单、状态、商品、价格和库存)以及常见问题的解决方法。
Selesto 连接能做什么
Selesto 是一个波兰的网店平台。将它连接到 easySales 后,你店铺的商品和订单会进入 easySales,库存会在店铺和你的其他销售渠道之间保持一致;当你在 easySales 中完成、取消订单或将订单标记为退货时,Selesto 也会做同样的标记。
开始之前需要了解三件事:
- easySales 通过 Selesto 后台生成的 API 密钥进行连接。 你可以在 Ustawienia / Integracje / Pozostałe / API Selesto 中生成,密钥以
sk_开头。 - 每个变体都需要自己的商品编码(Kod),并且在整个店铺中唯一。 easySales 通过这个编码识别商品。没有编码的商品不会被导入;两个商品编码相同时,只有第一个会进入 easySales。
- 商品和价格仍在 Selesto 中管理。 easySales 从店铺读取它们,不会在那里创建商品,也不会修改价格。
开始之前
✓
Selesto 店铺的管理员权限
用于生成 API 密钥。
✓
每个变体都有唯一编码
Kod 已填写,且每个变体各不相同。
✓
你的店铺地址
你自己的域名或 selesto.eu 地址。
第 1 步 — 在 Selesto 中生成 API 密钥
- 在 Selesto 后台,进入 Ustawienia → Integracje → Pozostałe → API Selesto。
- 为 easySales 添加一个应用,并生成它的 API 密钥。
- 复制密钥。它以
sk_开头。
第 2 步 — 在 easySales 中添加店铺
进入 整合方式 → 网站,点击 连结网站。填写店铺信息:
| 字段 | 填写内容 |
|---|---|
| 网站名称 | 店铺名称,在 easySales 内部使用。 |
| 网址 |
你的店铺地址 —— 你自己的域名或 selesto.eu 地址。
|
| 国家 | 店铺所在国家,即波兰。 |
| 增值税价格 | 你在 Selesto 中的价格所含的增值税税率,通常为 23%。 |
| 运输增值税 | 运费的增值税税率。 |
| 语言、货币 | 店铺的语言和货币。 |
| 新订单自定义状态 | 可选:新的 Selesto 订单在 easySales 中获得的自定义状态。 |
| 库存来源 | 店铺库存的管理位置:带有 Website 或 EasySales 等来源的 经典仓库,或 高级仓库。 |
| 隐式封装类型 | 新订单获得的包裹类型,在为订单生成物流标签时使用。 |
| 发票系列 | 你为该店铺订单开具的发票所用的系列。 |
第 3 步 — 输入 API 密钥
在店铺信息下方,选择 Selesto 图块,再选择 Selesto 版本。在 细节 选项卡中,把密钥粘贴到 API密钥,然后点击 保存。
easySales 会通过你的店铺验证密钥。连接成功后,它开始读取店铺的分类、商品和订单。
同步哪些内容
| 从 Selesto 到 easySales | 从 easySales 到 Selesto |
|---|---|
| 分类和商品,包括价格、图片、描述和属性 | 库存 |
| 已确认的订单及其状态变化 | Completed、Canceled 和 Return 状态 |
| 库存(以 Website 作为库存来源时) | — |
- 订单 每分钟同步一次,在 Selesto 确认之后进入 easySales。自提点配送(InPost、ORLEN Paczka、DPD Pickup)会连同所选自提点一起进入。
- 来自 Selesto 的订单状态:新订单和已发货订单以 New 进入,已完成的以 Completed 进入,已取消的以 Canceled 进入,退货以 Return 进入。
- 发往 Selesto 的订单状态:当你在 easySales 中完成、取消订单或将订单标记为退货时,Selesto 会做同样的标记。其他状态不会发送。
- 商品和价格 每 30 分钟读取一次。在 Selesto 中设置的折扣会成为 easySales 中的促销价。每个商品都会带着它的主分类进入。
- 库存:以 Website 作为库存来源时,easySales 每 30 分钟读取一次店铺库存,并把在 easySales 中发生的每次变动(例如在电商平台上的一笔销售)发回 Selesto。以 EasySales 或高级仓库作为来源时,easySales 会把可用库存发送给店铺。
不交换的内容:物流单号、发票和退货。如果你希望买家在 Selesto 中看到物流单号,请在 Selesto 中添加。
出现问题时
| 提示信息 | 处理方法 |
|---|---|
| Connection failed. Make sure easySales module is properly configured. If you need assistance, please contact us. | 检查 API 密钥和网址。如果不确定旧密钥是否仍然有效,请在 Selesto 中生成新密钥。 |
| The product.sku field is required. | 该商品或其某个变体在 Selesto 中没有编码(Kod)。请填写编码,商品会在下一次导入时进入。 |
| 某个商品在 easySales 中缺失,且没有任何提示 | 另一个商品使用了相同的编码。请在 Selesto 中为每个变体设置各自的编码。 |