如何将 CloudCart 连接到 easySales：完整设置指南
将 CloudCart 店铺连接到 easySales：创建 API 密钥，设置增值税和库存来源，并了解每个方向同步哪些内容——商品、库存和订单——以及什么会导致同步停止。
连接 CloudCart 能为你带来什么
easySales 会读取你的 CloudCart 商品目录，并把它转换成可以发送到各个电商平台的报价；它还会读取你的 CloudCart 订单，让你可以和其他所有订单一起为它们开票、打印物流标签并打包。easySales 还会把库存同步回你的店铺，因此在电商平台上卖出的商品，在 CloudCart 中的库存也会随之减少。店铺中无需安装任何东西：连接只需要你在 CloudCart 后台创建的一个 API 密钥，把它粘贴到 API密钥 字段即可。
每个方向同步哪些内容
| 从 CloudCart 到 easySales | 从 easySales 到 CloudCart | |
|---|---|---|
| 商品 | 名称、描述、价格、图片、分类、特征、品牌、条形码、重量 | — |
| 库存 | 每个变体的数量 | easySales 中的库存（发生变化时） |
| 订单 | 新订单和已修改的订单，包括客户、地址、商品、运费和折扣 | 已完成和已取消的订单 |
| 价格、物流标签和发票 | — | 不发送 |
开始之前
具备 API 访问权限的 CloudCart 店铺
使用包含 API 的 CloudCart 套餐，且订阅已付费。
一个 API 密钥
在 CloudCart 后台的 Settings → API Keys 中创建，并设置足以支撑你店铺的 rate limit。
每个变体都有 SKU
每个商品和每个变体的 SKU 都不相同。
第 1 步 — 在 CloudCart 中创建 API 密钥
- 在 CloudCart 后台打开 Settings → API Keys。
- 为 easySales 创建一个密钥，确认它处于启用状态，然后复制它。你将在第 4 步把它粘贴到 easySales 中。
- 在同一页面上提高 rate limit——即该密钥每分钟可以发出的请求数。默认是每分钟 100 次请求，最高可以提高到 800 次。你的店铺商品和订单越多，需要的就越多。
第 2 步 — 填写店铺信息
在 easySales 中，进入 整合方式 → 网站，然后点击 连结网站。
表单会先打开店铺信息部分。截图中的数值属于一个演示店铺；你填写的应是你自己店铺的信息。
| 字段 | 填写内容 |
|---|---|
| 网站名称 | 你希望这个店铺在 easySales 中显示的任意名称。 |
| 网址 | 你店铺的地址，按下文所述填写。 |
| 国家 | 店铺所在的国家。连接保存后无法更改。 |
| 增值税价格 和 运输增值税 | 你的商品价格和运费中已包含的增值税税率。 |
| 语言 和 货币 | 店铺销售所用的语言和货币。两者在保存后即固定。 |
| 新订单自定义状态 | 可选。你自己的一个状态，来自该店铺的每个订单都会以此状态开始。 |
第 3 步 — 库存与开票
| 字段 | 作用 |
|---|---|
| 库存来源 — 经典仓库 | 每个商品一个库存数值，来自旁边选择的来源。选择 EasySales 时，由 easySales 管理库存并发送到 CloudCart；选择 Website 时，从 CloudCart 读取库存。 |
| 库存来源 — 高级仓库 | 库存分布在多个地点，并由规则决定订单从哪个地点出货。 |
| 隐式封装类型 | 来自该店铺的订单导入时使用的包裹类型，在生成物流标签时使用。 |
| 发票系列 | 该店铺订单开票所用的发票系列。 |
第 4 步 — 选择 CloudCart 并粘贴密钥
点击 CloudCart 图块，然后点击其下方的 CloudCart 版本。下方会打开 细节 步骤。
把第 1 步中的密钥粘贴到 API密钥 中，然后点击 保存。
现在，这个店铺在 整合方式 → 网站 中有了自己的卡片，并带有一个显示连接正常的标记。首次同步完成后，商品会开始出现在 网上商店 → 产品 中。
商品如何同步过来
CloudCart 中的每个变体都会在 easySales 中成为一个商品，并以其 SKU 识别。
| 来自 CloudCart | 进入 easySales |
|---|---|
| 名称和描述 | 名称和描述 |
| 变体 SKU | SKU |
| 条形码 | EAN |
| 供应商（vendor） | 品牌 |
| 价格及有效折扣 | 原价和促销价 |
| 数量 | 库存 |
| 分类和属性 | 分类和特征 |
| 图片和重量 | 相同——使用变体的图片；如果变体没有图片，则使用商品的图片 |
你在 CloudCart 中对商品所做的修改会在几个小时内到达 easySales，而不是立即同步——商品、分类和特征每六小时读取一次，折扣价每小时读取一次。
订单如何同步过来
订单在 CloudCart 中下单或修改后大约一分钟内就会到达，并带有客户、账单地址和收货地址、商品、运费和折扣。首次同步会导入最近一天的订单。easySales 每天还会四次重新读取最近四周的所有订单，因此你在 CloudCart 中更正过的订单无需任何操作就会同步过来。
| 在 CloudCart 中 | 在 easySales 中 |
|---|---|
| 待处理（pending） | 新的 |
| 已付款（paid） | 已收到 |
| 已完成（completed） | 已完成 |
| 已取消（cancelled） | 已取消 |
| 已退款（refunded） | 退货 |
| 货到付款 / 银行转账 / 其他付款方式 | 付款方式 货到付款 / 银行转账 / 在线 |
| 配送到 Speedy 或 Econt 网点，或 Sameday 自提柜 | 配送到该网点或自提柜 |
微调连接
在 整合方式 → 网站 中编辑该店铺，并打开它的 偏好设置。在 同步 下，你可以选择 easySales 是否从 CloudCart 获取订单，以及是否将订单状态和商品库存发送回 CloudCart。
当店铺停止同步时
| 你看到的内容 | 如何处理 |
|---|---|
| You do not have API access on your current plan | 更换为包含 API 访问权限的 CloudCart 套餐。 |
| Your plan allows 100 requests per minute | 在 CloudCart 的 Settings → API Keys 中提高 rate limit。 |
| You have failed payments | 支付 CloudCart 订阅费用。 |
| 某个订单缺失，因为它没有城市或街道 | 在 CloudCart 中补全该订单的地址；它会在下一轮同步时过来。 |
| 新分类中的某个商品缺失 | 等待下一次分类同步；商品会随之同步过来。 |
| Only paid and/or fulfilled orders can be marked as Completed | 在 CloudCart 中将订单标记为已付款或已履约，然后再次完成它。 |
如果 CloudCart 持续拒绝 easySales 的请求大约一小时，easySales 会停用该店铺，其在 整合方式 → 网站 中的卡片也会显示这一点。排除原因后，点击卡片上的 恢复连接。