연동 · 판매 채널

판매 채널 연동 가이드

Oprai 채널 판매는 여러 판매 채널(오픈마켓·자사몰·홈쇼핑·오프라인)에서 팔린 내역을 한곳에 모아 재고를 자동 차감하고 매출을 집계합니다. 발송·클레임·CS는 각 판매자센터에서 그대로 하고, Oprai는 기록·재고용으로만 읽습니다 — 채널 쪽 데이터를 건드리지 않으니 안전합니다.

0. 원칙: 파는 채널만 연결합니다

  • 연결은 채널별 선택입니다. 롯데온에서 안 팔면 롯데온은 등록하지 않으면 됩니다.
  • 시즌 오프 등으로 잠깐 쉬는 채널은 일시정지 버튼으로 끄면 됩니다 — 키는 보존되고 동기화만 멈춥니다.
  • 연결 방식은 채널에 따라 두 가지입니다: API 자동 동기화 또는 엑셀 업로드.

1. 어떤 채널이 어떤 방식인가

방식채널이유
API 자동네이버 스마트스토어 · 쿠팡(마켓) · 11번가 · SSG · 롯데온판매자가 직접 API 키를 발급받을 수 있는 채널
엑셀 업로드29CM · 무신사 · GS샵 · 홈쇼핑(현대/롯데/CJ) · 마켓컬리 · 쿠팡 로켓배송 · 카카오톡 선물하기 · 오프라인 판매 등판매자 API가 없거나, 계약한 솔루션사에게만 열어주는 채널

목록에 없는 채널도 판매내역을 엑셀로 내려받을 수만 있으면 전부 엑셀 방식으로 연결됩니다.

2. API 채널 연결 (자동 동기화)

공통 흐름: 각 판매자센터에서 API 키 발급 → Flow → 회사 정보 · 거래명세서(설정) → 판매 채널 연동에 키 입력 → 채널 판매 화면에서 지금 가져오기.

네이버 스마트스토어

커머스 API 키(애플리케이션 ID·시크릿)가 필요합니다. 발급 절차는 네이버 스마트스토어 연동 가이드에 단계별로 있습니다. API 호출 IP에 158.180.91.95 등록 필수.

쿠팡 (마켓플레이스 판매)

  1. 쿠팡 Wing 로그인 → 우측 상단 판매자정보 → 추가판매정보
  2. OPEN API 키 발급에서 Access Key · Secret Key 발급
  3. 업체코드(Vendor ID, A로 시작)와 함께 Oprai 설정에 입력

참고: 로켓배송(쿠팡 직매입)은 별개 시스템(서플라이어 허브)입니다 — 아래 엑셀 채널로 연결하세요.

11번가

  1. 셀러오피스 로그인 → 하단 Open API → 서비스등록·확인
  2. 사용자 정보 입력(담당업무 "개발", 용도 "주문 통합관리") → API 키 발급
  3. API 호출 IP에 158.180.91.95 추가 → 승인 확인
  4. 발급된 키를 Oprai 설정에 입력

SSG.com

SSG 파트너오피스의 업체 인증키가 필요합니다. 파트너 담당자(MD)에게 OpenAPI 인증키 발급을 요청하면 받을 수 있습니다. 키 1개만 입력하면 됩니다.

롯데온

스토어센터(셀러오피스)에서 OpenAPI 키를 발급받아 입력합니다.

3. 엑셀 채널 연결 (수동 업로드)

API가 없는 채널은 판매자센터에서 판매(주문) 내역 엑셀을 내려받아 올리는 방식입니다. 처음 한 번만 설정하면 이후엔 파일만 올리면 됩니다.

  1. 설정 → 엑셀 채널에서 채널 추가 — 자주 쓰는 채널(29CM·무신사·GS샵 등)은 원클릭 프리셋, 그 외는 이름 직접 입력
  2. 채널 판매 → 판매내역 엑셀 업로드 — 채널 선택 + 파일 업로드. 첫 업로드 때 AI가 컬럼(주문번호·상품명·수량 등)을 자동 인식하니 따로 설정할 게 없습니다. 인식 결과는 업로드 완료 배너와 설정에서 확인·수정할 수 있습니다.
  3. 자동 인식이 애매한 파일이면(비표준 양식 등) 설정 → 엑셀 채널에서 헤더 이름을 직접 지정하면 됩니다. 파일에 상품코드/바코드 컬럼이 있으면 제품과 자동 연결돼 수동 상품 매핑이 거의 없어집니다.

안전장치:

  • 같은 파일을 두 번 올려도, 기간이 겹치는 파일을 올려도 재고는 한 번만 차감됩니다 (주문번호 기준 중복 방지). 헷갈리면 그냥 다시 올려도 됩니다.
  • 취소·반품: 주문상태 컬럼에 "취소"·"반품"이 있으면 자동 복원, 없으면 취소내역 엑셀을 같은 방식으로 올리면 복원됩니다.

4. 상품 매핑 — 채널 상품과 우리 제품 연결

채널의 상품명과 Oprai 제품이 자동으로 연결되지 않으면 매핑 필요 배지에 모입니다. 상품별로 한 번만 연결하면 이후 모든 판매에 계속 적용됩니다.

  • 자동 매핑: 판매자상품코드(바코드·관리코드)나 네이버 상품번호가 일치하면 자동 연결
  • 수동 매핑: 채널 판매 → 매핑 필요 카드에서 제품 선택. 묶음·세트 상품은 구성품 여러 개 + 수량으로 연결 (예: "파스타 2종 세트" → 부카티니 ×1 + 스파게티 ×1)
  • 제외: 사은품·배송비 상품처럼 재고와 무관한 항목은 "제외"하면 매출 집계에는 남고 매핑 대상에서만 빠집니다

5. 운영 루틴

  1. 채널 판매에서 지금 가져오기 — API 채널 전체가 한 번에 동기화됩니다 (하루 1~2회면 충분)
  2. 엑셀 채널은 정산 주기에 맞춰 파일 업로드 (주 1회 등)
  3. 매핑 필요 배지가 떠 있으면 그때그때 연결 — 연결 즉시 밀린 재고 차감이 자동 반영됩니다

자주 묻는 질문

Q. 우리는 스마트스토어랑 쿠팡만 하는데요?
그 둘만 등록하면 됩니다. 나머지 채널은 화면에 아무 영향이 없습니다.

Q. 지마켓·옥션, 카페24 자사몰은요?
API 연동을 준비 중입니다. 그 전까지는 판매내역 엑셀 업로드로 동일하게 연결됩니다.

Q. 채널 판매를 올리면 B2B(거래처) 주문과 섞이나요?
아니요. 거래처 주문(주문 목록)과 채널 판매는 완전히 분리돼 있고, 재고만 같은 풀에서 차감됩니다. 매출 분석에서도 따로 집계됩니다.

막히면 화면 우측 하단 Oprai 비서에게 "쿠팡 키 어디서 발급해?" 처럼 물어보세요.

판매 채널 연동 — Oprai 매뉴얼 | Oprai