ProductRequest

상품 등록, 수정시 product 패러미터의 데이터 타입입니다.

주의사항

1. 카테고리(categoryId)

: categoryId는 필수 입력 정보 입니다. 카테고리 조회 API로 응답받은 최하위 카테고리ID를 입력해 주세요.
사용일옵션=Y로 설정된 상품은 예약속성(여행/숙박/이용권/e쿠폰)이 아닌 다른 카테고리로 변경이 불가합니다. 

 

2. 모델명(modelId)

: 모델명 검색 API로 응답받은 modelId 입력시, 해당 modelid에 매핑된 브랜드, 모델명, 제조사가 상품 정보로 자동 저장됩니다. modelId를 입력하지 않는 경우, brand 및 manufacturer는 최대 50자까지 직접 입력이 가능합니다.

 

3. 공지사항(noticeId)

: 공지사항은 톡스토어 판매자센터 상품 수정 화면을 통해 별도로 미리 등록되어 있어야 합니다. 상품 등록시에는 기 등록된 공지사항 중 유효한 상태(전시대기/전시중 상태)의 공지사항 번호(noticeID)를 입력합니다.

 

4. 상품 재고(stockQuantity)

: 조합형 옵션을 등록하는 경우에는, 옵션별 재고를 입력하셔야 합니다. 상품 등록/수정 요청시 조합형 옵션인데 본상품 재고 필드가 포함된 경우 에러가 발생됩니다. 옵션 없는 단일 상품이거나, 조합형 옵션 이외의 옵션 타입만 설정하는 경우에는 본상품 재고 수량을 입력하셔야 합니다.

 

5. 쇼핑하우 노출여부(shoppingHowDisplayable)

: 상품의 다음 쇼핑하우 검색 노출 여부를 선택 설정합니다. 쇼핑하우 노출여부(shoppingHowDisplayable)가 ‘true’인 상품은 다음 통합검색, 쇼핑검색, 카카오톡 내 검색 결과에서 해당 상품이 노출됩니다.

 

6. 상품 인증 정보(Cert)

: 인증정보는 카테고리에 따라 필수 또는 선택 입력값입니다.

: 전기용품/어린이제품/방송통신기자재 관련 카테고리의 상품 등록 시, KC 인증유형 중 한 개 이상의 인증정보를 필수로 입력하셔야 합니다. (이경우 카테고리 목록 조회시, ‘certKc’가 ‘Required’로 확인됩니다.)

• KC 인증 유형: [생활용품] 안전인증, [생활용품] 안전확인, [생활용품] 어린이보호포장, [생활용품] 공급자적합성확인, [전기용품] 안전인증, [전기용품] 안전확인, [전기용품] 공급자적합성 확인, [어린이제품] 안전인증, [어린이제품] 안전확인, [어린이제품] 공급자적합성확인, [방송통신기자재] 적합성 평가
• KC인증정보 필수 카테고리이지만 해당 상품이 인증대상이 아닌 경우에는 CertType으로 ’해당없음(인증대상아님)(Not_applicable)’을 입력하면 됩니다.
• 상품 인증정보가 상세설명에 이미 기재된 경우에는 CertType으로 ’상품상세설명 참조(Detail_ref)’를 입력하면 됩니다.
• 기타 상세내용은 7.22 Cert 내용을 참고해주세요.

 

7. 쇼핑하기 노출여부(talkDisplayable)

: 상품의 카카오톡 쇼핑하기 전시여부를 선택 설정합니다.

-톡스토어 판매자센터>스토어 기본정보>연동관리에서 ‘쇼핑하기 전시’가 ’ON’으로 설정되어 있는 판매자의 상품 중 
'쇼핑하기 노출여부(talkDisplayable)'가'true'인 상품이면 카카오톡 쇼핑하기에 노출될 수 있습니다. 
단, 둘다 노출 설정이 되어 있더라도, 상품 이미지 품질 등 쇼핑하기에서 정한 요건을 충족하지 못하는 경우 쇼핑하기에 
상품이 노출되지 않습니다.

 

8. 소문내면 할인(shareDiscount)

 8-1)카카오톡 유저가 카카오톡을 통해 친구들에게 소문내기를 공유하면, 공유한 유저와 공유를 받은 유저가 모두 할인 혜택을 받을 수 있는 카카오톡 스토어의 할인기능입니다.

 8-2) 소문내면 할인 설정 후 할인기간이 시작된 이후부터 ‘할인 진행중’ 상태로 변경됩니다.

 8-3)소문내면 할인 1회 공유시 할인금액은 최소 10원 단위로 입력 가능합니다. 상품당 1인 최대 공유 횟수는 2회 이상 4회 이하로 설정 가능합니다.

 8-4)할인기간은 필수로 설정하셔야하고, 기간 제약사항은 없습니다.

 8-5)소문내면 할인은 할인상태와 무관하게 항상 할인정보 수정 및 삭제가 가능합니다.

 

9. 톡딜 할인(groupDiscount)

 9-1)톡딜 할인 설정 후 별도의 관리자 승인 과정 없이, 할인기간이 시작된 이후부터 ‘할인 진행중’ 상태로 변경됩니다.

 9-2)톡딜 할인 설정시, 톡딜 할인 기간 내에 아래 정보들의 동시 설정이 불가합니다.

-즉시할인 및 소문내면 할인

 9-3)톡딜 할인기간은 최대 14일 이내로만 설정 가능합니다.

 9-4)톡딜 할인이 시작된 이후, 아래의 예외 케이스를 제외하고는 모든 톡딜 할인정보 수정 및 삭제가 가능합니다. 부득이하게 수정이 필요한 경우에는 판매자가 톡스토어 고객센터로 수정요청을 하시면 됩니다.

-할인 진행중 상태에서 톡딜 정상 주문건이 존재하거나 쇼핑하기>톡딜탭에 전시 설정된 상품의 경우에는 발행수량만 
수정 가능합니다. (그외 수정/삭제 불가)

 9-5)구매가능 수량을 설정한 경우, 잔여수량이 남아 있을 때까지만 톡딜 주문이 가능합니다. 톡딜 주문 발생시 ‘구매가능 수량’이 자동으로 차감되며, ‘구매가능 수량’이 0개가 되면 할인 상태는 ‘소진중지’ 상태로 자동 변경됩니다.

 

10. 카테고리 부가정보 (categorySupplements)

 10-1)상품 카테고리별 부가 상품정보 데이터를 전송하는 필드 입니다. 일부 카테고리는 카테고리 부가 정보가 필수로 입력되어야 상품 등록/수정이 가능하며, 기타 상세한 내용은 7.47 CategorySupplement 내용을 참고해주세요.

 10-2)카테고리별 부가정보 예시

각 부가 정보 입력이 필요한 카테고리는 카테고리 API로 확인 가능합니다.

-전통주 상품: 상품당 구성 병 수량 (전통주 카테고리인 경우 상품을 구성하는 병 수를 필수로 입력해야 합니다.)

-박물관/미술관 티켓 상품: 문화비 소득공제 적용 여부 (박물관/미술관 입장권 상품은 문화비 소득공제 적용 여부를 
입력해야 합니다.)

-상품 리뷰 노출 선택형 상품: 상품 리뷰 노출 여부 (고객이 작성한 리뷰로 인하여 허위/과대광고 우려가 있는 식품 및 
유아동 카테고리의 경우 상품상세 내 고객이 작성한 리뷰내용 노출여부를 선택해야 합니다.)

-e쿠폰 상품: 쿠폰 유효기간, 발행처, 연락처, 사용처 입력 가능 (오픈 api로는 e쿠폰 정보가 포함되지 않아도 상품 
등록 및 수정이 가능합니다. 단, 오픈 api로 등록한 상품을 판매자센터 상품수정 화면을 통해 수정하는 경우에는 e쿠폰 
정보를 필수로 입력해야 합니다.)

-도서 상품: ISBN 코드 및 독립 출판물 여부 입력 가능 (오픈 api로는 도서 정보가 포함되지 않아도 상품 등록 및 
수정이 가능합니다. 단, 오픈 api로 등록한 상품을 판매자센터 상품수정 화면을 통해 수정하는 경우에는 도서 정보를 
필수로 입력해야 합니다.)

 

11. 미성년자 구매가능여부(minorPurchasable)

-카테고리 API 조회시 미성년자 구매가능여부(minorPurchasable)가 'required'가 아닌 경우, 상품의 미성년자 구매가능여부(minorPurchasable)는 반드시 “구매불가”로 설정되어야 합니다. (미성년자 구매불가 카테고리에 상품 등록/수정시 미성년자 ‘구매가능’으로 설정된 경우 상품 등록/수정이 실패됩니다.)

-미성년자 구매불가 상품은 소문내면 할인 설정이 불가합니다. (즉시할인 및 톡딜 할인은 설정 가능합니다.)

 

12. 판매자 포인트 적립 정보(productPoints)

상품 구매 / 리뷰 작성 리워드로 포인트 지급 설정을 할 수 있습니다. 구매/리뷰 포인트 모두 주문 시점 기준 상품에 설정된 포인트 지급 금액이 적용됩니다.

12-1)구매 포인트

- 주문수량 1개 당 포인트 적립금액을 정률 또는 정액으로 설정할 수 있습니다. 최종 적립금액은 아래의 계산식으로 계산됩니다.

  정액 설정시: 적립액X주문수량

  정률 설정시: (판매가-상품 즉시할인-소문내면 할인-톡딜할인)X적립율X주문수량  

                     *옵션가는 적립 대상 금액에서 제외.

- 구매 포인트는 주문 구매결정 시점에 지급되고(주문 완료 시점에 상품에 설정된 적립금액으로 최종 적립), 구매결정 후 반품 진행시 취소/환불 완료 시점에 적립 회수됩니다.

12-2)리뷰 포인트

- 리뷰 컨탠츠 1개 당 텍스트 / 포토 리뷰 적립금액을 정액으로만 설정할 수 있습니다. (주문수량 무관하게 리뷰 건당 설정된 적립액 지급)

- 상품 리뷰는 상품 당 최초 1회만 작성 가능하므로, 리뷰 포인트도 구매자-상품 당 1회만 지급됩니다.

- 리뷰 최초 등록시 이미지를 업로드 한 경우에만 포토 리뷰 포인트가 적립됩니다.

- 리뷰 최초 등록 시점에 포인트가 지급되고, 리뷰 삭제시 적립 회수됩니다.

 

13. 상품상세설명(productDetailDescription)

: 상품상세 이미지 대체 텍스트 입력을 권장합니다. 상품 등록/수정시, 상품상세설명(productDetailDescription) 이미지 삽입하는 경우 alt 태그로 대체 텍스트를 입력하시면 됩니다.

 

14. 추천리워드 설정여부(useAffiliate)

- 상품에 추천리워드를 설정하려면 추천리워드 설정여부(useAffiliate)를 'true'로 설정하시면 됩니다. 

- 기간을 설정하려면 기간설정 사용여부(useAffiliatePeriod)와 시작일자/종료일자를 입력하시면 됩니다.

- 배송방법이 이용권/e쿠폰, 미성년자 구매불가, 해외여행/국내여행 카테고리 상품은 설정할 수 없습니다.

-톡스토어 판매자센터>스토어 기본정보>연동관리에서 ‘추천리워드 설정’이 ’ON’으로 설정되어 있는 판매자의 상품 중 
'추천리워드 설정여부(useAffiliate)'가'true'인 상품이면 추천리워드 기능이 설정됩니다. 

필드 제약사항

# 판매가
  - 판매가의 입력 단위는 10원 단위이며, 마이너스 및 소수점 금액은 허용하지 않습니다.
  - 최소 입력 가능 금액은 10원 이상, 최대 입력 가능 금액은 1억 미만입니다.
  - 즉시 할인이 설정 되어 있다면 즉시 할인 금액보다 커야 합니다.

# Boolean 필드
  - 모든 Boolean 필드는 필수 입력을 원칙으로 하며, 빈 값은 허용하지 않습니다.

# 본 상품 재고수량
  - 본 상품의 재고 수량 최소 입력 수량은 1개 이상, 1억개 미만입니다.
  - 조합형 옵션이 있는 경우 조합형 옵션의 옵션 재고를 입력해야 하며 본 상품 재고는 입력 불가합니다.

# 1회 최소 구매 수량
  - 1회 최소 구매 수량 설정 시 최소 2개 이상 최대 1000개 이하로 설정 가능합니다.

# 1회 최대 구매 수량
  - 1회 최대 구매 수량 설정 시 최소 1개 이상 최대 1000개 이하로 설정 가능합니다.
  - 1회 최소 수량이 설정되어 있다면 1회 최소 수량보다 크거나 같아야 합니다.

# 1인 최대 구매 수량
  - 1인 최대 구매 수량 설정 시 최소 1개 이상 최대 1000개 이하로 설정 가능합니다.
  - 1회 최소 수량이 설정되어 있다면 1회 최소 수량보다 크거나 같아야 합니다.
  - 1회 최대 수량이 설정되어 있다면 1회 최대 수량보다 크거나 같아야 합니다.

# 문자열 길이제한 / 특수문자 제한
  - 상품명 : 상품명은 70자까지 입력 가능합니다. 일부 특수문자는 사용이 제한됩니다. 
    ( . , ( ) [ ] + - & / _ ' " % * ~ ! = | ˚ 만 허용)
  - 브랜드 / 모델명 / 제조사 : 각 명칭은 최대 50자까지 입력 가능합니다.
  - 원산지 표시 내용 : 원산지 표시 내용은 50자까지 입력 가능합니다.
  - 판매자 상품 코드 : 상품 코드는 30자까지 입력 가능합니다.
  - 사은품 : 사은품은 50자까지 입력 가능합니다.

# 예약판매 설정
  - 예약판매 설정 해제시(booked), 예상 출고일(bookedDate)을 입력할 수 없습니다.
  - 예상 출고일은 익일 이후 날짜부터 입력 가능합니다.
  - 설정시 전시에 예약상품 안내문구가 노출됩니다.

# 연관상품 설정
  - 연관상품 설정을 위해서는 판매자센터에서 연관상품그룹을 미리 등록하신 후, 연관상품번호 단위로 설정이 가능합니다.
  - 현재 보고있는 상품을 제외하고 판매중&전시중 상품이 최소 2개 이상 설정된 경우에 해당 영역이 정상 노출됩니다.

# 포인트 적립 금액 설정
  - 구매 포인트 : 최소 1원 이상, 최대 최종 상품 할인가의 10% 이하(도서 카테고리는 5% 이하)로 설정 가능합니다. 
(최대 10만원 이하로 설정 가능) 
  - 리뷰 포인트 : 최소 1원이상, 최대 최종 상품 할인가의 10% 이하로 설정 가능합니다. 
(최대 10만원 이하로 설정 가능)
포토 리뷰 포인트 금액은 텍스트 리뷰 포인트 금액 이상으로만 설정 가능합니다.
  - 업데이트 시 필드가 없는 경우 기존값으로 설정됩니다.

# 기간 설정
  - 상품 관련 기간 설정 시, 시작일과 종료일에는 아래의 허용된 분/초 외의 값은 00분 00초로 절삭 처리 됩니다.
  - 시작일은 00분 00초만 허용, 종료일은 00분 00초와 59분 59초만 허용. 
  - 대상 항목 : 판매기간, 즉시할인 기간, 톡딜할인 기간, 소문내면할인 기간 

# 상품이미지 / 상품상세설명 / 옵션이미지 / 옵션상세이미지
  - 외부 이미지의 경우, UTF-8 방식을 사용해서 인코딩된 URL만 허용합니다.

필드 상세