다크 모드
상품 동기화
개요
상품 동기화(/sync)는 마스터상품에서 변경한 가격·상품명 등의 정보를 판매 채널(사이트/마켓)에 반영하기 위한 승인 큐입니다. 마스터상품의 판매가나 콘텐츠를 수정하면 채널별 반영 태스크가 자동으로 생성되어 이 화면에 쌓이고, 변경 내용을 확인한 뒤 승인하면 실행 대기 상태로 전환됩니다. 실수로 잘못 바꾼 가격이 채널에 바로 반영되는 사고를 막기 위해, 반영 전 반드시 사람의 승인을 거치도록 설계되어 있습니다.
(예정) 승인된 태스크를 채널에 자동 반영하는 실행기는 아직 연동 전입니다. 따라서 현재는 승인 후 태스크가 실행 대기 상태로 유지되는 것이 정상 동작입니다. 자동 반영 전까지는 등록 엑셀 재업로드 또는 사이트 관리자 화면에서 직접 반영한 뒤, 해당 태스크의 수동 완료 버튼으로 성공 처리해 주세요.
화면 안내

위 화면은 상품 동기화 페이지입니다. 상단 페이지 제목 옆에는 "마스터상품 변경분을 사이트/마켓에 반영하는 승인 큐입니다"라는 안내가 있고, 우측에는 승인 대기, 실행 대기 등 상태별 건수 집계 배지가 표시됩니다(배지를 클릭하면 해당 상태로 목록이 필터링됩니다). 그 아래 필터 바에서 상태, 채널, 타입을 선택해 목록을 좁힐 수 있습니다. 목록 테이블의 컬럼은 다음과 같습니다.
| 컬럼 | 내용 |
|---|---|
| 마스터상품 | 마스터상품명과 연결된 사이트 상품명·옵션명 |
| 채널 | 반영 대상 채널의 한글 라벨 (예: 롯데온, 인더마켓) |
| 타입 | 가격 / 재고 / 콘텐츠 / 전체 |
| 방식 | API 자동 / 데스크톱 / 등록엑셀 재업로드 / 수동 |
| 변경 내용 | "판매가 10,000→12,000" 형식의 변경분. 여러 건이면 "외 n건" 태그에 마우스를 올려 전체 확인 |
| 상태 | 승인 대기 / 실행 대기 / 반영중 / 완료 / 실패 / 취소 / 대체됨 |
| 생성일 | 태스크 생성 날짜 |
| 액션 | 상태에 따라 수동 완료(실행 대기 시), 재시도(실패 시), 취소 버튼 |
체크박스는 승인 대기 상태의 행에서만 선택할 수 있으며, 선택하면 목록 위에 "n건 선택됨" 바와 일괄 승인, 선택 해제 버튼이 나타납니다.
위 화면은 필터 바 아래의 채널×상태 매트릭스입니다. 행은 채널, 열은 상태이며 각 셀에 해당 조합의 태스크 건수가 표시됩니다. 셀을 클릭하면 그 채널+상태로 목록이 동시에 필터링됩니다.

위 화면은 마스터상품 관리(/master-products) 페이지 상단입니다. 승인 대기 중인 동기화 태스크가 있으면 제목 오른쪽에 금색 동기화 대기 n 배지가 나타나고, 배지를 클릭하면 상품 동기화 페이지로 이동합니다.
절차
마스터상품 변경분을 채널에 반영 승인하기
- 좌측 메뉴에서 상품 > 마스터상품을 클릭해 마스터상품의 매입가·판매가 또는 상품명·브랜드를 수정합니다. 판매가가 바뀐 Variant마다 연결된 채널별 동기화 태스크가 자동 생성됩니다.
- 마스터상품 관리 상단에 나타난 동기화 대기 n 배지를 클릭하거나, 좌측 메뉴에서 상품 > 상품 동기화를 클릭합니다.
- 목록에서 각 태스크의 변경 내용 열을 확인합니다. 변경분이 여러 건이면 "외 n건" 태그 위에 마우스를 올려 전체 변경 목록을 확인합니다.
- 반영할 태스크의 체크박스를 선택합니다(승인 대기 상태만 선택 가능).
- 일괄 승인 버튼을 클릭합니다. "n건이 승인되어 실행 대기로 전환되었습니다." 메시지와 함께 상태가 실행 대기로 바뀝니다.
- 자동 실행기 연동 전이므로, 방식 열에 표시된 방법(등록엑셀 재업로드 또는 수동)으로 채널에 직접 반영합니다. 실행 대기 상태의 수동 방식 태스크에는 "자동 실행기 연동 전 — 등록 엑셀 재업로드 또는 수동 반영 후 [수동 완료] 버튼으로 상태를 갱신하세요"라는 경고 아이콘이 표시됩니다.
- 채널 반영을 마쳤으면 아래 "수동 반영 완료 처리하기"로 태스크를 성공 처리합니다.
수동 반영 완료 처리하기
- 실행 대기 상태 태스크의 수동 완료 버튼을 클릭합니다.
- "수동 반영 완료 처리" 확인 모달에서 사이트에 직접 반영을 마쳤는지 확인하고 완료 처리를 클릭합니다. "수동 반영이 완료 처리되었습니다." 메시지와 함께 상태가 완료로 바뀝니다.
- 완료 처리는 되돌릴 수 없으니 반드시 실제 반영을 마친 뒤 실행하세요.
마스터상품에서 수동으로 동기화 태스크 만들기 (채널 동기화)
가격이 바뀌지 않았더라도, 마스터의 현재 상품명·브랜드·판매가를 연동된 사이트 변형 전체에 반영하는 태스크를 직접 만들 수 있습니다.
- 마스터상품 관리에서 마스터상품 1건을 선택하고 액션 바의 채널 동기화 버튼을 클릭합니다.
- 채널 동기화 (승인 큐 경유) 모달에 실행 전 계획(채널·상품코드·옵션·반영 내용)이 표시됩니다 — 이 단계에서는 태스크가 만들어지지 않습니다.
- **태스크 생성 (n건)**을 클릭하면 "n건의 동기화 태스크가 승인 대기로 생성되었습니다." 메시지와 함께 상품 동기화 페이지로 이동합니다. 즉시 반영이 아니라 승인 큐를 거칩니다.
- 연동된 활성 사이트 변형이 없으면 계획이 비어 있습니다 — 먼저 사이트 상품 연결로 사이트 상품을 연결하세요.
잘못 생성된 태스크 취소하기
- 상품 동기화 목록에서 취소할 태스크를 찾습니다. 승인 대기, 실행 대기, 실패 상태에서 취소할 수 있습니다.
- 해당 행의 취소 버튼을 클릭합니다. "태스크가 취소되었습니다." 메시지와 함께 상태가 취소로 바뀝니다.
- 취소한 뒤 마스터상품에서 같은 필드를 다시 수정하면 새 태스크가 생성됩니다.
실패한 태스크 재시도하기
- 실패 상태의 태스크는 상태 태그에 마우스를 올리면 실패 사유가 표시됩니다.
- 해당 행의 재시도 버튼을 클릭합니다. "재시도 대기로 전환되었습니다." 메시지와 함께 상태가 실행 대기로 돌아갑니다.
상태·채널·타입으로 목록 필터링하기
- 필터 바에서 상태(승인 대기~대체됨), 채널(연동 채널 한글 라벨 검색 가능), 타입(가격/재고/콘텐츠/전체)을 선택합니다.
- 상단의 상태별 집계 배지를 클릭해도 해당 상태로 바로 필터링됩니다.
- 채널×상태 매트릭스의 셀을 클릭하면 그 채널과 상태로 동시에 필터링됩니다.
- 필터를 지우려면 필터 바의 초기화 버튼을 클릭합니다.
Q&A
Q: 동기화 태스크는 언제 자동으로 생성되나요?
A: 마스터상품 쪽 변경이 채널에 등록된 상품에 영향을 줄 때 생성됩니다. 대표적으로 ①옵션의 매입가를 수정해 판매가가 재계산될 때(가격 타입) ②Variant의 판매가가 바뀔 때(가격 타입 — 사이트별 변형 편집에서 직접 수정한 경우 포함) ③마스터상품의 상품명·브랜드를 수정할 때(콘텐츠 타입 — 활성 Variant 전체에 생성)입니다. 이 외에 마스터상품 1건을 선택해 채널 동기화 버튼으로 현재 값 전체를 반영하는 태스크를 직접 만들 수도 있습니다. 태스크는 Variant가 연결된 채널(사이트)별로 각각 만들어집니다.
Q: 승인했는데 상태가 "실행 대기"에서 바뀌지 않아요. 고장인가요?
A: 아닙니다. 현재는 정상 동작입니다. 승인된 태스크를 채널에 자동 반영하는 실행기가 아직 연동되지 않아(예정), 승인 후에는 실행 대기 상태로 유지됩니다. 방식 열의 안내대로 등록 엑셀 재업로드 또는 사이트 관리자 화면에서 직접 반영한 뒤, 해당 행의 수동 완료 버튼으로 성공 처리하세요.
Q: 같은 상품의 가격을 여러 번 바꾸면 태스크가 계속 쌓이나요?
A: 아닙니다. 같은 Variant·채널·타입 조합에 아직 처리되지 않은(승인 대기/실행 대기) 태스크가 있으면 새 태스크를 만들지 않고 기존 태스크에 변경분을 병합합니다. 이때 최초의 이전 값은 보존되고 새 값만 갱신되므로, 변경 내용에는 "처음 값→최종 값"이 표시됩니다.
Q: "방식" 열의 API 자동 / 데스크톱 / 등록엑셀 재업로드 / 수동은 무슨 뜻인가요?
A: 해당 채널에 변경분을 반영하는 방법입니다. API 자동은 서버가 채널 API로 직접 수정하는 방식(예: 롯데온), 데스크톱은 데스크톱 앱이 사이트 화면을 조작해 수정하는 방식, 등록엑셀 재업로드는 사이트의 일괄등록 엑셀을 다시 올려 수정하는 방식, 수동은 사이트 관리자 화면에서 직접 수정하는 방식입니다. 자동 실행 방식(API 자동 등)도 실행기 연동 전(예정)에는 자동으로 실행되지 않습니다.
Q: "대체됨" 상태는 무엇인가요?
A: 해당 태스크가 처리되기 전에 더 새로운 변경분으로 대체되어 더 이상 유효하지 않은 상태입니다. 대체된 태스크는 실행되지 않으며, 최신 태스크만 승인·반영하면 됩니다.
Q: 태스크의 실패 사유는 어디서 보나요?
A: 목록의 상태 열에서 빨간 실패 태그 위에 마우스를 올리면 오류 메시지가 표시됩니다. 원인을 해결한 뒤 재시도 버튼으로 다시 실행 대기에 올릴 수 있습니다.
Q: 마스터상품 페이지의 "동기화 대기" 배지 숫자는 무엇을 세는 건가요?
A: 승인 대기 상태인 동기화 태스크의 건수입니다. 승인 대기 태스크가 1건 이상일 때만 배지가 나타나며, 클릭하면 상품 동기화 페이지로 이동합니다.
문제해결
마스터상품 가격을 바꿨는데 태스크가 생기지 않아요
- 원인: 해당 마스터상품의 Variant가 채널 상품과 연결되어 있지 않으면 반영할 대상이 없어 태스크가 생성되지 않습니다.
- 조치: 마스터상품 관리 더보기(⋮) → **사이트 상품 연결 (후보 검토)**로 사이트 상품과 Variant를 먼저 연결한 뒤 다시 수정하세요. 연결 방법은 상품 관리 챕터를 참조하세요.
승인 대기가 아닌 행이 선택되지 않아요
- 원인: 일괄 승인 대상은 승인 대기 상태의 태스크뿐이라, 다른 상태의 행은 체크박스가 비활성화됩니다.
- 조치: 정상 동작입니다. 실패 태스크는 재시도, 불필요한 태스크는 취소 버튼으로 개별 처리하세요.
승인·취소 버튼을 눌렀는데 실패 메시지가 떠요
- 원인: 이미 다른 세션에서 상태가 바뀌었거나(예: 승인 직후 취소 시도), 네트워크 오류일 수 있습니다. 태스크 상태는 정해진 순서로만 전이됩니다.
- 조치: 목록을 새로고침해 현재 상태를 확인한 뒤 해당 상태에서 가능한 액션만 다시 시도하세요.