선물하기 상품을 수정 할 수 있습니다.
상품 수정 요청시, 변경 대상이 아닌 항목까지 포함하여 모든 상품정보 항목을 입력해서 전달해야 합니다. 누락시 해당 상품정보에 이전에 입력된 값은 삭제되며, 필수 입력 항목인 경우에는 Validation 오류가 납니다.
상품 수정 API 사용 중에는 요청 데이터 타입 항목의 각 수정 시 주의사항 을 숙지하신 후 사용을 하시기 바랍니다.
# 상품 수정 API 사용 시 주의사항
기존에 등록된 상품 수정 요청시에는 반드시 모든 필드를 입력해야 합니다.
변경을 원하지 않는 필드를 제외하고 요청하는 경우,
해당 필드는 현재 상태 유지가 아닌 기본 값으로 변경 될 수 있습니다.
각 필드의 현재 상태를 알 수 없다면 상품 조회 API를 사용해 전체 필드를 얻어 온 후,
해당 Object에서 변경을 원하는 필드만 수정해서 상품 수정 API의 요청으로 사용해주시기 바랍니다.
동일 동초에 수정 정보 전송 시 처리가 불가할 수 있습니다. 아래 메시지가 확인될 경우 순차적으로 호출해주셔야합니다.
- code: -30006,
- message: "상품 수정 이전 요청을 처리하고 있습니다.
요청
PUT /v1/gift/products/update
<요청 파라미터 설명>
요청 필드
필드명 | 타입 | 필수여부 | 설명 |
---|---|---|---|
id | Long | 필수 | 상품 ID |
categoryId | String | 필수 | 카테고리 ID 카카오쇼핑에서 제공하는 최하위(leaf) 카테고리 ID 입력 |
categorySupplements | List<ProductCategorySupplementView> | 카테고리별 필수 | 카테고리 부가 정보 |
bundleQuantity | Integer | 선택 | 번들수량 (전통주) |
advertisement_reviews | List<AdvertisementReview> | 선택 | 광고심의서류 파일 uuid 배열 |
name | String | 필수 | 상품명 권장 글자수 공백포함 15자 이내 브랜드명 기재 불가 특수문자 사용 제한 |
image | ProductImageView | 필수 | 상품 이미지 정보 |
originArea | ProductOriginAreaView | 필수 | 원산지 정보 |
giftBrandId | Long | 필수 | 브랜드 ID |
model | ProductModelView | 선택 | 모델 |
manufacturer | String | 선택 | 제조사 |
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 | 선택 | 옵션 정보 |
optionChangeable | boolean | 선택 | 주문 후 옵션 수정가능여부 *수정할때는 반드시 조회한 결과 그대로 포함하여 전송해야함 |
stock | ProductStockView | 필수 | 재고 수량 |
delivery | DeliveryView | 필수 | 배송 정보 |
displayStatus | DisplayStatus | 선택 | 전시 여부 |
shoppingHowDisplayable | boolean | 선택 | 쇼핑하우전시여부 전시함으로 설정할 경우 다음 통합검색, 쇼핑검색, 카카오톡 내 검색 결과에서 해당 상품이 노출 true : 다음쇼핑 전시 false: 다음쇼핑 전시 안함 |
mdMessage | String | 선택 | MD전달사항 |
eventName | EventNameView | 선택 | 이벤트명 |
<요청 내 광고심의서류 예시>
{
...,
"advertisement_reviews": [{
"sellerFileUuid": "string"
}, {
"sellerFileUuid": "string"
}],
...
}
응답
수정이 실패한 경우, validation 에러 결과를 참고하시기 바랍니다.
<응답 바디>
필드명 | 타입 | 설명 |
---|---|---|
- | - | - |
<응답 바디 샘플>
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8