# 상품 카탈로그

## 개요

상품 카탈로그에서 카탈로그 현황을 확인하거나 추가로 업로드할 수 있습니다.

<figure><img src="https://3826783036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyROeODSgPulCgZ9LFAYn%2Fuploads%2Fu8LkQXtT7YAGBPt2KbNQ%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-12-12%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%204.50.26.png?alt=media&#x26;token=3108d547-6c68-4111-9df9-a84457f90146" alt=""><figcaption></figcaption></figure>

## 카탈로그 업로드하기

### 1. CSV 파일로 업로드하기

csv 파일로 상품 목록을 업로드할 수 있습니다. 업로드시 각 [속성값](https://docs.marketap.io/t3ZS4WXNMj0HK27EtIMV/settings/catalog/property)을 정확하게 선택해야 합니다. [상품 ID 속성](https://docs.marketap.io/t3ZS4WXNMj0HK27EtIMV/settings/property#undefined-1)은 반드시 포함되어야 합니다. 업로드한 내용은 기존 내역에 반영되어 업데이트됩니다. (업로드하지 않은 상품이나 속성이 삭제되지 않습니다.)

업로드는 즉시 반영되지 않고 순차적으로 처리됩니다. 업로드 내역에서 현황을 확인해주세요.

<figure><img src="https://3826783036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyROeODSgPulCgZ9LFAYn%2Fuploads%2FHT2YV4uJT6TTsUVpglRV%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-12-12%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%204.53.30.png?alt=media&#x26;token=113ddfd6-9bbb-4946-bfc5-c0f68460e4aa" alt=""><figcaption></figcaption></figure>

#### 업로드 내역

업로드는 즉시 반영되지 않고 순차적으로 처리됩니다. 업로드 내역 탭에서 업로드 현황을 확인할 수 있습니다. 내역이 `완료` 상태일 경우 목록에 반영된 것을 의미합니다.

<figure><img src="https://3826783036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyROeODSgPulCgZ9LFAYn%2Fuploads%2FCUNXZ9R0fWWdHeYJOI9j%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-12-12%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%204.56.37.png?alt=media&#x26;token=8f92af1e-d954-4aa9-9649-9ab4974e417a" alt=""><figcaption></figcaption></figure>

### 2. API 연동하기

사전에 정의된 텍소노미는 **단순히 콘솔에서 설정을 마치는 것으로 끝나지 않으며**, 실제 데이터를 수집하기 위해서는 개발자의 연동 작업이 반드시 필요합니다.

즉, API를 통해 실시간 변경된 카탈로그 데이터가 전송되어야 하며, 이를 위해 반드시 정의된 구조에 맞게 구현되어야 합니다. 자세한 내용은 [상품 카탈로그](https://docs.marketap.io/t3ZS4WXNMj0HK27EtIMV/developer/open-api/catalog)를 참고해주세요.