배송 / 환불 APIs – Open APIs

발주서 목록 조회(일단위 페이징)

발주서 목록을 하루단위 페이징 형태로 조회합니다. 예)(2020-02-01 ~ 2020-02-03) 페이지당 row사이즈 조정은 maxPerPage 파라미터를 통해 가능하며 다음 페이지는 [nextToken]을 이용하여 얻을 수 있습니다. Path Parameter 일부 제외, 발주서 목록 조회(분 단위 전체)와 전반적으로 구성이 같습니다. ※ 결... 더보기

발주서 목록 조회 (분단위 전체)

발주서 목록을 24시간 이내의 분단위 구간으로 조회합니다. 예)(2017-02-01T00:01~2017-02-01T23:59) Path Parameter 일부 제외, 발주서 목록 조회(일 단위 전체)와 전반적으로 구성이 같습니다. 반품완료건은 발주서 목록에서 조회 불가하기에 '반품 /취소 요청 목록 조회' 또는 '발주서 단건 조회' API를 이용합니... 더보기

발주서 단건 조회(shipmentBoxId)

shipmentBoxId를 이용하여 발주서 단건을 조회하는 API입니다. 결제완료 상태에서 고객이 배송지를 변경할 수 있기 때문에 상품준비중 처리 이후에 꼭! 발주서 단건 조회를 통해 배송지 정보("receiver")가 변경되었는지 확인 및 업데이트를 해 주셔야 합니다. Path GET /v2/providers/openapi/apis/api/v4/v... 더보기

발주서 단건 조회 (orderId)

orderId를 이용하여 발주서 단건을 조회하는 API입니다. 결제완료 상태에서 고객이 배송지를 변경할 수 있기 때문에 상품준비중 처리 이후에 꼭! 발주서 단건 조회를 통해 배송지 정보("receiver")가 변경되었는지 확인 및 업데이트를 해 주셔야 합니다. Path GET /v2/providers/openapi/apis/api/v4/vendors... 더보기

배송상태 변경 히스토리 조회

특정 주문에 대한 배송상태 히스토리를 조회합니다. Path GET /v2/providers/openapi/apis/api/v4/vendors/{vendorId}/ordersheets/{shipmentBoxId}/history Example Endpoint https://api-gateway.coupang.com/v2/providers/openapi/a... 더보기

상품준비중 처리

주문상태를 "결제완료" 에서 "상품준비중"으로 변경합니다. 상태변경을 요청한 주문 중 취소 건이 있으면 Partial Error를 리턴합니다. ※ 전체 또는 부분 결제 취소를 통해 환불이 진행중인 주문이 포함되어 있다면 해당 주문에 대해서는 "배송상태를 변경할 수 없습니다. 주문내역을 확인해주세요."라는 메세지가 반환됩니다. 환불이 완료된 시점에 취... 더보기

송장업로드 처리

송장을 업로드하여 주문을 배송지시 상태로 변경합니다. 상품준비중 상태의 주문에 대해서만 송장업로드가 가능합니다. 분리배송이 필요한 경우, 송장 업로드 예시는 FAQ를 참고해주세요. 6개월 이내에 중복된 송장번호를 입력할 경우 송장중복에러가 발생할 수 있습니다. 올바르지 않은 운송장을 입력하여 정확한 배송흐름을 추적할 수 없거나 기한 내 운송장을 입... 더보기

송장업데이트 처리

잘못 등록한 운송장 내용을 변경합니다. 변경된 운송장의 배송상태는 배송지시(DEPARTURE)로 변경되며 이후 트래킹 정보 연동에 따라 변경될 수 있습니다. <주의!> 배송상태가 배송지시(DEPARTURE), 배송중(DELIVERING), 배송완료(FINAL_DELIVERY), 업체직송(NONE_TRACKING) 상태일 때만 운송장정보 변경이 가능... 더보기

출고중지완료 처리

고객이 주문을 취소처리 하여 반품요청목록 조회 시 상태가 출고중지요청(RELEASE_STOP_UNCHECKED) 이거나 반품접수미확인(RETURNS_UNCHECKED) 이면서 releaseStatus가 "N" 일 경우에 사용가능합니다. 아직 상품을 발송하지 않아, 고객 요청대로 상품을 출고하지 않았을 때 사용합니다. <주의!> 출고 중지 요청 상품... 더보기

이미출고 처리

고객이 주문을 취소처리 하여 반품요청목록 조회 시 취소진행 상태가 출고중지요청(RELEASE_STOP_UNCHECKED) 이거나 반품접수미확인(RETURNS_UNCHECKED) 이면서 releaseStatus가 "N" 일 경우에 사용가능합니다. 이미 판매자가 상품을 발송한 상태일 때 사용합니다. <주의!>고객의 출고중지요청에도 불구하고 상품을 출고... 더보기

주문 상품 취소 처리

[결제완료] 또는 [상품준비중] 상태에 있는 상품을 취소하기 위한 API 입니다. (나머지 상태에 적용 시 에러 발생) [결제완료] 상태에 있는 상품에 대해서는 즉시 취소로 작동하며, [상품준비중] 상태의 상품에 대해서는 출고중지를 시킵니다. ※ 주문 상품 취소 처리 API의 사용은 판매자 점수(주문이행)를 하락시키게 되므로, 재고와 가격 관리를... 더보기

장기미배송 배송완료 처리

송장 등록 후 1달이 경과하였으나, 배송추적 결과를 확인할 수 없는 내용에 대해 배송완료로 상태를 변경합니다. 정산된 주문에 대한 미배송으로 인해 고객 분쟁 발생 시 분쟁처리에 대한 비용은 판매자가 부담해야 하므로 정확한 확인이 필요합니다. 배송지시(DEPARTURE) 이후 30일이 지난 배송지시, 배송중 상태인 주문만 처리 가능합니다. Path PO... 더보기

OPENAPI 변경사항 안내