> For the complete documentation index, see [llms.txt](https://help.genser.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genser.ai/reference/naver-ep-url.md).

# Naver EP URL 설정 가이드

NaverEP URL을 확인하는 방법에 대해 안내합니다.

{% hint style="warning" %}
URL 은 접근 가능한 공개 URL만 사용할 수 있습니다.
{% endhint %}

## **URL만 찾으면 되는 경우**

TSV 파일이 어디에 저장되어 있는지에 따라 URL 형태가 다릅니다. 환경을 확인하여 URL 주소를 확인해 주세요.

#### **방법 1: 네이버 쇼핑파트너센터에서 확인**

1. [네이버 쇼핑파트너센터](https://center.shopping.naver.com/login) 로그인
2. 상품 관리 → 상품정보 수신현황 이동
3. 쇼핑몰 상품 DB URL 항목에서 URL 복사

{% hint style="warning" %}
URL 은 접근 가능한 공개 URL만 사용할 수 있습니다.
{% endhint %}

#### **방법 2: 개발팀에 문의**

TSV 파일은 보통 아래 중 한 곳에 저장되어 있습니다.

* 쇼핑몰 서버 내 특정 경로에 정적 파일로 생성되는 경우
* AWS S3, Google Cloud Storage 등 외부 파일 서버(오브젝트 스토리지)에 업로드되는 경우
* 별도 API 엔드포인트로 동적으로 생성되는 경우

저장 위치에 따라 EP URL 형태가 다릅니다. 아래의 URL 을 참고해 주세요.

<table><thead><tr><th width="210.1484375">저장 방식</th><th>EP URL 예시</th></tr></thead><tbody><tr><td>쇼핑몰 서버 내 정적 파일</td><td><code>https://www.yourshop.com/feed/products.tsv</code></td></tr><tr><td>AWS S3</td><td><code>https://s3.ap-northeast-2.amazonaws.com/bucket-name/ep/products.tsv</code></td></tr><tr><td>CloudFront (CDN) 경유</td><td><code>https://cdn.yourshop.com/ep/products.tsv</code></td></tr><tr><td>API 엔드포인트</td><td><code>https://api.yourshop.com/v1/feed/naver-ep</code></td></tr></tbody></table>

개발팀에 아래와 같이 문의해 주세요.

> "네이버 쇼핑 연동에 사용 중인 TSV 피드 파일 URL이 어떻게 되나요? S3나 CDN 등 외부 파일 서버를 사용 중이라면 해당 공개 URL도 함께 알려주세요."

***

## **처음 만드는 경우**

* **TSV 파일 스펙**
  * 1행: 컬럼 헤더
  * 2행 이후: 상품 데이터 (상품 1개 = 1행)
  * 구분자: 탭(`\t`)
  * 인코딩: UTF-8 (BOM 없음)

{% hint style="info" %}
gelatto는 [네이버 EP 3.0](https://join.shopping.naver.com/misc/download/ep_guide.nhn) TSV 표준 포맷을 사용합니다.&#x20;
{% endhint %}

#### **필수 필드**

<table><thead><tr><th width="150.296875">컬럼명</th><th width="215.74609375">설명</th><th>예시</th></tr></thead><tbody><tr><td><code>id</code></td><td>상품 고유 ID</td><td><code>PRD_001</code></td></tr><tr><td><code>title</code></td><td>상품명</td><td><code>[브랜드] 반팔 티셔츠 화이트 L</code></td></tr><tr><td><code>price_pc</code></td><td>PC 판매가 (정수, 원화)</td><td><code>29000</code></td></tr><tr><td><code>link</code></td><td>상품 상세 URL</td><td><code>https://www.yourshop.com/product/1</code></td></tr><tr><td><code>image_link</code></td><td>대표 이미지 URL</td><td><code>https://cdn.yourshop.com/img/1.jpg</code></td></tr><tr><td><code>category_name1</code></td><td>카테고리 대분류</td><td><code>의류</code></td></tr><tr><td><code>shipping</code></td><td>배송비 (무료=<code>0</code>, 착불=<code>-1</code>)</td><td><code>3000</code></td></tr></tbody></table>

#### **선택 필드 (권장)**

| 컬럼명              | 설명           |
| ---------------- | ------------ |
| `price_mobile`   | 모바일 판매가      |
| `normal_price`   | 정가 (할인 전 가격) |
| `mobile_link`    | 모바일 상품 URL   |
| `add_image_link` | 추가 이미지 URL   |
| `category_name2` | 카테고리 중분류     |
| `category_name3` | 카테고리 소분류     |
| `brand`          | 브랜드명         |
| `review_count`   | 리뷰 수         |

**TSV 샘플**

```
id	title	price_pc	link	image_link	category_name1	shipping
PRD_001	[브랜드] 반팔 티셔츠 화이트 L	29000	https://www.yourshop.com/product/1	https://cdn.yourshop.com/img/1.jpg	의류	3000
PRD_002	[브랜드] 슬랙스 블랙 M	49000	https://www.yourshop.com/product/2	https://cdn.yourshop.com/img/2.jpg	의류	0
```

#### **개발팀 구현 체크리스트**

* 전체 상품을 TSV 형식으로 출력하는 엔드포인트 구현
* 파일 URL이 외부에서 HTTP/HTTPS로 접근 가능한지 확인

{% hint style="warning" %}
URL 은 접근 가능한 공개 URL만 사용할 수 있습니다.
{% endhint %}

***

## **Naver EP URL 정상 여부 확인**

브라우저 주소창에 EP URL을 직접 입력했을 때 TSV 데이터가 텍스트로 표시되면 정상입니다.

```
O 정상 브라우저에서 탭 구분 텍스트 데이터가 표시됨
```

***

## **자주 묻는 질문**

<details>

<summary><strong>Q. 상품이 추가·수정되면 TSV 파일도 업데이트해야 하나요?</strong></summary>

TSV 생성 로직이 항상 최신 데이터를 반영하도록 구현되어 있으면 됩니다. 이후 gelatto가 어드민에서 설정된 주기로 EP URL에 접근하여 자동으로 최신 데이터를 수집합니다.&#x20;

</details>

<details>

<summary><strong>Q. 컬럼 값에 탭이나 줄바꿈이 포함된 경우 어떻게 처리하나요?</strong></summary>

탭(`\t`)과 개행(`\n`, `\r`) 문자는 반드시 공백( ) 처리 또는 제거 후 출력해야 합니다. 포함된 경우 파싱 오류로 해당 상품이 무효 처리됩니다.

</details>