连接 Unleashed 并同步产品与库存水平
将你的 Unleashed 账号（库存管理）连接到 CRM，并自动保持产品和库存余额的更新，不会产生重复数据。
你可以将 Unleashed 账号连接到 CRM。连接后，CRM 会从 Unleashed 拉取产品（创建或更新“产品”）以及库存水平（作为你“库存”中的一次调整），并通过 Unleashed 的 ID 保持所有数据关联。重新同步不会产生重复数据：它会更新已存在的记录。
该模式为“自带账号”（BYO）：你使用自己的 Unleashed 账号和 API 密钥对。我们绝不会看到你的 API Key（它仅用于对调用进行签名），也不会产生任何费用。集成初始状态为静默：在你配置凭据并启用之前，不会发生任何操作。在此第一阶段，同步方向为“入站”（从 Unleashed 到 CRM），通过定期轮询实现。
前提条件
- 拥有可访问 API 的 Unleashed 账号。
- 在 Unleashed 中生成的 API 密钥对（API ID 和 API Key）。
- 在 Sellio 中是管理员（具备“管理设置”权限），以便在“设置 → 集成”下保存凭据。
第一步：在 Unleashed 中生成 API ID 和 API Key
- 在 Unleashed 中打开“Integration”，然后进入“API”。
- 生成/复制 API ID 和 API Key。API Key 是一个密钥：请妥善保管，它不会再次显示。
第二步：将凭据粘贴到 CRM 中
- 打开“设置 → 集成”，找到“Unleashed（库存管理）”卡片。
- 粘贴 API ID 和 API Key。API Key 会被加密存储，且不会再次显示。
- 可选：输入一个仓库代码，以仅使用该仓库的库存余额。留空则 CRM 会汇总所有仓库的库存。
- 在“实体与方向”中，选择是否从 Unleashed 拉取“产品”和“库存水平”（或分别关闭）。
- 点击“保存连接”，然后点击“启用”。
第三步：同步
- 点击“立即同步”以立即从 Unleashed 拉取数据。
- 此后，系统会以短间隔（每隔几分钟）自动同步，以保持库存接近实时，同时每天还会执行一次安全性同步。
- 在卡片上观察“各实体的关联数量”随产品关联而增长。
同步内容
- 产品：产品代码（SKU）、描述、售价、成本以及状态（启用/停用）。如果 CRM 中已存在相同 SKU 的产品，会直接复用（不会产生重复数据）。
- 库存水平：每个产品的余额会成为你“库存”中的一次调整，使 CRM 的余额与 Unleashed 保持一致。每次调整都会记录在产品的变动历史中，因此不会有数据丢失或被盲目覆盖。
安全与隐私
API Key 会被加密存储且不会再次显示。它仅用于对每次调用进行签名（HMAC），因此该密钥不会在网络中传输。连接初始状态为静默，只有在配置并启用后才会开始同步。
💡 如果你在多个仓库中销售，并希望 CRM 的库存余额只反映其中一个仓库，请在卡片上填写仓库代码。留空则会汇总所有仓库的库存。
如何测试
- 保存并启用后，点击“立即同步”并等待确认。
- 打开“产品”列表和“库存”界面，检查来自 Unleashed 的产品和余额是否已出现。
- 在卡片上观察“各实体的关联数量”是否增长。
故障排查
- 没有任何同步发生：确认集成状态为“已启用”，且至少有一个实体设置为“从 Unleashed 拉取”。
- 同步时出现凭据错误：重新输入 API ID 和 API Key（Key 不会从服务器回传，因此需要完整粘贴）。
- 库存没有出现：库存只会应用到 CRM 中已存在的产品上。请同时将“产品”设置为“从 Unleashed 拉取”，以便先创建产品，或确保 CRM 中的 SKU 与 Unleashed 一致。
- 余额与预期不符：检查是否设置了正确的仓库（或留空以汇总全部仓库）。