如何将 OpenCart 与 easySales 连接：完整的跨境集成指南
只需三步即可将你的 OpenCart 商店与 easySales 连接——在 easySales 中启动向导并下载 OpenCart 模块，在 OpenCart 后台安装并刷新修改，然后将 easySales 的令牌粘贴回模块。集中管理订单、同步库存、自动生成发票和运单，并将同一目录作为报价上架到每个销售平台。
为什么要将 OpenCart 与 easySales 连接
你在 OpenCart 上销售，并希望有一个地方来管理订单、生成发票、向快递公司推送运单，并将相同的产品作为报价重新用于各平台？easySales 在一个仪表板中为你搞定这一切。
连接后，easySales 从 OpenCart 拉取产品和选项，并集中处理进来的订单。在这里，你可以生成发票、用任何支持的快递创建运单，并将这些产品转化为 eMAG、Allegro、Kaufland、Trendyol 以及 80+ 其他渠道的报价。库存和订单状态在双向上保持同步。
你将在 easySales 中启动向导，下载与商店版本相匹配的 OpenCart 模块，将其安装在 OpenCart 后台，然后将 easySales 的令牌粘贴回模块——无需代码、无需 FTP 访问、无需主题更改。
OpenCart 连接器如何工作
easySales 通过一个小型 .ocmod.zip 模块连接到 OpenCart，你从 easySales 账户下载该模块，并通过 OpenCart 后台安装。模块公开一个私有端点，easySales 调用该端点以读取你的目录和订单，并注册两个 webhook，使订单和库存变更近乎实时地到达 easySales。
模块从不主动外联。easySales 与它通信，使用 easySales 为每个站点生成的令牌进行身份验证。OpenCart 数据库凭证、管理员密码和支付网关密钥保留在你的 OpenCart 安装中。
easySales 支持哪些 OpenCart 版本
easySales 为每个 OpenCart 主要版本提供单独的模块构建，使集成与商店的 API 和后台布局相匹配：
- OpenCart 1.5.6.4
- OpenCart 2.0.0.0 – 2.1.0.2
- OpenCart 2.2.0.0
- OpenCart 2.3.0.0 – 2.3.0.2
- OpenCart 3.0.0 – 3.0.2.0
- OpenCart 4.0 – 4.1.0.3
当你选择版本时，向导会挑选对应的构建。如果你处于两个版本之间的补丁版本（例如 2.3.0.1），将使用最接近的较低版本的构建。OpenCart 的分支发行版和较旧的 1.5.x 补丁级别不在官方支持范围内——模块可能可以安装，但后台路径可能不同。
互动导览
不想阅读？体验互动导览。
开始之前的准备
几项要求可防止产品在导入时被跳过。
OpenCart 管理员访问
你需要店铺的管理员权限以安装模块、刷新修改和读取生成的令牌。
受支持的 OpenCart 版本
easySales 为 OpenCart 1.5、2.0–2.1、2.2、2.3、3.0 和 4.0 提供构建。分支发行版和不支持的补丁级别可以安装，但无法保证。
公开可访问的店面
easySales 调用 OpenCart 商店以读取目录和订单，因此店面必须可从公共互联网访问——不要置于 HTTP basic auth、IP 允许列表或维护模式页面之后。
每个产品和可售选项唯一的 SKU
两个具有相同 SKU 的产品会冲突——只有一个会被导入。在连接前进行审核和去重，包括单独销售的选项组合。
每个产品的数字库存
每个产品的库存必须是数字值。
第 1 步 — 在 easySales 中启动向导并下载模块
在 easySales 中，进入 集成 → 在线商店 → 连接网站，然后选择 OpenCart 并选择商店版本。向导在 下载模块 步骤上打开。
点击下载按钮获取模块归档（easysales.ocmod.zip 或版本特定的文件名，例如 2market-oc3x.ocmod.zip）。保持此标签页打开——你将在第 3 步返回此处完成配置。
第 2 步 — 在 OpenCart 中上传并安装模块
在你的 OpenCart 后台，进入 扩展 → 安装程序。点击 上传，选择你刚刚下载的 .ocmod.zip 归档，并等待绿色的"成功"确认。
接下来，打开 扩展 → 扩展，在顶部下拉菜单中按 模块 筛选，在列表中找到 easySales，并点击绿色的 安装（+）按钮。安装后，点击蓝色的 编辑（铅笔）按钮以打开模块的设置——你将看到一个 Token 字段。保持此标签页打开；你将在下一步在此处粘贴 easySales 的令牌。
第 3 步 — 在 easySales 中配置站点并在 OpenCart 中粘贴令牌
返回到 easySales 标签页——向导现在位于 配置 步骤并显示生成的令牌。复制令牌，切换回 OpenCart，并将其粘贴到 easySales 模块编辑页面的 Token 字段中。将 Status 设置为 Enabled，保留其他默认值不变，然后在 OpenCart 中点击 保存。
回到 easySales，完成站点的配置。向导下方的表单收集了 easySales 驱动集成所需的一切。
网站名称和 URL
- 网站名称 — 你选择的标签。仅在 easySales 内可见。
- 网站 URL — 你的 OpenCart 店面。使用 OpenCart 运行的确切 URL，包括
https://，如果你的域名使用www前缀也要加上。如果 OpenCart 位于子目录中（example.com/shop），请将其包含进来。
增值税和运费增值税
如果你是增值税纳税人，输入适用于你产品的税率，以及单独的运费税率（例如对应罗马尼亚当前标准税率的 21）。如果你不是增值税纳税人，请留空。OpenCart 的税务类别不会被自动检测——你在此处设置的税率正是 easySales 在发票和发送到平台的报价中使用的值。
语言和货币
选择店面语言（罗马尼亚语、保加利亚语、匈牙利语、波兰语或英语）和货币（RON、BGN、HUF、PLN 或 EUR）。它们作为导入产品的默认值，以及当订单未携带明确货币时的回退。它们从不覆盖单个订单——每个订单保留 OpenCart 报告的货币。
产品库存来源
表单上最重要的决定。它告诉 easySales 权威库存值在哪里：
- 网站 — OpenCart 是事实来源。easySales 从 OpenCart 读取库存且从不覆盖它。
- easySales — easySales 是事实来源。easySales 内的库存变更（销售、手动编辑、平台扣减）会推送到 OpenCart。
- 已连接的集成 — 你的库存位于已与 easySales 连接的第三方系统中（开票软件、ERP、履行合作伙伴等）。easySales 从该集成读取库存并推送到 OpenCart。先连接集成并声明其仓库——否则无法选择此选项。
经营多仓库业务？将表单切换到 高级仓库 模式。不是将商店绑定到一个库存来源，而是选择一个或多个 easySales 仓库，并定义它们的库存如何按渠道聚合、优先排序或拆分。
默认包裹类型
在订单未指定包裹时用于生成运单。选择适合你大多数订单的类型。
第 4 步 — 刷新 OpenCart 修改并在 easySales 中完成
这是 OpenCart 特有的步骤，是新连接最常出问题的环节，必须是你做的最后一件事。
在 OpenCart 后台打开 扩展 → 修改，并点击右上角的蓝色 刷新 按钮。OpenCart 在刷新时编译 ocmod 覆盖——在你点击之前，模块虽已安装但其钩子未激活。
现在返回 easySales 并点击 保存 以完成连接。easySales 测试连接、在你的 OpenCart 网站上注册 webhook，并开始导入你的目录。
保存后会自动发生什么
easySales 处理 webhook 设置和初始导入。
- 在你的 OpenCart 网站上注册两个 webhook：一个用于订单变更，一个用于库存变更。OpenCart 中创建、更新或取消的每个订单几乎实时到达 easySales，库存更新也是如此。
- 你的产品目录被导入——产品及其选项组合出现在 在线商店 → 产品 中，你可以在此浏览、编辑并将它们变成各平台的报价。
- 进来的 OpenCart 订单出现在 订单 界面中，你可以在此生成发票、运单并运行自动化流程。
- 库存根据你选择的来源同步。如果你选择了 easySales，库存推送持续运行，你的 OpenCart 店面反映集中化的库存。
| OpenCart → easySales | easySales → OpenCart |
|---|---|
| 订单（创建、更新、取消） | 库存更新 |
| 产品和选项组合 | 订单状态变更 |
| 库存水平 | 来自运单生成的履行状态 |
| 产品价格 | — |
| 类别 | — |
| 订单自定义字段（税号、自提柜 ID、快递选择） | — |
| 客户详情和地址 | — |
| 图片 URL | — |
微调 OpenCart 连接
保存后，打开 OpenCart 网站的 偏好设置 标签页。两组设置值得快速过一遍。
Order Behavior
- Allow reopening completed orders — 默认情况下，「Complete」等终态状态无法返回到「Processing」。如果你需要重新打开订单，请启用。
- Allow reopening cancelled orders — 对已取消订单的相同逻辑（当临时取消的未付款订单最终被支付时很有用）。
Synchronization
- Fetch orders — 自动导入新的 OpenCart 订单。
- Update order status on OpenCart — 将状态变更从 easySales 推送回 OpenCart，使两个系统保持同步。
- Update product stock on OpenCart — 将 easySales 库存水平推送到你的 OpenCart 店面。如果 OpenCart 是你的库存来源，请关闭。
点击页面底部的 保存 以应用更改。
选项、自提柜和其他 OpenCart 特性
几个值得知道的 OpenCart 特有行为：
- 产品选项。 OpenCart 产品携带选项（尺寸、颜色等）以及每个选项的可选 SKU。easySales 将每个可售组合作为单独的变体导入，通过 SKU 与父产品绑定。如果你的商店使用没有 SKU 的选项，这些产品将作为单个条目导入——如果你希望在各平台上单独跟踪它们，请在连接前为每个选项设置 SKU。
- 自提柜。 如果你的商店使用受支持的自提柜扩展（Sameday EasyBox、InPost 以及我们服务市场中的其他自提柜网络），easySales 会自动从订单的自定义字段中读取自提柜 ID。无需配置。然后在生成运单时将自提柜用作交付点。
- 自定义支付方式。 OpenCart 允许通过扩展添加任何支付方式。easySales 自动映射标准方式（银行转账、货到付款、通过常见网关的卡）。非标准方式以 Unknown 形式到达——联系支持，我们将为你的特定网关扩展映射。
- 图片 URL。 OpenCart 从相对于店面根目录的
image/catalog/...提供图片。模块在导出时将这些重写为绝对 URL。如果产品图片未出现在 easySales 中，最常见的原因是磁盘上缺少文件——即使文件已消失，OpenCart 也会记录路径。 - 修改缓存。 如果在 easySales 模块安装后你更改了 OpenCart 后台扩展或主题，请再次刷新 扩展 → 修改。OpenCart 在某些后台更新时会静默禁用
ocmod覆盖。 - 模块更新。 当发布新的模块版本时，easySales 在网站的偏好设置中显示红色警告。下载新构建，从 OpenCart 后台移除旧模块（扩展 → 扩展 → Modules → 卸载），然后再次按照第 2 步安装新归档。在 OpenCart 和 easySales 中均保存，然后刷新 扩展 → 修改。
- 发票序列前缀。 如果你想要在 OpenCart 下游生成的文档上使用特定的发票序列，请在 OpenCart 后台 Settings → Option → Checkout → Invoice Prefix 中设置。easySales 会与订单一起读取此值。
你已连接——下一步是什么
订单开始到达后，下一步是自动化。设置流程以生成发票、创建运单和发送跟踪通知。如果你也在各平台销售，将你的 OpenCart 目录转化为报价，让 easySales 帮你推送出去。