연동 · 네이버 스마트스토어

네이버 스마트스토어 → Oprai import

스마트스토어에 이미 등록한 상품을 한 번에 Oprai로 가져옵니다. 카탈로그를 처음부터 다시 타이핑할 필요가 없습니다. 식품 표시 의무사항·배송 정보까지 풀세트로 들어옵니다.

준비물

  • 스마트스토어 셀러 계정 (사업자)
  • 네이버 커머스 API 가입 + 본인 스토어용 애플리케이션 1개

스마트스토어는 한 스토어당 외부 연동 앱 1개만 등록할 수 있습니다. 이미 다른 시스템(Flow·다른 ERP 등)에서 같은 스토어를 쓰고 있다면, 그 앱의 키를 Oprai에서 같이 써도 됩니다 (충돌 없음). 새로 만들지 마세요.

1. 네이버 커머스 API 신청

  1. apicenter.commerce.naver.com 접속 → 셀러 계정으로 로그인
  2. 사업자 인증 (사업자등록증 업로드 · 영업일 1-2일 승인)
  3. 애플리케이션 등록 클릭 →
    • 스토어 선택 (마마스마켓 · 타이니타이거 등 본인 스토어)
    • 애플리케이션 이름: 자유 (예: Oprai)
    • 서비스 URL: https://shop.oprai.co.kr
    • 요청 권한: 상품 조회 + 상품 관리
  4. API 호출 IP 등록 — Oprai 서버가 호출할 수 있게: 158.180.91.95 추가 (기존 IP가 있으면 그대로 두고 줄바꿈으로 추가)
  5. 발급된 애플리케이션 ID + 애플리케이션 시크릿 두 값을 메모

2. Oprai에 키 등록

  1. Oprai admin → 설정(/flow/settings) → 네이버 스마트스토어 연동 섹션
  2. 스토어 이름(자유) · 애플리케이션 ID · 애플리케이션 시크릿을 입력하고 추가

키는 워크스페이스별로 저장되며, 같은 화면에서 발급 방법 안내도 펼쳐 볼 수 있습니다. 막히면 화면 우측 하단 Oprai 비서에게 물어보세요.

3. 상품 가져오기 — 전체 일괄 (처음 1회)

처음 셋업 때는 스토어의 상품을 한 번에 통째로 가져옵니다.

  1. Oprai admin → Flow(운영) → 제품 (카탈로그) 페이지 진입
  2. 상단의 📥 네이버에서 가져오기 박스에서 스토어 선택 (여러 개면 드롭다운)
  3. 가져오기 클릭 → 스토어의 상품을 fetch해 Oprai 카탈로그에 등록·갱신

한 번 가져온 뒤 스마트스토어에서 수정한 내용은 다시 가져오기 누르면 전체가 자동 갱신됩니다 (네이버 상품 번호 기준 멱등 UPSERT — 중복 등록 X).

4. 상품 1건만 다시 불러오기 — 단품 갱신

전체를 다시 돌릴 필요 없이, 특정 상품 하나만 네이버 최신값으로 새로고침할 수 있습니다. 가격·이미지·재고만 바뀐 한 제품을 빠르게 맞출 때 씁니다.

  1. 제품 (카탈로그) → 해당 제품을 눌러 편집 화면으로 진입
  2. 헤더 오른쪽 🔄 네이버에서 불러오기 클릭 → 그 제품만 네이버 최신값(이름·판매가·이미지·재고·원산지)으로 갱신

이 버튼은 네이버에서 가져온 제품에만 보입니다(직접 등록한 제품은 원본이 없어 표시 안 됨). 직접 수정한 원가는 보존되고, 네이버에서 바코드가 빠진 상품이면 카탈로그에서 제외(보관함)됩니다.

가져오는 데이터

네이버에서 받은 풀 페이로드를 Oprai의 naver_meta 컬럼에 그대로 보관하고, 다음 필드를 카탈로그에 매핑합니다:

  • 제품명 · 브랜드 · 판매가 · 재고
  • 이미지 갤러리 (대표 + 추가 이미지)
  • 바코드(SKU) · 모델명 · 제조사
  • 소재지(원산지) · 식품 유형 · 상품군 (카테고리에서 추정 — 편집에서 수정 가능)
  • 네이버 식별자 (origin_product_no · 스토어명)

원가는 네이버에 없어 판매가의 50%로 자동 산정합니다. 편집에서 바꾸면 이후 재가져오기 때도 그 값이 보존됩니다. 바코드 있는 정식 단품만 카탈로그에 등록되고, 바코드 없는 상품(이벤트·B급·묶음)은 자동 제외됩니다.

자주 묻는 질문

이미 Flow에서 쓰는 키를 Oprai에서 같이 써도 되나요?

네. 같은 키로 두 서버가 동시에 호출해도 충돌 없습니다. 단, 네이버 콘솔의 API 호출 IP 항목에 Oprai 서버 IP(158.180.91.95)를 추가해 두 IP 모두 허용 상태여야 합니다.

여러 스토어가 있으면?

스토어별로 별도 애플리케이션을 만들고, 각 키를 Oprai에 등록하시면 됩니다. Oprai의 import 버튼에서 스토어를 선택해 가져옵니다.

스마트스토어를 안 쓰면?

Flow(운영) → 제품 → + 새 제품 등록(/flow/products/new)으로 직접 등록하시면 됩니다. AI 설명 생성 기능으로 입력 시간 단축 가능합니다.

문제 있으면 donghyun@oprai.co.kr로 문의.

네이버 스마트스토어 import 연동 — Oprai 매뉴얼 | Oprai