톡스토어 상품 API 데이터 타입 – Kakao Shopping Open API

상품 등록, 수정시 product 패러미터의 데이터 타입입니다. 주의사항 1. 카테고리(categoryId) : categoryId는 필수 입력 정보 입니다. 카테고리 조회 API로 응답받은 최하위 카테고리ID를 입력해 주세요.사용일옵션=Y로 설정된 상품은 예약속성(여행/숙박/이용권/e쿠폰)이 아닌 다른 카테고리로 변경이 불가합니다. 2. 모... 더보기

필드 상세 필드명 타입 필수여부 설명 productId Long 필수 상품번호 wholeCategoryName String 필수 전체카테고리 명 storeId Long 필수 스토어아이디 storeName String 필수 스토어명 storeDomain String 필수 톡스토어 도메인 storeProfileImage St... 더보기

원산지 정보로는 원산지 종류(국내산, 수입산, 원양산, 혼합/기타), 원산지 상세 지역코드(ex: "0004750"), 원산지 표시 내용(원산지 타입이 혼합/기타인 경우 입력 필수)이 포함됩니다. 원산지 종류는 필수 입력 값이며, 나머지 필드 값은 빈 값이 전달될 경우 그대로 빈 값으로 저장됩니다. 복수 원산지 여부 true 일 경우 “원산지 등” 형... 더보기

타입명 설명 LOCAL 국내산 IMPORT 수입산 DEEP_SEA 원양산 USER_INPUT 혼합/기타 더보기

상품 이미지의 필드에는 대표 이미지, 추가 이미지, 기본 이미지 비율 코드가 포함됩니다. 이중 대표 이미지, 기본이미지 비율 코드는 필수이며 추가 이미지는 선택사항 입니다. 추가 이미지 항목이 빈 값으로 전달되면 추가 이미지는 그대로 빈 값으로 저장됩니다. 대표 이미지의 형태는 Json 내부에 이미지 URL 값을 포함합니다. 주의사항 이미지 URL... 더보기

옵션 이미지의 필드에는 대표 이미지, 추가 이미지가 포함됩니다. 이중 대표 이미지는 필수이며 추가 이미지는 선택사항 입니다. 추가 이미지 항목이 빈 값으로 전달되면 추가 이미지는 그대로 빈 값으로 저장됩니다. 대표 이미지의 형태는 Json 내부에 이미지 URL 값을 포함합니다. 주의사항 이미지 URL 은 반드시 이미지업로드 API 로 업로드 후 반... 더보기

이미지 노출시 비율을 나타냅니다. 타입명 설명 SQUARE 1:1 비율 VERTICAL_LONG_RECTANGLE 3:4 비율 더보기

이미지 유형을 나타냅니다. 타입명 설명 OPTION_REPRESENTATION 옵션 대표이미지 OPTION_DETAIL 옵션 상세이미지 더보기

ProductImage 타입의 주의사항을 참고하시기 바랍니다. 필드명 타입 필수여부 설명 url String 필수 대표 이미지 url 더보기

ProductImage 타입의 주의사항을 참고하시기 바랍니다. 필드명 타입 필수여부 설명 url String 필수 추가 이미지 url 더보기

요약 상품정보의 선택된 정보를 나타냅니다. announcementType 은 필수 항목이며, 여러 개를 선택할 수 없습니다. 상품 상세 설명 참조 항목이 있는 경우 아래 샘플을 참고하시기 바랍니다. 상품군별 상세 고시 정보는 상세 고시 정보 타입을 참고하여 Json 포맷으로 전송하시면 됩니다. 전체 상품상세설명 참조 시 샘플 { "announ... 더보기

announcement 항목의 하위 항목 중 “announcementType”, “ignoreAll” 은 필수 항목입니다. announcement 필드의 json 데이터는 5. (별첨) 상품정보고시 데이터 타입 및 하위 AnnouncementType 의 각 타입 설명 테이블을 참고하여 작성 하시길 바랍니다. 필드 제약사항 # 전체 상품상세설명 참조 (... 더보기

판매자 즉시할인을 적용하시려면 할인적용여부(useDiscount)를 ‘true’로 설정하시고, discount 값을 입력해 주세요. 즉시할인 적용시 할인적용여부, 할인종료, 할인 값은 필수 입력되어야 합니다. 할인 기간을 설정하시려면 할인 기간 적용여부 및 시작일자와 종료일자를 입력하시면 됩니다. 할인 종류에는 정액/정률 할인이 있으며, 정률 할인인 ... 더보기

배송방법, 묶음가능여부, 배송비 정책 정보 등을 설정할 수 있습니다.묶음가능여부는 동일한 장바구니에 단일 판매자의 상품이 여러 개 담기는 경우 배송비를 묶음 부과할 수 있는지에 따라 값을 선택 입력하면 됩니다.기본 배송비는 필수 입력 값이며, 무료인 경우 0을 입력해야 합니다. 배송비 유형이 조건부무료인 경우 무료 조건 금액은 필수 입력 값 입니다.참... 더보기

옵션관리 API에서 사용합니다. 옵션정보와 본상품 재고수량를 포함합니다. 키 타입 필수여부 설명 stockQuantity Integer 선택 본상품 재고 수량 option Option 필수 옵션 정보 Option 옵션의 type 필드는 필수 값이며, 옵션 없는 상품일 경우 “NONE” type 으로 전송하시면 됩니다. 독립형 ... 더보기

타입명 설명 TAX 과세 DUTYFREE 면세 SMALL 영세 더보기

타입명 설명 NEW 새상품 OLD 중고상품 STOCKED 재고상품 REFURBISH 리퍼상품 DISPLAY 전시상품 더보기

상품을 전시 영역 (플러스 친구 홈 등) 에 노출 여부를 설정하는 Enum 형태의 Type 입니다. 전시 여부는 상품의 판매 여부와는 별도의 속성이며, 전시 제어로만 사용 됩니다. 타입명 설명 OPEN 전시 HIDDEN 비전시 더보기

상품의 실제 판매 상태를 확인 할 수 있는 Enum 형태의 Type 입니다. 타입명 설명 WAIT 판매대기 ON_SALE 판매중 CLOSE 판매종료 OUT_OF_STOCK 품절 SUSPENSION 판매중지 PROHIBITION 판매금지 DELETED 삭제 더보기

DateTime 으로 명시된 필드들에 대한 값 입력 형식을 나타냅니다. 타입명 설명 날짜포맷 yyyyMMddHHmmss 형식의 String 더보기

Date 로 명시된 필드들에 대한 String 값 형식을 나타냅니다. 시/분/초의 default 는 00:00:00 으로 저장됩니다. 타입명 설명 날짜포맷 yyyyMMdd 형식의 String 더보기

상품 조회용 정렬 기준을 제공합니다. 타입명 설명 PRODUCT_ID 상품번호 기준 정렬 PRODUCT_NAME 상품명 기준 정렬 PRODUCT_PRICE 판매가 기준 정렬 STOCK_QUANTITY 재고수량 기준 정렬 ... 더보기

상품 판매상태를 나타냅니다. 판매중 상태는 판매기간에 따라 판매대기, 판매중, 판매종료 3가지 상태로 노출 됩니다. 타입명 설명 WAIT 판매대기 ON_SALE 판매중 CLOSE 판매종료 OUT_OF_STOCK 품절 SUSPENSION 판매중지 ... 더보기

필드명 타입 필수여부 설명 productId Long 필수 상품번호 imageUrl String 필수 대표이미지 URL storeManagementCode String 선택 판매자 상품코드 name String 필수 상품명 productSaleStatus SaleStatus 필수 상품판매상태 displayStatus Di... 더보기

인증정보는 카테고리에 따라 필수 또는 선택 입력값입니다. 전기용품/어린이제품/방송통신기자재 관련 카테고리의 상품 등록 시, KC 인증유형 중 한 개 이상의 인증정보를 필수로 입력하셔야 합니다. certType 필드는 필수값이며, certCode 는 certType 에 따라 필수 / 입력금지 여부가 정해집니다. 주의사항 - CertCode 가 필수인 C... 더보기

브랜드정보 타입 모델명 검색 API로 응답받은 modelId 입력시, 해당 modelId에 매핑된 브랜드, 모델명, 제조사가 상품 정보로 자동 저장됩니다. modelId를 입력하지 않는 경우, 브랜드명을 최대 50자까지 직접 입력이 가능합니다. 필드명 타입 필수여부 설명 brandId String 필수 브랜드 ID name Str... 더보기

제조사명 타입 모델명 검색 API로 응답받은 modelId 입력시, 해당 modelId에 매핑된 브랜드, 모델명, 제조사가 상품 정보로 자동 저장됩니다. modelId를 입력하지 않는 경우, 제조사명을 최대 50자까지 직접 입력이 가능합니다. 필드명 타입 필수여부 설명 manufacturerId String 필수 제조사 ID ... 더보기

모델정보 타입 모델명 검색 API로 응답받은 modelId 입력시, 해당 modelId에 매핑된 브랜드, 모델명, 제조사가 상품 정보로 자동 저장됩니다. modelId를 입력하지 않는 경우, 브랜드명 및 제조사명은 최대 50자까지 직접 입력이 가능합니다. 필드명 타입 필수여부 설명 modelId String 필수 모델 ID mo... 더보기

판매자 주소정보 타입 필드명 타입 필수여부 설명 addressId Long 필수 주소 ID name String 필수 배송지명 postNo Stri... 더보기

카테고리 데이터 타입 필드 제약사항 # supplementTypes - 상품 부가 정보를 입력해야 하는 특수 카테고리에 한해 부가 정보 타입을 구분해서 표기합니다. 부가 정보 타입이 표기된 카테고리에 상품 등록/수정시 반드시 상품 정보에 각 부가 정보가 포함되어야 합니다. 필드 상세 필드명 타입 필수여부 설명 id Stri... 더보기