网店平台集成

如何将 Selesto 连接到 easySales:网店设置指南

如何将 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 密钥

  1. 在 Selesto 后台,进入 Ustawienia → Integracje → Pozostałe → API Selesto。
  2. 为 easySales 添加一个应用,并生成它的 API 密钥。
  3. 复制密钥。它以 sk_ 开头。

第 2 步 — 在 easySales 中添加店铺

进入 整合方式 → 网站,点击 连结网站。填写店铺信息:

店铺信息表单(英文界面):Website Name 为 Demo Webshop,Website URL 为 https:// sklep-demo.selesto.eu,Country 为 Poland,Price Vat 为 23%,Shipping Vat 为 23,Language 为 Polish,Currency 为 Polish Zloty,Inventory source 为 Clasic warehouse 并选择 Website,附有关于库存的说明,Implicit package type 为 Parcel,Invoice Series 为 SL。
店铺信息,以 Website 作为库存来源。
字段 填写内容
网站名称 店铺名称,在 easySales 内部使用。
网址 你的店铺地址 —— 你自己的域名或 selesto.eu 地址。
国家 店铺所在国家,即波兰。
增值税价格 你在 Selesto 中的价格所含的增值税税率,通常为 23%。
运输增值税 运费的增值税税率。
语言、货币 店铺的语言和货币。
新订单自定义状态 可选:新的 Selesto 订单在 easySales 中获得的自定义状态。
库存来源 店铺库存的管理位置:带有 Website 或 EasySales 等来源的 经典仓库,或 高级仓库。
隐式封装类型 新订单获得的包裹类型,在为订单生成物流标签时使用。
发票系列 你为该店铺订单开具的发票所用的系列。
店铺信息

第 3 步 — 输入 API 密钥

在店铺信息下方,选择 Selesto 图块,再选择 Selesto 版本。在 细节 选项卡中,把密钥粘贴到 API密钥,然后点击 保存。

Selesto 的 Details 选项卡(英文界面),显示 Connection successful,API Key 为 sk_4f8a2c9e7b1d6053a8e2f9c4b7d1a6e3,并有 Delete 和 Save 按钮。
来自 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 中为每个变体设置各自的编码。
提示信息及处理方法

常见问题

在 Selesto 后台的 Ustawienia → Integracje → Pozostałe → API Selesto 中:添加一个应用并生成它的密钥。密钥以 sk_ 开头。

它没有商品编码,或者另一个商品使用了相同的编码。请在 Selesto 中为每个变体设置各自的编码,商品会在下一次导入时进入。

不可以。价格每 30 分钟从 Selesto 读取一次,请在你的店铺中修改。

Completed、Canceled 和 Return。其他状态不会发送。

不会。如果你希望买家在 Selesto 中看到物流单号,请在 Selesto 中添加。

如果你的库存由 Selesto 管理,选择 Website:easySales 每 30 分钟读取一次,并把在 easySales 中发生的每次变动发回。如果你的库存由 easySales 管理,选择 EasySales:店铺会从 easySales 接收库存。

每分钟一次,在 Selesto 确认之后。

本指南对你有帮助吗?