如何将 shopGold 连接到 easySales：连接器设置
将你的 shopGold 店铺连接到 easySales：上传带有你 API 密钥的双文件连接器，映射订单状态，了解目录编号以及双向同步的内容。
shopGold 连接能做什么
shopGold 是一款波兰网店软件，运行在你自己的服务器上。把它连接到 easySales 后，你店铺的产品和订单会进入 easySales，店铺库存由 easySales 保持更新，订单状态也会回传到店铺。
开始之前要知道的三件事：
- 连接方式是一个你上传到店铺的小型连接器。 你从 easySales 下载两个文件，把你的 API 密钥粘贴到其中一个文件里，然后把两个文件都上传到店铺的根目录，放在
index.php旁边。 - 每个产品和每个变体都需要目录编号（Nr katalogowy）。 easySales 通过它识别产品。没有目录编号的产品不会被导入，包含这种产品的订单会被拒绝。
- 连接后映射你的订单状态。 shopGold 的状态是你自己设置的，所以 easySales 需要知道哪个状态表示新订单、已完成或已取消。在你完成映射之前，所有订单都保持 New。
开始之前
✓
店铺文件的访问权限
通过 FTP 或主机的文件管理器，用于上传两个文件。
✓
每个产品都有目录编号
每个产品和每个变体上都填写 Nr katalogowy。
✓
纯文本编辑器
例如 Notepad，用于把 API 密钥粘贴到连接器中。
第 1 步 — 在 easySales 中添加店铺
进入 整合方式 → 网站，点击 连结网站。填写店铺信息：
| 字段 | 填写内容 |
|---|---|
| 网站名称 | 店铺的名称，在 easySales 内部使用。 |
| 网址 |
你的店铺地址，必须与在浏览器中打开时完全一致——相同的 https://，以及相同的有或没有 www.。easySales 不会跟随重定向。
|
| 国家 | 店铺所在国家，波兰。 |
| 增值税价格 | 你店铺价格中包含的增值税税率，通常为 23%。 |
| 运输增值税 | 运费的增值税税率。 |
| 语言、货币 | 店铺的语言和货币。 |
| 新订单自定义状态 | 可选：新的 shopGold 订单在 easySales 中获得的自定义状态。 |
| 库存来源 | 店铺库存的管理位置：带有 EasySales 等来源的 经典仓库，或 高级仓库。 |
| 隐式封装类型 | 新订单获得的包裹类型，在你为其创建运单标签时使用。 |
| 发票系列 | 你为该店铺订单开具的发票系列。 |
第 2 步 — 把连接器上传到你的店铺
在店铺信息下方选择 shopGold 图块，再选择 ShopGold 版本。细节 标签页会显示设置步骤、下载模块 按钮和你的 API密钥。
- 点击 下载模块 并解压文件。里面有
easy-sales-api.php和easy-sales-api-key.php。 - 用纯文本编辑器（例如 Notepad）打开
easy-sales-api-key.php，把 API密钥 粘贴到引号之间。保持直引号——文字处理软件会改变引号，导致文件损坏。 - 把两个文件都上传到店铺的根目录，放在
index.php旁边。 - 回到 easySales，点击 保存。easySales 会测试连接，并加载你店铺的订单状态和付款方式。
第 3 步 — 映射你的订单状态
再次打开店铺，选择 偏好设置。
- 映射订单状态：为每个 shopGold 状态选择它所对应的 easySales 状态——例如，你的店铺标记为已发货的订单，在 easySales 中就是 Completed。你没有映射的状态会以 New 进入。
- 将订单状态发送到 ShopGold：选择当你在 easySales 中完成、取消或退回订单时，订单在 shopGold 中获得的状态。只发送这三种；你未映射的状态不会被发送。
点击 保存。
同步哪些内容
| 从 shopGold 到 easySales | 从 easySales 到 shopGold |
|---|---|
| 类别和产品，包括价格、图片、描述和属性 | 库存 |
| 新订单和更新的订单，买家选择了自提点时一并带上 | 订单状态，当你完成、取消或退回订单时 |
| 跟踪号，需开启 从网站获取文档 | 你创建的运单标签的跟踪号 |
- 订单 在连接后立即开始进入。产品 每隔几小时读取一次，所以在处理新订单之前，先给首次导入留出时间：在其产品存在之前到达的订单行会保持没有产品，也不会预留库存。
- 库存：当店铺的库存来源设置为 EasySales 时，每个产品的库存一有变化，easySales 就会发送给店铺。当来源设置为网站时，easySales 每 30 分钟读取一次店铺库存。
- 跟踪号：当订单在 easySales 中获得运单标签时，其跟踪号会发送到店铺。要导入你在 shopGold 中填写的跟踪号，请在 偏好设置 中开启 从网站获取文档。
- 价格 从店铺读取。请在 shopGold 中修改价格。
更新连接器
当 easySales 发布新的连接器时，只替换你店铺中的 easy-sales-api.php。保持 easy-sales-api-key.php 不变——其中的密钥依然有效。如果你点击了 API密钥 旁边的刷新按钮，请把新密钥重新粘贴到 easy-sales-api-key.php 中。
出现问题时
| 提示信息 | 处理方法 |
|---|---|
| Connection failed. Make sure easySales module is properly configured. If you need assistance, please contact us. |
检查两个文件是否都在店铺根目录中、密钥是否已粘贴到 easy-sales-api-key.php 中，以及网址是否与店铺地址完全一致。
|
| Set your easySales key in easy-sales-api-key.php | 密钥文件仍为空。把 API 密钥粘贴到引号之间，然后重新上传该文件。 |
| easy-sales-api-key.php was changed. Upload a clean copy from the release zip and paste the key again. | 密钥文件在编辑时被损坏。从 zip 压缩包中重新取出该文件，用纯文本编辑器粘贴密钥后再上传。 |
| Shop configuration not found. Upload this file inside your shopGold directory, or fill in the database settings at the top of it. |
文件不在店铺根目录中。把它们移到 index.php 旁边。
|
| The product.sku field is required. | 该产品在 shopGold 中没有目录编号。为产品及其每个变体填写 Nr katalogowy。 |
| order.order_products.1.sku jest obowiązkowe. | 订单中的某个产品没有目录编号。在 shopGold 中填写后，订单会在下一次检查时进入。 |