IdoSell连接easySales指南 — 设置、同步与Webhooks

easySales直接连接到您的IdoSell商店，自动导入订单和产品，让您从单一控制面板管理一切。本指南将引导您完成从在IdoSell中生成API密钥到启用实时Webhooks和物流追踪的全部设置过程。

为什么要将IdoSell连接到easySales

如果您在多个渠道销售 — 自己的IdoSell商店加上Allegro、Amazon、eMag、Kaufland或eBay等欧洲市场 — 跨所有渠道管理订单和库存很快会变得不堪重负。将IdoSell连接到easySales为您提供：

• 集中订单管理 — IdoSell商店的订单与市场订单一起显示在同一个地方
• 自动库存同步 — 当easySales中的库存发生变化时，更新的数量会自动推送回IdoSell。不再超卖
• 多渠道产品管理 — 管理一次产品目录，同时发布到IdoSell和100多个市场
• 统一发货和履行 — 跨所有渠道生成运输标签、追踪交付和管理退货
• 自动化流程 — 设置当IdoSell订单到达时自动触发的规则
• ERP和发票 — 连接您的会计或ERP系统到easySales并自动生成发票。您还可以使用easySales Billing直接在平台内生成发票

互动演示

不想阅读？试试互动演示。

开始之前您需要什么

• 具有管理员权限的活跃IdoSell账户
• 访问IdoSell管理面板
• easySales账户（免费试用即可）

在IdoSell中生成API密钥

1. 登录IdoSell管理面板
2. 导航至 设置 → API → Admin API访问密钥
3. 点击 添加新密钥（或编辑现有密钥）
4. 确保密钥具有OMS（订单）、PIM（产品）和CMS（客户）的 读取权限
5. 复制生成的API密钥

将IdoSell连接到easySales

1. 在easySales账户中，前往 集成 → 网站
2. 点击 连接网站
3. 从平台列表中选择 IdoSell
4. 输入 IdoSell商店URL（例如 https://yourshop.idosell.com）
5. 粘贴之前生成的 API密钥

保存前，配置网站一般设置：

• 语言 — 选择IdoSell商店的语言
• 国家 — 选择商店运营所在的国家
• 默认增值税税率 — 设置适用于产品和运输的默认税率
• 货币 — 选择商店货币
• 库存来源 — 选择easySales如何管理此网站的库存。经典仓库每个产品使用单一库存值，高级库存来源允许从多个仓库独立管理库存
• 默认自定义状态 — 如果您在easySales中使用自定义订单状态，选择IdoSell新订单默认接收的状态

如果尚未在easySales中定义自定义状态或仓库库存来源，可以暂时跳过这些字段，稍后配置。

填写所有设置后，点击 保存。easySales将验证连接并开始导入数据。

配置偏好设置

商店范围

如果您的IdoSell账户管理多个商店，您可以选择从所有商店还是仅从特定商店同步数据。

• 所有商店 — 导入所有商店的订单和产品
• 选定商店 — 仅导入所选商店的数据

产品库存来源

此设置在库存来源设置为 经典仓库 时适用：

• 单一仓库 — 库存值来自一个特定仓库
• 所有仓库之和 — 库存值是所有仓库的合计总数

同步如何工作

• 订单（IdoSell → easySales）— 每1分钟
• 产品（IdoSell → easySales）— 每6小时
• 库存水平（IdoSell → easySales）— 每30分钟
• 库存更新（easySales → IdoSell）— 变化时即时
• 类别（IdoSell → easySales）— 每6小时

同步自动开始。您可以在 同步偏好 部分配置同步操作。

设置Webhooks进行实时同步

默认情况下，easySales定期轮询IdoSell商店。Webhooks增加了更快的层面：IdoSell在变化发生的瞬间将其推送到easySales。

Webhooks与轮询并行工作 — 您不需要选择其一。

步骤1：在easySales中启用Webhooks

1. 前往 集成 → 网站
2. 点击IdoSell连接上的 编辑 图标
3. 打开 偏好设置 选项卡
4. 开启 Enable IdoSell Webhooks
5. 将出现两个Webhook URL — 一个用于订单，一个用于产品
6. 使用旁边的复制按钮 复制两个URL

步骤2：在IdoSell中配置Webhooks

1. 在IdoSell管理面板中，前往 设置 → API → Admin API访问密钥
2. 编辑 用于easySales的API密钥
3. 点击 添加Webhook
4. 对于 订单Webhook：
   • 名称： easySales Orders
   • URL： 粘贴从easySales复制的订单Webhook URL
   • 事件： 选择所有订单事件 — orderCreated、orderUpdated、orderPaid、orderStatusUpdated、orderPackageCreated、orderSent、orderDelivered、orderCanceled
5. 保存，然后添加 第二个Webhook 用于产品：
   • 名称： easySales Products
   • URL： 粘贴产品Webhook URL
   • 事件： 选择所有产品事件 — productCreated、productPriceUpdated、productStockUpdated、productDispositionUpdated
6. 保存更改

IdoSell现在将实时向easySales推送更新。

测试Webhooks

IdoSell提供内置的Webhook测试功能。保存配置后点击 测试 按钮。

如果Webhook投递失败，IdoSell自动重试 — 第一小时每10分钟，然后每小时持续23小时。

追踪物流状态

如果您通过IdoSell的内置快递集成（InPost、DHL、GLS等）管理发货，easySales可以直接在订单上显示每个包裹的配送状态。

启用物流状态同步

1. 前往IdoSell连接的 偏好设置 选项卡
2. 开启 Sync shipment status

• delivery_62099969xxxxxx — 已送达（InPost）
• delivery_PKG-98xxx — 已发货（GLS）

状态自动更新 — 从 标签已创建 到 已发货 到 已送达。