상품 판매 상태 변경 문의

[gyoungbo]

상품 판매 상태 변경하는데 단일 상품은 매우 잘되는데
옵션있는 상품들은 어떤식으로 판매상태 변경을 해야하나요?

오류가 "조합형 옵션 상품인 경우 상품의 재고수량과 조합형옵션 재고수량의 합은 같아야 합니다." 라고 뜨는데 코드를 어떤식으로 짜야 조합형상품 관리가 가능할까요?

목표는 조합형상품 안에있는 옵션들을 자유자재로 판매와 품절을 가능하게끔 코드를 짜는것인데 가능한가요?

쿠팡은 옵션마저 개별코드가 있어서 품절이나 재판매가 수월한데 네이버는 상품에만 있어서 잘모르겠네요

[commerce-api-naver]

안녕하세요. 커머스API 이민석입니다.
확인이 늦었습니다. 통상적으로 답변은 3영업일 이내 답변을 원칙으로 하나, 급하게 확인이 필요하신 경우라면 처음 올리신 글에 @commerce-api-naver 멘션을 주시면 빠르게 확인 도와드리겠습니다.

조합형 옵션의 커머스API 관리

상품 등록 혹은 수정 시 API 요청 메시지 본문(Request body) 내 아래 필드로 조합형 옵션의 관리가 가능합니다.

• originProduct.detailAttribute.optionInfo.optionCombinationGroupNames: 옵션 항목명 (예: 색상 등)
• originProduct.detailAttribute.optionInfo.optionCombinations[n]: 옵션 값 (예: 빨강, 노랑, 파랑 등)

  [!NOTE]
  스마트스토어 판매자는 최대 3개의 옵션 항목을 설정할 수 있습니다.

조합형 옵션 상품의 재고관리

<①조합형 옵션 상품>이거나 <②표준형 옵션 상품 중 '옵션 재고 수량 관리 사용 여부(useStockManagement)'를 활성화(true)한 상품>은 '상품의 재고 수량'이 '각 옵션 조합별 재고 수량의 총 합'으로 자동 계산됩니다.
- 예: [색상: 빨강 - 3개] / [색상: 노랑 - 2개] / [색상: 파랑 - 5개] → 상품의 재고 총 합은 10개(3+2+5)

이러한 유형의 상품은 판매자가 상품 재고 수량(originProduct.stockQuantity)을 별도로 관리할 수 없으며, 옵션 조합별 재고 수량(...optionInfo.optionCombinations[n].stockQuantity)를 조합별로 개별 제어하여 관리가 가능합니다.
따라서 ①번, ②번에 해당하는 상품은 상품 수정 과정에서 originProduct.stockQuantity 필드를 제외하고 요청주실 경우 자동으로 처리됩니다.

조합형 옵션 제어

조합형 옵션은 기본적으로 각 옵션 단위별로 제어됩니다. (...optionInfo.optionCombinations[n] 단위)

• 특정한 옵션 조합에 대해서만 품절 처리가 필요한 경우 해당 옵션 조합의 stockQuantity를 0으로 설정해주시면 됩니다.
• 대상 상품 자체의 품절 처리가 필요할 경우 모든 옵션 조합의 stockQuantity를 0으로 설정해주셔야 합니다.

  [!NOTE]
  ...optionCombinations[n].usable 필드로 제어하는 '사용 여부'는 품절 상태와 무관합니다.
  '사용 여부'를 false 로 설정할 경우 해당 옵션 조합은 재고 유무와 관계없이 구매자에게 표시되지 않습니다.