시작하기

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

1. 다운로드

파일명	대상
`Hanaro-stable-Setup.exe`	Windows 10/11 (64-bit) — 권장. 파일명에 버전이 없고 항상 최신 버전을 설치합니다
`Hanaro-stable-Portable.zip`	설치 권한이 없는 환경 (USB 포터블 등)

SmartScreen 경고

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

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

Velopack 자동업데이트

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

수동 확인: 설정 → 일반 → 앱 정보의 업데이트 확인 버튼 버튼 왼쪽에 결과가 표시됩니다 — 최신 버전 입니다. 또는 새 버전 발견: 0.2.0 (현재: 0.1.0).

채널(stable / beta)은 앱에서 바꿀 수 없습니다. 설치할 때 사용한 Setup 파일의 채널을 계속 따라갑니다. 베타 채널로 옮기려면 운영팀에서 안내하는 베타용 Setup 파일로 다시 설치해야 합니다.

2. 첫 실행 — Onboarding 4단계

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

1단계: 환영

시작 화면 스크린샷 자리

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

라이선스 — 등록할 것이 없습니다 하나로 Core(주문 수집·송장 발행·마켓 전송·엑셀 송장 적용·배송 조회·매출 집계)는 무료입니다. 체험 기간도, 라이선스 키 등록도 없습니다 — 설치하면 바로 쓸 수 있습니다.

유료는 AI 직원 고용뿐이며 2026년 12월에 시작됩니다. 고용을 신청하면 운영팀이 서버에 반영하고, 설정 → 계정 탭에서 로그인해 두었다면 최대 24시간 안에 앱에 자동 반영됩니다 (즉시 반영이 필요하면 로그아웃 후 다시 로그인).

웹 자동결제(카드 등록)는 지원하지 않습니다.

ⓘ 현재 제공 기능은 마켓 연동·로젠 자동 접수·송장 전송·배송 조회·매출 집계이며 전부 무료입니다. 재고관리·멀티계정·세금계산서 자동은 아직 제공되지 않습니다.

💡 베타 테스터 전용 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)으로 문의해주세요.