> ## 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.
# Configuration
> 사이트 환경설정, 서비스, 인증서, 내보내기 작업 및 실시간 재고 확인
## 커스텀 사이트 환경설정
메타데이터를 가져온 후 **BM > Merchant Tools > Site Preferences > Custom Preferences**로 이동합니다.
**Kleep**를 선택합니다:
| 환경설정 | 설명 |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `kleepRetailerUUID` | **필수.** Kleep 플랫폼에서 귀하의 리테일러를 식별하는 고유 식별자로, Kleep 어카운트 매니저가 제공합니다. 반드시 수동으로 입력해야 하며, 모든 Kleep API 호출에 전송되고 추천 iframe의 `domain` 파라미터로 사용되어 귀하의 계정을 확인합니다. 자동 폴백은 없습니다. 비워 두면 추적, 추천 기능 및 iframe이 작동하지 않습니다(구성 오류가 발생함). |
| `isKleepRecommendationEnabled` | PDP에서 Kleep 버튼을 활성화/비활성화합니다. 추적이나 작업 내보내기에는 영향을 주지 않습니다. |
| `kleepButtonColor` | 버튼 색상(Black 또는 White). 커스텀 스타일링은 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`** — 다른 모든 기능에 사용됩니다. 사용자/비밀번호가 필요 없습니다. 모든 Kleep API 호출의 페이로드에 전송되는 `kleepRetailerUUID` 사이트 환경설정을 통해 요청이 인증되어 귀하의 계정을 확인합니다.
## 개인 키 및 인증서
**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(마지막 내보내기 이후 업데이트된 항목만) 또는 Full | Delta |
| `MainViewType` | 상품 이미지의 이미지 뷰 타입. PDP에서 사용하는 것과 동일하게 설정하세요. | `large` |
| `Locale` | 내보내기에 사용할 특정 로케일. 비어 있으면 기본값을 사용합니다. | — |
내보낸 상품 수가 처리된 상품 수를 초과할 수 있습니다. 이는 분류되지 않은 상품이 분류된 VariationGroup과의 연결을 통해 포함될 때 발생합니다.
**MainViewType** 파라미터가 매장 구성과 일치하는지 확인하세요. 뷰 타입이 일치하지 않으면 상품 이미지가 누락되며, 이는 AI 분석에 필요합니다.
### KleepResetLastExported(유틸리티 작업)
세 번째 작업인 **KleepResetLastExported**는 **주문 전체 재내보내기**를 강제하기 위해 제공됩니다. 이 작업의 `ResetKleepExportAttributes` 단계는 모든 주문의 내보내기 추적 속성을 초기화하여(`kleepLastExported` → 비움, `isKleepExported` → false) 다음 `KleepExportOrdersCSV` 실행 시 다시 처리되도록 합니다.
이 작업은 **기본적으로 비활성화되어 있으며** 필요할 때 수동으로 실행하도록 만들어졌습니다(예: Kleep 측 데이터 초기화 후). 파라미터를 받지 않습니다.
## 실시간 재고 확인
Kleep은 품절 사이즈를 추천하지 않도록 재고를 실시간으로 조회합니다. 아래 두 가지 방법 중 **하나**를 사용하여 액세스를 구성하세요.
어느 것을 선택해야 할지 잘 모르겠나요? **OCAPI**는 Business Manager Data API를 사용하는 전통적인 방식입니다. \*\*SCAPI (IAS)\*\*는 Inventory Availability Service를 사용하는 최신 Salesforce Commerce API입니다. 확실하지 않으면 Salesforce 관리자에게 문의하세요.
인스턴스가 재고 관리에 **OCAPI**를 사용하는 경우 이 방법을 사용하세요.
**1단계 — OCAPI 설정 열기**
**Administration > Site Development > Open Commerce API Settings**로 이동한 다음 **Data** API 설정을 편집합니다.
**2단계 — 클라이언트 ID 설정**
테스트용:
```
"client_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
```
프로덕션의 경우 [Salesforce 문서](https://help.salesforce.com/s/articleView?id=cc.b2c_generate_api_client_id.htm\&type=5)에 따라 새 클라이언트 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
* 재고 ID(마켓당 하나 — 매핑을 제공하세요)
* 프로덕션 SBX URL(재고 확인은 프로덕션에서만 활성화됨)
인스턴스가 **Inventory Availability Service (IAS)** / Omnichannel Inventory (OCI)와 함께 **SCAPI**를 사용하는 경우 이 방법을 사용하세요.
**1단계 — API 클라이언트 생성**
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. 귀하의 Organization에 할당합니다.
8. 저장합니다. **Client ID와 Client Secret를 복사하세요** — 시크릿은 한 번만 표시됩니다.
SCAPI와 OCAPI 클라이언트는 공유할 수 없습니다. 각 API 프레임워크에는 자체 클라이언트가 필요합니다.
**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)(마켓당 하나 — 매핑을 제공하세요)