안녕하세요, 쿠팡입니다.
개발자 포털 및 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 |
변경사항 안내:
모든 변경 사항은 아래와 같습니다.
- 다국어 지원: 24개 API 문서(대만 판매자용), FAQ, 가이드, 사용 방법 등을 포함하여 중국어 번체가 지원됩니다.
-
국제화: 이 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
-
모든 판매자가 입점 위치와 관계없이 개발자 포털을 사용하게 됩니다.
- 개발자 포털에서 로그인 창이 사라지며, 개발자 포털 로그인 필요 없이, 윙을 통한 문의가 가능합니다.
- 문의: 판매자는 Wing을 통해 문의 요청을 제출해야 합니다. 경로: 'Support/'Wing에서 온라인 문의 시작' 클릭 → Wing에 로그인(아니면 로그인) → 'OpenAPI'를 클릭하여 요청 제출
감사합니다.