마켓 추가하기
스마트스토어·쿠팡·카페24·ESM(G마켓·옥션)·11번가를 연결할 수 있어요. 마켓마다 키를 받는 곳이 달라요. 스마트스토어·쿠팡·카페24·11번가는 마켓에서 받은 키를 넣고, ESM은 ESM PLUS 아이디·비밀번호로 로그인해요. 내가 쓰는 마켓만 보세요. 아래 표에서 마켓 이름을 누르면 그 마켓 설명으로 바로 가요.
한눈에 보기
- 마켓 고르기설정 → 마켓 계정 → [+ 마켓 추가]
- 키 받기마켓 사이트에서 키를 받아요 (ESM은 필요 없어요)
- 하나로에 입력계정 이름과 키를 적어요
- 저장[저장]을 누르면 연결을 확인하고, 통과하면 저장돼요
화면 구성
- [+ 마켓 추가] — 새 마켓 계정을 등록해요.
- [이름 바꾸기] — 계정 이름을 바꿔요. [재인증] 화면에서는 바꿀 수 없어요.
- 상태 — 등록됨(초록)이면 키가 저장돼 있어요, 미설정(노랑)이면 [재인증]으로 키를 넣어 주세요. 미확인(회색)은 저장된 키를 읽지 못했다는 뜻이에요 — [재인증]으로 다시 넣어 주세요.
- [재인증] — 키를 다시 넣어요. 주문 데이터는 그대로 남아요.
- [삭제] — 계정을 지워요. 지우고 다시 만들지 말고 [재인증]을 먼저 써 보세요.
스마트스토어·쿠팡·카페24 카드에는 [셀러센터 로그인] 버튼도 있어요(ESM 카드에도 있지만 색은 바뀌지 않아요 — 카드 상태 배지가 같은 뜻이에요). 대시보드에서 여는 셀러센터 창의 자동 로그인 정보예요. 버튼 색으로 저장됐는지 보여요 — 저장돼 있으면 초록, 없으면 기본 색, 저장된 정보를 읽지 못했으면 노랑(다시 저장해 주세요). 마우스를 올리면 상태가 글로 보여요. 칸을 펼쳐 [저장]을 누르면 저장되고 칸이 닫혀요.
칸을 열면 로그인 방식 줄이 있는 마켓이 있어요. 스마트스토어는 판매자 아이디 / 네이버 아이디 중 쓰는 쪽을 고르세요 — 네이버 아이디를 고르면 저장하는 것은 네이버 계정 비밀번호이고, 보안문자·새 기기 확인·2단계 인증은 창에서 직접 마쳐요. G마켓·옥션은 ESM PLUS 마스터 / G마켓 판매자 / 옥션 판매자를 여기서 바꿀 수 있어요(바꾸면 다음 주문 받기 때 다시 로그인해요). 쿠팡·카페24는 로그인 방법이 하나라 이 줄이 없어요. 입력하다 그만두려면 [취소]를 누르면 값이 지워지고 칸이 접혀요(저장된 정보는 그대로).
마켓별 한눈에
| 마켓 | 필요한 것 | 위험도 |
|---|---|---|
| 스마트스토어 | 커머스API 애플리케이션 ID · 시크릿 + 이 PC의 IP 등록 | 낮음 |
| 쿠팡 | Wing OpenAPI의 업체코드 · Access Key · Secret Key | 낮음 |
| 카페24 | 개발자센터 앱의 Mall ID · Client ID · Client Secret | 낮음 |
| ESM(G마켓·옥션) | ESM PLUS 아이디·비밀번호 (공식 API 아님) | 중간 |
| 11번가 | 셀러오피스 오픈API 키 + 이 PC의 IP 등록 | 낮음 |
위험도 — 마켓 약관에 허용 여부가 적혀 있지 않은 방식(로그인 화면 자동화 등)을 쓰면 위험도를 표시해요. 자세한 내용은 FAQ — 공식 API와 세션 자동화의 차이 참조.
인증 방식 원문 표 보기
| 마켓 | 인증 방식 | 위험도 |
|---|---|---|
| 스마트스토어 | 커머스API (셀러 본인 애플리케이션 — 애플리케이션 ID · 시크릿 + 호출 IP 등록) | 낮음 |
| 쿠팡 | Wing OpenAPI (AccessKey/SecretKey) | 낮음 |
| 카페24 | OAuth 2.0 (셀러 본인 개발자센터 앱 — 몰 ID · Client ID · Client Secret 입력) | 낮음 |
| 11번가 | 셀러오피스 오픈API (API 키 + 이 PC의 IP 등록) | 낮음 |
| ESM(G마켓·옥션) | ESM PLUS 마스터 아이디·비밀번호로 로그인한 세션 (공식 API 아님, 주문 받기 + 로젠 송장 자동 등록) | 중간 |
스마트스토어
이미 스마트스토어를 연결해 쓰던 경우: 계정을 지우거나 새로 추가하지 말고,
설정→마켓 계정에서 기존 스마트스토어 카드의 [재인증]을 눌러 키를 넣으세요 — 새로 추가하면 같은 주문이 두 번 들어옵니다. 아래 1번의 [+ 마켓 추가]는 스마트스토어를 처음 연결하는 경우의 절차입니다. 기존 계정은 1번과 3번을 [재인증] 화면에서 하면 됩니다. 같은 애플리케이션을 다른 계정에 이미 넣어 두었다면 저장이 막히고, 어느 계정에 들어 있는지 알려 드립니다.
한 줄 요약 — 네이버 커머스API센터에서 내 애플리케이션을 만들고, 이 PC의 IP를 등록한 뒤, 받은 키를 하나로에 넣어요. 키가 없으면 주문을 가져올 수 없어요.
- IP 확인하나로에서 스마트스토어를 고르면 이 PC의 IP가 바로 보여요
- 애플리케이션 만들기커머스API센터에서 IP를 등록하고 ID·시크릿을 받아요
- 하나로에 입력판매자 아이디 · 애플리케이션 ID · 시크릿
- 저장[저장]이 연결을 확인하고 통과하면 저장돼요
- 계정 이름 — 꼭 적어요. 같은 마켓 계정이 여러 개여도 헷갈리지 않게 구분되는 이름이에요.
- 판매자 아이디 — 스마트스토어 판매자센터 로그인 아이디예요.
- 애플리케이션 ID — 커머스API센터에서 만든 애플리케이션의 ID예요.
- 애플리케이션 시크릿 — 비밀번호처럼 다루고 남에게 알려 주지 마세요.
- [저장] — 키가 맞는지 확인하고 통과하면 저장해요. 입력 칸 아래에는 커머스API센터에 등록할 이 PC의 인터넷 주소(IP)가 보여요.
자세히 보기 — 단계별 안내 · IP가 바뀌면 · 자주 나오는 안내 문구
스마트스토어는 네이버 커머스API로 연결해요. 셀러가 커머스API센터에서 자기 애플리케이션을 만들고, 그 애플리케이션에 하나로를 쓰는 PC의 인터넷 주소(IP)를 등록한 뒤, 발급된 키를 하나로에 입력하는 방식이에요.
키가 없으면 주문을 가져올 수 없어요. 예전 방식(네이버 로그인 창으로 연결)은 더 이상 쓰지 않아요. 이미 하나로를 쓰고 계셨더라도 아래 절차로 키를 한 번 등록해 주셔야 주문 받기와 송장 등록이 다시 동작해요.
1. 이 PC의 인터넷 주소(IP) 확인
- 하나로에서
설정→마켓 계정→ [+ 마켓 추가] →스마트스토어선택. (처음 연결하는 경우. 이미 쓰던 계정은 그 카드의 [재인증]) - 스마트스토어를 고르면 화면에 “이 PC의 인터넷 주소(IP): 000.000.000.000” 이 바로 표시돼요. 이 값을 복사해 두세요.
브라우저에서 “내 IP 주소”를 검색해도 같은 값을 볼 수 있어요.
ipconfig에 나오는192.168.…은 집·사무실 내부 주소라 여기에 쓰면 안 돼요.
2. 커머스API센터에서 애플리케이션 만들기
- 네이버 커머스API센터에 스마트스토어 판매자 계정으로 로그인.
- 애플리케이션 등록을 누르고 이름을 정해요(예:
하나로). - API 호출 IP에 1번에서 확인한 IP를 추가해요. (최대 3개까지 등록할 수 있어요.)
- 주문 관련 API 권한을 선택해요 — 주문 조회, 발주 확인, 발송 처리.
- 발급된 애플리케이션 ID와 애플리케이션 시크릿을 복사해요.
시크릿은
$2a$로 시작하는 긴 문자열이에요.
3. 하나로에 입력하고 저장
설정→마켓 계정→스마트스토어화면에서 입력해요.- 판매자 아이디 — 스마트스토어 판매자센터 로그인 아이디예요. 한 아이디로 스토어를 여러 개 운영한다면 스토어마다 따로 등록해 주세요(애플리케이션도 스토어마다 따로 만들어요). 같은 아이디로 이미 등록된 스토어가 있으면 하나로가 “다른 스토어를 추가하는 건지” 한 번 더 물어봐요. 다른 스토어면 [계속], 같은 스토어를 또 등록하는 거면 [취소]를 눌러 주세요 — 같은 스토어를 두 번 등록하면 주문이 두 번 들어와 매출이 겹쳐 잡혀요. 이미 등록된 계정([재인증])에서는 바꿀 수 없고, 비어 있어도 키를 저장할 수 있어요.
- 애플리케이션 ID
- 애플리케이션 시크릿
- [저장] — 하나로가 키로 연결을 확인하고, 통과하면 저장해요. 실패하면 저장하지 않고 이유를 보여 줘요(IP 미등록이면 등록할 IP도 함께).
시크릿은 Windows DPAPI로 암호화되어 이 컴퓨터에서만 풀 수 있는 형태로 저장돼요. 다시 열었을 때 시크릿 칸은 비어 있는 것이 정상이에요 — 비워 두고 저장하면 저장된 시크릿을 그대로 써요.
4. 인터넷 주소(IP)가 바뀌면
가정용·일반 사무실 인터넷은 IP가 바뀔 수 있어요(공유기 재시작, 통신사 정책, 다른 장소에서 노트북 사용 등). IP가 바뀌면 주문 받기가 멈추고 다음 안내가 떠요.
이 PC의 인터넷 주소(IP) 000.000.000.000가 커머스API 애플리케이션에 등록되지 않았습니다.
이때는 커머스API센터 → 애플리케이션 → API 호출 IP에 새 IP를 추가하면 다시 동작해요. 자주 바뀐다면 통신사의 고정 IP 부가서비스를 쓰시는 방법도 있어요.
자주 나오는 안내 문구
| 안내 문구 | 뜻과 조치 |
|---|---|
| 인터넷 주소(IP)가 …등록되지 않았습니다 | 커머스API센터에 표시된 IP를 추가하세요. |
| 애플리케이션 ID 또는 시크릿이 맞지 않습니다 | 커머스API센터에서 값을 다시 복사해 붙여 넣으세요. |
| PC 시계가 맞지 않아 … 거부됐습니다 | Windows 설정 → 시간 및 언어 → [지금 동기화] 후 다시 시도하세요. |
| 커머스API 키가 등록되지 않았습니다 | 기존 스마트스토어 계정의 [재인증]에서 위 2~3번 절차로 키를 등록하세요. 새로 추가하지 마세요. |
| 이 애플리케이션은 이미 ‘…’ 계정에 등록돼 있습니다 | 같은 스토어라면 안내된 그 계정의 [재인증]에서 키를 바꾸세요. |
| 요청 한도를 넘었습니다 | 잠시 후 다시 시도하세요. |
지금 지원하지 않는 기능
커머스API에 해당 기능이 없어 하나로에서도 지원하지 않아요. 필요하면 스마트스토어 판매자센터에서 직접 처리하세요.
- 이미 등록한 송장번호 수정 — 커머스API로는 못 해요. 다만 하나로 번호와 마켓 번호가 다를 때 쓰는 [우리 번호로 전송]은 커머스API가 아니라 셀러센터 로그인 창으로 처리해요. 자세한 방법은 송장번호 불러오기·불일치 처리를 보세요.
- 송장 등록 취소 통보
쿠팡
한 줄 요약 — 쿠팡 Wing에서 OpenAPI를 신청해 키 3개(업체코드·Access Key·Secret Key)를 받아 하나로에 넣어요. 승인까지 영업일 1~3일 걸리니 미리 신청하세요.
- OpenAPI 신청주문 조회 · 발송 처리 · 반품/교환(권장)을 선택해요
- 승인 대기영업일 1~3일
- 하나로에 입력업체코드 · Access Key · Secret Key
- 저장저장할 때 키가 맞는지 확인해요
키 받는 법
- 쿠팡 Wing에 로그인해요.
- 설정 → OPEN API로 들어가요.
- 사용 범위에서 주문 조회, 발송 처리, 반품 / 교환을 선택해 신청해요.
반품 / 교환 범위를 빼고 신청하면 쿠팡 취소·반품·교환이 하나로에 반영되지 않아요. 신청 때 꼭 함께 선택하세요. 자세한 내용은 아래 접기에 있어요.
- 계정 이름 — 꼭 적어요.
- 업체코드(Vendor ID) — A로 시작하는 8자리예요.
- Access Key — 쿠팡 Wing OpenAPI에서 받은 키예요.
- Secret Key — 비밀번호처럼 다뤄요.
- [저장] — 저장할 때 키가 맞는지 확인해요.
자세히 보기 — 신청 절차 · 입력 칸 · 같은 업체 중복 등록 · WING 로그인 아이디(AI 직원용) · 요청 횟수 제한
1. Wing OpenAPI 신청
- 쿠팡 Wing 로그인 후 좌측 메뉴 설정 → OPEN API 또는 직접 쿠팡 OPEN API 포털 접속.
- API 신청 → 사용 범위 선택:
- 주문 조회 (필수)
- 발송 처리 (필수)
- 반품 / 교환 (권장 — 하나로가 쿠팡 취소·반품·교환을 받아 송장 등록·로젠 접수에서 빼는 데 필요)
- 승인 완료 후 VendorId, AccessKey, SecretKey 발급.
반품 / 교환 범위가 빠져 있으면 [마켓 동기화] 결과에 “쿠팡 Open API 키가 취소·반품·교환 조회를 거부해 받지 못했습니다”가 떠요. 신규 주문·배송 중 주문은 그대로 받지만, 쿠팡 취소·반품·교환은 하나로에 반영되지 않고 완료된 주문 자동 정리도 쉬어 가요. 쿠팡 Wing → 설정 → OPEN API에서 사용 범위에 반품 / 교환을 추가 신청하면(영업일 1~3일) 다음 동기화부터 받아와요.
승인까지 영업일 1~3일 걸려요. 미리 신청해두세요.
2. Hanaro에서 등록
설정→마켓 계정(F12) → [+ 마켓 추가] → 마켓에서쿠팡선택.- 입력:
- 업체코드 (Vendor ID) —
A로 시작하는 8자리, 예:A00012345 - Access Key
- Secret Key
- WING 로그인 아이디 (선택 — 이 칸은 AI 직원을 고용했을 때만 보여요. 아래 3번 설명)
- 업체코드 (Vendor ID) —
- [저장]. 저장할 때 자격증명이 맞는지 한 번 확인하고, 실패하면 창에 사유가 표시돼요.
같은 쿠팡 업체는 한 번만 등록할 수 있어요. 입력한 업체코드(Vendor ID)나 Access Key를 다른 쿠팡 계정이 이미 쓰고 있으면 “이미 등록된 쿠팡 업체예요 — ‘…’ 계정에서 쓰고 있어요”라는 안내와 함께 저장이 막혀요. 같은 업체라면 안내된 그 계정의 [재인증]에서 키를 바꿔 주세요 — 같은 업체를 두 번 등록하면 주문이 두 번 들어와 매출이 겹쳐 잡혀요.
3. WING 로그인 아이디 (문의 답변용, 선택)
이 칸은 AI 직원을 고용했을 때만 보여요. AI 직원을 쓰지 않으면 이 칸이 없으니 건너뛰세요.
AI 직원이 쿠팡 상품문의에 답변을 등록할 때, 쿠팡은 답변자가 누구인지를 함께 보내라고 요구해요. 쿠팡 공식 API 문서가 이 항목을 “응답자 셀러포탈(WING) 아이디” 라고 적고 있어, Hanaro는 쿠팡 WING에 로그인할 때 쓰시는 아이디를 여기에 넣도록 했어요 (비밀번호는 입력하지 않아요). API 키와 달리 조회할 방법이 없어 셀러가 직접 적어 주셔야 해요. 입력한 값은 다른 자격증명과 똑같이 Windows DPAPI로 암호화되어 이 컴퓨터에만 저장돼요.
정직하게 적어요: 이 항목은 아직 실제 쿠팡 계정으로 답변을 등록해 확인하지 못했어요 (근거는 쿠팡 공식 문서 문구뿐이에요). 혹시 답변이 계속 실패하면 하나로 고객센터로 알려 주세요.
- 비워 두어도 돼요. 주문 받기·송장 전송은 WING 아이디 없이 그대로 동작해요.
- 비워 두면 문의 답변 등록만 쓸 수 없어요. 승인함에서 답변을 승인하면 “쿠팡 WING 아이디가 설정되지 않아 답변을 등록할 수 없습니다”라고 안내되고, 답변은 마켓으로 나가지 않아요. (그 답변은 쿠팡 WING에서 직접 등록하시면 돼요.)
- 오타가 있어도
저장은 그대로 돼요 — 확인할 API가 없어 입력 시점에는 맞는지 알 수 없고, 나중에 답변이 실패(권한 없음·거절)할 때에만 드러나요. - 이미 등록해 둔 쿠팡 계정에 나중에 추가하실 때는
재인증을 누르면 Vendor ID·Access Key는 채워진 채로 열리고, Secret Key는 비워 두면 저장된 값으로 연결을 확인해요 — WING 아이디만 넣고저장하면 돼요. (저장된 Secret Key는 보안상 화면에 다시 채워 넣지 않아요. Vendor ID나 Access Key를 바꾸면 키 쌍이 달라지므로 Secret Key를 새로 입력해야 해요.) - 나중에 채워 넣거나 바꾸면 다음 답변부터 바로 적용돼요 — 앱을 다시 켤 필요가 없어요.
- 칸을 비우고
저장하면 저장해 둔 아이디가 삭제되고, 답변 등록은 다시 쓰이지 않아요.
4. 쿠팡 특이사항
- 쿠팡은 모든 요청에 보안 서명을 요구해요 — 하나로가 알아서 처리하니 따로 할 일은 없어요.
- 쿠팡은 1분에 요청할 수 있는 횟수가 60회로 정해져 있어요 — 넘으면 하나로가 잠시 기다렸다가 다시 시도해요.
카페24
한 줄 요약 — 카페24 개발자센터에서 내 앱을 만들고(권한 7개 선택), 하나로에 Mall ID·Client ID·Client Secret을 넣고 [카페24 연결하기]로 [허용]해요. 한 번 연결하면 인증은 자동으로 갱신돼요.
- 앱 만들기카페24 개발자센터에서 새 앱을 만들어요
- Redirect URI · 권한 7개주소를 글자 그대로 등록하고 권한을 모두 선택해요
- 하나로에 입력Mall ID · Client ID · Client Secret
- [카페24 연결하기]카페24에 로그인해서 [허용]을 눌러요
Redirect URI는
https://hanaro-docs.pages.dev/cafe24-app-callback/로, 마지막/까지 글자 하나 다르지 않게 등록해요. 다르면 [허용] 뒤 연결이 실패해요.
연결 앱을 바꾸면 되돌릴 수 없어요. 한 번 내 앱으로 바꾸면 하나로 공용 앱으로는 돌아갈 수 없어요. 또 카페24 개발자센터에서 앱을 지우면 연결이 끊기니 앱을 지우지 마세요. 자세한 내용은 아래 접기의 “이미 연결해 둔 카페24 계정”에 있어요.
카페24 개발자센터에서 할 일
먼저 카페24 개발자센터에서 앱을 만든 뒤, 앱 설정의 “개발 정보 관리”(STEP 01) 화면에서 아래 두 가지를 해 주세요.
① Redirect URI 등록
- Redirect URI(s) 칸 —
https://hanaro-docs.pages.dev/cafe24-app-callback/를 마지막/까지 그대로 붙여 넣어요. 하나로 연결 화면의 [복사] 버튼으로 복사하면 틀리지 않아요.
② 권한 5줄 추가
- 상품(Product) — 읽기권한
- 주문(Order) — 읽기+쓰기권한 — 주문을 가져오고 송장을 올릴 때 써요.
- 게시판(Community) — 읽기+쓰기권한 — 고객 문의 확인·답변용이에요(준비 중이지만 미리 켜 둬요).
- 상점(Store) — 읽기권한 — [쇼핑몰 추가]에서 쇼핑몰 목록을 불러올 때 써요.
- 배송(Shipping) — 읽기권한 이상이면 돼요. 그림처럼 읽기+쓰기여도 괜찮아요.
위 5줄 중 하나라도 빠지면 하나로에서 [카페24 연결하기]를 눌러도 [허용] 화면이 열리지 않을 수 있어요. 다 추가한 뒤 꼭 [저장]을 눌러요. 그림에 없는 권한(회원·프로모션 등)은 켤 필요가 없어요.
이 그림은 하나로 쪽 앱 화면이에요. 셀러 본인 앱도 같은 화면이고, 앱 이름·Client ID·Client Secret만 달라요. 이 값들은 그림에서 가렸어요.
- 계정 이름 — 꼭 적어요.
- Mall ID — 카페24 관리자 주소 앞부분이에요(예: mystore.cafe24.com이면 mystore).
- Client ID — 개발자센터 앱의 Client ID예요.
- Client Secret — 비밀번호처럼 다뤄요.
- Redirect URI — 개발자센터 앱에 글자 하나 다르지 않게 등록해요. [복사]로 복사할 수 있어요.
- [카페24 연결하기] — 입력이 다 되면 켜져요. 눌러서 카페24 화면에서 [허용]해요.
자세히 보기 — 앱 만들기 · 하나로에서 연결 · 이미 연결한 계정
카페24는 셀러 본인이 카페24 개발자센터에서 만든 앱으로 연결해요. 앱을 한 번 만들어 두면 그 뒤로는 하나로가 주문 조회·송장 전송에 필요한 인증을 자동으로 갱신해요.
1. 카페24 개발자센터에서 앱 만들기
- 카페24 개발자센터에 카페24 계정으로 로그인한 뒤 새 앱을 만들어요.
-
앱 설정의 Redirect URI에 아래 주소를 글자 하나 다르지 않게 등록해요. 하나로 연결 화면에도 같은 주소와 [복사] 버튼이 있어요.
https://hanaro-docs.pages.dev/cafe24-app-callback/마지막
/까지 그대로 넣어 주세요. 주소가 조금이라도 다르면 [허용]을 누른 뒤 연결이 실패해요. -
앱 권한(scope) 에서 아래 7개를 모두 선택해요(위 그림 참고 — 개발자센터에서는 분류별로 “읽기권한” / “읽기+쓰기권한”을 골라요). 하나라도 빠지면 연결 창에서 진행되지 않을 수 있어요.
권한 하나로가 쓰는 곳 주문 읽기·쓰기 ( mall.read_order,mall.write_order)주문 가져오기, 송장 등록 배송 읽기 ( mall.read_shipping)택배사 목록 (준비 중) 상점 읽기 ( mall.read_store)[쇼핑몰 추가]의 쇼핑몰 목록 게시판 읽기·쓰기 ( mall.read_community,mall.write_community)문의 확인·답변 (준비 중) 상품 읽기 ( mall.read_product)상품 정보 참고 (준비 중) 하나로는 이 7개 외의 권한(회원·프로모션 등)은 요청하지 않아요. 앱에 더 많은 권한을 켜 두어도 하나로는 위 7개에만 동의를 받아요.
- 발급된 Client ID와 Client Secret을 확인해요. Client Secret은 비밀번호처럼 다루고 다른 사람에게 알려 주지 마세요.
2. 하나로에서 연결하기
설정→마켓 계정→ [+ 마켓 추가] →카페24선택.- Mall ID를 입력해요. 카페24 관리자 주소
mystore.cafe24.com의 앞부분(mystore)이에요. - Client ID와 Client Secret을 입력해요.
카페24 연결하기클릭 → 인증 창에서 카페24에 로그인 → [허용] → 창이 자동으로 닫혀요.- 토큰과 Client ID/Secret은 이 컴퓨터에서만 풀 수 있도록 암호화되어 저장돼요 (만료 전 자동 갱신).
버튼이 회색으로 눌리지 않으면 버튼 아래 문구에 무엇이 빠졌는지 표시돼요. 연결 직후 “주문 조회 확인에 실패했습니다”가 보이면 문구에 적힌 사유(예: 앱의 API 버전)를 운영팀에 알려 주세요.
이미 연결해 둔 카페24 계정
- 기존 방식(하나로 공용 앱)으로 연결해 둔 계정은 그대로 동작해요. 다시 연결해야 할 때는
[재인증]→ Client ID/Secret을 비운 채카페24 연결하기를 누르면 기존 방식으로 연결돼요. -
본인 앱으로 바꾸려면
[재인증]에서 Client ID/Secret을 입력하고 연결을 끝까지 완료하세요. 앱을 바꾸면 기존 연결은 새 앱으로 갱신되지 않으므로, 중간에 그만두면 주문 받기가 멈춰요.한 번 본인 앱으로 바꾸면 기존 방식(하나로 공용 앱)으로는 되돌릴 수 없어요. 되돌리려면 계정을 지우고 새로 등록해야 하는데, 새 등록도 본인 앱이 필요해요. 또 개발자센터에서 그 앱을 지우면 연결이 끊기니 앱을 지우지 마세요.
- 본인 앱으로 연결한 계정을 다시 연결할 때 Client ID가 같다면 Client Secret은 비워 두어도 돼요.
- 계정을 삭제하고 다시 등록하지 마세요. 같은 몰을 새로 등록하면 주문 이력이 두 계정으로 나뉘어요.
하나로가 요청하는 권한이 늘었을 때 (하나로 0.4.1)
한 줄 요약 — 권한이 주문 2개에서 7개로 늘었어요. 주문 가져오기·송장 등록은 그대로 되고, 새 기능만 [재인증] 한 번이면 써요. 계정을 지우지 마세요.
- [재인증]설정 → 마켓 계정의 카페24 카드에서 눌러요
- [카페24 연결하기]Client ID/Secret은 저장돼 있으면 비워 두어도 돼요
- [허용]늘어난 권한까지 허용하면 창이 저절로 닫혀요
자세히 보기 — 왜 필요한지 · 단계 설명
하나로 0.4.1부터 카페24에 요청하는 권한이 주문 2개에서 7개로 늘었어요(위 1번의 표). 그 전에 연결한 계정도 주문 가져오기·송장 등록은 그대로 동작해요. 새 권한이 필요한 기능(예: [쇼핑몰 추가]의 쇼핑몰 목록)만 한 번 다시 연결하면 쓸 수 있어요. 계정을 지우고 새로 등록할 필요는 없어요. 아래 3단계면 끝나요.
설정→마켓 계정에서 카페24 카드의 [재인증]을 눌러요. (아래 그림 ①)- 카드 안에 입력 칸이 열리면 [카페24 연결하기]를 눌러요. Client ID/Secret은 이미 저장돼 있으면 비워 두어도 돼요.
- 카페24 화면이 열리면 늘어난 권한까지 [허용]을 눌러요. 창이 저절로 닫히면 끝이에요.
본인 앱(Client ID/Secret)으로 연결하셨다면 [재인증] 전에 카페24 개발자센터의 그 앱에 위 7개 권한을 먼저 모두 켜 주세요.
한 몰에 쇼핑몰이 여럿일 때 — [쇼핑몰 추가]
카페24는 한 몰(Mall ID) 안에 쇼핑몰을 여러 개(국문몰·영문몰 등, 쇼핑몰 번호 1·2·3…) 둘 수 있어요. 처음 연결하면 기본 쇼핑몰(1번)만 등록돼요. 다른 쇼핑몰의 주문도 받으려면 카페24 카드의 [쇼핑몰 추가]를 누르세요.
- [쇼핑몰 추가]카페24 카드에서 눌러요 (다시 로그인 안 해도 돼요)
- 쇼핑몰 고르기목록에서 고르거나 번호를 직접 입력해요
- [추가]눌러야 계정이 생겨요
자세히 보기 — 목록이 없을 때 · 확인 방식
- 목록이 없으면 카페24 관리자에서 확인한 쇼핑몰 번호를 직접 입력하고 계정 이름을 정한 뒤 [추가]를 누르세요. 이미 추가한 쇼핑몰은 목록에서 빠져 있어요.
- 다시 로그인할 필요가 없어요. 같은 몰의 쇼핑몰들은 연결 하나를 함께 써요.
- 목록 대신 “카페24 권한이 새로 늘었어요…”가 보이면 위 3단계로 [재인증]하면 다음부터 목록에서 고를 수 있어요. 그 전에도 번호를 직접 입력해 추가할 수 있어요.
- 추가할 때는 연결이 살아 있는지만 확인해요. 번호가 맞는지는 확인하지 못해서, 최근 2개월 주문이 없으면 번호를 다시 확인하라고 알려 드려요(추가는 돼요).
ESM(G마켓·옥션)
한 줄 요약 — 키는 필요 없어요. ESM PLUS 아이디·비밀번호로 로그인하면 G마켓·옥션 주문을 함께 받아와요. 송장은 로젠만 자동 등록해요. 공식 API가 아니라 비공식 연결이에요.
- 로그인 방식 고르기ESM PLUS 마스터 · G마켓 판매자 · 옥션 판매자
- 아이디 · 비밀번호계정 이름도 함께 적어요
- [저장]하나로가 로그인해 확인해요. 보안문자·2단계 인증이 나오면 창에서 마쳐요
- 저장 완료비밀번호는 이 컴퓨터에서만 풀 수 있게 암호화돼요
로젠이 아닌 택배사 송장은 ESM PLUS에서 직접 발송처리해 주세요. 같은 ESM 계정을 마스터와 판매자 아이디로 따로 등록하지 마세요.
송장을 보냈는데 “처리 결과를 확인하지 못했습니다”가 보이면 다시 보내지 말고 ESM PLUS에서 먼저 확인하세요. 실제로는 처리됐을 수 있어요. 자세한 내용은 아래 접기의 “3. 송장 등록(발송처리)”에 있어요.
- 로그인 방식 — ESM PLUS 마스터 · G마켓 판매자 · 옥션 판매자 중에 골라요.
- ESM 아이디 — ESM PLUS 로그인 아이디예요.
- 비밀번호 — 이 컴퓨터에서만 풀 수 있게 암호화해 저장해요.
- [저장] — 하나로가 로그인해 확인하고 통과하면 저장해요. 보안문자·2단계 인증이 나오면 뜨는 창에서 마쳐요.
자세히 보기 — 등록 · 주문이 들어오는 방식 · 송장 등록 · 한 상자로 묶기 · 지원하지 않는 기능
ESM PLUS 마스터 계정 하나로 G마켓·옥션 주문을 함께 받아와요. 공식 API가 아니라
ESM PLUS에 로그인한 상태로 주문 화면이 쓰는 정보를 읽어 오는 방식이에요. 처음 설정(온보딩)의 마켓 선택 화면에는 스마트스토어·쿠팡·카페24·ESM (G마켓·옥션) 4종과 ‘추후 추가’ 카드가 보이고, ESM 카드에는 비공식 연결로 표시돼요.
ESM은 주문 받아오기와 로젠 송장 자동 등록을 지원해요. 로젠이 아닌 택배사 송장은 ESM PLUS에서 직접 발송처리해 주세요.
1. 하나로에서 등록
설정→마켓 계정→ [+ 마켓 추가] →ESM (G마켓·옥션)선택(처음 설정의 마켓 선택 화면에서도 같은 이름이에요).- 로그인 방식을 골라요 — ESM PLUS 로그인 화면의 탭과 같아요.
ESM PLUS 마스터(기본): ESM PLUS 마스터·매니저 아이디G마켓 판매자: G마켓 판매자 아이디로도 주문을 받아올 수 있어요.옥션 판매자: 옥션 판매자 아이디. 이 방식으로 주문을 받아오는지는 아직 확인 중이에요 — [저장]이 성공하면 쓸 수 있어요.
- 아이디와 비밀번호를 입력해요.
- [저장] — 하나로가 보이지 않는 창에서 고른 로그인 방식 탭으로 ESM PLUS에 로그인한 뒤 주문 목록을 한 번 불러와 확인하고, 통과하면 저장해요. 2단계 인증이나 보안문자가 나오면 로그인 창이 앞으로 떠요. 창에서 마쳐 주세요. 로그인에 실패하면 저장하지 않고 이유를 보여 줘요. 비밀번호는 이 컴퓨터에서만 풀 수 있도록 암호화되어 저장돼요.
- ESM 계정이 여러 개면 계정마다 따로 추가해요. 추가할 때 계정마다 구분되는 이름을 적어 두면 헷갈리지 않아요.
- 같은 아이디는 두 번 등록할 수 없어요. 같은 ESM 계정을 마스터 아이디와 G마켓·옥션 판매자 아이디로 따로 등록하지 마세요 — 같은 주문이 두 번 들어오지 않도록 하나로가 한쪽의 주문 받기를 멈춰요(먼저 주문을 받아 둔 판매처와 판매자 계정이 겹치는 쪽).
- 로그인 방식을 잘못 골랐으면 카드의 [재인증]에서 바꾸고 [저장]을 다시 하세요(아이디는 바꿀 수 없어요).
2. 주문은 이렇게 들어옵니다
- 주문 목록의 마켓 칸에 G마켓 주문은 G, 옥션 주문은 A로 표시돼요(마우스를 올리면 마켓 이름
ESM). 사이트를 알 수 없는 주문은 ES예요. 위쪽 마켓 탭은 ESM 계정마다 하나예요 — G마켓·옥션은 탭으로 나누지 않고 주문 목록에서 구분해요. - 매출·대시보드에서는 G마켓·옥션을 나누지 않고 계정 하나로 보여요.
- 주소·전화번호·옵션은 ESM PLUS의 신규주문·발송관리 화면 목록에서 한꺼번에 받아 와요. 발송 전 주문은 주문을 받을 때마다 최신 배송지로 다시 확인해요. 목록에서 찾지 못한 새 주문만 주문마다 따로 받고, 이건 한 번에 받는 수에 상한이 있어요 — 많으면 “배송지 N건은 다음 수집 때 이어서 받아요”가 보이고 다음 수집 때 나머지를 받아요. ESM 응답이 여러 번 연달아 실패하면 “ESM 화면이 바뀌었을 수 있어요 — 하나로 업데이트가 필요할 수 있어요”로 알려 드려요. 일부를 받지 못한 수집은 “ESM 배송지·송장 일부를 받지 못했어요 — 다음 수집 때 다시 받아요”로 알려 드려요.
- ESM PLUS에서 직접 발송처리한 주문의 송장번호도 하나로에 들어와요. 하나로에 송장번호가 없는 배송중·배송완료·구매확정 주문은
ESM PLUS의 배송현황·구매결정 화면 목록에서 송장번호와 택배사를 받아 와요(배송완료·구매확정 목록은 6시간에 한 번 확인하고, [과거 주문 받기]는 매번 확인해요).
- 하나로에 이미 송장번호가 있으면(로젠 자동접수·직접 입력) 바꾸지 않아요. ESM 번호가 다르면
⚠ 마켓 불일치로만 알려 드려요. - 방문수령 주문은 택배사 칸에
(방문수령)으로 보여요(송장번호는 받지 않아요). - 하나로가 모르는 택배사로 발송처리한 주문은 송장번호를 받지 않아요 —
“하나로가 모르는 택배사 N건은 송장번호를 받지 않았어요”가 보이면 ESM PLUS에서 확인해 주세요.
송장번호가 가려져 있거나(
*) 형식이 맞지 않을 때도 받지 않고 건수만 알려 드려요.
- 하나로에 이미 송장번호가 있으면(로젠 자동접수·직접 입력) 바꾸지 않아요. ESM 번호가 다르면
- ESM 로그인이 끊기면 다음에 주문을 받을 때 저장한 아이디·비밀번호로 다시 로그인해요. 자동으로 도는 주문 받기(주기 수집)나 접수 직전 배송지 확인 중에는 로그인 창을 띄우지 않아요 — 보안문자·2단계 인증이 필요하면 “ESM 로그인 확인(2단계 인증·보안문자)이 필요해 주문을 받지 못했습니다 — …”가 보여요(버튼 이름은 [마켓 동기화]). [마켓 동기화]를 누르면 창이 열려 직접 마칠 수 있어요.
- 대시보드의 마켓별 진행 현황에서 ESM 줄의 숫자를 누르면 그 상태에 맞는 ESM PLUS 화면이 하나로 안의 창으로 열려요 — 신규 → 신규주문 관리, 발주확인 → 발송관리, 배송중 → 배송현황, 완료 → 배송현황의 배송완료. 열기 전에 이 ESM 카드에 저장된 로그인 방식·아이디·비밀번호로 먼저 로그인해요(보안문자·추가 인증이 나오면 창에서 마쳐 주세요). 완료 칸은 하나로에서는 구매확정·취소 등도 함께 세지만 ESM 화면에는 배송완료만 보여요. 이슈 칸은 취소·반품·교환이 ESM에서 서로 다른 화면이라 하나로 주문 화면으로 열려요. ESM 계정이 여러 개면 다른 계정이 로그인할 때 열린 창의 계정이 바뀔 수 있으니, 화면 오른쪽 위 계정을 확인하세요.
- 받은 주문 수가 ESM이 알려 준 주문 수보다 적으면 “주문이 빠졌을 수 있으니 기간을 나눠 다시 받아 주세요”로 알려 드려요.
- ESM 판매자 정보가 지난번과 전혀 다르면(다른 계정의 로그인이 섞였을 수 있음) 주문을 저장하지 않고 멈춰요 — ESM 카드의 [재인증] → [저장]으로 계정을 확인하면 다시 받아 와요. [저장]할 때의 로그인 확인은 최근 주문에서 G마켓·옥션 판매자 정보를 함께 기억해요. 하나로가 창을 띄우지 않고 이 카드의 아이디로 방금 새로 로그인한 경우에는 같은 계정의 다른 사이트로 보고 새로 기억한 뒤 알려 드려요(다른 ESM 카드와 겹치면 그대로 멈춰요).
3. 송장 등록(발송처리)
주문 화면에서 주문을 체크하고 [선택 주문 송장 등록]을 누르면 다른 마켓처럼 ESM에도 송장이 등록돼요.
- 로젠 송장만 자동으로 등록해요. 다른 택배사 송장은 확인 창에
제외로 표시되고 “로젠 외 택배사 자동 등록 미지원 — ESM PLUS에서 직접 발송처리”로 따로 세어요. 그 주문은 ESM PLUS에서 발송처리해 주세요. - 새 주문(
신규주문)은 ESM [주문확인]을 먼저 한 뒤 발송처리해요. 확인 창에 ESM PLUS와 같은 주의사항이 함께 보여요 — 주문확인 후 발송마감일이 지나도록 실제로 보내지 않거나 구매자 요청 없이 취소하면 불이익을 받을 수 있으니, 재고를 확인한 뒤 진행하세요. 주문제작 상품은 구매자에게 발송예정일을 정확히 알린 뒤 주문확인하세요. - 하나로는 보내기 직전에 ESM에서 그 주문의 지금 상태를 한 번 더 확인해요. 이미 발송처리됐거나, 취소·환불됐거나,
클레임 표시가 있거나, 상태를 알 수 없으면 보내지 않고 [상태] 열에
등록 실패: …로 사유를 남겨요(실패 건수에 들어가요). ESM에서 이미 발송처리된 주문은등록 실패: ESM에서 이미 발송처리된 주문이라 보내지 않았습니다…로 보여요 — 송장번호를 바꾸려면 ESM PLUS에서 직접 수정하세요. - ESM이 처리 결과를 분명히 알려 주지 않으면(응답을 받지 못했거나 어느 주문이 실패했는지 가를 수 없을 때) 그 묶음의 주문이 모두
등록 실패: ESM 처리 결과를 확인하지 못했습니다 — ESM PLUS에서 처리됐는지 확인해 주세요(확인하기 전에 다시 보내지 마세요)로 보여요. 실제로는 처리됐을 수 있어요. 요약 줄에 “실패 건은 다시 시도해 주세요”가 함께 보여도 이 주문은 ESM PLUS에서 먼저 확인하고, 처리되지 않았을 때만 다시 등록하세요. - 이미 발송처리한 송장번호 수정·송장 취소는 지원하지 않아요 — ESM PLUS에서 직접 해 주세요.
- 송장 등록 중 ESM 로그인에 보안문자·2단계 인증이 필요하면 로그인 창이 떠요. 창에서 마쳐 주세요.
같은 분에게 가는 주문은 한 상자로
한 줄 요약 — 같은 ESM 계정·같은 사이트에서 받는 분 이름·우편번호·주소가 같은 주문은 함께 체크하면 한 상자(운송장 하나)로 나가요.
- `묶음 N` 확인주문번호 아래에 보내지 않은 같은 분의 주문 수가 보여요
- 함께 체크묶을 주문을 모두 체크해요
- [택배 자동접수]체크한 주문끼리 운송장 하나로 접수돼요
자세히 보기 — 묶는 규칙 · 일부만 먼저 접수했을 때 · 송장번호 입력
ESM은 장바구니로 함께 산 상품도 주문번호가 하나씩 따로 나와요. 그래서 하나로는 같은 ESM 계정에서, 같은 사이트(G마켓끼리·옥션끼리)로, 받는 분 이름·우편번호·주소가 같은 주문을 한 상자로 묶어 보낼 수 있게 해 드려요.
- 주문 목록의 주문번호 아래에
묶음 N이 보이면 아직 보내지 않은 같은 분의 주문이 N건 있다는 뜻이에요(이미 보낸 지난 주문은 세지 않아요). 체크는 다른 마켓처럼 한 줄씩 해요. - 묶을 주문을 함께 체크하고 [택배 자동접수]·[택배 접수용 엑셀]을 하면 체크한 주문끼리 한 상자(운송장 하나)가 돼요. 이미 보낸 주문은 함께 체크해도 묶지 않아요.
- 상자의 주문번호는 그중 가장 작은 주문번호로 접수되고, 받은 송장번호는 묶인 주문 모두에 똑같이 들어가요. 하나만 체크하면 그 주문만 따로 보내요.
- G마켓 주문과 옥션 주문은 같은 분이어도 묶지 않아요.
- 일부만 먼저 접수·출력했다면(예: A만 보냈는데 나중에 같은 분의 B·C를 발견) A·B·C를 모두 체크해 [택배 자동접수]로 다시 접수해 주세요. 셋이 한 운송장으로 접수되고(물품명에 세 주문의 상품이 모두 찍혀요) 새 송장번호가 셋 모두에 들어가요. 확인 창에 “이미 접수한 기록”이나 “이미 송장번호가 있는 주문” 경고가 보이는데, 다시 접수하려는 것이 맞으면 그대로 진행하세요. 먼저 뽑은 A의 옛 운송장은 버려 주세요. A를 [접수만]으로 접수해 두고 아직 출력하지 않았다면 확인 창에 “출력 요청 파일로 아직 출력하지 않은 이전 접수” 경고가 함께 떠요 — 프린터가 있는 PC에서 옛 출력 요청 파일로 출력하지 않게 해 주세요(출력하면 운송장이 두 장이 돼요). 옛 접수 기록은 로젠이 이번 접수를 받은 것이 확인된 뒤에 바뀌어요. 로젠이 오류로 돌려보내거나 접수됐는지 확인하지 못하면 옛 접수는 그대로 남고, B·C에는 송장번호가 채워지지 않아요 — 로젠 화주센터에서 확인한 뒤 다시 접수하거나 송장번호를 직접 넣어 주세요. 드물게 하나로가 접수 기록을 저장하지 못하면 “송장번호를 채우지 않았습니다” 안내가 뜨고 번호가 비어 있어요 — 같은 방법으로 확인해 주세요. A의 송장번호를 B·C에 직접 넣는 방법은 운송장에 B·C 상품이 찍히지 않아 쓰면 안 돼요.
- 전화번호는 보지 않아요. 이름이나 주소가 한 글자라도 다르면(띄어쓰기·대소문자 차이는 같게 봐요) 묶이지 않으니, 따로 보내도 될지 확인해 주세요.
- 한 번 접수한 상자는 체크하지 않는 한 그 구성 그대로 유지돼요. 접수한 뒤에 같은 분의 새 주문이 들어와도 저절로 그 상자에 끼어들지 않아요 — 함께 보내려면 위처럼 모두 체크해 다시 접수하세요. 묶여 있던 상자의 일부만 다시 접수하면, 이번에 체크하지 않은 주문은 그 상자에서 빠져요(송장번호는 그대로예요) — 확인 창에 “같은 운송장으로 나갔던 주문 N건이 이번 접수에서 빠집니다”로 알려 드려요. 다른 PC에서 먼저 접수한 주문을 다시 체크해 접수할 때도 확인 창에 “이미 로젠에 접수한 기록이 있는 주문”으로 알려 드려요. 로젠이 오류로 받지 않은 상자는 내용을 고쳐 다시 접수할 때 다시 묶여요.
- [송장번호 불러오기]는 새로 묶지 않아요. 하나로로 한 상자로 접수한 주문만 같은 번호를 받고, 그 밖의 주문은 주문번호마다 따로 찾아요 — [택배 접수용 엑셀]로 묶어 보냈거나 이전 버전·로젠 화면에서 따로 접수한 주문은 번호를 못 찾으면 빈 칸으로 남으니 직접 넣어 주세요.
- 주문을 오른쪽 클릭해 [송장번호 입력/수정]을 열면 “같은 받는 분 주문 N건 전부”(기본)와 “이 주문만” 중에서 고를 수 있어요. “전부”에는 아직 보내지 않은 주문만 들어가요(이미 보낸 지난 주문은 빠져요). 이미 접수한 상자의 주문이면 그 상자의 주문만 들어가요.
- 묶은 주문 중 하나만 “이 주문만”으로 다른 번호나 다른 택배사로 바꿨다면, 상자 번호가 나중에 바뀌어도 그 주문의 번호는 하나로가 덮어쓰지 않아요.
ESM — 지금 지원하지 않는 기능 · 주문 상태 구분
지금 지원하지 않는 기능
- 로젠 외 택배사 송장 자동 등록·송장번호 수정 — ESM PLUS에서 직접 해 주세요(위 3. 참고).
- 주문 상태 구분 — 결제가 끝난 새 주문(
신규주문), ESM [주문확인] 뒤 발송 대기(발주확인), 발송처리 뒤(배송중),배송완료,구매확정, 취소가 끝난 주문(취소)은 구분해요. ESM에서 정산 송금까지 끝난 주문(송금완료)도구매확정으로 보여요(환불이 있었던 주문은알수없음). 결제 전에 취소된 주문은 받지 않아요(매출·발송과 무관) — 받지 않은 건수는 동기화 결과에 알려 드려요. 이미 하나로에 받아 둔 주문이 결제 전 취소로 바뀐 경우는 받아서취소로 바꿔요. 취소는 ESM의 취소 완료 상태와 환불 승인일로 판단해요 — 취소가 끝난 주문(G마켓취소완료, 옥션환불완료)은취소, 환불 승인일이 있는 주문은취소요청이에요. 반품·교환은 아직 따로 구분하지 못해요. 취소 처리일만 있고 환불 승인일이 없는 주문은 취소로 보지 않고 ESM 상태 그대로 두되클레임 확인 필요로 표시해요 (취소가 철회됐거나 반품·교환·미수령 처리일 수 있어요). 옥션 주문의 취소 표시(CN)는 보지 않아요 — 옥션은 취소 이력이 없는 진행 중 주문에도 이 표시를 붙여요. G마켓 주문은 발송 전(신규주문·발주확인)인데 취소 표시(CN)가 붙어 있으면 취소가 진행 중일 수 있어클레임 확인 필요로 표시해요. 그 밖의 클레임 표시(미수령·반품·교환 등)가 환불 승인일 없이 붙은 주문도 ESM 상태 그대로(신규주문·발주확인·배송중등) 보이고, 발송 전이면 [택배 자동접수] 확인창에서 처음부터 체크가 풀리고클레임 확인 필요 — ESM PLUS에서 확인으로 보여요. 상태를 알 수 없는(알수없음) 주문도 발송 전일 수 있어 처음부터 체크가 풀리고상태 확인 필요 — ESM PLUS에서 확인으로 보여요. ESM PLUS에서 확인한 뒤 보낼 주문이면 체크해 접수하세요([택배 접수용 엑셀]은 확인 문구로 건수를 알려 드려요). 상태가알수없음인 주문은 [택배 자동접수]·[택배 접수용 엑셀] 직전에 배송지가 바뀌었는지 확인하지 못해요 — 확인창에주소 확인 필요와 함께 “ESM PLUS에서 배송지를 확인해 주세요”가 표시돼요. - 마켓 문의 답변·블로그 상품 이미지 — ESM 주문에는 쓰지 않아요.
11번가
한 줄 요약 — 오픈API 센터에서 API 키를 확인하고 이 PC의 인터넷 주소(IP)를 등록한 뒤 하나로에 키를 넣어요. 주문 받기·[발주확인]·택배 자동접수·송장 등록이 돼요.
11번가는 셀러오피스 오픈API로 연결합니다. 11번가 오픈API 센터에서 API 키를 확인하고, 그 키에 하나로를 쓰는 PC의 인터넷 주소(IP)를 등록한 뒤, 키를 하나로에 입력하는 방식입니다.
IP를 등록하지 않으면 주문을 가져올 수 없습니다. 11번가는 등록된 IP에서 온 요청만 받아요. IP가 바뀌면(공유기 재시작, 통신사 사정 등) 새 IP를 다시 등록해야 합니다 — 아래 인터넷 주소(IP)가 바뀌면 참고.
1. 오픈API 센터에서 [API 관리] 열기
- 11번가 오픈API 센터에 11번가 판매자 계정으로 로그인합니다.
- 화면 위쪽의 [API 관리]를 누릅니다.
2. API 키 확인하기
- [API 관리] 화면의 API KEY 관리에서 [인증하기]를 누릅니다. 2차 인증을 마쳐야 API 키가 보여요.
- 보이는 API 키를 복사해 둡니다. API 키는 비밀번호처럼 다루고 다른 사람에게 알려 주지 마세요.
3. 이 PC의 인터넷 주소(IP) 등록하기
- 같은 화면의 접속권한에서 IP 직접 입력의 [사용]을 고릅니다.
- IP 칸(개발서버 IP · 개발자 PC · 상용서버 IP 중 한 칸)에 하나로를 쓰는 PC의 인터넷 주소(IP)를 넣습니다.
- 하나로를 쓰는 PC가 여러 대면 한 칸에 세미콜론(
;)으로 이어서 넣을 수 있어요. 예:203.0.113.10;203.0.113.20
- 하나로를 쓰는 PC가 여러 대면 한 칸에 세미콜론(
- [수정하기]를 눌러 저장합니다.
이 PC의 IP는 이렇게 확인하세요. 하나로
설정→마켓 계정→ [+ 마켓 추가]에서 마켓을 고르면 화면에 “이 PC의 인터넷 주소(IP): …” 가 바로 보여요(어느 마켓을 골라도 같은 값). 브라우저에서 “내 IP 주소”를 검색해도 같은 값입니다. 하나로에서 연결에 실패했을 때 안내 문구 끝에 나오는 “(이 PC의 IP: …)”도 같은 값이에요.ipconfig에 나오는192.168.…은 집·사무실 내부 주소라 여기에 쓰면 안 됩니다.
4. 하나로에 입력하고 저장
설정→마켓 계정(F12) → [+ 마켓 추가] → 마켓에서11번가선택.- 입력:
- 계정 이름 (필수) — 아래 계정 이름 정하기 참고.
- 오픈API 키 — 2번에서 복사한 API 키.
- [저장] — 하나로가 11번가에서 최근 주문 목록을 한 번 읽어 확인하고(주문을 바꾸지 않아요), 통과하면 저장합니다. 실패하면 저장하지 않고 이유를 보여 줘요(IP 미등록 포함). API 키는 이 컴퓨터에서만 풀 수 있도록 암호화되어 저장됩니다. 다시 열었을 때 API 키 칸은 비어 있는 것이 정상이에요 — 비워 두면 저장된 키를 그대로 씁니다.
같은 11번가 API 키는 한 번만 등록할 수 있어요. 다른 11번가 계정이 이미 같은 키를 쓰고 있으면 “이미 등록된 11번가 API 키예요 — ‘…’ 계정에서 쓰고 있어요”라는 안내와 함께 저장이 막혀요. 같은 판매자라면 그 계정을 수정해 주세요 — 같은 판매자를 두 번 등록하면 주문이 두 번 들어와 매출이 겹쳐 잡혀요.
인터넷 주소(IP)가 바뀌면
가정용·일반 사무실 인터넷은 IP가 바뀔 수 있습니다(공유기 재시작, 통신사 사정, 다른 장소에서 노트북 사용 등). IP가 바뀌면 11번가가 요청을 받지 않아 주문 수집이 멈추고, 다음과 같은 안내가 뜹니다.
11번가: [203.0.113.10]인증된 IP가 아닙니다. 등록된 IP 정보를 확인하십시오. — 11번가 셀러오피스 > 오픈API 설정에서 API 키와 이 PC의 IP가 등록돼 있는지 확인해 주세요. IP가 바뀌면(공유기 재시작 등) 다시 등록해야 해요. (이 PC의 IP: 203.0.113.10)
이때는 위 3번처럼 오픈API 센터 → [API 관리] → 접속권한에 안내에 나온 새 IP를 넣고 [수정하기]를 누르면, 다음 수집부터 다시 받아 옵니다. 자주 바뀐다면 통신사의 고정 IP 부가서비스를 쓰시는 방법도 있습니다.
주문과 송장은 이렇게 처리됩니다
- 주문 목록의 마켓 칸에 11번가 주문은 11로 표시됩니다.
- 주문 받기 — 새 주문(결제완료)·발주확인(배송준비중)·배송완료 주문을 받아 오고, 이미 받은 주문은 배송중·구매확정·취소로 바뀝니다.
발주확인 전에 구매자가 취소한 주문은 다음 수집 때
취소로 바뀌어요. - 셀러오피스에서 직접 발송한 주문의 송장번호도 하나로에 들어와요.
- [발주확인] — 체크한 새 주문을 11번가에 발주확인합니다.
- [택배 자동접수](로젠) — 접수 직전에 11번가에서 배송지를 한 번 더 확인합니다.
- [선택 주문 송장 등록] — 로젠·CJ대한통운·한진·롯데·우체국 송장을 11번가에 발송처리합니다.
- 같은 배송번호 주문은 함께 처리돼요. 구매자가 한 번에 결제한 여러 상품은 11번가에서 배송번호가 같아, 체크하지 않은 주문도 11번가에서 함께 발송처리됩니다(11번가 안내 기준 — 실제 계정에서는 아직 확인하지 못했어요). 하나로에 그 주문이 있으면 확인 창에 “같은 배송번호(묶음배송) 주문 N건도 11번가에서 함께 발송처리돼요(체크하지 않았어도)”가 보이고, 하나로에는 다음 동기화 때 반영돼요. 따로 결제한 주문은 배송번호가 달라 따로 처리됩니다.
- 배송완료 단계에서 처음 받은 지난 주문은 결제금액 대신 할인 전 주문금액으로 보일 수 있어요 — 이런 주문은 매출이 실제보다 크게 잡힐 수 있습니다.
지금 지원하지 않는 기능
필요하면 11번가 셀러오피스에서 직접 처리하세요.
- 이미 보낸 송장번호 수정·송장 취소
- 반품·교환 목록 받기
- 부분발송
계정 이름 정하기
한 줄 요약 — 마켓 계정을 처음 추가할 때 계정 이름(필수)을 꼭 적어요. 같은 마켓에 계정이 여럿이어도 구분되게 적어요.
- [+ 마켓 추가]마켓을 고르면 바로 아래에 계정 이름 칸이 있어요
- 이름 적기예: 하나플랫폼 쿠팡 (30자까지)
- 나중에 바꾸기카드의 [이름 바꾸기]
자세히 보기 — 이름 규칙
설정 → 마켓 계정 → [+ 마켓 추가]를 누르면 나오는 입력 화면에서, 마켓을 고르는 칸 바로 아래에 계정 이름 (필수) 칸이 있어요. 마켓 계정을 처음 추가할 때는 이 이름을 꼭 적어야 해요. 비어 있으면 저장되지 않고 “이 계정을 구분할 이름을 입력해 주세요”라는 안내가 나와요.
- 같은 마켓의 계정이 여러 개여도 헷갈리지 않게 구분되는 이름을 적어 주세요. (예:
하나플랫폼 쿠팡,이포시스템 쿠팡) - 30자까지 쓸 수 있어요.
- 마켓 이름만 쓰거나(
쿠팡) 마켓 이름 뒤에 숫자만 붙인 이름(쿠팡 2)은 쓸 수 없어요. 같은 마켓에 이미 있는 이름도 안 돼요. - 등록한 뒤에 이름을 바꾸고 싶으면
설정→마켓 계정의 카드에서 [이름 바꾸기]를 누르세요. [재인증] 화면에서는 이름을 바꿀 수 없어요.
등록 후 확인
한 줄 요약 — 설정 → 마켓 계정에서 카드의 상태가 등록됨(초록)이면 정상이에요. 미설정(노랑)이면 [재인증]으로 키를 다시 넣으세요. 미확인(회색)은 저장된 키를 읽지 못한 경우예요. 주문 데이터는 그대로 남아요.
자세히 보기 — 카드 구성 · 재인증 때 채워지는 칸
설정 → 마켓 계정에서 등록된 마켓 목록을 확인할 수 있어요.
카드마다 계정 이름, 그 아래 마켓 · 식별자, 오른쪽에 상태 배지와 [재인증] [삭제] 버튼이 있고, 이름 옆에 [이름 바꾸기] 가 있어요.
처음 설정(온보딩)에서 마켓을 추가할 때 열리는 입력 창도 같은 창이라, 거기서도 계정 이름을 적어야 해요(위 계정 이름 정하기 참고).
| 배지 | 의미 |
|---|---|
| 등록됨 | 키가 저장돼 있어요(초록) |
| 미설정 | 키가 없어요(노랑) — [재인증]으로 넣어 주세요 |
| 미확인 | 저장된 키를 읽지 못했어요(회색) — [재인증]으로 다시 넣으면 돌아와요 |
자격증명을 다시 입력하려면 카드의 [재인증] → 새 값 입력 → [저장]. 기존 주문 데이터는 보존됩니다.
- 스마트스토어 판매자 아이디·애플리케이션 ID, 쿠팡 Vendor ID·Access Key, 카페24 Mall ID는 저장된 값이 미리 채워집니다.
- 스마트스토어 애플리케이션 시크릿·쿠팡 Secret Key는 채워지지 않습니다. 비워 두면 저장된 값을 그대로 씁니다. 바꿀 때만 입력하세요.
- 스마트스토어 애플리케이션 ID나 쿠팡 Vendor ID·Access Key를 바꾸면 시크릿·Secret Key도 새로 입력해야 합니다.