다크 모드
채널 연동
개요
채널 연동(/channels)은 상품을 판매하는 모든 채널 — 도매 사이트 8곳과 오픈마켓 5곳 — 의 연동 정보를 한 곳에서 관리하는 화면입니다. 도매 사이트는 사이트 로그인 정보(ID/비밀번호), 오픈마켓은 판매자센터에서 발급한 **API 자격증명(키)**을 저장하는 방식이 서로 다릅니다. 자격증명을 저장하고 검증까지 마친 채널만 주문수집 등 연동 기능에 나타납니다.
지원 채널은 다음과 같습니다.
| 구분 | 채널 | 연결 방식 |
|---|---|---|
| 사이트 | 롯데온 | 스크래퍼 (API 준비 중) |
| 사이트 | 온누리굿데이 | 스크래퍼 |
| 사이트 | 인더마켓 | 스크래퍼 |
| 사이트 | 놀장 | 스크래퍼 |
| 사이트 | 이지웰 | 스크래퍼 |
| 사이트 | 이제너두 | 스크래퍼 |
| 사이트 | 온누리찬스 | 스크래퍼 |
| 사이트 | 온누리마켓 | 스크래퍼 |
| 오픈마켓 | 스마트스토어 | OAuth 2.0 |
| 오픈마켓 | 쿠팡 | HMAC 서명 |
| 오픈마켓 | 11번가 | API Key |
| 오픈마켓 | G마켓 | ESM+ (JWT/HMAC) |
| 오픈마켓 | 옥션 | ESM+ (JWT/HMAC) |
온누리찬스, 온누리굿데이, 온누리마켓은 이름이 비슷하지만 서로 다른 사이트입니다. 온누리찬스는 구 보물마켓이 리브랜딩된 사이트입니다.
화면 안내

위 화면은 채널 연동 페이지입니다. 상단에 "상품을 올리는 모든 판매 채널을 한 곳에서 관리합니다"라는 안내와 함께 우측에 Desktop 앱 연동 태그가 표시되고, 그 아래 연동완료 n / 전체 n채널 요약 칩이 보입니다. 본문은 사이트와 오픈마켓 카드가 하나의 그리드로 나열됩니다.
- 사이트 카드: 사이트명 옆에 연결방식 배지(API/스크래퍼, 자격증명 저장 시 ✓ 표시)와 상태 배지(미연동/인증됨/미인증)가 있고, 하단에 연동(또는 수정), 테스트, 삭제 버튼이 있습니다.
- 마켓 카드: 마켓명 옆에 인증방식 태그(OAuth 2.0/HMAC 서명/API Key 등)와 상태 배지(미연동/연동됨/미검증)가 있고, 판매자 ID·마지막 동기화·상태(활성/비활성) 정보가 표시됩니다. 하단에 연동하기(또는 설정), 검증, 그리고 검증 완료 시에만 주문 수집 버튼이 나타납니다.

위 화면은 사이트 카드에서 연동(또는 수정)을 클릭했을 때 열리는 "{사이트명} 연동 설정" 모달입니다. 스크래퍼 사이트는 로그인 ID와 비밀번호를 입력합니다. 롯데온은 **API 모드 (준비 중)**와 스크래퍼 모드 두 탭이 있으며, "현재는 스크래퍼 모드로 동작합니다. API 모드는 검증 완료 후 활성화됩니다."라는 안내와 함께 API 입력칸(벤더 번호, API Key)은 비활성화되어 있습니다.

위 화면은 마켓 카드에서 연동하기(또는 설정)를 클릭했을 때 열리는 "{마켓명} 연동 설정" 모달입니다. 마켓의 인증 방식에 따라 입력 항목이 달라지며, 하단에 연동(수정 시 수정)·취소 버튼과, 이미 연동된 경우 연동 해제 버튼이 있습니다.
절차
도매 사이트 연동하기 (로그인 정보 저장)
- 좌측 메뉴에서 채널 연동을 클릭합니다.
- 연동할 사이트 카드의 연동 버튼을 클릭합니다.
- "{사이트명} 연동 설정" 모달에서 로그인 ID와 비밀번호를 입력합니다. 롯데온의 API 모드 탭은 준비 중(비활성)이므로 스크래퍼 모드 탭에서 입력합니다.
- 저장을 클릭합니다. "자격증명이 저장되었습니다." 메시지가 표시되고 카드 상태가 미인증으로 바뀝니다.
- 이어서 아래 "사이트 연결 테스트"로 실제 로그인 검증을 진행합니다.
사이트 연결 테스트하기 (실제 로그인 검증)
사이트 연결 테스트는 데스크톱 앱이 실제 로그인을 시도해 자격증명을 검증합니다. 따라서 데스크톱 앱이 실행 중이고 Selltic에 로그인된 상태여야 합니다.
- 사이트 카드의 테스트 버튼을 클릭합니다.
- "Desktop 앱에서 실제 로그인으로 연결을 확인합니다. 잠시 대기하세요." 안내와 함께 카드에 "연결 테스트 중…"이 표시됩니다.
- 성공하면 "로그인 성공 — 정상 연동"이 표시되고 상태 배지가 인증됨으로 바뀝니다. 실패하면 실패 사유가 카드에 표시됩니다.
- 90초 안에 데스크톱 앱의 응답이 없으면 "Desktop 앱 응답이 없습니다. 앱이 실행·로그인 중인지 확인하세요."라는 실패로 처리됩니다.
11번가 API Key 발급받기 (셀링툴 「셀틱」 선택)
셀틱은 11번가에 공식 셀링툴 업체로 등록되어 있습니다. 11번가 OPEN API 센터에서 접속 권한을 셀틱으로 지정하고 API Key를 셀틱에 붙여 넣으면 연동됩니다. IP 주소를 직접 입력할 필요가 없습니다 — 셀틱을 고르면 셀틱 서버 IP가 11번가에 자동으로 적용됩니다.
준비물: 11번가 판매자 계정, 2차 인증을 받을 휴대폰 또는 이메일(셀러오피스 담당자 정보에 등록된 것).
- 11번가 셀러오피스(soffice.11st.co.kr)에 로그인합니다.
- 화면 상단의 OPEN API 관리를 클릭합니다. 11번가 OPEN API CENTER의 API 관리 화면이 열립니다(openapi.11st.co.kr에서 상단 API 관리를 눌러도 같은 화면입니다).
- 접속권한 표의 셀링툴 업체 선택 드롭다운에서 셀틱을 고릅니다. 목록 맨 아래쪽에 있습니다.
- 이미 다른 셀링툴(예: 사방넷, 플레이오토)을 쓰고 있다면 그 칸은 그대로 두고 + 업체추가로 칸을 하나 늘려 셀틱을 추가합니다. 셀링툴은 최대 5개까지 함께 쓸 수 있습니다.
- IP 직접 입력은 미사용을 선택합니다. 이때 IP 입력칸(개발서버 IP·개발자 PC·상용서버 IP)은 보이지 않는 것이 정상입니다. 사용이 선택되어 IP 입력칸이 보인다면 미사용으로 바꾸세요 — 셀틱 서버 IP는 셀링툴 선택만으로 적용됩니다.
- 화면 아래 저장 버튼(이미 API를 쓰던 계정은 수정하기)을 누르고, "접속 권한 설정을 수정하시겠습니까?" 확인 창에서 확인을 누릅니다.
- 화면 위쪽 API KEY 관리에 "KEY 확인은 2차인증 후 확인 가능합니다."가 보이면 인증하기를 누릅니다.
- 로그인 2단계 인증 화면에서 휴대폰 또는 이메일을 고르고 인증번호 전송을 누른 뒤, 받은 인증번호를 입력합니다. 휴대폰은 카카오 메시지(11번가 셀러)로 오고, 실패하면 문자로 옵니다.
- 인증이 끝나면 API 관리 화면으로 돌아오고 API KEY 관리에 API Key가 표시됩니다. 복사 버튼으로 키를 복사합니다.
- 셀틱 채널 연동에서 11번가 카드의 연동하기(이미 연동했다면 설정)를 누르고 API Key 칸에 붙여 넣은 뒤 연동(수정 시 수정)을 누릅니다.
- 카드의 검증을 누릅니다. "11번가 인증 성공"이 뜨면 끝입니다. 이후 주문은 30분 간격으로 자동 수집됩니다.
- API Key는 비밀번호처럼 다루세요. 셀틱에는 암호화되어 저장되며 화면에 다시 표시되지 않습니다.
- 11번가 API 관리 화면에서 키를 재발급하면 기존 키는 더 이상 쓸 수 없습니다. 재발급했다면 새 키를 셀틱에도 다시 저장하고 검증하세요.
- 나중에 접속권한에서 셀틱을 지우면 셀틱의 11번가 주문 수집·송장 전송·상품 등록이 모두 멈춥니다.
오픈마켓 연동하기 (API 자격증명 저장)
- 각 마켓의 판매자센터에서 API 자격증명을 먼저 발급받습니다.
- 쿠팡: 쿠팡 Wing(wing.coupang.com) → 오픈API 메뉴에서 Access Key / Secret Key 발급. Vendor ID(업체코드, A로 시작)도 함께 확인합니다.
- 스마트스토어: 네이버 커머스API센터(apicenter.commerce.naver.com)에서 애플리케이션 등록 → 애플리케이션 ID(Client ID) / Client Secret 발급.
- 11번가: 11번가 OPEN API 센터 API 관리에서 셀링툴 업체를 셀틱으로 선택하고 API Key를 복사합니다. 자세한 순서는 아래 "11번가 API Key 발급받기"를 따르세요.
- G마켓/옥션: ESM+(sa2.esmplus.com) 마스터 계정으로 로그인 → API 연동 관리에서 Secret Key 발급. 마스터 ID와 각 마켓 셀러 ID를 확인합니다. G마켓과 옥션은 ESM+ 마스터 계정 하나로 함께 연동됩니다.
- 채널 연동에서 해당 마켓 카드의 연동하기를 클릭합니다.
- "{마켓명} 연동 설정" 모달에서 인증 항목을 입력합니다.
- 스마트스토어: Client ID (애플리케이션 ID), Client Secret
- 쿠팡: Access Key (Vendor ID), Secret Key
- 11번가: API Key
- G마켓/옥션: ESM+ Master ID, Secret Key, G마켓 셀러 ID (선택), 옥션 셀러 ID (선택)
- 공통: 판매자 ID (선택)
- 연동을 클릭합니다. "{마켓명} 연동이 완료되었습니다" 메시지가 표시됩니다.
- 카드의 검증 버튼을 클릭해 키 유효성을 확인합니다. 성공 시 "{마켓명} 인증 성공" 메시지와 함께 상태가 연동됨으로 바뀝니다.
오픈마켓 주문 수집하기
- 검증이 완료된 마켓 카드에는 주문 수집 버튼이 나타납니다. 클릭하면 "{마켓명} 주문 수집을 시작했습니다" 메시지와 함께 공식 API로 주문을 가져옵니다. 데스크톱 앱이 필요 없습니다.
- 수집된 주문은 주문 관리에 추가되어 도매 주문과 동일한 매칭→발주 흐름을 따릅니다.
- 11번가는 검증·활성 상태이면 30분 간격으로 주문이 자동 수집됩니다(별도 설정 불필요). 나머지 마켓은 주문 수집 버튼으로 수동 수집합니다.
- 11번가 수집 시 자동 접수 처리: 11번가 카드의 수집 시 자동 접수 처리 토글을 켜면, 수집한 신규 주문(결제완료)을 11번가에서 발주확인(배송준비중) 으로 바로 넘깁니다. 도매 사이트의 같은 이름 토글과 같은 기능이며 기본은 꺼짐입니다. 끄면 수집만 하고, 송장을 보낼 때 발주확인과 발송처리를 함께 합니다.
- 발주확인한 주문은 구매자가 바로 취소할 수 없고, 취소 요청을 셀러가 셀러오피스에서 승인해야 합니다.
- 발주확인에 실패한 주문은 결제완료로 남고 다음 수집 때 다시 시도합니다. 실패 사유는 마켓 동기화 로그에 남습니다.
- 주문 관리 상단의 채널 주문 수집 드롭다운에서도 검증 완료된 마켓을 골라 같은 수집을 실행할 수 있습니다. 사이트/마켓에서 내려받은 주문 엑셀을 직접 올리는 주문 업로드도 지원됩니다 — 자세한 방법은 주문 관리를 참조하세요.
사이트별 등록 파일 설정하기 (소비자가 배수·온누리찬스 정보)
사이트 등록 파일에 들어가는 값 중 셀러와 사이트 조합마다 같은 값을 저장합니다. 로그인 정보를 저장한 사이트 카드에만 등록 파일 설정 줄이 보입니다.
- 사이트 카드의 등록 파일 설정 · {요약} 줄에서 설정을 누릅니다(요약은 "소비자가 ×배수", "찬스 상수 입력됨/미입력", "기본값" 등). 마스터상품 사이트 변형 탭의 고칠 곳 버튼 "{사이트} 등록 파일 설정"으로도 열립니다.
- {사이트} 등록 파일 설정 창에서 소비자가(정상가)를 판매가 × 배수로 채우기를 켜고 배수(1.001~3), 단위(10원/100원/1000원), 방식(반올림/올림)을 정합니다. "예: 판매가 10,900원 → 소비자가 N원" 예시로 결과를 확인합니다. 끄면 상품에 입력된 소비자가(없으면 판매가)를 씁니다.
- 온누리찬스는 전통시장명(예: 능곡전통시장), 입점업체(온누리찬스 판매자 아이디 — 등록 파일 마지막 칸), 판매 수수료(%)(온누리찬스·복지몰 수수료 칸에 같은 값)를 추가로 입력합니다.
- 저장하면 다음에 받는 그 사이트 등록 파일부터 반영됩니다. → 상품 관리
- 대상 사이트: 온누리찬스·온누리굿데이·인더마켓·놀장·이제너두·온누리핫딜(롯데온은 양식에 소비자가 칸이 없어 제외).
- 사이트 로그인 정보를 삭제하면 이 설정도 함께 지워집니다.
11번가 등록 기본값 저장하기
11번가 API 상품 등록에 함께 들어가는 값입니다. 11번가를 연동한 뒤에만 보입니다.
- 11번가 카드의 등록 기본값 버튼을 누릅니다.
- 주소(출고지, 반품/교환지 — 11번가 셀러오피스 주소록에서 선택), 배송비(무료/고정/조건부 무료, 기본 배송비, 무료배송 기준금액, 선결제/착불, 배송 가능 지역, 제주·도서산간 추가 배송비, 반품·교환 배송비, 묶음배송), 안내 문구(A/S 안내, 반품/교환 안내), 옵션 제목·기본 생산지 국가코드를 입력하고 저장합니다.
- 출고지·반품/교환지는 내 사업장 주소를 고르세요. 매입처(도매처) 주소로 등록하면 사이트 제재 대상이 될 수 있습니다. 목록에 없으면 11번가 셀러오피스 주소록에 먼저 등록합니다.
- 여기 넣은 배송비·제주/도서산간 추가 배송비·반품/교환 배송비·A/S·반품/교환 안내는 11번가 상품 페이지에 그대로 표시됩니다. 매입처마다 따로 발송한다면 묶음배송은 불가를 권합니다.
- 저장하지 않으면 11번가 등록 준비도에 "11번가 등록 기본값(출고지·반품지·배송비) 설정 필요"로 차단됩니다. 등록 절차는 상품 관리의 "11번가에 API로 등록하기"와 따라 하기의 "오픈마켓 11번가는 이렇게 다릅니다"를 참조하세요.
연동 정보 수정·해제하기
- 사이트: 카드의 수정 버튼으로 모달을 열어 정보를 고치거나, 삭제 버튼 → "자격증명 삭제" 확인 모달에서 삭제를 클릭해 로그인 정보를 지웁니다.
- 마켓: 카드의 설정 버튼으로 모달을 열어 수정하거나, 모달 하단 연동 해제 → "연동을 해제하시겠습니까?" 확인에서 해제를 클릭합니다. 저장된 인증 정보가 삭제됩니다.
Q&A
Q: 사이트 연동과 오픈마켓 연동은 무엇이 다른가요?
A: 도매 사이트 8곳은 사이트 **로그인 정보(ID/비밀번호)**를 저장하고 데스크톱 앱의 스크래퍼가 그 계정으로 로그인해 주문수집·상품등록을 수행합니다. 오픈마켓 5곳은 판매자센터에서 발급한 **API 자격증명(키)**을 저장하고 서버가 공식 API로 직접 통신하므로 데스크톱 앱이 필요 없습니다. 롯데온은 API 모드가 함께 마련되어 있으나 현재는 검증 전(준비 중)이라 스크래퍼 모드로 동작합니다.
Q: 예전의 "사이트 연동", "오픈마켓 연동" 메뉴는 어디로 갔나요?
A: 두 화면은 채널 연동(/channels) 하나로 통합되었습니다. 구 주소(/sites, /marketplaces)로 접속해도 자동으로 채널 연동 페이지로 이동합니다.
Q: 연결 테스트(검증)는 꼭 해야 하나요?
A: 네. 자격증명을 저장만 하면 미인증(마켓은 미검증) 상태이며, 검증이 완료된 채널만 주문수집 등 연동 기능 대상에 나타납니다. 사이트는 테스트 버튼(데스크톱 앱 실로그인), 마켓은 검증 버튼(API 키 확인)으로 검증합니다.
Q: 사이트 연결 테스트가 계속 응답 없음으로 실패해요.
A: 사이트 검증은 데스크톱 앱이 대신 실제 로그인을 수행하는 방식이라 데스크톱 앱이 실행 중이고 로그인된 상태여야 합니다. 앱을 실행·로그인한 뒤 다시 테스트하세요. 90초 안에 응답이 없으면 타임아웃으로 실패 처리됩니다. 데스크톱 앱 설치는 데스크톱 앱 챕터를 참조하세요.
Q: 마켓 주문은 자동으로 수집되나요?
A: 11번가는 연동·검증이 완료되어 있으면 30분 간격으로 자동 수집됩니다. 스마트스토어·쿠팡·G마켓·옥션은 마켓 카드의 주문 수집 버튼으로 수동 수집합니다.
Q: 11번가 주문을 수집하면 11번가 주문 상태도 바뀌나요?
A: 11번가 카드의 수집 시 자동 접수 처리를 켜 두면 바뀝니다 — 수집한 신규 주문(결제완료)이 11번가에서 발주확인(배송준비중) 이 됩니다. 꺼 두면(기본) 수집만 하고 상태는 그대로이며, 송장을 보낼 때 발주확인과 발송처리를 함께 합니다. 어느 쪽이든 송장 전송은 같게 동작합니다.
Q: 11번가에 셀틱 서버 IP를 직접 입력해야 하나요?
A: 아니요. 11번가 OPEN API 센터 API 관리의 셀링툴 업체 선택에서 셀틱만 고르면 셀틱 서버 IP가 자동으로 적용됩니다. IP 직접 입력은 미사용을 선택해 IP 입력칸이 보이지 않게 둡니다. 순서는 위 "11번가 API Key 발급받기"를 참조하세요.
Q: 다른 셀링툴을 쓰고 있어도 셀틱을 함께 쓸 수 있나요?
A: 네. + 업체추가로 셀링툴 칸을 늘려 기존 업체와 셀틱을 함께 선택하면 됩니다(최대 5개). API Key는 하나라서 같은 키를 셀틱에도 저장합니다. 이때 키를 재발급하면 다른 셀링툴에도 새 키를 다시 넣어야 하니 주의하세요.
Q: G마켓과 옥션을 따로 연동해야 하나요?
A: 두 마켓 모두 ESM+ 마스터 계정 기반이라 같은 ESM+ Master ID / Secret Key를 사용합니다. 다만 카드는 각각이므로 두 카드 모두에서 연동하고, 모달의 G마켓 셀러 ID (선택) / 옥션 셀러 ID (선택) 항목에 해당 마켓의 셀러 ID를 입력하세요. 한쪽만 동작한다면 그 마켓의 셀러 ID 누락을 의심하세요.
Q: 오픈마켓에 상품 등록이나 송장 전송도 되나요?
A: 오픈마켓 주문의 송장은 주문에 송장번호+택배사가 연결되면 API로 전송됩니다 — 송장 관리 참조. 오픈마켓 상품 등록은 11번가만 API 등록 경로가 있습니다 — 셀틱 서버가 바로 등록하고, 등록한 상품의 재고도 동기화 화면에서 승인하면 11번가에 반영됩니다. 스마트스토어·쿠팡·G마켓·옥션 상품 등록은 아직 지원되지 않습니다(예정). 상품 관리 참조.
Q: "등록 파일 설정"은 무엇이고 어디서 하나요?
A: 사이트 등록 파일에 셀러×사이트 공통으로 들어가는 값(소비자가 배수, 온누리찬스의 전통시장명·입점업체·판매 수수료)을 저장하는 곳입니다. 채널 연동에서 로그인 정보를 저장한 사이트 카드의 등록 파일 설정 → 설정으로 엽니다. 매입처마다 다른 값(협력업체 코드·출고지/반품지 번호·온누리핫딜 배송정책코드)은 여기가 아니라 매입처 관리의 사이트별 등록 정보에서 입력합니다.
문제해결
연동 저장은 됐는데 "검증"이 안 돼요 (마켓)
- 원인: 키 값 오타 또는 만료된 키.
- 조치: 판매자센터에서 키를 재발급한 뒤 카드의 설정 → 수정으로 다시 저장하고 검증을 다시 실행하세요.
11번가 "검증"이 "11번가 인증 실패"로 나와요
- 원인: ①11번가 API 관리에서 셀링툴 업체 선택에 셀틱을 고르지 않았거나 저장(수정하기)을 누르지 않았습니다. ②API Key를 일부만 복사했거나 앞뒤에 공백이 붙었습니다. ③11번가에서 키를 재발급해 셀틱에 저장된 키가 옛 키입니다.
- 조치: 11번가 API 관리 화면에서 셀틱이 선택돼 있는지 확인하고 저장한 뒤, 2차 인증 후 키를 다시 복사해 셀틱 11번가 카드의 설정 → 수정으로 저장하고 검증을 다시 누르세요.
11번가 2차 인증 번호가 다른 사람에게 가요
- 원인: 11번가 셀러오피스 담당자 정보의 휴대폰·이메일이 대표나 이전 담당자 것으로 등록돼 있습니다.
- 조치: 그 사람에게 인증번호를 받아 진행하거나, 11번가 고객센터(1599-5115)에 담당자 정보 변경을 요청하세요.
쿠팡 인증이 401/403으로 실패해요
- 원인: Access Key와 Vendor ID 혼동.
- 조치: Access Key (Vendor ID) 항목에 Vendor ID 형식(A00000000)의 키를 정확히 입력했는지 확인하세요.
스마트스토어 인증이 실패해요
- 원인: 커머스API센터 애플리케이션에 필요한 권한(주문/상품) 미신청.
- 조치: 네이버 커머스API센터에서 애플리케이션 권한을 신청·승인받은 뒤 다시 검증하세요.
마켓 주문 수집 버튼이 카드에 보이지 않아요
- 원인: 자격증명 저장 후 검증이 완료되지 않았습니다. 주문 수집 버튼은 검증 완료된 마켓에만 나타납니다.
- 조치: 카드의 검증 버튼으로 인증을 완료하세요. 실패하면 키 값을 다시 확인하세요.
사이트 상태가 "미인증"으로 남아 있어요
- 원인: 자격증명 저장 후 연결 테스트를 하지 않았거나 테스트가 실패했습니다.
- 조치: 데스크톱 앱을 실행·로그인한 상태에서 카드의 테스트 버튼을 클릭하고, 실패 사유가 표시되면 로그인 정보를 수정 후 재시도하세요.