🚀 베타 시작 가이드 (5분)

1. Hanaro-stable-Setup.exe 더블클릭
2. Windows SmartScreen이 “확인되지 않은 게시자” 경고를 띄우면:
   • 추가 정보 클릭 → 실행 클릭
3. 자동 설치 후 시작 메뉴에 “Hanaro” 등록 완료

⚠️ SmartScreen 경고는 하나로가 아직 코드서명 전이라 뜨는 정상 현상이에요.

ℹ️ Hanaro-stable-Setup.exe는 stable 채널로 설치돼요. beta 빌드를 받으려면 Hanaro-beta-Setup.exe로 따로 설치해야 해요(채널은 설치 시 정해지고 앱 안에서 바꿀 수 없음).

1. 시작 메뉴 → Hanaro 실행
2. 체험 신청도, 라이선스 키 등록도 없어요 — 주문 받기·송장 발행·마켓 전송·배송 조회·매출 집계는 무료이고 설치 직후부터 전부 동작해요.
3. 계정 로그인(설정 → 계정)은 AI 직원을 고용했을 때만 필요해요. 고용이 없으면 로그인하지 않아도 돼요.

ℹ️ 유료는 AI 직원 고용뿐이며 2026년 12월에 시작돼요. 이전에 안내한 “평생 50% 할인”은 Core 무료화로 폐기되었어요 — 베타 참여 특전은 AI 직원 고용 기준으로 다시 안내드려요.

설정 → 마켓 계정 클릭. 가장 빠른 순서:

🟦 쿠팡 (Wing OpenAPI) — 가장 쉬움

1. https://wing.coupang.com 로그인
2. 좌측 메뉴 → OPEN API → API 사용 신청
3. 3개 값 복사:
   • Vendor ID (예: A00xxxxx)
   • Access Key
   • Secret Key
4. Hanaro 마켓 계정 → 쿠팡 추가 → 3개 값 입력 → [저장] 클릭
   • 저장할 때 하나로가 값이 맞는지 자동으로 확인해요. 틀리면 오류 문구가 나오니 확인 후 다시 입력하세요.

🟦 카페24

카페24는 내 개발자센터에서 앱을 만들어야 해서 시간이 더 걸려요(약 10분). 단계와 화면은 마켓 추가하기 — 카페24에 있어요.

🟦 스마트스토어 (네이버 커머스API)

1. 커머스API센터에서 애플리케이션 등록 → 주문 관련 권한 선택
2. 애플리케이션의 API 호출 IP에 하나로를 쓰는 PC의 인터넷 주소(IP) 등록 (하나로 마켓 계정 → [+ 마켓 추가] → 스마트스토어를 고르면 그 IP가 화면에 바로 나와요)
3. 하나로 마켓 계정 → 스마트스토어 추가 → 판매자 아이디 · 애플리케이션 ID · 시크릿 입력
4. [저장] — 하나로가 연결을 확인하고 통과하면 저장돼요(실패하면 이유를 보여 줘요)

⚠️ 커머스API 키가 없으면 주문 수집·송장 등록이 되지 않아요. 등록 절차는 마켓 추가하기에 자세히 있어요.

방법 A: 택배 자동접수 — 로젠택배 (현재 권장, 무료)

1. 설정 → 택배사에 로젠 화주 ID/PW를 저장해 둬요 (저장돼 있어야만 접수할 수 있고, 로그인 창은 뜨지 않아요)
2. Hanaro 주문 (F2) 화면에서 접수할 주문을 체크 → 아래 줄 [발주확인] 오른쪽 택배사 선택이 로젠택배인지 확인 → [택배 자동접수]
3. 확인 창에서 이 PC에서 출력 또는 접수만 (출력은 다른 PC에서) 을 고르면 로젠 화주센터 로그인·엑셀 첨부·서버 전송까지 자동 진행 (출력을 고르면 운송장 출력까지)
4. 발급된 송장번호를 Hanaro가 자동으로 목록에 채워요 (접수만 한 주문은 ⏳ 출력 대기로 보이고, 출력 뒤 [접수 후 작업 ▾] → 송장번호 불러오기로 채워요)
5. 등록할 주문 선택 → 오른쪽 아래 끝의 [선택 주문 송장 등록] → 마켓 자동 등록

마켓 셀러센터에서 이미 송장번호를 입력한 주문은 [마켓 동기화] 가 그 번호까지 함께 가져와요.

방법 B: 다른 택배사 자동접수 (예정)

지금 자동접수는 로젠택배만 돼요. CJ대한통운·한진택배·롯데택배·우체국택배는 택배사 선택 목록에 (예정)으로 보이며 아직 자동접수를 쓸 수 없어요. 제공 시점은 운영팀이 별도 안내해요.

방법 C: 굿스플로 API (옵션 — 사용자 직접 가입)

굿스플로는 지금 쓸 수 없어요(예정). 자세한 내용은 굿스플로 연동에서 확인하세요.

Q1. SmartScreen 경고가 떠요

정상이에요. 추가 정보 → 실행 클릭하세요. 하나로가 아직 코드서명 전이라 뜨는 경고예요.

Q2. 라이선스 키를 어디서 받나요?

받을 것이 없어요. Core는 무료라 키가 필요 없어요. AI 직원 고용(2026-12 시작)은 운영팀(hanalabs@hanapf.kr)에 신청하면 서버 계정에 반영되고, 앱은 로그인한 상태에서 최대 24시간 안에 자동으로 받아와요.

Q3. 고용이 만료되면 어떻게 되나요?

고용한 AI 직원 기능만 멈춰요. 주문 받기·송장 발행·전송·배송 조회·매출 집계는 그대로 무료로 계속 쓸 수 있어요.

Q4. 자격증명이 안전한가요?

Windows 사용자 계정 기반으로 암호화되어 %APPDATA%\Hanaro\hanaro.db에 저장돼요. 같은 PC의 다른 윈도우 계정에서는 복호화할 수 없어요.

Q5. 마켓 호출이 실패해요

1. 마켓 계정 화면에서 그 카드의 [재인증] → [저장]을 눌러 오류 메시지 확인(저장할 때 연결을 확인해요)
2. 도움말 (?) → 검색창에 오류 메시지 입력 → AI 봇 답변
3. 그래도 안 되면 운영팀에 스크린샷 + %APPDATA%\Hanaro\logs\ 폴더의 최신 로그 첨부

Q6. 데이터를 다른 PC로 옮기려면?

%APPDATA%\Hanaro\ 폴더 통째로 복사 — 단, 암호화된 자격증명은 재입력 필요 (다른 사용자/PC 복호화 불가).

Q7. 굿스플로 없이도 송장 발송 가능?

가능해요. 기본 모드는 마켓이 발급한 송장번호 사용이에요. 굿스플로는 자동 발행 옵션이에요.

베타 테스터로서 받은 모든 케이스스터디 협조 의무가 있어요 (사용 패턴/스크린샷/피드백 인터뷰).