FAQ — 자주 묻는 질문

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

일반

Sello와 무엇이 다른가요?

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

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

사용료가 있나요?

처음 실행하면 14일 무료 체험이 자동으로 시작됩니다. 카드 등록 없이 바로 시작되고, 체험 기간에는 모든 기능을 제한 없이 쓸 수 있습니다. 체험이 끝난 뒤 계속 쓰시려면 아래 티어 중 하나로 라이선스를 등록하면 됩니다.

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

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

무엇에 돈을 내는 건가요?

계속 손이 가야 하는 부분에 과금합니다. 마켓과 택배사는 사양을 예고 없이 바꾸기 때문에, 한 번 만들어 두면 끝나는 프로그램이 아닙니다.

사양 변경 대응 — 마켓·택배사가 API나 화면을 바꾸면 수집·전송이 멈춥니다. 그때마다 추적해서 패치합니다
자동업데이트 — 새 버전이 나오면 Velopack으로 자동 적용. 셀러가 다시 설치할 필요가 없습니다
지원 — 오류 문의 대응, 사양 변경 시 영향 범위 안내

결제는 어떻게 하나요?

웹 자동결제(카드 등록)가 아니라 운영자에게 직접 결제하고 라이선스 코드를 받는 방식입니다.

운영팀(hanalabs@hanapf.kr 또는 안내받은 카카오톡 채널)에 원하는 티어를 알리고 직접 결제합니다.
결제 확인 후 라이선스 코드(키)가 발급됩니다.
Hanaro에서 설정 → 라이선스 탭에 코드를 등록하면 즉시 적용됩니다.

14일 무료 체험이 끝나기 전에 위 절차로 전환하면 중단 없이 계속 사용할 수 있습니다.

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의 대처:

모든 세션 자동화 작업에 RiskLevel을 부여하고 사용 전 동의 요청.
설정 → 자동화 → 세션 자동화 비활성화로 완전히 차단 가능.
공식 API만으로 운영 가능한 흐름을 우선 제공.

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

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

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

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

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

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

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

데이터 / 마이그레이션

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

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

Sello에서 미발송 주문 엑셀 다운로드.
Hanaro 마켓 등록 후 같은 주문을 동기화 (마켓 API에서 직접 가져옴 — Sello보다 신뢰 가능).
Sello 엑셀의 송장번호를 송장 임포트로 일괄 적용.

자세한 절차는 송장 임포트 — Sello에서 마이그레이션 참조.

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

부분적으로 가능합니다.

옮길 수 있는 것:

주문 / 송장 데이터 (hanaro.db)
임포트 프리셋 (presets.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 또는 안내받은 카카오톡 채널)으로 보내주세요. 실제 운영에서 불편했던 지점이 가장 도움이 됩니다.