선물하기 상품 API 데이터 타입

  • EventNameView plus icon minus icon
    • - 이벤트명은 20자 이내로 입력 가능합니다. - 설정한 이벤트명은 선물하기 상품 상세 > 상품명 상단에 노출됩니다. - 이벤트명에 생일선물 또는 생일 선물, 일부 특수문자 (<>, [ ],(), {}), 이모지는 입력 불가합니다.  - 이벤트명 설정 시, 상품 상세에만 노출되며 수신자에게는 노출되지 않습니다. - 이벤트명은 담당 MD와 사전 협의된 ... 더보기
  • Accessory plus icon minus icon
    • 옵션 추가정보는 독립형 또는 조합형 옵션에만 적용할 수 있습니다. (작성형 옵션인 경우 옵션 추가정보 설정 불가)   필드명 타입 설명 accessoryType String 옵션 추가정보 타입 타입 설명 COLOR 옵션 컬러 optionName String 대상 옵션명 optionValue S... 더보기
  • OriginArea plus icon minus icon
    • 원산지 데이터 타입 필드명 타입 필수여부 설명 originAreaType String 필수 원산지 타입 originAreaContent String 필수 원산지 명 originAreaCode String 필수 원산지 코드 level int 필수 원산지 depth   더보기
  • ProhibitionDetailView plus icon minus icon
    • - 해당 오픈 API 는 2023/8/8 부터 사용가능합니다.   - 상품의 판매상태 (SaleStatus) 가 판매금지 (PROHIBITION) 인 경우에만 판매금지 상세정보(ProhibitionDetailView)이 제공됩니다.  - 판매금지 사유 중 안전거래센터 판매금지 사유인 경우 위반사유/상세사유 확인 후 정상적으로 상품정보 수정 후 카카오톡... 더보기
  • AdvertisementReview plus icon minus icon
    •   선물하기 상품 등록/수정 시 카테고리 속성정보가 광고심의서류 필수/선택 카테고리인 경우 광고심의서류 파일 업로드가 가능합니다. 선물하기 상품 등록 시 광고심의서류 필수 카테고리인 경우 해당 카테고리 등록가능한 광고심의서류 종류(건강기능식품, 의료기기, 기타)에 맞는 서류를 등록하지 않으면 상품을 등록할 수 없습니다.  상품의 서류 등록 시 카카오 ... 더보기
  • FileUploadResponse plus icon minus icon
    • 서류파일 업로드 상세 필드 필드명 설명 result 성공여부 SUCCESS: 성공 FAILURE: 실패 data 업로드 된 서류파일의 정보  sellerFileUuid: 파일 식별자  originalFilename: 원본 파일 이름  mimeType: mime 타입  fileSize: 파일 사이즈 더보기
  • SellerFileView plus icon minus icon
    • 판매자 상품 서류파일 상세 필드   필드명 설명 sellerFileUuid 업로드 한 파일의 uuid originalFilename 원본 파일의 이름 더보기
  • 필드 제약사항 plus icon minus icon
    • # 판매가 - 판매가의 입력 단위는 10원 단위이며, 마이너스 및 소수점 금액은 허용하지 않습니다. - 최소 입력 가능 금액은 10원 이상, 최대 입력 가능 금액은 1억 미만입니다. - 즉시 할인이 설정 되어 있다면 즉시 할인 금액보다 커야 합니다.# 상품상세 - 이미지 태그 입력 시 alt 태그로 이미지를 설명하는 대체텍스트를 함께 입... 더보기
  • RejectionCode plus icon minus icon
    • 필드 타입 REQUIRE_PRODUCT_INFO 상품정보 보강필요 REQUIRE_REPRESENTATIVE_IMAGE_CHANGE 대표이미지 변경필요 REQUIRE_OPTIONAL_IMAGE_CHANGE 상세이미지 수정필요 DUPLICATED_PRODUCT_NAME 상품명 중복/변경필요 REQUIRE_CATEGORY... 더보기
  • ApproveStatus plus icon minus icon
    • 필드 타입 NEW_PRODUCT_REGISTERED 신규상품 등록 NEW_PRODUCT_UNDER_EXAMINATION 신규상품 심사중 NEW_PRODUCT_REJECTED 신규상품 반려 APPROVED 승인 EXISTING_PRODUCT_MODIFIED 기존상품 수정 MODIFIED_INFO_UNDER_EXA... 더보기
  • DisplayStatus plus icon minus icon
    • 필드 타입 OPEN 전시함 HIDDEN 전시안함 더보기
  • ProductStockView plus icon minus icon
    • 옵션 타입이 조합형 경우 재고수량은 옵션별로 입력 해주세요. 필드 타입 설명 unlimitedStockQuantity boolean 무제한재고 수량 사용하는 경우 true stockQuantity Integer 재고수량 (무제한재고수량 true 이면 null 이어야 합니다.) 더보기
  • PurchaseQuantityView plus icon minus icon
    • 필드 타입 설명 maxPurchaseQuantity Integer 1회 최대 구매 수량. 필드 제약사항 참고  최소 1개 이상, 최대 100개 이하로 입력 가능 maxPurchaseQuantityOfBuyer Integer 1인 최대 구매 수량. 필드 제약사항 참고 최소 1개 이상, 최대 5,000개 이하로 입력 가능  1회 최대 ... 더보기
  • BookedView plus icon minus icon
    • - 예약판매 설정 시 상품상세 페이지 내 예약상품 여부와 예상 출고일이 노출됩니다. - 예약판매상품의 예상 출고일은 설정시점 기준 다음날부터 최대 250일 이내로 설정가능합니다. - 예약판매가 필수적인 상품이 아닌 경우 카카오 커머스 운영정책에 따라 판매중단 처리 될 수 있습니다. - 예약상품에 설정된 예상 출고일자를 기준으로  예상 출고일 10일 이... 더보기
  • ProductAdditionalInfo plus icon minus icon
    • 필드 타입 설명 customOrder boolean 커스텀제작(주문제작) 상품인 경우 true giftPackaging boolean 선물포장 상품인 경우 true  giftPackagingDescription String 선물포장 설명 입력 더보기
  • SalePeriodView plus icon minus icon
    • 판매기간을 별도로 입력 하지 않으면 판매 종료일이 설정되지 않은 상태로 등록됩니다.특정 판매 기간을 설정하고 싶을 경우에 기간설정 여부와 상세 기간을 입력해주세요.판매 기간은 시간 단위로만 등록 가능 합니다. 필드 타입 설명 useSalePeriod Boolean 판매기간 설정 여부 salePeriod DateTime 판매기간  fr... 더보기
  • SaleStatus plus icon minus icon
    • 상품 판매상태를 나타냅니다.판매중 상태는 판매기간에 따라 판매대기, 판매중, 판매종료 3가지 상태로 노출 됩니다. 타입명 설명 WAIT 판매대기 설정한 판매 기간 이전의 상품 상태 ON_SALE 판매중  판매기간이 유효하고 재고수량이 1이상인 상태  상품 판매 정보 수정 API 를 이용하여 변경 가능합니다. CLOSE 판매종료 판매... 더보기
  • ProductCategorySupplementView plus icon minus icon
    • 상품 등록/수정 요청 및 상품 응답 정보에 포함 되는 상품 카테고리 부가정보 필드명 타입 설명 categoryType CategorySupplementType 부가정보 종류 supplement CategorySupplement 타입별 json 더보기
  • CategorySupplementType plus icon minus icon
    • 카테고리 부가정보 종류 (Enum) 타입명 구분 LIQUOR 전통주 DEDUCT_CULTURE 문화비 소득공제 선택형 더보기
  • CategorySupplement plus icon minus icon
    • 상품 등록/수정시 포함될 상품 부가정보이다. CategorySupplementType 에 따라 요청정보가 달라진다. 더보기
  • 전통주 (LIQUOR) plus icon minus icon
    • 전통주 관련 카테고리는 별도 상품 등록 권한이 필요합니다. (담당자 문의)상품을 구성하는 병의 수량을 반드시 정확하게 입력하셔야 합니다.예시) 1세트 3병 구성일 경우, 숫자 ‘3’ 입력 - 최소 1개 ~ 최대 100,000,000개 입력 가능 필드명 타입 설명 eachCount Integer 상품구매당 구성단위 병 수 더보기
  • 문화비 소득공제 선택형 (DEDUCT_CULTURE) plus icon minus icon
    • 필드명 타입 설명 useDeduction Boolean 소득공제 적용대상 유무 더보기
  • ProductImageView plus icon minus icon
    • 이미지 비율 코드는 대표이미지는 필수이며 추가 이미지는 선택사항 입니다.추가 이미지 항목이 빈 값으로 전달되면 추가 이미지는 그대로 빈 값으로 저장됩니다.대표 이미지의 형태는 Json 내부에 이미지 URL 값을 포함합니다. 주의사항 이미지 URL 은 반드시 이미지업로드 API 로 업로드 후 반환받은 URL 값을 입력하세요.대표 이미지 및 추가 이미지... 더보기
  • ProductOriginAreaView plus icon minus icon
    • 원산지 정보로는 원산지 종류 (국내산, 외국산, 원양산, 혼합/기타) 원산지 표시 내용 (원산지 타입이 혼합/기타인 경우 입력 필수)이 포함됩니다. 원산지 종류는 필수 입력 값이며, 나머지 필드 값은 빈 값이 전달될 경우 그대로 빈 값으로 저장됩니다. 복수 원산지 여부 true 일 경우 “기본원산지 등” 형태의 노출 정보로 활용됩니다. 상품의 카테고리... 더보기
  • OriginAreaType plus icon minus icon
    • 타입명 설명 LOCAL 국내산 IMPORT 외국산 OVERSEA 원양산 USER_INPUT 혼합/기타 더보기
  • ProductModelView plus icon minus icon
    • 모델명 조회 API로 확인된 id와 name을 입력하세요. 필드명 타입 설명 id String 모델ID name String 모델명 더보기
  • CertView plus icon minus icon
    • certType 필드는 필수 값이며, certCode, certResult 는 certType 에 따라 필수 / 선택이 달라질 수 있습니다.   주의사항 - CertCode 가 필수인 CertType 인데 CertCode 가 미입력 된 경우는 검증 에러를 리턴합니다. - CertCode 가 비필수인 CertType 에 CertCode 가 입력된 경우는... 더보기
  • DateTime plus icon minus icon
    • DateTime 으로 명시된 필드들에 대한 값 입력 형식을 나타냅니다. 타입명 설명 날짜포맷 yyyyMMddHHmmss 형식의 String 더보기
  • TaxType plus icon minus icon
    • 타입명 설명 TAX 과세 DUTYFREE 면세 SMALL 영세 더보기
  • DiscountView plus icon minus icon
    • 판매자 즉시할인을 적용하시려면 할인적용여부(useDiscount)를 ‘true’로 설정하시고, discount 값을 입력해 주세요. 즉시할인 적용시 할인적용여부, 할인기간 적용여부 설정, 할인 값이 필수 입력되어야 합니다. 할인 기간의 할인기간 적용여부는 설정 필수이며 시작일자와 종료일자를 31일 이내로 입력하시면 됩니다. 할인 종류에는 정액/정률 할... 더보기