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

[commerce-api-naver]

API 문서 v2.30.0 Release Notes

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

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

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

[주문] '상품 주문 상세 내역 조회' API 내 클레임 정보 구조 변경: 2025년 중 예정

스마트스토어 주문건의 추가 클레임 기능 대응을 위해 대상 API의 클레임 정보 관련 JSON 계층 구조가 변경될 예정입니다.
지원 중단이 예정된 필드들은 2025년 중 API 응답 내용에서 제거될 예정으로 사전에 대응하는 것을 권장합니다.

• 대상 API: [주문] 상품 주문 상세 내역 조회 (POST /v1/pay-order/seller/product-orders/query)
  • 지원 중단 필드: data[n] 필드의 차일드 중 cancel, exchange, return 필드의 제거 예정 (2025년 중 예정)

대체 수단 제공

동 API의 응답 본문(Response body)으로 대체 필드를 제공할 예정입니다. (2024년 7월 중 예정)

제거 대상 필드 (2025년 중 예정)	대체 필드 (2024년 7월 중 제공 예정)
data[n].cancel	data[n].currentClaim.cancel
data[n].exchange	data[n].currentClaim.exchange (또는) data[n].beforeClaim.exchange
data[n].return	data[n].currentClaim.return

^{(위 내용은 당사 내부 사정에 따라 변동될 수 있습니다.)}

Note

대상 필드들의 제거는 2025년 중으로 예정하고 있습니다. (구체적인 일정은 차후 별도 공지)
일정 확정 이전까지 다음 릴리즈 노트에서는 대상 필드의 지원 중단 주의 노트를 v2.30.0 릴리즈 노트 링크로 대체합니다.

[상품] 그룹

문서 변경

1. [다수의 API] '배송 속성 타입 코드' 필드 설명에 사소한 오탈자를 정정하였습니다.
   • 대상 API:
     • 상품 등록 (POST /v2/products)
     • 채널 상품 조회 (GET /v2/products/channel-products/{channelProductNo})
     • 채널 상품 수정 (PUT /v2/products/channel-products/{channelProductNo})
     • 원상품 조회 (GET /v2/products/origin-products/{originProductNo})
     • 원상품 수정 (PUT /v2/products/origin-products/{originProductNo})
     • 원상품 수정 (PUT /v2/products/origin-products/{originProductNo})
     • 상품 벌크 업데이트 (PUT /v1/products/origin-products/bulk-update)