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

  • SpecialGiftDisplayStatus plus icon minus icon
    • 사은품 행사 전시 상태를 나타내는  값입니다.상태조건설명WAITperiod.from이 존재하고 now < period.from전시 대기OPENperiod.from 가 현재 시각 이후이고,period.to가 없거나 period.to 가 현재 시각 이전인 경우전시 중CLOSEDto가 존재하고 period.to 가 현재시각 이후인 경우전시종료 더보기
  • SpecialGiftResponse plus icon minus icon
    • 필드 타입 설명 specialGiftId Long 사은품 행사 아이디 title String 사은품 행사명 timePeriod TimePeriod 제공 기간 imageUrl String 이미지 condition String 증정 대상 조건 description String 사은품 행사 내용 displayStatu... 더보기
  • CustomOrderInfo plus icon minus icon
    • 타이틀은 최대 20자이며, 이모지, 일부 특수문자 입력 불가합니다. 입력 가능한 특수문자: . , + - & / _ ' " % * ~ ! = | :  커스텀 제작 배너 이미지 URL 은 반드시 imageType 을 BANNER 로 하여 이미지업로드 API 로 업로드 후 반환받은 URL 값을 입력하세요. 유의사항은 최대 200자 이내로 입력 가능합니... 더보기
  • GiftPackagingInfo plus icon minus icon
    • 선물포장 타이틀은 기존 productAdditionalInfo.giftPackagingDescription 필드와 동일한 데이터이며, 신규 구조에서 필드명만 변경되었습니다. 선물포장 타이틀은 최대 20자이며, 이모지, 일부 특수문자 입력 불가합니다. 입력 가능한 특수문자: . , + - & / _ ' " % * ~ ! = | :  선물포장 배너 이... 더보기
  • TimePeriod plus icon minus icon
    • 기간을 나타내는 데이터 타입 필드명 타입 필수여부 설명 from DateTime 필수 시작일시 to DateTime 필수 종료일시       더보기
  • OptionCustomValidationView plus icon minus icon
    • 작성형 옵션> 입력제한조건 필드의 설정 항목입니다.   필드명 타입 필수 여부 설명 maxLength Number 필수 최대 글자수 - 30자 이하로 입력 가능 allowedCharacter List[AllowedCharacter] 필수 허용 문자 - 아래의 값들 중 1개 이상 입력 필수 NUMBER (숫자) ALPHA_UPPER (... 더보기
  • NoticeDisplayStatus plus icon minus icon
    • 필드 설명 WAIT 전시대기 DISPLAYING 전시중 CLOSE 전시종료 더보기
  • NoticeView plus icon minus icon
    • 1. 판매자 공지사항 등록 시, contentType을 TEXT, IMAGE 중 한 가지를 필수로 선택해야 합니다. 2. 이미지 공지사항은 카카오 이미지 서버에 업로드된 이미지 url를 등록해 주세요.3. 판매자 공지사항의 landingUrl은 선물하기 for biz 이벤트 메이커 URL(https://event-giftbiz.kakao.com/~) ... 더보기
  • 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일 이내로만 설정 가능합니다. - 예약판매가 필수적인 상품이 아닐 경우 카카오 커머스 운영정책에 따라 판매중단 처리 될 수 있습니다. - 예약판매 설정된 경우 배송정보> 묶음배송 불가로 강제처리됩니다. - 예약... 더보기
  • ProductAdditionalInfo plus icon minus icon
    • 필드 타입 설명 customOrder (deprecated) boolean 커스텀제작(주문제작) 상품인 경우 true customOrderInfo CustomOrderInfo 커스텀제작(주문제작) 설정 정보 giftPackaging (deprecated) boolean 선물포장 상품인 경우 true  giftPackagin... 더보기
  • SalePeriodView plus icon minus icon
    • 판매기간을 별도로 입력 하지 않으면 판매 종료일이 설정되지 않은 상태로 등록됩니다.특정 판매 기간을 설정하고 싶을 경우에 기간설정 여부와 상세 기간을 입력해주세요.판매 기간은 시간 단위로만 등록 가능 합니다. 필드 타입 설명 useSalePeriod Boolean 판매기간 설정 여부 salePeriod TimePeriod 판매기간  fro... 더보기
  • 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 소득공제 적용대상 유무 더보기