连接 Cin7 Core

连接 Cin7 Core 后，StoreClaw 可通过 Cin7 Core API 访问您授权账户中的库存、销售订单、采购订单、产品和多仓库等业务数据，并用于查询、分析和自动化任务。

请注意： Cin7 Core 的这种连接方式不使用单独的 OAuth Token 或 Refresh Token。您需要在 Cin7 Core 中创建一组 API 凭证：Account ID 和 API Application Key。它们分别对应 StoreClaw 授权弹窗中的两个必填项。

连接前准备

开始前，请确认：

• 您已经拥有可正常登录的 Cin7 Core 账户。试用账户也可以访问 API。
• 当前用户拥有 Settings: Cin7 Core API Setup 权限。该权限用于访问 Integrations → Cin7 Core API。如看不到该入口，请联系 Cin7 Core 管理员或主账户用户授权。
• 您的 Cin7 Core 订阅有可用的 API／外部集成许可。如果创建时出现许可或集成数量提示，请在订阅页面检查当前方案与可用名额。

第一步：在 Cin7 Core 中创建 API 凭证

1. 登录 Cin7 Core。
2. 在左侧菜单进入 Integrations（集成）-> Cin7 Core API。部分界面或旧版帮助文档中，该入口可能简称为 API。
3. 您也可以在登录后直接打开 Cin7 Core API 设置页。
4. 在 API Integration 页面右上角点击 +。
5. 输入便于识别的 API 名称，例如 StoreClaw，然后点击 Create。
6. 创建完成后，打开该 API 应用的 Setup 标签页。Cin7 Core 会显示：
   • Account ID
   • Application Key（部分页面可能简称为 Key 或 API Key）
7. 分别复制这两个值，并点击 Save 保存 API 应用。

建议为 StoreClaw 单独创建一个名为 StoreClaw 的 API 应用，不要复用其他系统的凭证。Cin7 Core 支持在同一账户下创建多个 API 应用，API 限制也按 API 应用分别计算。

第二步：在 StoreClaw 中完成连接

1. 在 StoreClaw 中打开 Cin7 Core 连接器，点击 连接。

2. 在授权弹窗中填写：

   StoreClaw 字段	应填写的 Cin7 Core 凭证
   Account ID	Setup 标签页中的 Account ID
   Application Key	Setup 标签页中的 Application Key / Key

3. 检查复制内容的前后没有多余空格或换行。

4. 点击 使用 Cin7 Core 继续。

5. 等待连接校验完成。看到“已连接”状态后，即表示授权成功。

第三步：验证连接

连接成功后，建议先进行一次简单查询，例如查看产品、库存或订单列表，以确认 StoreClaw 可以正常读取对应公司下的数据。

如果您的 Cin7 Core 登录账户可以访问多个公司，请注意：每个公司都有不同的 Account ID。需要连接多个公司时，请分别在对应公司中创建 API 应用，并在 StoreClaw 中逐个添加连接。建议为每个连接设置清晰的名称，避免在后续对话或自动化任务中选错账户。

凭证安全说明

Cin7 官方将 Account ID 和 Application Key 视为与登录名和密码同等敏感的凭证。请务必：

• 只在 StoreClaw 的 Cin7 Core 授权弹窗中填写凭证。
• 不要通过聊天、邮件、工单或截图发送完整凭证。
• 不要把凭证写入公开文档、代码仓库或共享表格。
• 怀疑凭证泄露时，立即在 Cin7 Core 的 API Integration 页面停用或移除对应的专用 API 应用，并创建新凭证后重新连接。

常见问题