> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kleep.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# 配置
> 站点偏好设置、服务、证书、导出任务与实时库存检查
## 自定义站点偏好设置
元数据导入完成后，前往 **BM > Merchant Tools > Site Preferences > Custom Preferences**。
选择 **Kleep**：
| 偏好设置 | 说明 |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `kleepRetailerUUID` | **必填。** 您在 Kleep 平台上的零售商唯一标识符，由您的 Kleep 客户经理提供。需手动输入——它会在每次 Kleep API 调用中发送，并作为推荐 iframe 的 `domain` 参数用于解析您的账户。无自动回退：若留空，追踪功能、推荐功能和 iframe 将无法正常工作（会触发配置错误）。 |
| `isKleepRecommendationEnabled` | 启用/禁用 PDP 中的 Kleep 按钮。不影响追踪或任务导出。 |
| `kleepButtonColor` | 按钮颜色（黑色或白色）。可通过 CSS 覆盖以进行自定义样式设置。 |
| `kleepFontFamily` | Kleep 按钮和 iFrame 使用的字体系列。 |
| `kleepCountryCode` | 市场 / 国家代码（[ISO 3166 A-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)）。 |
## 服务
在 **Administration > Operations > Services** 中可找到：
**`kleep.sftp`** — 将导出文件从 SFCC WebDAV 发送到 Kleep SFTP。请将用户替换为 Kleep 提供的用户名，同时替换 `.p12` 证书。无需设置密码。
**`kleep`** — 用于所有其他功能。无需用户名/密码——请求通过 `kleepRetailerUUID` 站点偏好设置进行身份验证，该值会在每次 Kleep API 调用的 payload 中发送，用于解析您的账户。
## 私钥与证书
前往 **Administration > Operations > Private Keys and Certificates**：
1. 点击 **Import**
2. 点击 **Select**，选择 Kleep 提供的 `.p12` 文件
3. 使用 `kleep` 作为别名
4. 点击 **Save**
结果应如下所示——证书必须有效且命名为 `kleep`：
## 导出任务
前往 **Administration > Operations > Jobs**。已预配置两个任务：
* **KleepExportProductsCSV** — 导出您站点的商品
* **KleepExportOrdersCSV** — 导出客户的订单历史
两个任务**默认禁用**。请启用它们以每天运行一次：
### 通用设置（两个任务）
前往 **Job Steps** 标签页 → 点击 **RefArch** 以选择您使用 Kleep 的站点。
* **Timeout** — 停止导出前的等待秒数
* **OrdersMaxToExport** — 最大导出订单数 *（仅限订单任务）*
### KleepExportProductsCSV 设置
| 参数 | 说明 | 默认值 |
| -------------- | ---------------------------- | ------- |
| `SkipMaster` | 忽略主商品导出 | 禁用 |
| `OnlineOnly` | 仅导出上线商品 | 禁用 |
| `ExportType` | 增量（仅自上次导出后更新的内容）或完整导出 | Delta |
| `MainViewType` | 商品图片的图像视图类型。请使用与您 PDP 相同的类型。 | `large` |
| `Locale` | 导出使用的特定语言区域。为空时使用默认值。 | — |
导出的商品数量可能超过实际处理的数量。这是因为未分类商品通过其与已分类 VariationGroup 的关联被包含在内。
请确保 **MainViewType** 参数与您店铺的配置一致。视图类型不匹配将导致商品图片缺失，而商品图片是 AI 分析所必需的。
### KleepResetLastExported（工具任务）
第三个任务 **KleepResetLastExported** 用于强制**完整重新导出订单**。其 `ResetKleepExportAttributes` 步骤会清除每个订单上的导出追踪属性（`kleepLastExported` → 空，`isKleepExported` → false），使其在下次运行 `KleepExportOrdersCSV` 时被重新处理。
该任务**默认禁用**，适合手动按需运行（例如在 Kleep 端数据重置后）。无需任何参数。
## 实时库存检查
Kleep 实时查询库存，以避免推荐已缺货的尺码。请使用以下**两种方法之一**配置访问权限。
不确定选哪种？**OCAPI** 是使用 Business Manager Data API 的传统方法。**SCAPI (IAS)** 是配备库存可用性服务的新版 Salesforce Commerce API。如有疑问，请咨询您的 Salesforce 管理员。
如果您的实例依赖 **OCAPI** 进行库存管理，请使用此方法。
**第 1 步 — 打开 OCAPI 设置**
前往 **Administration > Site Development > Open Commerce API Settings**，然后编辑 **Data** API 设置。
**第 2 步 — 设置 Client ID**
测试用：
```
"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
```
生产环境请参考 [Salesforce 文档](https://help.salesforce.com/s/articleView?id=cc.b2c_generate_api_client_id.htm\&type=5) 生成新的 Client ID。[视频演示](https://www.youtube.com/watch?v=Z3cZlQHWjtM)。
**第 3 步 — 配置资源访问权限**
将以下内容添加到您的 OCAPI **Data** API 配置中：
```
Authorizations
(GET) /inventory_lists/*
(GET) /inventory_lists/*/product_inventory_records/*
```
**第 4 步 — 将凭证发送给 Kleep**
* Client ID
* Client Secret
* Inventory IDs（每个市场一个——请提供您的映射关系）
* 生产 SBX URL（库存检查仅在生产环境启用）
如果您的实例使用 **SCAPI** 及**库存可用性服务（IAS）**/ Omnichannel Inventory (OCI)，请使用此方法。
**第 1 步 — 创建 API Client**
1. 登录 [Salesforce Account Manager](https://account.demandware.com)。
2. 点击 **API Client** → **Add API Client**。
3. 显示名称：例如 `Kleep Inventory`。
4. Token Endpoint Auth Method：`client_secret_post`。
5. Access Token Format：`JWT`。
6. Allowed Scopes：`sfcc.inventory.availability`
7. 分配到您的组织。
8. 保存。**复制 Client ID 和 Client Secret**——Secret 仅显示一次。
SCAPI 和 OCAPI 的 Client 不能共用。每种 API 框架都需要各自独立的 Client。
**第 2 步 — 收集实例标识符**
| 标识符 | 查找位置 | 示例 |
| --------------------- | ----------------------------------------------------------------------------- | ------------------------------ |
| **Short Code** | BM > **Administration > Site Development > Salesforce Commerce API Settings** | `kv7kzm78` |
| **Organization ID** | 同上页面，或 Account Manager | `f_ecom_zzzz_prd` |
| **Tenant ID** | Account Manager > Organizations | `zzzz_prd` |
| **Location Group(s)** | BM > **Merchant Tools > Inventory > Inventory Availability** | `WAREHOUSE_FR`, `WAREHOUSE_US` |
**第 3 步 — 将凭证发送给 Kleep**
* Client ID & Client Secret
* Short Code
* Organization ID
* Tenant ID
* Location Group(s)（每个市场一个——请提供您的映射关系）