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

[commerce-api-naver]

API 문서 v2.34.0 Release Notes

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

변경일: 2024년 7월 24일 (한국 표준시)

[주문] 그룹

API 변경

1. "네이버페이 추가 클레임" 적용에 따라 교환 클레임¹⁾ 에 추가 반품/교환(재교환)을 요청하여 처리할 수 있게 됩니다.

   설명: 이에 따라 관련 API들의 행동이 달라집니다.

   • 아래 API는 추가적인 반품/교환(재교환) 클레임이 요청된 경우 해당 클레임을 처리할 수 있도록 변경됩니다.
     • 추가 반품 클레임: 반품 승인, 반품 봉류, 반품 보류 해제, 반품 거부(철회) API
     • 추가 교환 클레임: 교환 수거 완료, 교환 재배송 처리, 교환 보류, 교환 보류 해제, 교환 거부(철회) API
   • 아래 API는 추가적인 반품 요청이 가능하도록 변경됩니다.
     • 반품 요청 API

2. [상품 주문 상세 내역 조회] 추가 클레임 기능 대응이 가능한 신규 클레임 필드를 새로이 제공합니다.

   • data[n].currentClaim: 대상 주문건에 가장 최근에 요청된 클레임 정보
   • data[n].beforeClaim: 대상 주문건에 가장 처음에 요청된 클레임 정보

Note

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

3. [상품 주문 상세 내역 조회] 클레임 필드의 차일드 노드로 클레임ID 정보를 새로이 제공합니다.

   • 각 취소(cancel 필드) / 반품(return 필드) / 교환(exchange 필드) - 정보로서 요청된 클레임의 '클레임ID(claimId 필드)' 정보를 제공합니다.

---

^{1) 추가 클레임 요청은 대상 교환 클레임이 '교환재배송중' 상태일 때에만 가능합니다.}