반품관리API – Open APIs

반품/취소 요청 목록 조회 API에서 orderId를 사용하여 반품을 조회하려면 어떻게 해야 합니까?

반품/취소 요청 목록 쿼리 API에서 orderId를 사용하여 반품을 조회할 때 쿼리 매개변수인 createdAtFrom, createdAtTo, orderId 및 cancelType을 아래 샘플과 같이 설정하시기 바랍니다. https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vend... 더보기

반품/취소 요청 목록 API에서 상품준비 중 상태에서 취소 요청을 한 것과 배송지시 이후에 취소 요청을 한 주문의 구분을 어떻게 하나요?

상품준비중 상태에서 반품(취소)요청 된 건들은 반품/취소 요청 목록 조회 API로 조회 시 RU(출고중지요청) 상태로 조회가 가능합니다. UC(반품접수) 상태로 조회 시에는 상품준비중 상태 및 배송지시 상태 이후에 반품(취소) 요청된 건들 모두를 조회하실 수 있습니다. 즉 상품준비중 상태에서 요청된 반품 건들은 RU 상태와 UC 상태 모두에서 동일한 ... 더보기

출고중지 요청 건에 대해 이미출고 API로 처리하면 이후 과정은 어떻게 되나요?

판매자가 출고중지요청 건에 대해 이미출고 처리를 하면 반품접수로 상태가 변경되며 이후 반품회수, 반품 입고, 반품 승인 처리가 필요합니다. 이미출고 처리 시 왕복배송비를 판매자가 부담해야 합니다. 더보기

쿠팡에서 직권취소했거나, 선환불된 주문 정보를 조회할 수 있는 방법이 있나요?

직권취소되었거나, 선환불된 주문정보만을 따로 조회할 수 있는 방법은 없습니다. 다만, [반품/취소 요청 목록조회] API를 통해 각각의 취소 또는 반품된 주문의 직권취소여부, 선환불 여부를 확인할 수 있습니다. 이를 확인하는 방법은 조회된 json 데이터의 다음 속성값을 확인하는 것입니다. attribute type description... 더보기

반품/교환 등으로 발생한 추가배송비에 대한 정보를 따로 볼 수 있는 API가 있나요?

추가배송비는 API로 제공되지 않습니다. 반품의 경우, 상품에서 반품비 차감 후 환불되는 프로세스로 진행되고 있습니다. 교환의 경우, 동일 상품으로의 교환만 가능하므로 판매자 귀책인 상황에서 발생합니다. 따라서 별도의 교환배송비 확인 API는 존재하지 않으며, 고객 변심이 발생한 경우 반품 시 동봉 또는 계좌입금으로 안내되고 있습니다. 더보기

반품요청 목록조회로 일단위/분단위/단건조회 3종류가 있는데 어떤걸 사용해야 하나요?

기본적으로 3종류의 API의 기능은 같습니다. 단순히 조회 조건이 다르기에 편의에 따라 개발하시면 됩니다. 일단위 : 최대 31일까지 조회 가능 분단위 : 최대 24시간 이내 데이터 조회 가능 단건조회 : 취소(단품)접수번호 단위로 데이터 조회 가능 더보기

반품요청 목록조회 시, returnDeliveryType 값으로 노출되는 전담택배, 연동택배, 수기관리가 각각 무엇을 의미하나요?

returnDeliveryType으로 들어갈 수 있는 항목과 내용은 다음과 같습니다. <각 배송 분류> 연동 택배 : 파트너사(판매자)가 거래하는 배송 택배사 전담 택배 : 쿠팡과 거래하는 택배사 수기 관리 : 상담사가 고객 또는 택배사에 확인하여 수기로 반송장 번호로 입력하는 것 더보기

반품/교환 신청 시 쿠팡에서 자동 회수 연동을 예외처리 해주실 수는 없나요? (굿스플로;Goodsflow 예외 처리)

상품을 등록/수정할 때 반품지를 선택 메뉴에서 선택하지 않고 [직접입력] 버튼을 클릭 후 반품지를 직접 입력하면 자동회수 연동이 되지 않습니다.⠀※ 반품지 직접입력 경로판매관리시스템(WING) > 상품관리 > 상품등록 > 배송 및 반품 > [반품지 변경] 버튼 클릭 > [직접입력] 을 선택합니다. * 참고- 반품 주소지를 직접 입력했을 경우, ... 더보기

반품 취소/수정에 대한 고객 업데이트 내용을 따로 받아볼 수 없나요?

고객에 의해 수정/취소된 반품 건을 따로 모아 볼 수 있는 기능은 없습니다. 번거롭더라도 [반품 요청 목록 조회 API]와 [반품 철회 이력 조회 API]를 통해 수시로 조회해야 합니다. 단 반품의 경우 철회 시, 반품 철회 접수 ID를 확인할 수 없기에 (반품목록에서 사라짐) 따로 저장해두고 있어야 합니다. 더보기

반품상품 입고 확인처리를 하면 반품 status가 어떻게 변하나요?

시스템 상 환불 처리가 완료된 뒤, status가 반품 완료(CC)로 변경됩니다. 더보기

상품 준비중 상태에서 출고중지요청한 것과 출고 이후에 반품요청한 항목을 구분하여 조회하는 방법이 있을까요?

상품준비중 상태는 아직 배송지시(운송장번호 등록)을 하지 않았으므로 RU(출고중지요청)와 UC(반품접수) 두 가지 status에서 모두 조회 가능합니다. 출고 이후 고객 반품 시, 이미 상품이 배송지시되어 출고완료가 불가능하니 UC(반품접수)로만 조회 가능합니다. 따라서 출고 전(상품준비중), 출고 후(배송지시 이후)는 RU(출고중지요청) 조회 결과로... 더보기

반품요청 목록 조회에 enclosePrice(동봉배송비) 라는 항목이 있습니다. 사용하는 값인가요?

반품 비용 추가 발생 분으로 인해 박스 안에 동봉하는 배송비를 의미하며, 사용하지 않는 값입니다. 기본적으로 0으로 표시되며, 참고하지 말아 주시기 바랍니다. 더보기

반품요청 승인처리 API의 cancelCount는 어떤값이 들어가야하나요?

해당 반품 접수 건에 포함된 상품의 모든 개수를 기재해주시면 됩니다. ex) A상품 5개, B상품 2개 반품이라면 cancelCount는 7 입니다. 더보기

반품/교환 신청 시 쿠팡에서 자동 회수 연동을 해주는 조건을 알고 싶습니다. (굿스플로;Goodsflow)

반품지 생성 시, 굿스플로(Goodsflow)의 반품 자동 회수를 지원하는 6개 택배사 중 선택하여 등록하시고, 유효한 택배사 계약 코드를 입력해야 연동 조건이 성립됩니다. 더보기

반품요청 승인처리 API는 어떤 상황에서 사용하나요?

빠른 환불(선환불)조건에 해당하지 않는 상품의 반품이나 반품 회수가 완료되었는데 반품회수의 상태에 머물러 있는 경우에는 반품요청 승인 처리를 판매자가 해주시면 반품승인, 반품 완료로 진행됩니다. 더보기

receiptId(접수번호)는 어떻게 확인 가능한가요?

[반품요청 목록 조회 API] 를 통해 확인 가능합니다. 더보기

고객 반품/교환 요청건이 고객에 의해 수정 또는 철회될 수 있는 최대 기한이 있나요?

따로 정해진 기간은 없습니다. 다만, 택배기사가 고객으로부터 상품을 회수하고, 회수 송장 스캔을 한 시점부터는 고객 반품/교환 철회 및 수정이 불가능합니다. 그렇지만 고객센터를 통하면 회수 송장 스캔 등의 정책과 무관하게 철회 및 수정이 이뤄질 수 있습니다. 더보기

반품의 경우도 교환처럼 목록조회에서 취소된 내역을 확인할 수 있나요?

현재 반품의 경우 취소된 내역을 반품요청 목록조회에서 확인할 수 없습니다. 현 구조상, 반품이 취소되면 요청 목록에서 해당 항목이 삭제됩니다. 번거롭더라도 최초 반품 접수 시, 반품 접수 ID(receiptId)를 별도로 저장해두고, 반품철회 이력 조회 API를 통해 취소 여부를 확인해보는 것이 좋습니다. 더보기

회수송장 API는 어떤 상황에서 어떻게 사용하나요?

반품 자동연동 서비스를 사용하지 않고 자체적으로 반품을 회수하는 판매자의 경우, 반품/교환 접수 시 본 API를 통해 수동으로 회수 송장을 등록할 수 있습니다.계약한 택배사가 있어 반품자동연동 서비스를 이용하는 판매자의 경우 사용하실 필요가 없습니다.<교환/반품 상태별 사용 조건>- 반품 : 반품요청 목록조회 시 status가 반품접수(RETURNS_... 더보기

OPENAPI 관련 안내