FAQ — 자주 묻는 질문

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

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

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

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

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

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

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

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

기술적으로는 가능해요. 하지만 1차 타깃은 Windows 10/11이에요.

• 마켓 어댑터(스마트스토어 WebView2 등)는 Windows 의존성이 있어요.
• 코드서명, 자동 업데이트 패키지가 Windows용으로 만들어져요.
• Mac/Linux는 더 뒤에 정식 지원할 예정이에요.

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

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

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

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

다음만 외부와 통신해요:

• 마켓 API — 주문/발송 처리 (셀러가 등록한 마켓에만)
• 택배사 추적 API — 송장 상태 조회 (5대 택배사 공식 API)
• 업데이트 서버 — 새 버전 확인 (자동 업데이트)
• 오류 보고 — 오류 발생 시 오류가 난 코드 위치 (운영자가 켠 경우에만, 이름·주소·전화번호 같은 개인정보는 자동으로 수집하지 않아요)

오류 보고는 운영자가 켜 둔 경우에만 활성화돼요(설정 방법은 맨 아래 고급 참고). 전송되는 것:

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

전송되지 않는 것:

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

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

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

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

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

Hanaro의 대처:

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

공식 API 사용은 약관 준수예요 — 마켓이 발급한 키를 정상적으로 사용해요.

로그인 화면 자동화는 마켓 약관에 허용 여부가 적혀 있지 않아요. Hanaro는 이를 숨기지 않고 명시적으로 표시해요. 사용 여부는 셀러 본인이 위험을 인지하고 결정해요.

약관이 바뀌면 바로 반영할 수 있도록, Hanaro는 위험도를 마켓별 정보로 따로 관리해요.

스마트스토어, 쿠팡, 카페24, G마켓·옥션(ESM), 11번가 (현재). G마켓·옥션은 ESM으로 주문 받기를 지원해요(아래 문항). 운영팀(hanalabs@hanapf.kr 또는 안내받은 카카오톡 채널)으로 마켓 추가 요청을 보내주세요 — 사용자 수가 많은 마켓을 우선 검토해요.

ESM PLUS 마스터 계정으로 G마켓·옥션 주문 받아오기와 로젠 송장 자동 등록(주문확인·발송처리)이 돼요. 공식 API가 아니라 로그인한 상태로 ESM PLUS 화면이 쓰는 기능을 부르는 방식(위 표의 세션 자동화)이라 처음 설정의 마켓 선택 화면에 비공식 연결로 표시돼요.

• 송장 자동 등록은 로젠 송장만 돼요 — [선택 주문 송장 등록]으로 새 주문은 ESM [주문확인]을 먼저 하고 발송처리해요. 다른 택배사 송장은 제외로 빠지니 ESM PLUS에서 직접 발송처리해 주세요. 이미 발송처리한 송장번호를 바꾸는 것도 ESM PLUS에서 해 주세요.
• 주문 상태는 새 주문·발주확인(ESM 발송 대기)·배송중·배송완료·구매확정(송금완료 포함)·취소를 구분해요. 취소는 ESM의 취소 완료 상태(G마켓 취소완료·옥션 환불완료)와 환불 승인일로 판단해요(옥션이 진행 중 주문에도 붙이는 취소 표시 CN은 보지 않아요). 취소 처리일만 있거나 미수령·반품·교환 같은 클레임 표시만 있고 환불 승인일이 없는 발송 전 주문, G마켓 발송 전 주문에 붙은 CN, 상태를 알 수 없는 주문은 [택배 자동접수]에서 기본으로 빼요(클레임 확인 필요·상태 확인 필요). 반품·교환은 아직 따로 구분하지 못해요.
• 등록 방법은 마켓 추가하기의 ESM(G마켓·옥션) 절을 보세요.

11번가 셀러오피스 공식 오픈API로 연결해요(위 표의 공식 API). 오픈API 센터에서 API 키를 확인하고 하나로를 쓰는 PC의 IP를 등록해야 해요.

• 주문 받기 — 새 주문·발주확인·배송완료 주문을 받아 오고, 이미 받은 주문은 배송중·구매확정·취소로 바뀌어요. 발주확인 전에 구매자가 취소한 주문은 다음 수집 때 취소로 바뀌어요. 셀러오피스에서 직접 발송한 주문의 송장번호도 하나로에 들어와요. 주문 목록의 마켓 칸에는 11로 보여요.
• [발주확인], [택배 자동접수](로젠 — 접수 직전 배송지 다시 확인), [선택 주문 송장 등록](로젠·CJ대한통운·한진·롯데·우체국)이 돼요. 한 번에 결제한 여러 상품(같은 배송번호)은 체크하지 않은 주문도 11번가에서 함께 발송처리돼요(11번가 안내 기준, 실제 계정 미확인).
• 안 되는 것 — 이미 보낸 송장번호 수정·송장 취소, 반품·교환 목록, 부분발송은 11번가 셀러오피스에서 직접 해 주세요.
• 배송완료 단계에서 처음 받은 지난 주문은 결제금액 대신 할인 전 주문금액으로 보일 수 있어, 매출이 실제보다 크게 잡힐 수 있어요.
• IP가 바뀌면 주문 수집이 멈춰요 — 문제해결을 보세요.
• 등록 방법은 마켓 추가하기의 11번가 절을 보세요.

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

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

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

부분적으로 가능해요.

옮길 수 있는 것:

• 주문 / 송장 데이터 (hanaro.db)
• 인쇄·화면 설정 (%APPDATA%\Hanaro\ 폴더 안의 설정 파일들)

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

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

절차:

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

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

• 수동 백업: 매일 또는 매주 별도 외장 디스크/NAS에 복사.
• 자동 백업: 자동 백업 기능은 아직 제공하지 않아요(예정). 지금은 수동 백업을 해 주세요.

로드맵에 포함되어 있어요. 2026년 하반기 목표예요.

지금은 한국어만 지원해요. 영어 추가는 이후에 검토해요.

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

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

앱 안의 도움말 (?)에서 질문하거나 운영팀(hanalabs@hanapf.kr 또는 안내받은 카카오톡 채널)으로 보내주세요. 다음 정보가 있으면 빠른 처리에 도움돼요:

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

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

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

환경변수 HANARO_AI_PROVIDER=anthropic + HANARO_ANTHROPIC_API_KEY 설정 시 Claude API 백엔드로 자동 전환되며, 기본은 시드 FAQ 기반 오프라인 답변이에요.

• 기술 스택: .NET 8 + Avalonia 11 + EF Core(SQLite). 자동 업데이트는 Velopack이 맡아요.
• 오류 보고는 HANARO_SENTRY_DSN 환경변수가 설정되어 있을 때만 활성화돼요(개인정보 PII는 자동 수집하지 않고, 사용자/판매처 ID는 코드에서 명시적으로 붙인 경우만 SentryUserScope로 전송).
• 인쇄·화면 설정 파일 이름은 print-settings.json, ui-prefs.json, theme.json이에요.
• 위험도는 코드의 RiskLevel 메타데이터로 관리해요.