# 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.1.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 제품 정보값이 복구되었음을 안내하고, 반영합니다. |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.archisketch.com/dev-guide/builder/cafe24/import-data.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.