시작하기

Hanaro를 처음 받았다면 이 문서 하나만 따라하면 됩니다. 약 15분 소요.

1. 다운로드

최신 버전 받기

설치파일은 운영팀(hanalabs@hanapf.kr 또는 안내받은 카카오톡 채널)에서 안내해 드립니다. 결제·체험 문의와 같은 창구입니다.

파일명 대상
Hanaro-Setup-x.y.z.exe Windows 10/11 (64-bit) — 권장
Hanaro-Portable-x.y.z.zip 설치 권한이 없는 환경 (USB 포터블 등)

SmartScreen 경고

처음 실행 시 Windows SmartScreen이 “확인되지 않은 게시자” 경고를 띄울 수 있습니다. 이는 코드서명 인증서가 EV(Extended Validation)로 평판이 쌓이기 전까지 발생하는 정상 현상입니다.

해결: 추가 정보실행 클릭. 또는 코드서명 검증 절차 참조.

Velopack 자동업데이트

설치 후에는 시작 시마다 백그라운드에서 새 버전을 확인합니다. 새 버전이 있으면 알림이 뜨고, 사용자가 동의하면 다음 재시작 시 자동으로 적용됩니다.

  • 채널 변경: 설정업데이트채널 (stable / beta)
  • 수동 확인: 설정업데이트지금 확인

2. 첫 실행 — Onboarding 4단계

처음 실행하면 Onboarding 마법사가 자동으로 시작됩니다. 4단계로 구성됩니다(환영 → 마켓 선택 → 계정 추가 → 첫 동기화).

1단계: 환영

시작 화면 스크린샷 자리

Hanaro 소개 화면입니다. 다음 클릭.

라이선스 — Trial 또는 키 등록 처음 실행 시 14일 무료 체험이 자동 시작됩니다. 상단에 코발트 배너로:

ⓘ 무료 체험 중 (14일 남음). 모든 기능 사용 가능.

체험 이후 계속 쓰려면 직접 결제 → 코드 수령 → 등록 순서로 진행합니다:

  1. 운영팀(hanalabs@hanapf.kr 또는 안내받은 카카오톡 채널)에 원하는 티어를 알리고 직접 결제
  2. 결제 확인 후 라이선스 코드(키) 수령
  3. 설정 → 라이선스 탭에서 코드 등록 (별도 단계가 아니라 설정 탭에서 언제든 처리)

웹 자동결제(카드 등록)는 지원하지 않습니다. 자세한 내용은 FAQ — 결제는 어떻게 하나요? 참조.

가격 티어 가격 (월, 부가세 별도) 포함
Lite 12,000원 마켓 3채널, 송장 임포트·전송, 배송 추적
Pro 24,000원 Lite + 재고관리·멀티계정 (예정 — 로드맵)
Business 39,000원 Pro + 세금계산서 자동·멀티계정 확장 (예정 — 로드맵)
베타 5명 평생 50% 할인 Pro 가격 50%(12,000원/월) 약속
자사 직원 무료 피드백 의무 조건

ⓘ “예정(로드맵)” 표시 기능(재고관리·멀티계정·세금계산서 자동)은 아직 제공되지 않습니다. 현재 모든 티어에서 마켓 연동·송장 임포트·전송·배송 추적이 동작합니다.

💡 베타 테스터 전용 1쪽 양식: 베타 시작 가이드

2단계: 마켓 선택

사용 중인 마켓 채널을 고릅니다. 이 단계는 건너뛰고 나중에 선택할 수 있습니다.

  • 스마트스토어
  • 쿠팡
  • 카페24

3단계: 계정 추가

2단계에서 고른 마켓의 자격증명을 입력합니다. 이 단계는 건너뛰고 나중에 추가할 수 있습니다.

마켓별 자격증명 발급 방법은 마켓 추가하기 참조.

4단계: 첫 동기화

추가한 마켓에서 최근 30일 주문을 가져옵니다. 마켓당 1~3분 소요.

완료 후 대시보드로 이동합니다.


2-1. 데이터 폴더

Hanaro의 데이터는 기본값 %APPDATA%\Hanaro\ (예: C:\Users\<사용자>\AppData\Roaming\Hanaro\)에 저장됩니다.

이 폴더에는 다음이 저장됩니다:

  • hanaro.db — SQLite 데이터베이스 (주문, 송장, 자격증명)
  • logs/ — 로그 파일 (롤링 7일)

권고: 클라우드 동기화 폴더(OneDrive, Dropbox)에 데이터 폴더를 두지 마세요. SQLite 파일이 손상될 수 있습니다.


3. 첫 동기화 결과 해석

대시보드에는 첫 동기화 결과가 “처리할 작업” 중심으로 표시됩니다.

카드 의미
신규 주문 발주 확인이 필요한 신규 주문
발송 대기 송장번호가 아직 입력되지 않은 주문
배송 중 송장 등록 후 택배사 인수 ~ 배송 완료 직전
취소 · 반품 취소 요청 / 반품 요청 건수

카드 아래 “처리할 일” 목록(송장 미등록 · 발송 지연 · 라벨 미인쇄)을 클릭하면 주문 화면에서 해당 건만 바로 볼 수 있습니다. 자세한 읽는 법은 대시보드와 알림 참조.

송장번호 충돌이 감지되면: 송장 전송 — 충돌 처리 참조.


4. 다음 단계

문제가 생기면 문제해결을 먼저 확인하시고, 해결되지 않으면 운영팀(hanalabs@hanapf.kr)으로 문의해주세요.