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

[commerce-api-naver]

API 문서 v2.31.0 Release Notes

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

변경일: 2024년 5월 29일 (한국 표준시)

⚠ API 지원 중단 및 제거 주의 (Deprecation and Removal Warnings)

[상품] 지원 중단된 v1 API 제거: 2024년 6월 26일 예정

[상품] 그룹 내 지원이 중단된 v1 API를 완전히 제거할 예정입니다. 대상 API들은 현재 정상 호출을 지원하지 않는 API로 대체 제공된 v2 API를 이용해주시기 바랍니다.
(v2 API 확인: #337)

• 제거 대상 v1 API (지원 중단됨):
  • (v1) 상품 등록 (POST /v1/products)
  • (v1) 채널 상품 조회 (GET /v1/products/channel-products/{channelProductNo})
  • (v1) 채널 상품 수정 (PUT /v1/products/channel-products/{channelProductNo})
  • (v1) 채널 상품 삭제 (DELETE /v1/products/channel-products/{channelProductNo})
  • (v1) 원상품 조회 (GET /v1/products/origin-products/{originProductNo})
  • (v1) 원상품 수정 (PUT /v1/products/origin-products/{originProductNo})
  • (v1) 원상품 삭제 (DELETE /v1/products/origin-products/{originProductNo})
  • (v1) 반품 택배사 다건 조회 (GET /v1/product-delivery-info/return-delivery-companies)

[상품] 그룹

새 기능

1. [다수의 API] 아래 필드로 '판매자 창고 ID'를 새로이 제공합니다.

   영향받는 API	구분	필드
   상품 등록	요청	originProduct.deliveryInfo.outboundLocationId
   채널 상품 조회	응답	originProduct.deliveryInfo.outboundLocationId
   채널 상품 수정	요청	originProduct.deliveryInfo.outboundLocationId
   원상품 조회	응답	originProduct.deliveryInfo.outboundLocationId
   원상품 수정	요청	originProduct.deliveryInfo.outboundLocationId
   상품 벌크 업데이트	요청	deliveryInfo.outboundLocationId

[주문] 그룹

문서 변경

1. [상품 주문 상세 내역 조회] sellerBurdenImediateDiscountAmount 필드 설명 내용을 바로 잡았습니다.

---

Note

커머스API에서는 2025년 중 '[주문] 상품 주문 상세 내역 조회' API의 클레임 정보 구조 변경을 계획하고 있습니다.
자세한 내용은 v2.30.0 릴리즈 노트 내용을 참고해주시기 바랍니다.