개발자 포털 변경 및 24 API 국제화 관련 안내 (2025년 6월 26일)

안녕하세요, 쿠팡입니다. 

개발자 포털 및 24 API 국제화 작업으로 인한 통화, 날짜/시간, 전화번호 등의 형식 변경 사항에 대한 업데이트를 안내드립니다.

이전 버전의 API 엔드포인트는 여전히 유효하며 응답은 이전과 동일합니다. 새 버전의 API 엔드포인트는 7월 25일 이후 이전 버전과 병행하여 실행될 예정입니다. 쿠팡은 이전 버전의 API도 계속 지원할 계획 입니다.

- 적용일: 2025년 7월 25일 
- 대상 API: 전체 API 목록은 아래와 같습니다. 

API	URL
반품 / 취소 요청 목록 조회	/v2/providers/openapi/apis/api/v6/vendors/{vendorId}/returnRequests
반품상품 입고 확인처리	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnRequests/{receiptId}/receiveConfirmation
반품요청 단건 조회	/v2/providers/openapi/apis/api/v6/vendors/{vendorId}/returnRequests/{receiptId}
반품요청 승인 처리	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnRequests/{receiptId}/approval
반품지 단건 조회	/v2/providers/openapi/apis/api/v3/return/shipping-places/center-code
반품지 목록 조회	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters
반품지 생성	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters
반품지 수정	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/returnShippingCenters/{returnCenterCode}
발주서 단건 조회(orderId)	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/{orderId}/ordersheets
발주서 단건 조회(shipmentBoxId)	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets/{shipmentBoxId}
발주서 목록 조회(분단위 전체)	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets
발주서 목록 조회(일단위 페이징)	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets
배송상태 변경 히스토리 조회	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets/{shipmentBoxId}/history
상품별 고객문의 답변	/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/onlineInquiries/{inquiryId}/replies
상품별 고객문의 조회	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/onlineInquiries
상품준비중 처리	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets/acknowledgement
주문 상품 취소 처리	/v2/providers/openapi/apis/api/v6/vendors/{vendorId}/orders/{orderId}/cancel
출고지 생성	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/outboundShippingCenters
출고지 수정	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/outboundShippingCenters/{outboundShippingPlaceCode}
출고지 조회	/v2/providers/marketplace_openapi/apis/api/v2/vendor/shipping-place/outbound
쿠팡 고객센터 문의 단건 조회	/v2/providers/openapi/apis/api/v5/vendors/callCenterInquiries/{inquiryId}
쿠팡 고객센터 문의답변	/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/callCenterInquiries/{inquiryId}/replies
쿠팡 고객센터 문의조회	/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/callCenterInquiries
쿠팡 고객센터 문의확인	/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/callCenterInquiries/{inquiryId}/confirms

 

변경사항 안내:

모든 변경 사항은 아래와 같습니다. 

1. 다국어 지원: 24개 API 문서(대만 판매자용), FAQ, 가이드, 사용 방법 등을 포함하여 중국어 번체가 지원됩니다.
2. 국제화: 이 24개 API의 통화, 날짜/시간, 전화번호 형식을 국제 표준에 맞게 업그레이드하여 새 버전을 출시합니다. 이러한 API의 요청 및 응답은 최신 형식을 따릅니다. 
   - 통화: {"currencyCode":"KRW", "units":1000, "nanos": 0}와 같은 JSON을 사용하여 통화를 표현합니다. currencyCode는 ISO-4217을 따릅니다. https://en.wikipedia.org/wiki/ISO_4217 
   - 날짜/시간: ISO-8601을 따릅니다. https://en.wikipedia.org/wiki/ISO_8601 
   - 전화번호: E.164 표준을 따릅니다. https://en.wikipedia.org/wiki/E.164

3. 모든 판매자가 입점 위치와 관계없이 개발자 포털을 사용하게 됩니다.
   - 개발자 포털에서 로그인 창이 사라지며, 개발자 포털 로그인 필요 없이, 윙을 통한 문의가 가능합니다.
   - 문의: 판매자는 Wing을 통해 문의 요청을 제출해야 합니다. 경로: 'Support/'Wing에서 온라인 문의 시작' 클릭 → Wing에 로그인(아니면 로그인) → 'OpenAPI'를 클릭하여 요청 제출 

감사합니다.