Skip to content

문제해결 ​

개요 ​

웹과 데스크톱 앱을 사용하며 자주 겪는 문제의 원인과 해결 방법을 증상별로 정리했습니다. 데스크톱 앱의 화면 구성과 기능은 데스크톱 앱, 각 기능의 정상 사용 절차는 해당 챕터를 참조하세요. 여기서 해결되지 않으면 마지막 항목("문의할 때 무엇을 알려주면 빠른가요?")의 정보를 준비해 문의해 주세요.

Q&A ​

Q: 데스크톱 앱 설치 요구사항이 어떻게 되나요? ​

A: Windows 10 이상(64비트) PC가 필요합니다. 설치 파일은 selltic.kr 랜딩의 다운로드 섹션에서 받습니다 (항상 최신 버전 링크). 설치·로그인 절차는 데스크톱 앱을 참조하세요.

Q: 데스크톱 앱 업데이트는 어떻게 하나요? ​

A: 새 버전이 배포되면 앱 상단에 업데이트 배너가 표시됩니다. 다운로드 버튼을 눌러 내려받고(사용자 확인 후 다운로드), 완료되면 재시작하여 설치를 클릭하면 적용됩니다. 재시작하지 않아도 다음 앱 종료 시 자동 설치됩니다. 현재 버전은 앱 하단 푸터(v버전번호)에서 확인합니다. 자동 업데이트가 실패하는 환경(사내 방화벽 등)에서는 다운로드 페이지에서 최신 설치 파일을 받아 덮어 설치하면 됩니다(설정·자격증명은 서버에 저장되어 유지).

Q: PC를 켜면 데스크톱 앱이 자동으로 실행되게 하려면? ​

A: 데스크톱 설정 > 일반 설정 > Windows 시작 시 자동 실행을 켜세요. 앱이 시스템 트레이에서 자동 시작되어 수집 스케줄이 끊기지 않습니다.

Q: 데스크톱 알림을 끄고 싶어요. ​

A: 데스크톱 설정 > 일반 설정 > 데스크톱 알림 토글을 끄세요. 수집 완료/실패 시 표시되는 Windows 알림이 꺼집니다.

Q: 문의할 때 무엇을 알려주면 빠른가요? ​

A: 다음 다섯 가지면 대부분 빠르게 원인을 찾을 수 있습니다.

  1. 앱 버전 — 데스크톱 하단 푸터의 v버전번호 (웹 문제는 사용 브라우저)
  2. 발생 시각
  3. 해당 사이트/채널명 (예: 롯데온, 이지웰)
  4. 로그 메시지 — 데스크톱 각 탭의 로그 뷰어(수집 로그·상품 등록 로그·송장 처리 로그·엔진 로그)에서 오류 부분 복사, 웹은 화면에 표시된 오류 메시지
  5. 백그라운드 수집 모드 사용 여부 (데스크톱 수집 문제인 경우)

문제해결 ​

웹 로그인이 안 됩니다 ​

  • 원인: 비밀번호 오류, 이메일 미인증, 또는 세션 만료.
  • 조치:
    1. 로그인 페이지의 비밀번호 찾기(/forgot-password)에서 재설정 링크를 받아 새 비밀번호를 설정하세요.
    2. 가입 후 이메일 인증을 완료했는지 확인하세요 — 인증 메일의 링크를 클릭해야 합니다. 시작하기 참조.

데스크톱 로그인이 안 됩니다 ​

  • 원인: 계정 문제(비밀번호/미인증) 또는 API 서버 URL 설정 오류, 네트워크 차단.
  • 조치 (순서대로 확인):
    1. 웹(selltic.kr)에서 같은 이메일/비밀번호로 로그인되는지 확인 — 웹도 안 되면 비밀번호 재설정부터.
    2. 이메일 인증을 완료했는지 확인.
    3. 데스크톱 설정 > 일반 설정 > API 서버 URL이 기본값(https://api.selltic.kr/api/v1)인지 확인 — 바뀌어 있으면 초기화 후 저장. 웹과 동일한 서버여야 로그인과 데이터 동기화가 됩니다.
    4. 네트워크/방화벽에서 api.selltic.kr 접근이 차단되어 있지 않은지 확인.
  • 소셜 계정(Google/카카오)으로 가입했다면 데스크톱에서도 Google로 로그인/카카오로 로그인 버튼을 사용하세요.

사용 중 갑자기 로그인 화면으로 돌아갑니다 (세션 만료) ​

  • 원인: 인증 토큰 갱신이 최종 실패하면 세션 만료로 처리되어 로그인 화면으로 전환됩니다. 장시간 오프라인이었거나 서버와의 연결이 오래 끊긴 경우 발생할 수 있습니다.
  • 조치: 다시 로그인하면 됩니다. 반복되면 API 서버 URL 설정과 네트워크 상태를 확인하세요.

데스크톱 헤더에 "미연결"이라고 뜹니다 ​

  • 원인: 서버와의 실시간 연결(WebSocket)이 끊긴 상태입니다. 수집 자체는 가능할 수 있으나 웹 화면 실시간 반영이 지연됩니다.
  • 조치:
    1. 인터넷 연결 확인.
    2. 앱 재시작 (자동 재연결).
    3. 설정 > API 서버 URL 확인 (위 항목 참조).
    4. 지속되면 서비스 상태 공지 확인 후 문의.

웹 Agent 관리에 "에이전트 미연결"로 표시됩니다 ​

  • 원인: 데스크톱 앱이 실행되어 있지 않거나 로그인되지 않은 상태입니다. 웹 시스템 > Agent 관리(/agent)의 원격 명령(전체 수집·사이트 검증)은 데스크톱 앱이 연결되어 있어야 동작합니다.
  • 조치: 데스크톱 앱을 실행하고 로그인한 뒤 Agent 관리 화면의 새로고침을 누르세요. 앱이 실행 중인데도 미연결이면 위의 "데스크톱 헤더에 '미연결'" 항목(네트워크·API 서버 URL)을 확인하세요.

인터넷이 끊긴 동안 수집한 데이터가 걱정됩니다 ​

  • 원인: 일시적 네트워크 단절.
  • 조치: 데스크톱 앱은 오프라인 큐를 갖고 있어, 끊긴 동안의 전송 작업을 보관했다가 연결 복구 시 자동 재전송합니다. 장시간 오프라인이었다면 복구 후 웹 주문 관리(/orders)에서 누락 여부를 확인하고 필요 시 재수집하세요 — 재수집해도 중복 생성되지 않습니다.

특정 사이트 수집이 "로그인 실패"로 끝납니다 ​

  • 원인: 도매 사이트의 로그인 정보가 만료/변경된 경우가 대부분입니다.
  • 조치:
    1. 해당 도매 사이트에 브라우저로 직접 로그인해 보고, 비밀번호 변경·휴면 해제·추가 인증 요구가 있는지 확인.
    2. 변경된 정보를 데스크톱 설정 > 사이트 연동 설정(또는 웹 /sites)에서 재등록 — 연결 테스트 버튼으로 실제 로그인이 되는지 즉시 검증할 수 있습니다.
    3. 다시 수집 실행.
  • 로그인 단계는 최대 3회까지 자동 재시도한 뒤 실패 처리됩니다. 자격증명 자체가 틀린 경우에는 재시도해도 실패하니, 반드시 정보를 갱신한 후 재실행하세요. 반복해서 잘못된 비밀번호로 시도하면 사이트 계정이 잠길 수 있습니다.

롯데온·이지웰 수집이 "로그인 시간 초과"로 실패합니다 ​

  • 원인: 롯데온은 2단계 인증, 이지웰은 전화인증이 필요해 사용자가 브라우저에서 직접 인증을 완료해야 합니다. 제한 시간(롯데온 최대 3분, 이지웰 최대 110초) 안에 인증이 완료되지 않으면 실패 처리됩니다. 송장 사이트 업로드 시에도 같은 인증 대기가 적용됩니다.
  • 조치:
    1. 백그라운드 수집 모드(설정 > 일반 설정)를 끈 상태에서 수집을 실행해 브라우저 창이 보이게 하세요.
    2. 브라우저 창에서 인증(롯데온 2단계 인증 / 이지웰 LOGIN 클릭 후 전화인증)을 제한 시간 내에 완료하세요.
    3. 한 번 로그인하면 세션이 PC에 보존되어 이후 수집은 보통 재인증 없이 진행됩니다.
  • 대안: 두 사이트는 대시보드 카드의 엑셀 업로드 버튼으로 사이트에서 받은 주문 엑셀을 직접 업로드할 수도 있습니다.

이지웰 작업 중 "중복 로그인"으로 세션이 끊깁니다 ​

  • 원인: 이지웰은 같은 계정으로 다른 곳(다른 PC/브라우저)에서 로그인하면 기존 세션을 즉시 끊습니다. 수집이나 송장 업로드 진행 중에 다른 브라우저로 이지웰에 로그인하면 앱이 쓰던 세션이 끊겨 작업이 실패합니다.
  • 조치:
    1. 다른 PC/브라우저의 이지웰 로그인을 종료하세요.
    2. 앱이 띄운 브라우저 창에서 LOGIN 클릭 후 전화인증을 다시 완료하세요 — 중복 로그인이 감지되면 앱이 로그인 화면으로 되돌려 재로그인 기회를 줍니다.
    3. 수집·송장 업로드가 진행되는 동안에는 다른 곳에서 이지웰에 로그인하지 마세요.

수집이 중간에 실패합니다 (타임아웃/네트워크 오류) ​

  • 원인: 일시적 네트워크·사이트 오류, 사이트 팝업/공지, 사이트 점검, 또는 사이트 화면 개편.
  • 조치:
    1. 일시적 오류는 앱이 간격을 늘려가며 최대 3회 자동 재시도합니다. 그래도 실패하면 아래를 확인하세요.
    2. 대시보드 하단 수집 로그에서 실패 단계(초기화/로그인/수집)와 메시지 확인.
    3. 백그라운드 수집 모드를 잠시 꺼서 브라우저 창을 띄운 채 재실행 — 사이트의 팝업/공지/추가 인증이 원인인 경우 화면에서 바로 보입니다.
    4. 도매 사이트 자체 점검 시간인지 확인.
    5. 사이트 화면 개편으로 계속 실패하면 문의해 주세요 (수집기 패치 대상).
  • 한 사이트의 수집은 최대 10분까지 실행되며 초과 시 타임아웃 처리됩니다.

업데이트 후 첫 수집에서 재로그인을 요구합니다 ​

  • 원인: 앱 업데이트로 사이트 로그인 세션 저장 방식이 갱신되면 저장된 세션이 초기화될 수 있습니다.
  • 조치: 정상 동작입니다. 첫 수집 1회만 브라우저에서 로그인(추가 인증 포함)을 완료하면 이후에는 세션이 보존됩니다.

스케줄을 켰는데 자동 수집이 안 돕니다 ​

  • 원인: 앱 미실행, 시간 범위 밖, 저장 누락, 또는 개별 실행 실패.
  • 조치 (순서대로 확인):
    1. 앱이 실행 중인지 확인 — 스케줄은 데스크톱 앱이 켜져 있어야 동작합니다 (트레이 최소화 상태는 실행 중).
    2. 스케줄 카드의 시작 시간~종료 시간 범위 안인지 확인.
    3. 스케줄 설정 후 저장 버튼을 눌렀는지 확인 (저장해야 적용됩니다).
    4. 카드의 마지막 실행 상태가 "실패"라면 표시된 오류 메시지 확인 — 대부분 위의 로그인/네트워크 문제입니다.
    5. 다음 실행 시간이 표시되는지 확인 — 없으면 토글을 껐다 켜고 다시 저장.
  • "Windows 시작 시 자동 실행" + "창 닫기 시 트레이로 최소화"를 함께 켜두면 앱이 항상 상주해 스케줄이 끊기지 않습니다.

같은 주문이 두 번 들어왔습니다 ​

  • 원인: 정상적으로는 발생하지 않습니다 — 수집 시 주문번호·상품코드·옵션명 조합을 기준으로 기존 주문을 갱신합니다. 사이트 측에서 같은 주문이 다른 주문번호로 두 번 노출된 특수 사례일 수 있습니다.
  • 조치: 웹 주문 관리(/orders)에서 중복 건 중 한 건을 삭제하고, 재발하면 해당 주문번호와 함께 문의해 주세요.

자동 접수를 켰는데 사이트 주문 상태가 바뀌지 않습니다 ​

  • 원인: 설정이 실제로는 꺼져 있거나(기본값 꺼짐), 이번 수집에서 새로 수집된 주문이 없는 경우입니다. 자동 접수는 안전을 위해 이번 수집에서 실제로 수집된 주문만 접수 상태로 전환합니다.
  • 조치:
    1. 웹 채널 연동(/sites)에서 해당 사이트의 수집 시 자동 접수 처리 토글이 켜져 있는지 확인하세요. 데스크톱 대시보드 사이트 카드의 자동 접수 ON/OFF 배지로도 현재 설정을 볼 수 있습니다 (배지는 표시 전용, 변경은 웹에서만).
    2. 토글을 켠 뒤 해당 사이트의 수집을 다시 실행하세요 — 자동 접수는 수집 과정의 일부로 동작합니다.
    3. 대시보드 하단 수집 로그에서 "자동 접수" 메시지(전환 건수/중단 사유)를 확인하세요.

데스크톱 상품 등록(엑셀 생성/사이트 업로드)이 실패합니다 ​

  • 원인: 등록 엑셀 생성 실패(서버 처리)는 마스터상품 데이터 문제, 사이트 업로드 실패는 사이트 로그인/화면 문제인 경우가 많습니다.
  • 조치:
    1. 상품 등록 로그에서 실패 메시지 확인.
    2. "외부이미지 N건" 경고가 있으면 해당 상품 이미지를 Selltic에 적재한 후 엑셀을 재생성하세요 — 외부 이미지 URL은 사이트 등록 시 누락될 수 있습니다.
    3. 사이트 업로드 실패 시: 해당 사이트 자격증명을 연결 테스트로 확인 후 재시도.
    4. 자동 업로드가 계속 실패하면 파일 열기로 생성된 엑셀을 받아 사이트 관리자 페이지에 직접 업로드하세요 (엑셀 자체는 사이트 공식 일괄등록 양식입니다).

웹 등록 큐의 등록 요청이 "실패"로 끝났습니다 ​

  • 원인: 필수 항목 누락(제목/가격/카테고리 등), 사이트 로그인/인증 오류, 또는 일시적 사이트 오류.
  • 조치: 웹 등록 큐(/registrations)에서 실패 사유를 확인하고, 원인을 해소한 뒤 상세 화면의 재시도 버튼을 누르세요. 상태가 대기로 돌아가 다시 처리됩니다. 상품 정보 보완은 상품 관리를 참조하세요.

송장 엑셀 업로드(웹)가 파싱되지 않습니다 ​

  • 원인: 엑셀에 필요한 컬럼이 없거나 머리글 행을 인식하지 못한 경우입니다.
  • 조치:
    • 주문 관리(/orders) > 송장 업로드: 엑셀에 주문번호, 택배사, 송장번호 컬럼이 있어야 하며 컬럼명으로 자동 인식됩니다(택배사/배송사, 송장번호/운송장번호 등 유사 명칭 허용). .xlsx/.xls만 지원합니다. 머리글이 꼭 첫 행일 필요는 없습니다 — 발주서 회신 양식처럼 위에 안내 문구가 있어도 주문번호·송장번호가 같은 행에 있는 곳을 머리글로 자동 인식합니다. 병합 셀이 없는지 확인하세요.
    • 발주서 송장 회수 업로드(발주서에 대한 송장 등록): 발주서 양식 그대로 회신받은 파일을 쓰는 것이 가장 안전합니다. 송장번호와 상품코드 컬럼이 있는 행을 머리글로 자동 인식하고(옵션 컬럼은 옵션명/옵션/옵션1 표기 허용), 주문번호가 있으면 주문번호까지 포함해 매칭합니다. 옵션 표기가 달라 매칭에 실패하면 주문번호+상품코드로 다시 매칭합니다. 송장 관리 참조.
  • 송장번호 칸에 "품절" 등 숫자가 없는 텍스트가 적힌 행은 등록하지 않고 건너뛰며, 건너뛴 사유가 결과에 표시됩니다. 품절 항목은 발주서에서 품절/취소 처리하세요.
  • 업로드 결과 화면에 건별 상태가 표시됩니다: 등록완료 / 미발견(일치하는 주문 없음 — 주문번호 확인) / 이미발송(이미 송장이 등록된 주문).

송장 사이트 업로드가 "로그인 세션 없음/세션 만료"로 실패합니다 ​

  • 원인: 데스크톱의 사이트 업로드는 주문 수집과 같은 로그인 세션을 재사용합니다. 해당 사이트의 주문 수집을 한 번도 실행하지 않았거나 세션이 만료되면 업로드할 세션이 없어 실패합니다. 특히 온누리마켓은 수집으로 만들어진 세션이 반드시 필요합니다.
  • 조치: 해당 사이트의 주문 수집을 먼저 1회 실행해 로그인 세션을 만든 뒤(롯데온·이지웰은 이때 추가 인증 완료) 송장 처리 탭에서 다시 업로드하세요.

데스크톱 송장 처리(사이트 업로드)에서 일부만 성공합니다 ​

  • 원인: 사이트 로그인 만료, 사이트에서 이미 발송 처리된 주문, 사이트 점검 등.
  • 조치: 송장 처리 로그에 사이트별 성공/실패와 사유가 표시됩니다. 로그인 문제면 자격증명 갱신 후 새로고침 → 재실행하세요 — 성공한 건만 전송완료로 마킹되어 목록에서 빠지고, 실패 건은 전송완료로 처리되지 않고 남아 있으므로 재실행하면 남은 건만 다시 업로드됩니다. 자동 업로드가 계속 실패하면 파일 열기로 엑셀을 받아 사이트에 직접 업로드한 뒤 전송완료 처리를 눌러 마킹하세요.

송장 엑셀 파일이 어디에 저장됐는지 못 찾겠습니다 ​

  • 원인: 사이트 업로드용 송장 엑셀은 설정 > 일반 설정 > 수집 파일 저장 폴더 아래 사이트 이름 하위 폴더에 저장됩니다 (기본값: 문서\Selltic\수집주문). 다른 위치를 찾고 있었을 수 있습니다.
  • 조치: 송장 처리 탭 카드의 파일 열기 버튼을 누르면 탐색기가 해당 파일이 선택된 상태로 열립니다. 송장 처리 로그에도 생성 시 전체 경로가 표시됩니다.

앱을 껐는데도 계속 실행 중이라고 나옵니다 ​

  • 원인: 기본 설정이 창 닫기 시 트레이로 최소화이기 때문입니다. 처음 최소화될 때 안내 알림이 한 번 표시됩니다.
  • 조치: 트레이 아이콘 더블클릭으로 창을 열거나, 우클릭 → 완전 종료로 끕니다. 창 닫기로 완전 종료되길 원하면 설정 > 일반 설정에서 해당 옵션을 끄세요.

수집 완료/실패 알림이 오지 않습니다 ​

  • 원인: 데스크톱 알림 설정이 꺼져 있거나 Windows의 알림 설정에서 차단된 경우입니다.
  • 조치: 데스크톱 설정 > 일반 설정 > 데스크톱 알림이 켜져 있는지 확인하고, Windows 설정 > 시스템 > 알림에서 Selltic 알림이 허용되어 있는지 확인하세요. 웹 화면의 실시간 수집 알림은 데스크톱 헤더가 "연결됨" 상태(WebSocket 연결)여야 표시됩니다.