1688 API 상품 옵션·SKU 구조 이해하기

작성 2026-09-16

1688 상품은 상품 ID 아래에 속성 조합과 판매 단위가 따로 존재합니다. 이 구조를 쇼핑몰 SKU로 옮길 때 무엇을 키로 잡아야 하고 어디서 매핑이 깨지는지 설명합니다.

상품 하나에 가격이 여러 개인 이유

중국 도매 플랫폼의 상품 데이터를 처음 다루면 대개 같은 지점에서 막힙니다. 상품은 하나인데 가격과 재고가 여러 개로 나옵니다. 색상이 빨강일 때와 파랑일 때 값이 다르고, 같은 색이라도 사이즈에 따라 또 다릅니다. 심지어 수량 구간에 따라 단가가 달라지기도 합니다.

이는 오류가 아니라 구조입니다. 상품 아래에 속성(색상·사이즈 등)의 조합이 있고, 조합마다 독립된 판매 단위가 존재합니다. 우리 쇼핑몰의 SKU와 정확히 같은 개념입니다. 문제는 이 대응 관계를 어떻게 저장하느냐입니다.

세 가지 층으로 나눠 보기

가장 흔한 실수: 옵션명을 키로 쓰는 것

"빨강 / L" 같은 텍스트를 키로 저장하면 반드시 깨집니다. 판매자가 옵션명을 "정품 빨강 / L(권장)"으로 바꾸는 순간, 우리 쪽 SKU와 연결이 끊어지기 때문입니다. 번역을 거치면 문제가 더 커집니다. 같은 조합이 번역 시점에 따라 다른 문자열이 됩니다.

그래서 저장할 때는 세 가지를 분리합니다.

• 매핑용 식별자 — 원본 상품 ID + 조합 식별자. 절대 화면에 쓰지 않고 연결에만 씁니다.
• 원문 표기 — 판매자가 쓴 그대로. 분쟁 대응과 재확인용입니다.
• 표시용 표기 — 번역 + 운영자 수정본. 고객에게 보여 주는 값이며 언제든 바뀔 수 있습니다.

SKU를 만들 때 정해야 하는 것

1) 어느 속성까지 SKU로 만들 것인가

조합을 모두 SKU로 만들면 수백 개가 생기기도 합니다. 실제로 팔 조합만 선별해 등록하는 편이 재고 관리와 화면 구성 모두에 유리합니다. 선별 기준(재고 있는 조합만, 특정 색상만)을 운영자가 화면에서 고를 수 있게 만들어 두면 등록 작업이 훨씬 빨라집니다.

2) 수량 구간 단가를 어떻게 다룰 것인가

도매 상품은 수량이 늘수록 단가가 내려가는 구조가 흔합니다. 이 구간 정보를 버리고 최저가만 저장하면 실제 매입가와 어긋나고, 최고가만 저장하면 경쟁력이 없어집니다. 구간 자체를 저장하고, 판매가 계산 시 예상 매입 수량 기준으로 적용하는 규칙을 두는 편이 안전합니다.

3) 재고 값을 믿을 것인가

수집한 재고 수량은 참고값입니다. 실제로 발주해 보면 품절인 경우가 드물지 않습니다. 따라서 재고를 그대로 노출하기보다 판매 가능/불가 정도로 단순화하고, 품절은 발주 단계에서 확정되는 상태로 다루는 편이 고객 응대에 낫습니다.

이미지와 상세 설명

상세 설명은 대부분 이미지입니다. 원본 이미지를 그대로 링크로 걸면 판매자가 이미지를 교체하거나 삭제했을 때 상품 페이지가 깨집니다. 우리 쪽 저장소로 내려받아 쓰는 방식이 안전하며, 이때 저작권과 플랫폼 정책을 함께 확인해야 합니다.

수집 방식에 대한 주의

정리

요약하면 한 줄입니다. 보여 주는 값과 연결하는 값을 반드시 나누어 저장하십시오. 옵션 텍스트는 언제든 바뀌지만 식별자는 바뀌지 않습니다. 이 원칙 하나만 지켜도 재발주, 가격 갱신, 재고 동기화에서 생기는 문제의 상당수가 사라집니다.

관련 내용