재고동기화

즉시 전체 실행

지금 전체 동기화

상단의 지금 전체 동기화 버튼은 자동 실행이 OFF인 상태에서도 사용할 수 있습니다. 셀러툴 조회 → 네이버 조회·반영 → 쿠팡 조회·반영을 즉시 실행하며, 실행 중에는 다른 전체 동기화를 중복으로 시작할 수 없습니다.

처음 사용하거나 상품이 변경된 경우

네이버 옵션 매핑 업데이트 / 쿠팡 옵션 매핑 업데이트

플랫폼 계정을 선택하고 매핑 업데이트를 실행하면 플랫폼 옵션 관리 코드와 셀러툴 옵션코드를 연결합니다. 계정별 최초 1회 실행하고 상품·옵션을 새로 등록하거나 옵션코드를 변경한 경우 다시 실행하세요. 자동·즉시 전체 동기화는 매핑을 자동 갱신하지 않습니다. 최근 1시간 이내에 매핑을 완료했다면 외부 API를 다시 호출하지 않고 DB 저장 결과를 사용할 수 있습니다.

패키지 옵션

패키지 매핑 업데이트

패키지 매핑 탭에서 셀러툴 패키지와 구성품 관계를 DB에 저장합니다. 구성품이 변경된 경우에만 다시 실행하면 되며, 평소 조회와 자동 동기화는 저장된 매핑을 사용합니다. 구성품 재고를 필요 수량으로 나눈 값 중 최솟값을 패키지 판매 가능 재고로 계산합니다.

STEP 1

셀러툴 조회

오늘 입출고가 있었던 옵션과 현재재고를 셀러툴에서 조회하여 DB에 저장합니다. 최근 조회가 1시간 이내면 외부 API를 호출하지 않고 저장 결과를 사용합니다.

STEP 2

선택 항목 네이버 조회

테이블에서 확인할 행을 선택한 뒤 네이버 조회 버튼을 누릅니다. 연결된 스토어의 상품번호, 현재 재고와 가격을 확인합니다. 최근 업데이트가 1시간 이내인 항목은 DB 저장 결과를 사용합니다. 예외적으로 다시 조회하려면 1시간 캐시를 OFF로 변경합니다.

STEP 3

선택 재고 네이버 반영

셀러툴 현재재고와 네이버 재고를 확인한 뒤 반영할 행을 선택합니다. 반영 버튼과 확인창을 누르면 셀러툴 현재재고가 연결된 네이버 옵션에 적용됩니다. 네이버의 현재 판매가, 옵션가와 미선택 옵션 정보는 유지됩니다.

쿠팡

쿠팡 조회·반영 및 실패 재시도

쿠팡 탭에서도 매핑 업데이트 후 행 선택 → 쿠팡 조회 → 쿠팡 반영 순서로 진행합니다. 눈 아이콘이 OFF인 옵션은 API로 전송되지 않습니다. 반영 결과는 동기화 이력에 저장되며, 실패한 실행은 이력 탭에서 실패 항목만 다시 시도할 수 있습니다.

반영 제외

플랫폼별 재고 반영 ON/OFF

네이버와 쿠팡의 눈 아이콘 설정은 서로 독립적으로 저장됩니다. OFF 항목도 재고 조회는 가능하지만 수동·자동 반영 API에는 전송되지 않습니다.

API 호출 절약

동일 재고·최근 조회 결과 처리

플랫폼 재고와 셀러툴 재고가 같으면 반영 API를 호출하지 않습니다. 최근 1시간 이내 조회 항목은 DB 저장 결과를 사용할 수 있으며, 같은 쿠팡 vendorItemId가 중복 연결된 경우에도 재고 API는 한 번만 호출합니다.

실패 처리

쿠팡 반영 후 검증과 재시도

쿠팡 반영 응답이 실패하거나 불확실하면 해당 항목만 다시 조회합니다. 실제 재고가 목표 수량과 같으면 검증 성공으로 복구하고, 불일치 또는 검증 실패는 동기화 이력에 기록합니다. 실패한 실행은 이력 탭에서 실패 항목만 재시도할 수 있습니다.

결과 확인

동기화 상태

SUCCESS는 전체 성공, PARTIAL은 일부 항목 실패, FAILED는 실행 자체 실패를 의미합니다. 최근 플랫폼별 반영·실패 건수는 상단 결과 패널에서 확인하고, 옵션별 상세 결과와 변경 전후 재고는 동기화 이력에서 확인하세요.