공지사항
공지사항

옵션별 가격 API 연동

Tags
가이드
Last edited time
2024/11/06 07:35

개요

기존에서는 상품가격(대표가)만 지원하고 있습니다. (상품 생성/수정 API의 price의 sellingPrice)
셀러 공지 이후 시점부터 상품 내 옵션가 설정이 가능합니다.

변경 사항

상품 생성/수정 API : PUT /seller/product-proposals
saveProductProposal (링크)
요청 Body(Request Body)
itemProposals.price : 기존 상품 옵션의 가격 필드는 삭제 예정
삭제 예정 사유 : 기존에 API 필드로 존재하였으나, 실제 시스템에 쓰고 있지 않았던 필드였이며 혼선을 방지하기 위하여 사용하지 않으며 삭제될 예정입니다.
하위호환성 유지를 지키고 있으므로 해당 필드를 계속 넣으시더라도 에러 발생하지 않습니다.
옵션가 지원하지 않는 연동사의 경우 해당 필드는 삭제해주시면 됩니다.
itemProposals.optionPrice : 옵션별 가격
옵션별 가격 기능을 쓰시지 않을 때는 해당 필드에 null 값으로 주시거나 해당 필드를 제외시켜주셔도 됩니다.
price(ProductPriceDto)의 sellingPrice 와 같거나 커야합니다.
예시) 기본가격 10000 + 옵션 추가금액이 3000 인 경우에는, optionPrice : 13000 으로 요청
카테고리별로 옵션별 가격 설정가 정책을 갖고 있으며 해당 범위를 벗어나는 변경인 케이스에는 에러가 발생할 수 있습니다. 기본 정책은 공지사항에 있는 정보를 참고 부탁드리며 카테고리별 옵션가 범위 정책 API 연동 이 필요하신 경우에는 아래 내용 참고부탁드립니다.
카테고리별 옵션 가격 범위 정책 조회 : GET /v2/option-price-policies/category
응답 예시 Json : 전체 카테고리 목록에 대한 정책을 조회할 수 있으며, maxPercentage100 이면 옵션별 가격 사용하지 않으며, 최소 100이상의 값으로 설정됩니다.
{ "list": [ { "categoryId": "0227e", "categoryTitle": "청바지/팬츠", "maxPercentage": 200 // 상품가에서 최대 200% 까지 설정 가능합니다. } ] }
JSON
복사