1. 사용자 가이드
  2. 서비스 설정
  3. API 관리
  4. 자동화 수집 설정
서비스 설정 · API 관리

자동화 수집 설정

판매채널의 주문, 상품 등 데이터를 자동으로 수집하기 위한 연동 및 수집 조건을 설정하는 방법을 안내합니다.

등록된 판매채널마다 수집 종류·주기를 지정해 스케쥴러가 자동으로 데이터를 가져오는 기능입니다.

왜 필요한가요?

판매채널마다 수시로 발생하는 신규 주문 · 클레임 · 상품문의 · 정산 데이터를 손으로 조회하지 않고, 정해진 주기에 자동으로 윈셀링에 반영 하기 위한 설정입니다. 스케쥴러가 사이클마다 대상 채널에 API 를 호출해 최근 데이터를 가져옵니다.

사전 조건

  • 판매채널 API 관리 에 채널이 등록 · 승인 완료 상태여야 합니다.
  • 채널의 연동 토글이 ON 이어야 합니다. (OFF 이면 이 페이지에서 설정해도 스케쥴러가 스킵)
  • 서비스 이용권에 따라 수집 주기 옵션 이 달라집니다. (아래 4번 문서 참고)
ℹ️
등록된 판매채널이 없으면 이 페이지는 안내 메시지를 보여줍니다. 먼저 판매채널 API 관리 에서 채널을 등록하세요.

KPI 4장 · 탭 · 툴바 · 채널 카드 그리드 · 스티키 저장 바 구조를 안내합니다.

KPI 카드 4장

카드표시 값
등록 채널연동 가능한 전체 채널 수 · 서비스 레벨 표시
활성 스케쥴활성 채널 / 전체 · 정산 활성 채널 수
수집 응답 지연30초 이상 응답 채널 수
최근 실패최근 24시간 실패 건수
KPI 4장

탭 · 툴바 · 그리드 · 스티키 바

  • 탭 — 스케쥴 설정 · 최근 수집 로그 · 실패 로그 3개
  • 툴바 — 전체 선택 · 검색(스토어명 / 판매자 ID) · 상태 필터 · 새로고침 · 일괄 저장
  • 채널 카드 그리드 — 채널마다 1장, 6종 수집 옵션을 pill 로 표시
  • 스티키 저장 바 — 하단 고정, 선택 개수 · 일괄 저장 버튼
채널 카드 그리드

채널 카드에서 지정 가능한 6가지 수집 트랙을 안내합니다.

수집 트랙

트랙수집 대상
주문 수집결제대기 ~ 구매확정 6단계 주문
클레임취소 · 반품 · 교환 · 미수령 · 미결제취소 · AS 요청
CS · 상품문의 · 리뷰고객 커뮤니케이션 · 리뷰
주문확인 · 배송준비중 단독결제 직후 상태 신속 반영용 별도 트랙
취소 클레임 단독취소 클레임만 별도 트랙
정산전날 기준 정산 내역 매일 01시 · TODAY 옵션만 제공

왜 트랙을 나눴나요?

주문 전체를 짧은 주기로 조회하면 마켓 서버 부하와 대량 응답이 문제가 됩니다. 결제 직후 상태만 짧은 주기(주문확인 · 배송준비중 단독) 로 잡고, 나머지는 넉넉한 주기로 두면 실시간성 · 안정성 을 함께 확보할 수 있습니다.

💡
대부분의 채널은 주문 수집 = 1시간, 주문확인 · 배송준비중 = 30분 / 10분, 클레임 = 오전 / 오후 조합이면 충분합니다.

주기 옵션과 서비스 이용권에 따른 지원 여부를 안내합니다.

주기 옵션

옵션동작지원 조건
10분10분마다 최근 데이터 조회런풀 연계 이용자 · 주문확인 / 취소클레임 단독에만
30분30분마다 조회premium / giant 이용자 전용
1시간매 정각 최근 1시간 조회모든 이용자
오전 / 오후11시 · 23시 최근 12시간 조회모든 이용자
하루 일괄매일 00시 전일 주문 일괄 조회모든 이용자
미설정해당 트랙 스케쥴러가 실행되지 않음—
⚠️
10분 · 30분 은 서비스 레벨에 따라 자동으로 노출 / 숨김 됩니다. 대상이 아니면 pill 이 표시되지 않으니 별도 신청이 필요합니다.

자동수집 제한 (워크카운트)

모든 수집 호출은 사용자별 워크카운트 로 제한됩니다. 이용권에 따라 상한이 다르며 이 페이지에서 별도로 조정하지 않습니다. 상한 초과 시 다음 사이클로 이월됩니다.

채널 카드에서 개별 저장 또는 여러 채널 일괄 저장하는 방법을 안내합니다.

개별 저장

  1. 대상 채널 카드에서 트랙별 pill(미설정 / 주기)을 눌러 선택합니다.
  2. 카드 하단 우측의 💾 저장 버튼을 누릅니다.
  3. 저장 성공 시 상단에 토스트로 안내되고 화면이 최신 상태로 반영됩니다.
채널 카드 저장

일괄 저장

  1. 툴바의 전체 선택 체크박스 또는 카드별 체크박스로 대상 채널을 고릅니다.
  2. 필요하면 상태 필터(정상 / 응답 지연 / 실패 / 미설정) 로 좁힙니다.
  3. 툴바 우측 또는 하단 스티키 바의 💾 선택 일괄 저장 을 누릅니다.
  4. 확인 모달에서 승인하면 선택된 모든 채널의 현재 pill 상태가 저장됩니다.

상태 · 마지막 수집 확인

카드 하단에는 마지막 수집 시각 · 응답 시간 · 상태 · 최근 실패 메시지 요약이 표시됩니다. 응답 시간이 30초를 넘으면 주황색 으로 강조되며, 실패 사유는 최대 80자까지 미리보기로 노출됩니다.

스케쥴러가 수행한 최근 수집 이력을 확인하는 방법을 안내합니다.

탭 진입

  1. 페이지 상단 최근 수집 로그 탭을 누릅니다.
  2. 테이블에 발생 일시 · 채널 · 판매자 ID · 스토어명 · 트랙 · 결과 가 표시됩니다.
수집 로그

채널로 좁혀 보기

채널 카드 하단의 로그 버튼을 누르면 해당 채널의 로그로 바로 이동합니다. 전체 로그와 채널 로그를 상호 이동하며 확인할 수 있습니다.

조회 기간

⏱️
로그는 조회 성능을 위해 최근 7일 범위에서 우선 표시됩니다. 더 오래된 이력이 필요하면 관리 콘솔에서 별도 조회하세요.

수집 실패 원인을 확인하고 후속 대응을 결정하는 방법을 안내합니다.

실패 로그 열기

  1. 페이지 상단 실패 로그 탭을 누릅니다.
  2. 테이블에 발생 일시 · 채널 · 실패 사유 가 표시됩니다.
  3. 채널 카드 하단의 실패 버튼으로 해당 채널만 좁혀 볼 수 있습니다.
실패 로그

대표 실패 사유별 대응

실패 사유확인 지점
인증 실패 · 401 / 403채널 API 키 · Secret · 만료 여부 확인 → 판매채널 API 관리 에서 갱신
응답 없음 · 타임아웃마켓 점검 여부 확인 — 다음 사이클에 자동으로 재시도됩니다.
스펙 오류 · 400마켓 API 정책 변경 가능성 — 지원팀 문의
워크카운트 초과다음 사이클로 이월 — 상위 이용권으로 상향 필요
ℹ️
이 페이지에서 수동 재수집 기능은 제공하지 않습니다. 실패 원인 확인 후 채널 자체를 점검(키 갱신 · 지원팀 문의)하면 다음 스케쥴 사이클부터 정상 수집으로 이어집니다.

정산 트랙의 동작 조건과 활성화 방법을 안내합니다.

정산 트랙의 규칙

  • TODAY 옵션만 제공 — 다른 주기 없음
  • 매일 새벽 01시 · 전날 기준 정산 내역을 하루 일괄로 수집
  • 정산 API 를 지원하는 채널에서만 활성화 가능 (미지원 채널은 pill 노출 X)
₩
정산 카드는 다른 트랙과 시각적으로 구분되도록 골드톤 으로 강조 표시됩니다.

활성화

  1. 대상 채널 카드의 정산 행에서 하루 일괄 (TODAY) pill 을 누릅니다.
  2. 저장 하면 다음 새벽 01시부터 자동 수집됩니다.
  3. 수집 결과는 정산관리 · 수집 로그 에서 확인합니다.

비활성 · 미지원 채널

⚠️
정산 API 를 제공하지 않는 채널은 정산 pill 이 표시되지 않습니다. 이런 채널의 정산 확인은 마켓 관리자에서 수동으로 진행합니다.