For the complete documentation index, see llms.txt. This page is also available as Markdown.

Naver EP URL 설정 가이드

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

URL만 찾으면 되는 경우

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

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

  1. 상품 관리 → 상품정보 수신현황 이동

  2. 쇼핑몰 상품 DB URL 항목에서 URL 복사

방법 2: 개발팀에 문의

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

  • 쇼핑몰 서버 내 특정 경로에 정적 파일로 생성되는 경우

  • AWS S3, Google Cloud Storage 등 외부 파일 서버(오브젝트 스토리지)에 업로드되는 경우

  • 별도 API 엔드포인트로 동적으로 생성되는 경우

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

저장 방식
EP URL 예시

쇼핑몰 서버 내 정적 파일

https://www.yourshop.com/feed/products.tsv

AWS S3

https://s3.ap-northeast-2.amazonaws.com/bucket-name/ep/products.tsv

CloudFront (CDN) 경유

https://cdn.yourshop.com/ep/products.tsv

API 엔드포인트

https://api.yourshop.com/v1/feed/naver-ep

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

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


처음 만드는 경우

  • TSV 파일 스펙

    • 1행: 컬럼 헤더

    • 2행 이후: 상품 데이터 (상품 1개 = 1행)

    • 구분자: 탭(\t)

    • 인코딩: UTF-8 (BOM 없음)

gelatto는 네이버 EP 3.0 TSV 표준 포맷을 사용합니다.

필수 필드

컬럼명
설명
예시

id

상품 고유 ID

PRD_001

title

상품명

[브랜드] 반팔 티셔츠 화이트 L

price_pc

PC 판매가 (정수, 원화)

29000

link

상품 상세 URL

https://www.yourshop.com/product/1

image_link

대표 이미지 URL

https://cdn.yourshop.com/img/1.jpg

category_name1

카테고리 대분류

의류

shipping

배송비 (무료=0, 착불=-1)

3000

선택 필드 (권장)

컬럼명
설명

price_mobile

모바일 판매가

normal_price

정가 (할인 전 가격)

mobile_link

모바일 상품 URL

add_image_link

추가 이미지 URL

category_name2

카테고리 중분류

category_name3

카테고리 소분류

brand

브랜드명

review_count

리뷰 수

TSV 샘플

개발팀 구현 체크리스트

  • 전체 상품을 TSV 형식으로 출력하는 엔드포인트 구현

  • 파일 URL이 외부에서 HTTP/HTTPS로 접근 가능한지 확인


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


자주 묻는 질문

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

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

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

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

마지막 업데이트