如何将 Magento 与 easySales 连接：完整集成指南
把 Magento 1 或 Magento 2 店铺连接到 easySales：填写连接表单、安装模块、粘贴令牌，并了解两个方向各自同步什么、多久一次。
连接 Magento 能带来什么
easySales 会读取你的 Magento 商品目录——产品、价格、库存、分类和属性——并据此在你销售的各个市场平台上创建并维护商品报价。订单则沿相反方向回流，汇入同一个列表，你在那里开票并生成运单，无需在店铺里额外添加任何东西。
重点不是第一次导入，而是连接在那之后仍持续工作：库存随着销售而变动，订单状态回写到 Magento，某件商品售罄时报价会自动下架。
开始之前
你的 Magento 店铺后台权限
你需要能进入 Stores → Configuration（Magento 2）或 System → Configuration（Magento 1）才能粘贴令牌。
一种把文件上传到服务器的方式
SFTP、SSH 或主机商的文件管理器。Magento 2 还需要用 SSH 执行一条命令；Magento 1 不需要。
整个商品目录中唯一的 SKU
easySales 靠 SKU 把 Magento 产品与自己的产品对应起来。两个共用同一个 SKU 的产品无法同时导入。
以数字形式保存的库存
库存是文字或留空的产品会被跳过。
手边备好你的增值税税率
连接过程中你要设定默认的产品增值税和运输增值税。
第 1 步 — 在 easySales 中添加店铺
进入 整合方式 → 网站，点击 连结网站。
这张表单没有任何一处是 Magento 专用的——每个店铺平台用的都是同一张表单。其中三个字段之后无法更改，因此值得第一次就填对。
| 字段 | 作用 |
|---|---|
| 网站名称 | 你为这家店铺起的标签。凡是 easySales 需要区分你的多家店铺的地方都会显示它，从你连接第二家店铺起就很重要。 |
| 网址 |
你的店铺前台地址。按照站点实际提供的协议选择 http:// 或 https://，如果站点强制带 www 就要写上——这里出现跳转就等于连接测试失败。
|
| 国家 | 店铺所在国家。它决定下一个字段可选哪些增值税税率。之后无法更改。 |
| 增值税价格 | 对未携带税率的产品所适用的增值税税率。从你所在国家的税率中选择，不能手动输入。 |
| 运输增值税 | 订单未携带税率时，对配送所适用的增值税税率。 |
| 语言 | 店铺的语言。之后无法更改。 |
| 货币 | 你的 Magento 价格所使用的货币。之后无法更改。 |
| 新订单自定义状态 | 可选。让每一笔导入的订单直接进入你自定义的某个状态，而不是默认状态。 |
| 库存来源 | 以哪里的库存数量为准。参见表格下方的说明。 |
| 隐式封装类型 | 信封或包裹，作为为这些订单生成运单时的默认值。 |
| 发票系列 | 当 Magento 未提供发票系列时，本店铺订单所使用的开票系列。 |
第 2 步 — 先选 Magento，再选版本
表单下方是一排平台徽标。选择 Magento，会出现第二行，询问你的店铺运行的是哪个版本。
两个版本都受支持，两个模块也都可以下载：
| 版本 | 安装方式 | 订单回传 | 文档回读 |
|---|---|---|---|
| Magento 2 |
上传到 app/code/，然后执行 setup:upgrade
|
支持，需较新模块 | 支持 |
| Magento 1.7 – 1.9 | Magento Connect Manager | 不支持 | 不支持 |
第 3 步 — 安装模块
选定版本后会打开一个三步向导：下载模块、上传模块、配置。
Magento 2
下载压缩包，解压后把文件夹上传到服务器的 app/code/ 下。最终路径必须正好是：
app/code/EasySales/Integrari/
然后通过 SSH 连接并启用模块：
php bin/magento setup:upgrade
最后在 System → Cache Management → Flush Magento Cache 中清除缓存。
Magento 1
Magento 1 的模块改为通过 Magento Connect 安装。在店铺后台进入 System → Magento Connect → Magento Connect Manager，重新输入登录信息，用 Direct package file upload 上传你下载的压缩包。
随后在 System → Cache Management 中清除缓存，并且——这一步确实是必须的——退出 Magento 后台再重新登录。不这样做，模块的菜单不会出现。
第 4 步 — 在 Magento 内配置模块
在店铺后台打开模块设置。Magento 2 位于 Stores → Configuration 下的 easySales 区块；Magento 1 位于 System → Configuration 下，靠近列表底部。
把向导 配置 这一步里的令牌粘贴到 网站令牌 字段中。
| 设置项 | 作用 |
|---|---|
| 网站令牌 | 必须与 easySales 向导中显示的令牌完全一致。两个系统之间的每一次调用都靠它来鉴权。 |
| 导出的店铺范围 | 导出哪个 Magento store view 的产品和订单。默认取第一个——如果你有多个，请有意识地设定。 |
| 库存来源 | easySales 从哪个 Magento 库存来源读取数量。 |
| 发票系列 | 随每一笔订单一起传给 easySales 的系列。 |
| EAN / 品牌 / 仓库库位 | 这几项分别由哪个 Magento 产品属性保存。不使用就留空。 |
| 重量和尺寸 | 由哪些属性保存重量和尺寸，以及使用什么单位。如果你的快递按体积计费就需要填写。 |
先在 Magento 中保存，再在 easySales 中点击 保存。easySales 会调用你的店铺来校验令牌，并告诉你结果。
第 5 步 — 确认连接
已连接的店铺会在 整合方式 → 网站 下显示为一张卡片，上面有平台、令牌、店铺上报的模块版本，以及一个 积极的 开关。
如果店铺没有响应，保存会以红色的 连接失败 提示告终，而不会悄悄保存。这几乎总是三种情况之一：Magento 中的令牌与 easySales 中的不一致、模块未启用，或者店铺无法通过你填写的网址从公网访问。
同步哪些内容，多久一次
这些都不需要你去排程，也没有任何刷新频率的设置项要配置。
| 内容 | 方向 | 频率 |
|---|---|---|
| 订单 | Magento → easySales | 每分钟 |
| 库存 | Magento → easySales | 每 30 分钟 |
| 价格 | Magento → easySales | 每 30 分钟 |
| 产品 | Magento → easySales | 每 6 小时 |
| 分类和属性 | Magento → easySales | 每 6 小时 |
| 订单状态、发货、运单 | easySales → Magento | 每分钟 |
| 库存数量 | easySales → Magento | 每分钟 |
有哪些内容会回流到 Magento
只有三样，也仅有三样：订单状态（订单完成后连同发货信息与运单追踪号）、库存数量，以及——在 Magento 2 上并使用较新模块时——完整的新订单。
产品名称、描述、图片、价格和分类不会被写回。easySales 只从 Magento 读取它们，不会覆盖，因此 Magento 始终是你编辑商品目录的唯一地方。
让连接保持健康
关注模块版本。 卡片上显示的是你的店铺上报的版本。有新版本发布时，卡片会变红并显示 需要更新。在 Magento 2 上，你把新压缩包覆盖安装到旧的之上，再次运行 setup:upgrade；在 Magento 1 上，先在 Magento Connect Manager 中卸载旧扩展，再安装新的。两种方式设置都会保留。
错误集中在一个地方。 产品 → 网上商店 → 网站错误 会列出两个方向上所有保存失败的记录，每一行都带有重试和忽略操作，并可按店铺批量重新发送。
SKU 是匹配的钥匙，请保持稳定
easySales 通过 SKU 匹配 Magento 产品，而且这种匹配是永久的。你在 Magento 里改了某个产品的 SKU，easySales 就会把它当作新产品导入——旧的仍然留着，连同挂在上面的报价。
如果需要查找重复项，用 产品 → 网上商店 → 产品 页面上的下载按钮，然后在导出文件中检查重复的 SKU。