상품 옵션 등록/수정

특정 상품의 옵션 등록/수정 시에 사용합니다. (승인 완료 이후 상품만 Partial API 사용 가능)

옵션 등록/수정 시에는 본 상품이 이미 등록되어 있어야 하며, 본 상품을 찾을 수 없는 경우 에러가 발생됩니다.

옵션의 TYPE 필드는 필수 값이며, 옵션 없는 상품일 경우 “NONE” TYPE 으로 전송하시면 됩니다.
옵션의 TYPE optionType 을 참고 해주시면 됩니다.

옵션 type은 크게 선택형과 구매자 작성형으로 구분됩니다.

• 선택형: 주문시 판매자가 미리 설정해 둔 옵션 리스트 중에서 구매자가 옵션값을 선택하도록 하는 옵션 형태로, 상품 옵션 설정시 다시 독립형(Simple)과 조합형(Combination)으로 구분해서 설정할 수 있습니다.
  선택형 중 조합형만 옵션별 재고수량을 설정할 수 있습니다.
• 구매자 작성형(Custom): 주문시 구매자가 주문하려는 옵션 내용을 직접 작성할 수 있는 옵션 형태 입니다.

조합형 옵션인 경우 옵션별 재고수량(Combinations.stockQuantity)을 입력해야 하며, 본상품 재고수량(OptionRequest.stockQuantity)은 빈 값으로 요청되어야 합니다.

조합형 옵션이 아닌 경우에는 본상품 재고수량(OptionRequest.stockQuantity)을 입력해 주세요.

옵션의 타입별로 정렬 기준을 선택할수 있으며, 독립형은 simpleSortType , 조합형은 combinationSortType (OptionSortType 타입) 의 값이 비어 있을 경우 default (등록순) 기준이 적용 됩니다.

요청

PUT /v1/gift/products/partial/option/update

<요청 파라미터 설명>

응답

수정이 실패한 경우, validation 에러 결과를 참고하시기 바랍니다.

<응답 바디>

 <응답 바디 샘플>

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8

옵션 수정 요청 json 샘플

< option json 샘플>

• 옵션 없는 상품으로 수정

{
  "option":{
    "type":"NONE"
  },
  "id": 10000
}

• 독립형 상품으로 수정

{
  "option":{
    "type":"SIMPLE",
    "simpleSortType":"CREATE",
    "simples":[
      {
        "name":"사이즈",
        "value":"M",
        "usable":true
      }
    ]
  },
  "id": 10000
}

• 조합형 상품으로 수정

{
  "option":{
    "type":"COMBINATION",
    "combinationSortType":"CREATE",
    "combinations":[
      {
        "id":10000,
        "name":[
          {
            "key":"사이즈",
            "value":"M"
          },
          {
            "key":"컬러",
            "value":"RED"
          }
        ],
        "usable":true,
        "price":2000,
        "stockQuantity":10,
        "managedCode":"판매자상품코드"
      }
    ]
  },
  "id": 10000
}

• 작성형 상품으로 수정

{
  "option":{
    "type":"CUSTOM",
    "customs":[
      {
        "name":"각인 문구",
        "description": "최대 10자까지 입력 가능합니다",
        "usable":true
      }
    ]
  },
  "id": 10000
}