카테고리/모델명/브랜드검색/판매자주소록 조회, 이미지 업로드 API 등을 통해
상품등록 API의 요청 데이터를 구성해야 합니다..
product option 파라미터에 들어가는 json object String 은 각 상품 옵션 유형별 샘플을 참고하세요.
요청
POST /v1/gift/products/register
<요청 파라미터 설명>
필드명 | 타입 | 필수여부 | 설명 |
detailBuyingType | DetailBuyingType |
매입 유형 - 아래의 값들 중 한 가지 선택필수 CONSIGNMENT (위탁수수료) BROKERAGE (중개수수료) DIRECT (직매입) * 승인이후 수정 불가능하므로 신중하게 선택해주세요. * 중개수수료 선택 시 카테고리 속성정보의 etc_types 속성 내 중개수수료 필수/선택 카테고리(주류, 가공식품 등)만 등록 가능합니다. * 중개수수료, 직매입 경우 담당MD협의 통해 별도 권한이 있어야 등록가능합니다. |
|
categoryId | String | 필수 | 카테고리ID 카카오쇼핑에서 제공하는 최하위(leaf) 카테고리ID 입력 |
categorySupplements |
List |
카테고리별 필수 | 카테고리 부가 정보 |
bundleQuantity | Integer | 선택 | 번들수량 (전통주) |
advertisement_reviews | List<AdvertisementReview> | 선택 | 광고심의서류 파일 uuid 배열 |
name | String | 필수 | 상품명 권장 글자수 공백포함 15자 이내 브랜드명 기재 불가 특수문자 사용 제한 |
image | ProductImageView | 필수 | 상품 이미지 정보 |
originArea | ProductOriginAreaView | 필수 | 원산지 정보 |
giftBrandId | Long | 필수 | 브랜드 ID |
model | ProductModelView | 선택 | 모델 |
manufacturer | String | 선택 |
제조사 (최대 100자까지 등록가능) |
sellerManagementCode | String | 선택 | 판매자 관리코드 |
salePeriod | SalePeriodView | 선택 | 판매 기간 |
booked | BookedView | 선택 | 예약 판매 설정 |
productAdditionalInfo | ProductAdditionalInfo | 선택 |
상품 부가정보 (선물포장 여부, 커스텀 제작상품 여부) |
suggestionName | String | 선택 | 선물제안명 |
taxType | TaxType | 필수 | 부가세 타입 |
salePrice | BigDecimal | 필수 | 판매가격 100원 이상 10원 단위로 입력 가능 최대 천만원 금액대 까지 입력 가능 |
discount | DiscountView | 선택 | 즉시할인 정보 |
detailDescription | String | 필수 |
상품상세 *이미지 삽입 시 alt 태그로 대체텍스트 입력 권장 |
announcementInfo | AnnouncementInfoView | 필수 | 상품 정보 고시 |
certs | List<CertView> | 선택 | 상품 인증 정보 |
minorPurchasable | boolean | 선택 | 미성년자 구매 가능 여부 true : 미성년자 구매가능 false : 미성년자 구매불가 |
purchaseQuantity | PurchaseQuantityView | 선택 | 구매수량 제한 |
option | OptionView | 선택 | 옵션 정보 |
stock | ProductStockView | 필수 | 재고 수량 |
delivery | DeliveryView | 필수 | 배송 정보 |
displayStatus | DisplayStatus | 선택 | 전시 여부 |
shoppingHowDisplayable | boolean | 선택 | 쇼핑하우전시여부 전시함으로 설정할 경우 다음 통합검색, 쇼핑검색, 카카오톡 내 검색 결과에서 해당 상품이 노출 true : 다음쇼핑 전시 false: 다음쇼핑 전시 안함 |
mdMessage | String | 선택 | MD전달사항 |
eventName | EventNameView | 선택 | 이벤트명 |
<광고심의서류 정보가 포함된 요청 예시>
{
...,
"advertisement_reviews": [{
"sellerFileUuid": "f592908c-9999-1000-0000-727712557596"
}, {
"sellerFileUuid": "d3145fe9-0188-1000-0000-02d7a90b7a9f"
}],
...
}
응답
상품 등록에 성공한 상품번호를 응답 합니다.
<응답 바디>
필드명 | 타입 | 설명 |
---|---|---|
id | Long | ID |
<응답 바디 샘플>
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"id": 10000
}