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

연관 상품 그룹 등록 및 수정시 데이터 타입 연관상품 그룹 등록 - 연관상품 번호는 자동 채번됩니다.- 연관상품 그룹명은 중복되지 않게 입력해야 합니다. - 연관상품 그룹당 상품은 최소 2개에서 최대 15개까지 설정 가능합니다. - 스토어당 연관상품 그룹은 최대 50개까지만 등록할 수 있습니다. 연관상품 그룹 수정 - 본인 스토어에 기 등록된 ... 더보기

연관상품 그룹 개별 조회시 전달되는 등록된 상품정보 데이터타입 필드명 타입 필수여부 설명 id Long 필수 상품번호 imageUrl String 필수 이미지 주소 name String 필수 상품명 salePrice Long 필수 판매 가격 saleStatus String 필수 판매중/판매종료/품절/판매중지/삭제 등 상품 상... 더보기

연관상품 그룹 조회 시 응답 데이터 타입 - 연관상품 그룹 전체 목록 조회 : 스토어에 등록된 연관상품 그룹 전체 목록을 조회합니다. - 연관상품 그룹 개별 조회 : 특정 연관상품 그룹번호로 조회 시, 해당 연관상품 그룹에 등록된 상품번호를 포함한 상세 내역 조회가 가능 합니다. 필드 상세 필드명 타입 필수여부 설명 비고 id Long ... 더보기

필드명 타입 필수여부 설명 name String 필수 상품 등록/수정시 AnnounceInfo에 announcement 객체에 입력될 필드명 고지정보에 사용할 필드명 title String 필수 필드명 description String 필수 필드에대한 설명 type FormType 필수 입력 필드 코드 info Ann... 더보기

상품 가격을 업데이트 할 방식을 나타내는 Enum Type입니다. 타입명 설명 SET 지정 가격으로 설정 INCREASE 가격 인상 DECREASE 가격 인하 더보기

상품 가격을 업데이트할 단위 Enum Type 입니다. 타입명 설명 RATE 정률(%)로 업데이트 PRICE 정액(원)으로 업데이트 더보기

상품 등록, 수정시 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... 더보기