coupang
GET/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/exchangeRequests2609170000

교환요청 목록조회

KRTW
# 01

요약

교환요청 목록조회

# 02

상세

API 적용 가능한 구매자 사용자 지역: 한국 대만

교환 접수일자로 최대 7일 이내의 교환 내역을 확인할 수 있습니다.
각 교환 건에 대한 접수사유(reasonCode)는 아래 자료를 다운받아 확인해주세요.

Download 교환/반품/취소 VOC 사유 코드

경로

GET/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/exchangeRequests

예시 엔드포인트

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/exchangeRequests?createdAtFrom=2018-03-05T00:00:00&createdAtTo=2018-03-10T23:59:59&status=PROGRESS

URL API Name

GET_EXCHANGE_REQUEST
# 03

Path 파라미터

NameTypeDescription
vendorId*string
판매자 ID
쿠팡에서 업체에게 발급한 고유 코드. WING 로그인 후 확인 가능
예) A00012345
# 04

Query 파라미터

NameTypeDescription
createdAtFrom*string
검색 시작일 (yyyy-MM-ddTHH: mm: ss)
예) 2016-03-15T13:00:00
createdAtTo*string
검색 종료일 (yyyy-MM-ddTHH: mm: ss)
예) 2016-03-16T13:00:00
statusstring
교환진행상태
구체적인 교환 상태를 선택하지 않을시 모든 상태로 반환됩니다.
Name Status
RECEIPT 접수
PROGRESS 진행
SUCCESS 완료
REJECT 불가
CANCEL 철회
orderIdnumber
주문번호
예) 19000009511537
nextTokenstring
다음 페이지 조회를 위한 토큰값
첫번째 페이지 조회 시에는 필요하지 않습니다.
maxPerPagenumber
최대 조회 요청 값
기본값 : 10
# 05

응답 본문

응답 메시지

NameTypeDescription
codeinteger
server response status code
messagestring
detail info
dataobject[]
결과
exchangeId
data[].exchangeId
integer
교환 ID
orderId
data[].orderId
integer
주문번호
vendorId
data[].vendorId
string
판매자 ID
orderDeliveryStatusCode
data[].orderDeliveryStatusCode
string
주문 배송 상태
Name Status
ACCEPT 결재완료
INSTRUCT 상품준비중
DEPARTURE 배송지시
DELIVERING 배송중
FINAL_DELIVERY 배송완료
NONE_TRACKING 업체 직접 배송(배송 연동 미적용), 추적불가
exchangeStatus
data[].exchangeStatus
string
교환 상태
Name Status
RECEIPT 접수
PROGRESS 진행
SUCCESS 완료
REJECT 불가
CANCEL 철회
referType
data[].referType
string
접수경로
Name Status
VENDOR 벤더
CS_CENTER CS
WEB_PC 웹 PC
WEB_MOBILE 웹 모바일
faultType
data[].faultType
string
귀책
Name Status
COUPANG 쿠팡과실
VENDOR 업체과실
CUSTOMER 고객과실
WMS 물류과실
GENERAL 일반
exchangeAmount
data[].exchangeAmount
integer
교환배송비
reason
data[].reason
string
null *더 이상 사용하지 않는 항목입니다.
reasonCode
data[].reasonCode
string
교환사유코드
해당 페이지 상단에서 VOC 사유코드를 다운받아 확인해주세요.
reasonCodeText
data[].reasonCodeText
string
교환사유설명
reasonEtcDetail
data[].reasonEtcDetail
string
교환사유상세설명
cancelReason
data[].cancelReason
string
교환철회사유
createdByType
data[].createdByType
string
최초 등록자 유형
Name Status
CUSTOMER 고객
COUNSELOR 상담사
COUPANG 내부직원
VENDOR 업체
ETC 기타
createdAt
data[].createdAt
string
등록일시
(yyyy-MM-ddTHH: mm: ss)
modifiedByType
data[].modifiedByType
string
수정자
Name Status
CUSTOMER 고객
COUNSELOR 상담사
COUPANG 내부직원
VENDOR 업체
ETC 기타
TRACKING 배송추적
modifiedAt
data[].modifiedAt
string
수정 일시
(yyyy-MM-ddTHH: mm: ss)
exchangeItemDtoV1s
data[].exchangeItemDtoV1s
object[]
교환 항목 목록
exchangeItemId
data[].exchangeItemDtoV1s[].exchangeItemId
integer
교환 상품 아이디
교환 데이터 저장 시 사용하는 내부ID
orderItemId
data[].exchangeItemDtoV1s[].orderItemId
integer
원주문 아이템 ID
orderItemUnitPrice
data[].exchangeItemDtoV1s[].orderItemUnitPrice
integer
원주문 아이템 단가
orderItemName
data[].exchangeItemDtoV1s[].orderItemName
string
원주문 아이템 명
orderPackageId
data[].exchangeItemDtoV1s[].orderPackageId
number
원주문 패키지 ID
orderPackageName
data[].exchangeItemDtoV1s[].orderPackageName
string
원주문 패키지 명
targetItemId
data[].exchangeItemDtoV1s[].targetItemId
integer
교환 아이템 ID
targetItemUnitPrice
data[].exchangeItemDtoV1s[].targetItemUnitPrice
integer
교환 아이템 단가
targetItemName
data[].exchangeItemDtoV1s[].targetItemName
string
교환 아이템 명
targetPackageId
data[].exchangeItemDtoV1s[].targetPackageId
integer
교환 패키지 ID
targetPackageName
data[].exchangeItemDtoV1s[].targetPackageName
string
교환 패키지 명
quantity
data[].exchangeItemDtoV1s[].quantity
integer
교환수량
orderItemDeliveryComplete
data[].exchangeItemDtoV1s[].orderItemDeliveryComplete
boolean
True/False
원주문 아이템 배송완료 여부
orderItemReturnComplete
data[].exchangeItemDtoV1s[].orderItemReturnComplete
boolean
True/False
원주문 아이템 반품완료 여부
targetItemDeliveryComplete
data[].exchangeItemDtoV1s[].targetItemDeliveryComplete
boolean
True/False
교환 아이템 배송완료 여부
createdAt
data[].exchangeItemDtoV1s[].createdAt
string
생성 일시
(yyyy-MM-ddTHH: mm: ss)
modifiedAt
data[].exchangeItemDtoV1s[].modifiedAt
string
수정 일시
(yyyy-MM-ddTHH: mm: ss)
originalShipmentBoxId
data[].exchangeItemDtoV1s[].originalShipmentBoxId
integer
원배송번호
exchangeAddressDtoV1
data[].exchangeAddressDtoV1
object
교환 주소
exchangeAddressId
data[].exchangeAddressDtoV1.exchangeAddressId
integer
교환 주소 아이디
returnCustomerName
data[].exchangeAddressDtoV1.returnCustomerName
string
반품 신청인 이름
returnAddressZipCode
data[].exchangeAddressDtoV1.returnAddressZipCode
string
반품지 우편번호
returnAddress
data[].exchangeAddressDtoV1.returnAddress
string
반품 신청인 주소
returnAddressDetail
data[].exchangeAddressDtoV1.returnAddressDetail
string
상세한 반품주소
returnPhone
data[].exchangeAddressDtoV1.returnPhone
string
반품 신청인 전화번호
returnMobile
data[].exchangeAddressDtoV1.returnMobile
string
반품 신청인 모바일
returnMemo
data[].exchangeAddressDtoV1.returnMemo
string
반품 메모
deliveryCustomerName
data[].exchangeAddressDtoV1.deliveryCustomerName
string
수취인 이름
deliveryAddressZipCode
data[].exchangeAddressDtoV1.deliveryAddressZipCode
string
우편번호
deliveryAddress
data[].exchangeAddressDtoV1.deliveryAddress
string
수취인 주소
deliveryAddressDetail
data[].exchangeAddressDtoV1.deliveryAddressDetail
string
상세한 주소
deliveryPhone
data[].exchangeAddressDtoV1.deliveryPhone
string
수취인 폰
deliveryMobile
data[].exchangeAddressDtoV1.deliveryMobile
string
수취인 모바일 (안심번호)
deliveryMemo
data[].exchangeAddressDtoV1.deliveryMemo
string
배송 메모
createdAt
data[].exchangeAddressDtoV1.createdAt
string
생성 일시
(yyyy-MM-ddTHH: mm: ss)
modifiedAt
data[].exchangeAddressDtoV1.modifiedAt
string
수정 일시
(yyyy-MM-ddTHH: mm: ss)
exchangeId
data[].exchangeAddressDtoV1.exchangeId
integer
교환 ID
deliveryInvoiceGroupDtos
data[].deliveryInvoiceGroupDtos
object[]
Delivery Invoice informations
shipmentBoxId
data[].deliveryInvoiceGroupDtos[].shipmentBoxId
number
배송번호
boxPrice
data[].deliveryInvoiceGroupDtos[].boxPrice
number
Box price
orderId
data[].deliveryInvoiceGroupDtos[].orderId
number
주문번호
orderType
data[].deliveryInvoiceGroupDtos[].orderType
string
주문 유형
customerType
data[].deliveryInvoiceGroupDtos[].customerType
string
사용자 유형
bundleType
data[].deliveryInvoiceGroupDtos[].bundleType
string
배송 묶음 유형
extraMessage
data[].deliveryInvoiceGroupDtos[].extraMessage
string
메모
shippingDeliveryType
data[].deliveryInvoiceGroupDtos[].shippingDeliveryType
string
배송 타입
Name Status
DELIVERY 일반배송
EXCHANGE_DELIVERY 교환배송
FORCED_DELIVERY 추가출고배송
deliveryInvoiceDtos
data[].deliveryInvoiceGroupDtos[].deliveryInvoiceDtos
object[]
Delivery Invoice informations
invoiceNumber
data[].deliveryInvoiceGroupDtos[].deliveryInvoiceDtos[].invoiceNumber
string
운송장 번호
estimatedDeliveryDate
data[].deliveryInvoiceGroupDtos[].deliveryInvoiceDtos[].estimatedDeliveryDate
string
주문에서 실제 출고까지 리드타임
(yyyy-MM-ddTHH: mm: ss)
deliveredDate
data[].deliveryInvoiceGroupDtos[].deliveryInvoiceDtos[].deliveredDate
string
배송일
(yyyy-MM-ddTHH: mm: ss)
statusModifiedAt
data[].deliveryInvoiceGroupDtos[].deliveryInvoiceDtos[].statusModifiedAt
string
상태 수정 일시
(yyyy-MM-ddTHH: mm: ss)
invoiceNumberUploadDate
data[].deliveryInvoiceGroupDtos[].deliveryInvoiceDtos[].invoiceNumberUploadDate
string
운송장 번호 업로드 일시
(yyyy-MM-ddTHH: mm: ss)
statusCode
data[].deliveryInvoiceGroupDtos[].deliveryInvoiceDtos[].statusCode
string
발주서 상태
Name Status
ACCEPT 결재완료
INSTRUCT 상품준비중
DEPARTURE 배송지시
DELIVERING 배송중
FINAL_DELIVERY 배송완료
NONE_TRACKING 업체 직접 배송(배송 연동 미적용), 추적불가
deliverCode
data[].deliveryInvoiceGroupDtos[].deliveryInvoiceDtos[].deliverCode
string
isMainShipmentInvoice
data[].deliveryInvoiceGroupDtos[].deliveryInvoiceDtos[].isMainShipmentInvoice
boolean
Retail 분리배송 시 대표 송장 여부
parcelType
data[].deliveryInvoiceGroupDtos[].deliveryInvoiceDtos[].parcelType
string
Retail 배송 타입
invoiceVendorItemDtos
data[].deliveryInvoiceGroupDtos[].deliveryInvoiceDtos[].invoiceVendorItemDtos
object[]
vendor item information
vendorItemId
data[].deliveryInvoiceGroupDtos[].deliveryInvoiceDtos[].invoiceVendorItemDtos[].vendorItemId
number
옵션아이디
quantity
data[].deliveryInvoiceGroupDtos[].deliveryInvoiceDtos[].invoiceVendorItemDtos[].quantity
number
수량
hasAdditionalItem
data[].deliveryInvoiceGroupDtos[].deliveryInvoiceDtos[].invoiceVendorItemDtos[].hasAdditionalItem
boolean
일부 여부
promiseDeliveryDate
data[].deliveryInvoiceGroupDtos[].deliveryInvoiceDtos[].invoiceVendorItemDtos[].promiseDeliveryDate
string
주문시점의 상품별 배송 예정일
(yyyy-MM-ddTHH: mm: ss)
estimatedShippingDate
data[].deliveryInvoiceGroupDtos[].deliveryInvoiceDtos[].invoiceVendorItemDtos[].estimatedShippingDate
string
주문시 출고예정일
(yyyy-MM-ddTHH: mm: ss)
deliveryStatus
data[].deliveryStatus
string
재배송상태
Name Status
BeforeDirection 배송연동 전
CompleteDirection 배송연동
Delivering 배송중
CompleteDelivery 배송완료
DirectionFail 배송연동실패
VendorDirect 업체직송
Fail 배송실패
Withdraw 교환배송철회
NoneData 정보없음
collectStatus
data[].collectStatus
string
회수상태
Name Status
BeforeDirection 회수연동 전
CompleteDirection 회수연동
Delivering 회수중
CompleteCollect 업체전달완료
DirectionFail 회수연동실패
Fail 회수실패
Withdraw 교환회수철회
NoCollect 회수 불필요
NoneData 정보없음
collectCompleteDate
data[].collectCompleteDate
string
입고완료일시
(yyyy-MM-ddTHH: mm: ss)
collectInformationsDto
data[].collectInformationsDto
object
회수정보
returnType
data[].collectInformationsDto.returnType
string
반품유형: 반품 혹은 교환(RETURN or EXCHANGE_RETURN)
expectedReturnDate
data[].collectInformationsDto.expectedReturnDate
string
반품예정일시
(yyyy-MM-ddTHH: mm: ss)
returndeliveryItemDtos
data[].collectInformationsDto.returndeliveryItemDtos
object[]
returndeliveryItemDtos
vendorItemId
data[].collectInformationsDto.returndeliveryItemDtos[].vendorItemId
integer
옵션아이디
statusCode
data[].collectInformationsDto.returndeliveryItemDtos[].statusCode
string
상태코드
Name Status
RETURN_SEND_READY 접수
RETURN_SEND_COMPLETE 전송완료
RETURN_COLLECT_OK 정상반품완료
RETURN_COLLECT_NOT_OK 비정상반품완료(수량불일치 등)
CHANGE_SEND_READY 교환확정
CHANGE_SEND_HOLD 교환확정홀드(교환확정에서 철회될 경우 변경되는 코드)
CHANGE_SEND_COMPLETE 교환정보 전송완료
CHANGE_SEND_FAIL 교환재고없음(미발송)
COLLECT_FAIL 회수실패
returnCount
data[].collectInformationsDto.returndeliveryItemDtos[].returnCount
number
반품수량
releaseStatus
data[].collectInformationsDto.returndeliveryItemDtos[].releaseStatus
string
출고상태
Name Status
RELEASED 이미출고
NOT_RELEASED 미출고
paymentReturnDeliveryMapId
data[].collectInformationsDto.returndeliveryItemDtos[].paymentReturnDeliveryMapId
integer
paymentReturnDeliveryMapId
paymentItemId
data[].collectInformationsDto.returndeliveryItemDtos[].paymentItemId
integer
paymentItemId
modifiedBy
data[].collectInformationsDto.returndeliveryItemDtos[].modifiedBy
string
변경자
modifiedAt
data[].collectInformationsDto.returndeliveryItemDtos[].modifiedAt
string
최종상태 변경일시
(yyyy-MM-ddTHH: mm: ss)
createdBy
data[].collectInformationsDto.returndeliveryItemDtos[].createdBy
string
접수자
createdAt
data[].collectInformationsDto.returndeliveryItemDtos[].createdAt
string
접수일시
(yyyy-MM-ddTHH: mm: ss)
count
data[].collectInformationsDto.returndeliveryItemDtos[].count
integer
수량
confirmType
data[].collectInformationsDto.returndeliveryItemDtos[].confirmType
string
confirmType
Name Status
RELEASED 이미 출고
STOPPED 출고중지 완료
collectStatus
data[].collectInformationsDto.returndeliveryItemDtos[].collectStatus
string
회수상태
Name Status
NONE 값 없음
RETURN 회수진행
NO_RETURN 회수안함
ALREADY_RETURN 이미회수
CANCEL_REQUEST_WHEN_DEPARTURE 출고시 철회요청
returndeliveryDestinationDto
data[].collectInformationsDto.returndeliveryDestinationDto
object
대표회수지 정보
vendorZipCode
data[].collectInformationsDto.returndeliveryDestinationDto.vendorZipCode
string
판매자우편번호
vendorPhone
data[].collectInformationsDto.returndeliveryDestinationDto.vendorPhone
string
판매자전화번호
vendorName
data[].collectInformationsDto.returndeliveryDestinationDto.vendorName
string
판매자 이름
vendorMobile
data[].collectInformationsDto.returndeliveryDestinationDto.vendorMobile
string
판매자 휴대전화번호
vendorAddressDetail
data[].collectInformationsDto.returndeliveryDestinationDto.vendorAddressDetail
string
상세한 판매자주소지
vendorAddress
data[].collectInformationsDto.returndeliveryDestinationDto.vendorAddress
string
판매자주소
safetyNumberStatus
data[].collectInformationsDto.returndeliveryDestinationDto.safetyNumberStatus
string
안심번호 상태
Name Status
WAIT 대기
ENABLE 사용가능
DEPOSE 폐기
DISABLE 사용불가
ERROR 오류
RESERVE 보류
safetyNumberId
data[].collectInformationsDto.returndeliveryDestinationDto.safetyNumberId
integer
안심번호Id
safetyNumber
data[].collectInformationsDto.returndeliveryDestinationDto.safetyNumber
string
안심번호
returnDeliveryId
data[].collectInformationsDto.returndeliveryDestinationDto.returnDeliveryId
number
회수송장번호
returnCenterCode
data[].collectInformationsDto.returndeliveryDestinationDto.returnCenterCode
string
반품지센터코드
receiptId
data[].collectInformationsDto.returndeliveryDestinationDto.receiptId
number
접수번호
orderedByMobile
data[].collectInformationsDto.returndeliveryDestinationDto.orderedByMobile
string
주문자 전화번호
orderId
data[].collectInformationsDto.returndeliveryDestinationDto.orderId
integer
주문번호
message
data[].collectInformationsDto.returndeliveryDestinationDto.message
string
메세지
customerZipCode
data[].collectInformationsDto.returndeliveryDestinationDto.customerZipCode
string
고객우편번호
customerPhone
data[].collectInformationsDto.returndeliveryDestinationDto.customerPhone
string
고객전화번호 (안심번호)
customerName
data[].collectInformationsDto.returndeliveryDestinationDto.customerName
string
고객명
customerMobile
data[].collectInformationsDto.returndeliveryDestinationDto.customerMobile
string
고객핸드폰번호 (안심번호)
customerAddressDetail
data[].collectInformationsDto.returndeliveryDestinationDto.customerAddressDetail
string
상세한 고객주소지
customerAddress
data[].collectInformationsDto.returndeliveryDestinationDto.customerAddress
string
고객 주소
returnDeliveryDtos
data[].returnDeliveryDtos
object[]
회수정보
deliveryCompanyCode
data[].returnDeliveryDtos[].deliveryCompanyCode
string
택배사 코드
deliveryInvoiceNo
data[].returnDeliveryDtos[].deliveryInvoiceNo
string
회수 운송장 번호
successable
data[].successable
boolean
True/False
교환 완료 처리 가능여부
orderDeliveryStatusLabel
data[].orderDeliveryStatusLabel
string
주문 배송 상태 라벨
exchangeStatusLabel
data[].exchangeStatusLabel
string
교환 상태 라벨
referTypeLabel
data[].referTypeLabel
string
접수 경로 라벨
faultTypeLabel
data[].faultTypeLabel
string
귀책 (배송비 부담 주체) 라벨
createdByTypeLabel
data[].createdByTypeLabel
string
최초 등록자 타입 라벨
rejectable
data[].rejectable
boolean
True/False
교환 불가처리 가능여부
modifiedByTypeLabel
data[].modifiedByTypeLabel
string
수정자 라벨
deliveryInvoiceModifiable
data[].deliveryInvoiceModifiable
boolean
True/False
송장번호입력 가능여부
nextTokenstring
다음 페이지 조회를 위한 토큰값

Response Example

{
  "code": 200,
  "message": "OK",
  "data": [
    {
      "exchangeId": 101268974,
      "orderId": 11000013144262,
      "vendorId": "A001234567",
      "orderDeliveryStatusCode": "FINAL_DELIVERY",
      "exchangeStatus": "PROGRESS",
      "referType": "WEB_MOBILE",
      "faultType": "VENDOR",
      "exchangeAmount": 0,
      "reason": null,
      "reasonCode": "DIFFERENTOPT",
      "reasonCodeText": "색상/ 사이즈가 기대와 다름",
      "reasonEtcDetail": "베이지색 주문했는데 브라운이 왔습니다",
      "cancelReason": null,
      "createdByType": "CUSTOMER",
      "createdAt": "2018-03-05T10:54:41",
      "modifiedByType": "TRACKING",
      "modifiedAt": "2018-03-05T10:54:41",
      "exchangeItemDtoV1s": [
        {
          "exchangeItemId": 1765111,
          "orderItemId": 3476137875,
          "orderItemUnitPrice": 35900,
          "orderItemName": null,
          "orderPackageId": null,
          "orderPackageName": null,
          "targetItemId": 3476137875,
          "targetItemUnitPrice": 35900,
          "targetItemName": "후아유(WHO.A.U) 벙커Ⅰ 레터 백팩 / WHAK82104C, (35)Beige, FREE",
          "targetPackageId": -1,
          "targetPackageName": "",
          "quantity": 1,
          "orderItemDeliveryComplete": null,
          "orderItemReturnComplete": null,
          "targetItemDeliveryComplete": null,
          "createdAt": "2018-03-05T10:54:41",
          "modifiedAt": "2018-03-05T10:54:41",
          "originalShipmentBoxId": 123456789012345680
        }
      ],
      "exchangeAddressDtoV1": {
        "exchangeAddressId": 1691712,
        "returnCustomerName": "이***",
        "returnAddressZipCode": "431-0*",
        "returnAddress": "경기도 안양시 동안구 평촌동",
        "returnAddressDetail": "꿈마을건영아파트 *",
        "returnPhone": null,
        "returnMobile": "010-****-****",
        "returnMemo": null,
        "deliveryCustomerName": "이인용",
        "deliveryAddressZipCode": "431-0*",
        "deliveryAddress": "경기도 안양시 동안구 평촌동",
        "deliveryAddressDetail": "꿈마을건영아파트 *",
        "deliveryPhone": null,
        "deliveryMobile": "050382470825",
        "deliveryMemo": null,
        "createdAt": "2018-03-05T10:54:41",
        "modifiedAt": "2018-03-05T10:54:41",
        "exchangeId": 101268974
      },
      "deliveryInvoiceGroupDtos": [],
      "deliveryStatus": "BeforeDirection",
      "collectStatus": "Collecting",
      "collectCompleteDate": null,
      "collectInformationsDto": {
        "returnType": "EXCHANGE_RETURN",
        "expectedReturnDate": "2018-03-08T10:54:41",
        "returndeliveryItemDtos": [
          {
            "vendorItemId": 3476137875,
            "statusCode": "RETURN_SEND_READY",
            "returnCount": null,
            "releaseStatus": "RELEASED",
            "paymentReturnDeliveryMapId": 29713264,
            "paymentItemId": 1,
            "modifiedBy": "104132490",
            "moodifiedAt": "2018-03-05T10:54:41",
            "createdBy": "104132490",
            "createdAt": "2018-03-05T10:54:41",
            "count": 1,
            "confirmType": null,
            "collectStatus": "RETURN"
          }
        ],
        "returndeliveryDestinationDto": {
          "vendorZipCode": "312-14",
          "vendorPhone": "1899-6500",
          "vendorName": "(주)*몰)",
          "vendorMobile": "",
          "vendorAddressDetail": "** 물류센터 지하1층",
          "vendorAddress": "충청남도 천안시 동남구 풍세면 * ()",
          "safetyNumberStatus": "DISABLE",
          "safetyNumberId": 245668944,
          "safetyNumber": "050382470825",
          "returnDeliveryId": null,
          "returnCenterCode": "1000276167",
          "receiptId": null,
          "orderedByMobile": null,
          "orderId": 11000013144262,
          "message": null,
          "customerZipCode": "14101",
          "customerPhone": "05029870825",
          "customerName": "이**",
          "customerMobile": "010*",
          "customerAddressDetail": "꿈마을건영아파트 *",
          "customerAddress": "경기도 안양시 동안구 평촌동"
        }
      },
      "returnDeliveryDtos": [
        {
          "deliveryCompanyCode": "CJGLS",
          "deliveryInvoiceNo": ""
        }
      ],
      "orderDeliveryStatusLabel": "FINAL_DELIVERY",
      "exchangeStatusLabel": "PROGRESS",
      "referTypeLabel": "WEB_MOBILE",
      "faultTypeLabel": "VENDOR",
      "createdByTypeLabel": "CUSTOMER",
      "rejectable": false,
      "modifiedByTypeLabel": "CUSTOMER",
      "deliveryInvoiceModifiable": false,
      "successable": false
    },
    {
      "exchangeId": 101284720,
      "orderId": 3000013258427,
      "vendorId": "A00127960",
      "orderDeliveryStatusCode": "FINAL_DELIVERY",
      "exchangeStatus": "PROGRESS",
      "referType": "WEB_MOBILE",
      "faultType": "VENDOR",
      "exchangeAmount": 0,
      "reason": null,
      "reasonCode": "COMPOMISS",
      "reasonCodeText": "상품의 구성품, 부속품이 제대로 들어있지 않음",
      "reasonEtcDetail": "배송되지 않았어요 확인해주세요",
      "cancelReason": null,
      "createdByType": "CUSTOMER",
      "createdAt": "2018-03-08T16:42:11",
      "modifiedByType": "TRACKING",
      "modifiedAt": "2018-03-08T16:42:11",
      "exchangeItemDtoV1s": [
        {
          "exchangeItemId": 1784732,
          "orderItemId": 3288964806,
          "orderItemUnitPrice": 4900,
          "orderItemName": null,
          "orderPackageId": null,
          "orderPackageName": null,
          "targetItemId": 3288964806,
          "targetItemUnitPrice": 4900,
          "targetItemName": "펠릭스키즈 펠릭스 시그니쳐 맨투맨 FXMS178N3, 30 YELLOW, 100호",
          "targetPackageId": -1,
          "targetPackageName": "",
          "quantity": 1,
          "orderItemDeliveryComplete": null,
          "orderItemReturnComplete": null,
          "targetItemDeliveryComplete": null,
          "createdAt": "2018-03-08T16:42:11",
          "modifiedAt": "2018-03-08T16:42:11",
          "originalShipmentBoxId": 123456789012345680
        },
        {
          "exchangeItemId": 1784733,
          "orderItemId": 3288975565,
          "orderItemUnitPrice": 4900,
          "orderItemName": null,
          "orderPackageId": null,
          "orderPackageName": null,
          "targetItemId": 3288975565,
          "targetItemUnitPrice": 4900,
          "targetItemName": "펠릭스키즈 펠릭스 시그니쳐 맨투맨 FXMS178N3, 30 YELLOW, 120호",
          "targetPackageId": -1,
          "targetPackageName": "",
          "quantity": 1,
          "orderItemDeliveryComplete": null,
          "orderItemReturnComplete": null,
          "targetItemDeliveryComplete": null,
          "createdAt": "2018-03-08T16:42:11",
          "modifiedAt": "2018-03-08T16:42:11",
          "originalShipmentBoxId": 123456789012345680
        }
      ],
      "exchangeAddressDtoV1": {
        "exchangeAddressId": 1707458,
        "returnCustomerName": "김혜은",
        "returnAddressZipCode": "18488",
        "returnAddress": "경기도 화성시 동탄면 동탄대로9길 20",
        "returnAddressDetail": "Lh26단지 *",
        "returnPhone": null,
        "returnMobile": "010-****-****",
        "returnMemo": null,
        "deliveryCustomerName": "김**",
        "deliveryAddressZipCode": "18488",
        "deliveryAddress": "경기도 화성시 동탄면 동탄대로9길 20",
        "deliveryAddressDetail": "Lh26단지 *",
        "deliveryPhone": null,
        "deliveryMobile": "050382470825",
        "deliveryMemo": null,
        "createdAt": "2018-03-08T16:42:11",
        "modifiedAt": "2018-03-08T16:42:11",
        "exchangeId": 101284720
      },
      "deliveryInvoiceGroupDtos": [],
      "deliveryStatus": "BeforeDirection",
      "collectStatus": "Collecting",
      "collectCompleteDate": null,
      "collectInformationsDto": {
        "returnType": "EXCHANGE_RETURN",
        "expectedReturnDate": "2018-03-13T16:42:11",
        "returndeliveryItemDtos": [
          {
            "vendorItemId": 3288975565,
            "statusCode": "RETURN_SEND_READY",
            "returnCount": null,
            "releaseStatus": "RELEASED",
            "paymentReturnDeliveryMapId": 29829105,
            "paymentItemId": 1,
            "modifiedBy": "56373890",
            "moodifiedAt": "2018-03-08T16:42:11",
            "createdBy": "56373890",
            "createdAt": "2018-03-08T16:42:11",
            "count": 1,
            "confirmType": null,
            "collectStatus": "RETURN"
          },
          {
            "vendorItemId": 3288964806,
            "statusCode": "RETURN_SEND_READY",
            "returnCount": null,
            "releaseStatus": "RELEASED",
            "paymentReturnDeliveryMapId": 29829106,
            "paymentItemId": 1,
            "modifiedBy": "56373890",
            "moodifiedAt": "2018-03-08T16:42:11",
            "createdBy": "56373890",
            "createdAt": "2018-03-08T16:42:11",
            "count": 1,
            "confirmType": null,
            "collectStatus": "RETURN"
          }
        ],
        "returndeliveryDestinationDto": {
          "vendorZipCode": "312-14",
          "vendorPhone": "1899-6500",
          "vendorName": "(주)**몰)",
          "vendorMobile": "010-9203-8248",
          "vendorAddressDetail": "**물류센터 4층 이커머스BD",
          "vendorAddress": "충청남도 천안시 동남구 *()",
          "safetyNumberStatus": "ENABLE",
          "safetyNumberId": 247397194,
          "safetyNumber": "0502987****",
          "returnDeliveryId": null,
          "returnCenterCode": "1000274320",
          "receiptId": null,
          "orderedByMobile": null,
          "orderId": 3000013258427,
          "message": null,
          "customerZipCode": "18488",
          "customerPhone": "05029870825",
          "customerName": "김혜은",
          "customerMobile": "05029870825",
          "customerAddressDetail": "Lh26단지 ***",
          "customerAddress": "경기도 화성시 동탄면 동탄대로9길 20"
        }
      },
      "returnDeliveryDtos": [
        {
          "deliveryCompanyCode": "CJGLS",
          "deliveryInvoiceNo": ""
        }
      ],
      "orderDeliveryStatusLabel": "FINAL_DELIVERY",
      "exchangeStatusLabel": "PROGRESS",
      "referTypeLabel": "WEB_MOBILE",
      "faultTypeLabel": "VENDOR",
      "createdByTypeLabel": "CUSTOMER",
      "rejectable": false,
      "modifiedByTypeLabel": "CUSTOMER",
      "deliveryInvoiceModifiable": false,
      "successable": false
    }
  ],
  "nextToken": ""
}
# 06

에러 코드

HTTP코드메시지
400HTTP_400Bad Request

오류 사양

HTTP유형오류 메시지해결 방법
400400 (요청변수확인)

error-message=createdAtTo - createdAtFrom should less then 7day.

조회기간이 7일 이하 인지 확인합니다.

400400 (요청변수확인)

createdAtFrom format should be yyyy-MM-ddTHH:mm:ss.

검색 시작일의 입력형식이 yyyy-MM-ddTHH:mm:ss 인지 확인합니다.

400400 (요청변수확인)

The vendorId in path or requestBody doesn't match the one got from api-gateway.

vendorId (판매자 ID) 값을 올바르게 입력했는지 확인합니다.

400400 (요청변수확인)

start time should early or equals to end time

검색 종료일이 검색 시작일 보다 빠른 날짜로 설정 되었는지 확인합니다.