시작하기

최신 버전 받기

설치파일은 운영팀(hanalabs@hanapf.kr 또는 안내받은 카카오톡 채널)에서 안내해 드려요.

SmartScreen 경고

처음 실행 시 Windows SmartScreen이 “확인되지 않은 게시자” 경고를 띄울 수 있어요. 하나로가 아직 코드서명 전이라 뜨는 경고이고, 정상이에요.

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

자동 업데이트

앱을 켤 때 먼저 작은 “하나로 업데이트” 창이 떠 새 버전이 있는지 확인해요.

1. 안내 문구 — 지금 무엇을 하는지 알려 줘요. 내려받는 중에는 "새 버전(0.x.x)을 내려받고 있습니다 (42%)"처럼 보여요. "창을 닫거나 앱을 다시 켜지 마세요"는 새 버전을 적용하는 단계에서만 나와요.
2. 진행률 — 내려받는 진행 정도예요.
3. [나중에] — 지금 적용하지 않고 먼저 쓰고 싶을 때 눌러요(보이는 경우에만).

• 새 버전이 있으면 메인 화면을 띄우기 전에 내려받아 적용하고 다시 시작해요. 내려받는 동안 창에 진행률(%)이 표시되고, 적용 단계에서는 “새 버전을 적용하는 중입니다 — 곧 다시 시작합니다”와 “창을 닫거나 앱을 다시 켜지 마세요”가 표시돼요. 이때는 창을 닫거나 앱을 다시 켜지 마세요(내려받는 중에는 [나중에]로 먼저 써도 돼요).
• [나중에]를 누르면 지금 버전으로 바로 시작해요. 내려받기는 멈추지 않고 뒤에서 이어지며, 화면 상단 알림에 같은 진행률로 이어서 표시돼요. 다 받으면 알림의 [지금 다시 시작]을 누르거나, 다음에 앱을 켤 때 적용돼요. 창의 X 버튼도 [나중에]와 같아요.
• 인터넷이 없거나 서버가 느리면 기다리지 않고 바로 시작해요(확인은 최대 5초). 내려받기가 30초 넘게 진행되지 않을 때도 바로 시작하고 뒤에서 이어 받아요.
• 새 버전이 없으면 창은 잠깐 보였다가 곧바로 메인 화면으로 넘어가요.
• 앱을 쓰는 도중에도 몇 시간마다 새 버전을 확인해요. 이때는 상단 알림으로만 알려 드리고, 다 받은 새 버전은 [지금 다시 시작]을 누르시거나 다음에 앱을 켤 때 적용돼요(작업 중에 저절로 다시 시작하지 않아요).

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

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

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

1단계: 환영

1. 4단계 목록 — 환영 → 마켓 선택 → 계정 추가 → 첫 동기화 순서예요.
2. 현재 단계 — 지금이 몇 번째 단계인지 보여 줘요.
3. [취소] — 마법사를 닫아요. 설정에서 다시 할 수 있어요.
4. [다음] — 다음 단계로 가요.

Hanaro 소개 화면이에요. 다음 클릭.

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

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

웹 자동결제(카드 등록)는 지원하지 않아요.

ⓘ 현재 제공 기능은 마켓 연동·택배 자동접수(로젠택배)·송장 전송·배송 조회·매출 집계이며 전부 무료예요. 마켓 간 통합 재고관리·세금계산서 자동은 아직 제공되지 않아요.

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

2단계: 마켓 선택

판매 중인 마켓을 카드로 골라요(여러 개 선택 가능). 카드는 다음과 같아요.

• 스마트스토어
• 쿠팡
• 카페24
• ESM (G마켓·옥션)
• 추후 추가 — 지금은 마켓을 연결하지 않고 둘러보기만 할 때 골라요.

“추후 추가”만 고르면 3단계(계정 추가)를 건너뛰어요. 마켓은 나중에 설정 → 마켓 계정에서 추가할 수 있어요.

3단계: 계정 추가

2단계에서 고른 마켓의 자격증명을 입력해요. 2단계에서 “추후 추가”를 골랐다면 이 단계는 건너뛰어요.

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

4단계: 첫 동기화

추가한 마켓에서 최근 30일 주문을 가져와요. 마켓당 1~3분 걸려요.

완료 후 대시보드로 이동해요.

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

이 폴더에는 다음이 저장돼요:

• hanaro.db — SQLite 데이터베이스 (주문, 송장, 자격증명)
• logs/ — 로그 파일 (날짜별, 최근 14개만 보관)

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

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

• 칸 아래 칩(송장번호 미등록 · 발송 지연 · 배송 이상(반송·미배달))을 누르면 주문 화면에서 해당 건만 바로 볼 수 있어요. 칸을 눌러도 그 단계 주문이 열려요.
• 띠 아래 흐름 밖 줄에는 취소 요청 · 반품 요청 · 교환 재배송 대기 칩이 있어요.
• 그 아래 매출 띠(오늘 매출 · 어제 매출 · 이번 달 누적, 최근 7일 막대)와 마켓별 진행 현황 표(최근 30일)가 이어져요.