FAQ — 자주 묻는 질문

💡 인앱 도움말 — Hanaro 안에서 ? 키(또는 우측 상단 “도움말” 버튼)를 누르면 사이드 패널이 열립니다. AI 봇이 자연어 질문에 답하고 관련 FAQ를 함께 보여줍니다. 카테고리: 시작하기 / 마켓 / 송장 / 발송처리 / 문제해결. 환경변수 HANARO_AI_PROVIDER=anthropic + HANARO_ANTHROPIC_API_KEY 설정 시 Claude API 백엔드로 자동 전환되며, 기본은 시드 FAQ 기반 오프라인 답변입니다.

일반

Sello와 무엇이 다른가요?

항목	Sello	Hanaro
가격	월/연 구독	Core 무료 · AI 직원 월정액
기술 스택	(비공개)	.NET 8 + Avalonia 11 + EF Core
데이터 위치	로컬 + 클라우드 (선택)	로컬 SQLite (기본)
한국어 도메인	(UI만)	코드 내부까지 한국어 식별자
자동업데이트	자체	Velopack
에러 추적	(비공개)	Sentry (PII 미수집)
굿스플로 통합	✓	Phase γ 예정

Hanaro는 Sello를 직접 대체하지 않습니다. 셀러 데이터를 셀러 PC 안에 두고, 무엇이 언제 전송됐는지 화면에서 확인할 수 있어야 한다는 다른 철학에서 출발합니다.

사용료가 있나요?

하나로 Core는 무료입니다. 설치하면 바로 쓰고, 기간 제한과 결제가 없습니다. 유료는 선택 기능인 AI 직원(2026-12 베타, 직원 1명당 월 30,000원)뿐이며 고용하지 않으면 청구되지 않습니다.

구분	요금	내용
Core	무료	스마트스토어·쿠팡(카페24는 다음 업데이트) 주문 수집, 로젠 자동 접수·송장 전송, 5대 택배사 배송 추적, 매출 집계
AI 직원	직원 1명당 월 30,000원 (부가세 별도)	2026-12 베타. 첫 직원은 구매자 문의 응대. 고용한 만큼만 과금

담당자 1:1 상담은 AI 직원 고용 이용자에게 제공합니다. 무료 이용자 지원 범위는 지원 정책을 봐주세요.

Core는 왜 무료인가요?

주문·송장 관리 도구의 가격은 이미 0원으로 내려왔고, Hanaro는 셀러 PC에서 돌아가는 구조라 셀러가 늘어도 저희 비용이 거의 늘지 않습니다.

대신 2026년 12월부터 선택 기능인 AI 직원(첫 번째는 구매자 문의 응대)을 월정액으로 내놓고, 그것으로 운영합니다. AI 직원을 쓰지 않으셔도 기본 기능은 계속 무료입니다.

무엇에 돈을 내는 건가요?

AI 직원을 고용한 만큼만 냅니다. 직원 1명당 월 30,000원(부가세 별도)이며, 고용하지 않으면 청구되지 않습니다.

Core의 유지보수 — 마켓·택배사가 API나 화면을 바꿀 때 추적해서 패치하는 일, Velopack 자동업데이트 — 는 계속하지만 이 비용을 Core 이용자에게 청구하지 않습니다.

결제는 어떻게 하나요?

지금은 결제할 것이 없습니다. AI 직원은 2026년 12월 베타부터 고용할 수 있고, 고용 화면에서 직원별 월 요금과 예상 실비를 먼저 보여드립니다.

Mac/Linux에서도 돌아가나요?

기술적으로는 가능합니다 (.NET 8 + Avalonia 11). 하지만 1차 타깃은 Windows 10/11입니다.

마켓 어댑터(스마트스토어 WebView2 등)는 Windows 의존성이 있습니다.
코드서명, Velopack 패키지가 Windows용으로 빌드됩니다.
Mac/Linux는 Phase γ 이후 정식 지원 예정.

보안

마켓 자격증명은 어디에 저장되나요?

%APPDATA%\Hanaro\hanaro.db SQLite 파일에 저장됩니다. DPAPI(Data Protection API)로 암호화되어 있어:

같은 사용자 + 같은 머신에서만 복호 가능
파일을 다른 PC로 옮겨도 복호 불가 (DPAPI 키가 사용자 프로필에 묶임)
로그인 비밀번호 변경 시에도 영향 없음 (Windows가 자동 마이그레이션)

백업 시 주의: hanaro.db만 복사하면 다른 PC에서 자격증명을 복호할 수 없습니다. 마켓을 다시 등록해야 합니다.

셀러 데이터(주문, 송장)가 외부로 전송되나요?

아니요. 모든 데이터는 로컬 SQLite에 저장됩니다.

다음만 외부와 통신합니다:

마켓 API — 주문/발송 처리 (셀러가 등록한 마켓에만)
택배사 추적 API — 송장 상태 조회 (5대 택배사 공식 API)
업데이트 서버 — 새 버전 확인 (Velopack)
Sentry — 오류 발생 시 스택트레이스 (DSN 미설정 시 비활성, PII 자동 수집 X)

Sentry에는 어떤 정보가 전송되나요?

HANARO_SENTRY_DSN 환경변수가 설정되어 있을 때만 활성화됩니다. 전송되는 것:

예외 스택트레이스 (코드 경로)
OS 버전 + Hanaro 버전
사용자/판매처 ID (명시적으로 attach한 경우만 — SentryUserScope)

전송되지 않는 것:

마켓 자격증명
주문 데이터 (수령인 정보, 상품명 등)
송장번호
환경변수 값

전송 항목을 더 자세히 확인하고 싶으시면 운영팀(hanalabs@hanapf.kr 또는 안내받은 카카오톡 채널)으로 문의해 주세요.

마켓 / 약관

공식 API와 세션 자동화의 차이는?

Hanaro는 두 가지 통합 방식을 명시적으로 구분합니다.

방식	설명	RiskLevel
공식 API	마켓이 공개한 OpenAPI/REST 엔드포인트	낮음
세션 자동화	WebView2로 마켓 웹 페이지를 자동 조작	중간~높음

왜 세션 자동화가 필요한가? 일부 운영 작업(주문 상태 변경, 일부 메모 입력)은 공식 API로 노출되지 않습니다.

위험은? 마켓 약관에서 자동화 도구 사용을 제한할 수 있습니다. 셀러 계정 정지 위험.

Hanaro의 대처:

어떤 마켓이 어느 방식인지 처음 설정할 때 마켓 선택 화면의 위험도 배지(공식 API / 비공식 연결 / 실험적)로 알려드립니다.
세션 자동화를 쓰고 싶지 않으시면 해당 마켓을 등록하지 않으시면 그 방식이 쓰이지 않습니다.
공식 API만으로 운영 가능한 흐름을 우선 제공.

마켓 약관을 위반하지 않나요?

공식 API 사용은 약관 준수입니다 — 마켓이 발급한 키를 정상적으로 사용합니다.

세션 자동화는 마켓 약관의 회색지대에 해당합니다. Hanaro는 이를 숨기지 않고 명시적으로 표시합니다. 사용 여부는 셀러 본인이 위험을 인지하고 결정합니다.

약관 변경 시 즉시 반영하기 위해 Hanaro는 위험 정책을 코드에 하드코딩하지 않고 RiskLevel 메타데이터로 관리합니다.

마켓이 더 추가될 예정인가요?

Phase β: 스마트스토어, 쿠팡, 카페24 (현재). Phase γ: 11번가, G마켓/옥션, 위메프, 티몬. Phase δ 이후: 자체몰(독립몰) 어댑터.

운영팀(hanalabs@hanapf.kr 또는 안내받은 카카오톡 채널)으로 마켓 추가 요청을 보내주세요 — 사용자 수가 많은 마켓을 우선 검토합니다.

데이터 / 마이그레이션

Sello 사용자입니다. 기존 데이터를 옮길 수 있나요?

직접 DB 마이그레이션 도구는 제공하지 않습니다 (Sello DB 스키마 비공개). 대신 엑셀 기반 마이그레이션을 권장합니다:

Sello에서 미발송 주문 엑셀 다운로드 (넘길 주문을 확인하는 용도).
Hanaro 마켓 등록 후 같은 주문을 동기화 (마켓 API에서 직접 가져옴 — Sello보다 신뢰 가능).
이미 송장번호를 마켓에 입력한 주문은 동기화가 그 번호까지 함께 가져옵니다.
아직 송장이 없는 주문은 Hanaro에서 [로젠 자동 접수]로 새로 접수하면 됩니다.

Sello에서 발행했지만 마켓에는 아직 입력하지 않은 송장번호가 있다면, 마켓 셀러센터에 먼저 입력한 뒤 Hanaro에서 [마켓 동기화]를 누르세요.

데이터를 다른 PC로 옮길 수 있나요?

부분적으로 가능합니다.

옮길 수 있는 것:

주문 / 송장 데이터 (hanaro.db)
인쇄·화면 설정 (print-settings.json, ui-prefs.json, theme.json)

옮길 수 없는 것 (재등록 필요):

마켓 자격증명 — DPAPI 암호화로 인해 다른 PC에서 복호 불가.

절차:

기존 PC: %APPDATA%\Hanaro\ 폴더 복사.
새 PC: Hanaro 설치 후 같은 위치에 붙여넣기.
설정 → 마켓 계정에서 각 마켓 자격증명을 재입력.

백업은 어떻게 하나요?

%APPDATA%\Hanaro\ 폴더 전체를 정기 백업하세요. 클라우드 동기화(OneDrive 등)는 SQLite 파일 손상 위험이 있어 권장하지 않습니다. 대신:

수동 백업: 매일 또는 매주 별도 외장 디스크/NAS에 복사.
자동 백업: 설정 → 백업 → 자동 백업 활성화 (Phase γ 예정).

로드맵

굿스플로 통합은 언제?

Phase γ 로드맵에 포함되어 있습니다. 2026년 하반기 목표.

다국어 지원은?

Phase β까지는 한국어만 지원합니다. 영어 추가는 Phase γ 이후 검토합니다.

모바일 앱은?

데스크톱 핵심 기능이 안정화된 후 검토합니다. 우선순위 낮음 — 셀러 코어 작업(엑셀 다루기)은 데스크톱이 적합합니다.

Phase 별 로드맵 전체 보기

로드맵 상세는 운영팀(hanalabs@hanapf.kr 또는 안내받은 카카오톡 채널)으로 문의해 주세요.

문의

버그를 발견했어요. 어떻게 신고하나요?

앱 안의 도움말 (?) → 버그 신고를 쓰거나 운영팀(hanalabs@hanapf.kr 또는 안내받은 카카오톡 채널)으로 보내주세요. 다음 정보가 있으면 빠른 처리에 도움됩니다:

Hanaro 버전 (설정 → 일반 → 앱 정보)
Windows 버전
재현 절차
%APPDATA%\Hanaro\logs\ 의 최근 로그 파일 (개인정보 제거 후)

기능 제안은 어디에?

운영팀(hanalabs@hanapf.kr 또는 안내받은 카카오톡 채널)으로 자유롭게 보내주세요.

사용 후기나 개선 아이디어를 보내고 싶어요

운영팀(hanalabs@hanapf.kr 또는 안내받은 카카오톡 채널)으로 보내주세요. 실제 운영에서 불편했던 지점이 가장 도움이 됩니다.