跳转到主要内容

​
自定义站点偏好设置

元数据导入完成后，前往 BM > Merchant Tools > Site Preferences > Custom Preferences。
image.png
选择 Kleep：
image.png

​
服务

在 Administration > Operations > Services 中可找到：
image.png
kleep.sftp — 将导出文件从 SFCC WebDAV 发送到 Kleep SFTP。请将用户替换为 Kleep 提供的用户名，同时替换 .p12 证书。无需设置密码。
image.png
kleep — 用于所有其他功能。无需用户名/密码——请求通过 kleepRetailerUUID 站点偏好设置进行身份验证，该值会在每次 Kleep API 调用的 payload 中发送，用于解析您的账户。

​
私钥与证书

前往 Administration > Operations > Private Keys and Certificates：
  1. 点击 Import
  2. 点击 Select，选择 Kleep 提供的 .p12 文件
  3. 使用 kleep 作为别名
  4. 点击 Save
image.png
结果应如下所示——证书必须有效且命名为 kleep：
image.png

​
导出任务

前往 Administration > Operations > Jobs。已预配置两个任务：
  • KleepExportProductsCSV — 导出您站点的商品
  • KleepExportOrdersCSV — 导出客户的订单历史
image.png
两个任务默认禁用。请启用它们以每天运行一次：
image.png

​
通用设置（两个任务）

前往 Job Steps 标签页 → 点击 RefArch 以选择您使用 Kleep 的站点。
  • Timeout — 停止导出前的等待秒数
  • OrdersMaxToExport — 最大导出订单数 （仅限订单任务）
image.png

​
KleepExportProductsCSV 设置

image.png
导出的商品数量可能超过实际处理的数量。这是因为未分类商品通过其与已分类 VariationGroup 的关联被包含在内。
请确保 MainViewType 参数与您店铺的配置一致。视图类型不匹配将导致商品图片缺失，而商品图片是 AI 分析所必需的。
image.png
The TargetFolder parameter of each SFTP upload step must match the folder structure expected by Kleep’s ingestion pipeline. For example, a dev store might use dev/products instead of products. See the SFTP Data Structure documentation for the complete directory layout.

​
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测试用：
生产环境请参考 Salesforce 文档 生成新的 Client ID。视频演示。第 3 步 — 配置资源访问权限将以下内容添加到您的 OCAPI Data API 配置中：
第 4 步 — 将凭证发送给 Kleep
  • Client ID
  • Client Secret
  • Inventory IDs（每个市场一个——请提供您的映射关系）
  • 生产 SBX URL（库存检查仅在生产环境启用）