커머스API 문서 릴리즈 노트 (v2.0.0)

[commerce-api-naver]

API 문서 v2.0.0 Release Notes

커머스API 문서: https://apicenter.commerce.naver.com/ko/basic/commerce-api

변경일: 2022년 12월 21일 중

[상품] 그룹

새 기능

1. 상품정보제공고시 개정안 대응을 위해 아래 API를 새로이 제공합니다.

   • 적용 API (7개):

     • 상품 등록(v2): POST /v2/products
     • 채널 상품 조회(v2): GET /v2/products/channel-products/{channelProductNo}
     • 채널 상품 수정(v2): PUT /v2/products/channel-products/{channelProductNo}
     • 채널 상품 삭제(v2): DELETE /v2/products/channel-products/{channelProductNo}
     • 원상품 조회(v2): GET /v2/products/origin-products/{originProductNo}
     • 원상품 수정(v2): PUT /v2/products/origin-products/{originProductNo}
     • 원상품 삭제(v2): DELETE /v2/products/origin-products/{originProductNo}

   • 변경사항(상품정보제공고시 외):

     • 필드 제거: originProduct.productLogistics.logisticsCenterId

   • 상품정보제공고시 관련 변경사항:

     • 공통
       • 필드 제거: releaseDateType, packDateType, expirationDateType
         설명: 날짜 입력 방식(캘린더 또는 직접 입력)을 정의하는 필드를 제거하였습니다.
       • 설명 변경: certificationType(KC 인증 필 여부 → KC 인증정보)
     • 가구(furniture)
       • 필드 추가: refurb
     • 영상가전(imageAppliances)
       • 필드 추가: additionalCost
       • 설명 변경: size
     • 가정용 전기제품(homeAppliances)
       • 필드 추가: additionalCost
       • 설명 변경: size
     • 화장품(cosmetic)
       • 필드 추가: customizedDistributor
       • 설명 변경: capacity, distributor, certificationType, caution
     • 식품(food)
       • 지원 중단 예정(Deprecated): expirationDate, expirationDateText
       • 필드 추가: consumptionDate, consumptionDateText
       • 설명 변경: packDate, packDateText
     • 가공식품(generalFood)
       • 지원 중단 예정(Deprecated): expirationDate, expirationDateText
       • 필드 추가: consumptionDate, consumptionDateText
     • 건강기능식품(dietFood)
       • 지원 중단 예정(Deprecated): expirationDate, expirationDateText
       • 필드 추가: consumptionDate, consumptionDateText
       • 필드 제거: foodType, packDate, packDateText
     • 어린이제품요약정보(kids)
       • 필드 추가: numberLimit
       • 설명 변경: recommendedAge
     • 스포츠용품(sportsEquipment)
       • 필드 추가: certificationType
     • 서적(books)
       • 설명 변경: publishDate, publishDateText
     • 살생물제품(biocidal)
       • 필드 추가: expirationDate, expirationDateText
       • 설명 변경: productName
     • 휴대폰(cellPhone): 신규 유형 추가

2. "반품 택배사 다건 조회 API"(v2)를 새로이 제공합니다.

   적용 API: GET /v2/product-delivery-info/return-delivery-companies

API 제거

1. 상품정보제공고시 개정안 대응을 위해 아래 API를 제거합니다.

   • 상품 등록(v1): POST /v1/products
     • 대체 API: "상품 등록 API"(v2)
   • 채널 상품 조회(v1): GET /v1/products/channel-products/{channelProductNo}
     • 대체 API: "채널 상품 조회 API"(v2)
   • 채널 상품 수정(v1): PUT /v1/products/channel-products/{channelProductNo}
     • 대체 API: "채널 상품 수정 API"(v2)
   • 채널 상품 삭제(v1): DELETE /v1/products/channel-products/{channelProductNo}
     • 대체 API: "채널 상품 삭제 API"(v2)
   • 원상품 조회(v1): GET /v1/products/origin-products/{originProductNo}
     • 대체 API: "원상품 조회 API"(v2)
   • 원상품 수정(v1): PUT /v1/products/origin-products/{originProductNo}
     • 대체 API: "원상품 수정 API"(v2)
   • 원상품 삭제(v1): DELETE /v1/products/origin-products/{originProductNo}
     • 대체 API: "원상품 삭제 API"(v2)

2. "반품 택배사 다건 조회 API"(v1)를 제거합니다.

   • 대체 API: "반품 택배사 다건 조회 API"(v2)

[문의] 그룹

새 기능

1. "고객 문의 조회 API"의 반환 메시지로 '최근 문의 답변 ID' 필드를 새로이 제공합니다.

   대상 필드: content[n].answerContentId

해결된 문제점

1. "고객 문의 조회 API"에서 '문의 검색 종료일' 날짜가 조회 범위에 포함되지 않았던 문제를 수정하였습니다.

API 변경

1. "고객 문의 답변 조회 API"의 이름을 "고객 문의 조회 API"로 변경합니다.

[주문] 그룹

새 기능

1. "변경 상품 주문 내역 조회 API"의 '최종 변경 구분'으로 배송 희망일 변경 코드를 새로이 제공합니다.

   대상 필드: (요청 메시지)lastChangedType, (반환 메시지)data.lastChangeStatuses[n].lastChangedType
   신규 필드 코드 값: HOPE_DELIVERY_INFO_CHANGED

   설명: 희망일 배송 설정 주문건의 배송 희망일이 변경된 경우 "변경 상품 주문 내역 조회 API"로 해당 사실을 알려줍니다.