클레임 (취소/교환/반품)
조회용 클레임 유형. 값을 입력하지 않으면 모든 type에 대해 내려줍니다. type 값을 입력하지 않을 때는 status도 입력하지 않아야 합니다.
CANCELPossible values: 조회용 클레임 상태. 값을 입력하지 않으면 모든 status에 대해 내려줍니다. status 값을 입력하지 않을 때는 type도 입력하지 않아야 합니다.
REQUESTEDPossible values: 조회 시작일자 yyyy-MM-dd 형태 (기본값: 오늘)
2025-10-06조회 종료일자 yyyy-MM-dd 형태 (기본값: fromRequestDate의 7일 전)
2025-10-13클레임 요청 철회 조회 시작일자 yyyy-MM-dd 형태 (기본값: 7일 전, status가 REVOKED_REQUEST일 때 유효)
2025-10-06클레임 요청 철회 조회 종료일자 yyyy-MM-dd 형태 (기본값: 오늘, status가 REVOKED_REQUEST일 때 유효)
2025-10-13주문 번호 목록 (복수 조회, orderId와 함께 사용 가능)
123456,789012다음 페이지를 위한 커서 정보 (직전 호출에서 받은 nextToken을 그대로 넘겨 호출)
eyJpZCI6MTAwMX0=페이지 사이즈 (기본값: 20)
20Example: 20모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
주문 상품 ID
12345판매자 주문 취소 요청
배송비 부과 책임자
MERCHANTPossible values: 주문 취소 사유 (100자 이내)
재고 부족주문 취소 상세 사유 (250자 이내)
상품 재고가 일시적으로 부족하여 주문을 취소합니다.모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
클레임 ID
12345모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
클레임 ID
12345취소 요청 거절 요청
배송 회사
CJ대한통운Possible values: 송장번호. 직접전달일 때는 null로 보낼 수 있습니다.
1234567890모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
클레임 ID
12345모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
클레임 ID
12345교환 요청 거절 요청
교환 요청 거절 사유
상품 재고 부족으로 교환이 불가능합니다모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
클레임 ID
12345모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
클레임 ID
12345모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
클레임 ID
12345교환 반려 요청
교환 반려 사유
상품 훼손이 심하여 교환이 불가능합니다모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
클레임 ID
12345교환 재배송 요청
배송 회사
CJ대한통운Possible values: 송장번호
1234567890모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
클레임 ID
12345모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
클레임 ID
12345반품 요청 거절 요청
반품 요청 거절 사유
고객 단순 변심으로 반품이 불가능합니다모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
클레임 ID
12345모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
클레임 ID
12345반품 반려 요청
반품 반려 사유
상품 훼손이 심하여 반품이 불가능합니다모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
클레임 ID
12345모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
API 연동 중 문의사항이나 개선 제안이 있으신가요?
Last updated