> For the complete documentation index, see [llms.txt](https://docs.archisketch.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.archisketch.com/guide/dev-kr/builder/cafe24/import-data.md).
# 1.3. 카페24: 데이터 가져오기(동기화)
## ✅ 미리 확인해주세요.
{% hint style="danger" %}
❗️ 관리자 등급 계정만 사용할 수 있는 기능입니다.
대시보드의 **설정 관련 기능들**은 **관리자 등급 계정(Admin)**만 이용할 수 있습니다. 따라서 데이터 가져오기 기능을 사용하려면 **관리자 계정**으로 로그인해야 합니다.
만약 관리자 계정을 잊어버리셨다면, [**아키스케치 채널톡**](https://archisketch.channel.io/home) 또는 [**도입문의**](https://www.archisketch.com/kr/enterprisetrial)를 통해 아키스케치 팀에 문의해 주세요.
{% endhint %}
{% hint style="info" %}
📘 데이터 가져오기(동기화) 이후 카테고리 관리 안내
데이터 가져오기(동기화)가 완료되면, **기업 라이브러리 > 카테고리**는 **관리**(생성/수정/삭제)를 대시보드 내에서 진행 할 수 없습니다. 카테고리를 생성/수정/삭제 하고 싶으시다면, 카페24 관리자 **상품 > 분류관리 > 상품 분류 관리**페이지에서 진행해주세요.
{% endhint %}
***
## 개요
아키스케치에서 **"데이터 가져오기"** 기능을 활용하면, 카페24에 등록된 **1)브랜드**, **2)카테고리**, **3)판매 상품**을 손쉽게 가져올 수 있습니다. 해당 문서에서는 다음 내용을 안내드립니다.
**1️⃣ 연동 방법**: **1)브랜드** → **2)카테고리** → **3)판매 상품** 순서로 진행되는 연동 방법에 대해 설명합니다.
**2️⃣ 연동 상태**: **1)브랜드**, **2)카테고리**, **3)판매 상품** 별 연동 상태 내용들을 확인하는 방법에 대하여 설명합니다.
아키스케치와 카페24를 연동하여 보다 효율적인 웹사이트 운영을 시작해 보세요!
***
{% stepper %}
{% step %}
## 아키스케치 대시보드의 **\[설정 > 연동 > 데이터 가져오기]** 페이지로 이동해주세요.
이 페이지에서는 다음 두 가지 기능을 제공합니다. ✅ 데이터 연동을 원하시면 **"데이터 가져오기"** 버튼을 클릭해주시고, ❌ 데이터 연동을 해제하려면 **"데이터 초기화하기"** 버튼을 클릭해주세요.
| 기능 | 설명 |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **데이터 가져오기** | 버튼을 클릭하면, 아키스케치 대시보드 속 **기존 데이터**(브랜드, 카테고리(폴더), 판매 상품)를 삭제한 후 버튼을 누른 시간 기준으로 가져온 **웹빌더 데이터**로 덮어씌워집니다. |
| **데이터 초기화하기** | 버튼을 클릭하면 카페24에서 가져온 데이터가 삭제되고, 아키스케치가 제공하는 기본 데이터로 초기화됩니다.
\*제공되는 기본 데이터가 없을 경우, 데이터가 없는 공백 상태로 초기화됩니다.
\*3D 모델링 데이터는 삭제되지 않고, \[미분류 제품들] 폴더로 이동됩니다.
|
{% endstep %}
{% step %}
## 버튼 클릭 후, **데이터 초기화** 및 **데이터 가져오기** 상태는 **개요**에서 간략하게 확인할 수 있습니다.
1. 연동되지 않았거나, 연동에 이슈가 있을 경우 → 개요 속 **아이콘**이 **\[❌]**로 표시됩니다.
2. 정상적으로 데이터 연동이 완료된 경우 → 개요 속 **아이콘**이 **\[🔄]**로 표시됩니다.
{% endstep %}
{% step %}
## 개요 속 **모든 아이콘**이 **\[🔄]**로 표시되었다면, **\[대시보드 > 기업 라이브러리]** 페이지를 확인해주세요.
1. **카페24에서 가져온 브랜드(들)**은(는) **\[기업 라이브러리 > 브랜드 관리]** 페이지에서 확인 가능합니다.
2. **카페24에서 가져온 카테고리(들) 및 판매상품(들)**은(는) **\[기업 라이브러리 > 제품 > 가구]** 페이지에서 확인 가능합니다.
{% endstep %}
{% endstepper %}
***
## 2️⃣ 연동 상태
아키스케치 대시보드의 \[설정 > 연동 > 데이터 가져오기] 페이지를 통해 **1) 브랜드, 2) 카테고리(폴더), 3) 판매 상품**의 연동 상태를 확인할 수 있습니다. 연동 상태는 카페24 Webhook을 통해 자동 업데이트되며, 카페24 관리자에서 카테고리(폴더) 또는 판매 상품 데이터가 변경될 때마다 최신 상태로 반영됩니다.
{% hint style="warning" %}
🚧 \[데이터 가져오기 / 브랜드]: 수동 지원
카페24는 브랜드 Webhook을 통한 자동 동기화를 지원하지 않고 있습니다. 최신 데이터를 반영하려면, **\[개요 > 브랜드 > 탭 페이지]** 속 **\[데이터 가져오기]** 버튼을 클릭해주세요.
{% endhint %}
**1)브랜드, 2)카테고리(폴더), 3)판매 상품**의 연동 상태 상세 정보를 확인하시려면 **개요** 속 **브랜드**, **카테고리**, **제품** 버튼을 클릭해주세요.
***
👇 **\[개요 > 탭 페이지**(브랜드, 카테고리, 제품) **> 주석]** 속에서는 아래의 상태 정보값들을 보여줍니다.
### 2.1 브랜드
**2.1.1. 데이터 초기화**
| 상세 정보 | 설명 |
| ----- | -- |
| 없음 | 없음 |
**2.1.2. 데이터 가져오기**
| 상세 정보 | 설명 |
| ----------------------------- | -------------------------------- |
| **BRAND\_CREATED\_FROM\_API** | 카페24에서 성공적으로 가져온 브랜드 리스트를 알려줍니다. |
***
### 2.2 카테고리(폴더)
**2.2.1. 데이터 초기화**
| 상세 정보 | 설명 |
| ----- | -- |
| 없음 | 없음 |
**2.2.2. 데이터 가져오기**
| 상세 정보 | 설명 |
| ------------------------------------------- | ----------------------------------------------------------------------------------------- |
| **CATEGORY\_CREATED\_FROM\_API** | 카페24에서 성공적으로 가져온 브랜드 리스트를 알려줍니다. |
| **CATEGORY\_CREATED\_FROM\_WEBHOOK** | 카페24에서 생성된 신규 카테고리 정보를 안내하고, 가져옵니다. |
| **CATEGORY\_UPDATED\_FROM\_WEBHOOK** | 카페24 카테고리 정보값이 변경되었음을 안내하고, 반영합니다. |
| **CATEGORY\_DELETED\_FROM\_WEBHOOK** | 카페24 카테고리 정보값이 삭제되었음을 안내하고, 반영합니다. |
| **CATEGORY\_ORDER\_UPDATED\_FROM\_WEBHOOK** | 카페24 카테고리 순서(Sort by)가 변경되었음을 안내합니다.
\*해당 이벤트는 대시보드의 데이터에 영향을 주지 않습니다.
|
***
### 2.3 제품
**2.3.1. 데이터 초기화**
| 상세 정보 | 설명 |
| ----- | -- |
| 없음 | 없음 |
**2.3.2. 데이터 가져오기**
| 상세 정보 | 설명 |
| -------------------------------------------------- | ---------------------------------- |
| **PRODUCT\_ASYNCHRONOUS\_CREATED\_FROM\_API** | 카페24에서 성공적으로 가져온 제품 리스트 정보를 안내합니다. |
| **PRODUCT\_ASYNCHRONOUS\_CREATED\_FROM\_WEBHOOK** | 카페24에서 생성된 신규 제품 정보를 안내하고, 가져옵니다. |
| **PRODUCT\_ASYNCHRONOUS\_UPDATED\_FROM\_WEBHOOK** | 카페24 제품 정보값이 변경되었음을 안내하고, 반영합니다. |
| **PRODUCT\_ASYNCHRONOUS\_DELETED\_FROM\_WEBHOOK** | 카페24 제품 정보값이 삭제되었음을 안내하고, 반영합니다. |
| **PRODUCT\_ASYNCHRONOUS\_RESTORED\_FROM\_WEBHOOK** | 카페24 제품 정보값이 복구되었음을 안내하고, 반영합니다. |