GET
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/exchangeRequests2609170000교환요청 목록조회
KRTW
# 01
요약
교환요청 목록조회
# 02
상세
API 적용 가능한 구매자 사용자 지역: 한국 대만
교환 접수일자로 최대 7일 이내의 교환 내역을 확인할 수 있습니다.
각 교환 건에 대한 접수사유(reasonCode)는 아래 자료를 다운받아 확인해주세요.
경로
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=PROGRESSURL API Name
GET_EXCHANGE_REQUEST
# 03
Path 파라미터
| Name | Type | Description |
|---|---|---|
| vendorId* | string | 판매자 ID 쿠팡에서 업체에게 발급한 고유 코드. WING 로그인 후 확인 가능 예) A00012345 |
# 04
Query 파라미터
| Name | Type | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| createdAtFrom* | string | 검색 시작일 (yyyy-MM-ddTHH: mm: ss) 예) 2016-03-15T13:00:00 | ||||||||||||
| createdAtTo* | string | 검색 종료일 (yyyy-MM-ddTHH: mm: ss) 예) 2016-03-16T13:00:00 | ||||||||||||
| status | string | 교환진행상태 구체적인 교환 상태를 선택하지 않을시 모든 상태로 반환됩니다.
| ||||||||||||
| orderId | number | 주문번호 예) 19000009511537 | ||||||||||||
| nextToken | string | 다음 페이지 조회를 위한 토큰값 첫번째 페이지 조회 시에는 필요하지 않습니다. | ||||||||||||
| maxPerPage | number | 최대 조회 요청 값 기본값 : 10 |
# 05
응답 본문
응답 메시지
| Name | Type | Description | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | integer | server response status code
| ||||||||||||||||||||
| message | string | detail info
| ||||||||||||||||||||
| data | object[] | 결과
| ||||||||||||||||||||
| exchangeId data[].exchangeId | integer | 교환 ID
| ||||||||||||||||||||
| orderId data[].orderId | integer | 주문번호
| ||||||||||||||||||||
| vendorId data[].vendorId | string | 판매자 ID
| ||||||||||||||||||||
| orderDeliveryStatusCode data[].orderDeliveryStatusCode | string | 주문 배송 상태
| ||||||||||||||||||||
| exchangeStatus data[].exchangeStatus | string | 교환 상태
| ||||||||||||||||||||
| referType data[].referType | string | 접수경로
| ||||||||||||||||||||
| faultType data[].faultType | string | 귀책
| ||||||||||||||||||||
| 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 | 최초 등록자 유형
| ||||||||||||||||||||
| createdAt data[].createdAt | string | 등록일시 (yyyy-MM-ddTHH: mm: ss) | ||||||||||||||||||||
| modifiedByType data[].modifiedByType | string | 수정자
| ||||||||||||||||||||
| 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 | 배송 타입
| ||||||||||||||||||||
| 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 | 발주서 상태
| ||||||||||||||||||||
| 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 | 재배송상태
| ||||||||||||||||||||
| collectStatus data[].collectStatus | string | 회수상태
| ||||||||||||||||||||
| 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 | 상태코드
| ||||||||||||||||||||
| returnCount data[].collectInformationsDto.returndeliveryItemDtos[].returnCount | number | 반품수량
| ||||||||||||||||||||
| releaseStatus data[].collectInformationsDto.returndeliveryItemDtos[].releaseStatus | string | 출고상태
| ||||||||||||||||||||
| 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
| ||||||||||||||||||||
| collectStatus data[].collectInformationsDto.returndeliveryItemDtos[].collectStatus | string | 회수상태
| ||||||||||||||||||||
| 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 | 안심번호 상태
| ||||||||||||||||||||
| 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 송장번호입력 가능여부 | ||||||||||||||||||||
| nextToken | string | 다음 페이지 조회를 위한 토큰값
|
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 | 코드 | 메시지 |
|---|---|---|
| 400 | HTTP_400 | Bad Request |
오류 사양
| HTTP | 유형 | 오류 메시지 | 해결 방법 |
|---|---|---|---|
| 400 | 400 (요청변수확인) | error-message=createdAtTo - createdAtFrom should less then 7day. | 조회기간이 7일 이하 인지 확인합니다. |
| 400 | 400 (요청변수확인) | createdAtFrom format should be yyyy-MM-ddTHH:mm:ss. | 검색 시작일의 입력형식이 yyyy-MM-ddTHH:mm:ss 인지 확인합니다. |
| 400 | 400 (요청변수확인) | The vendorId in path or requestBody doesn't match the one got from api-gateway. | vendorId (판매자 ID) 값을 올바르게 입력했는지 확인합니다. |
| 400 | 400 (요청변수확인) | start time should early or equals to end time | 검색 종료일이 검색 시작일 보다 빠른 날짜로 설정 되었는지 확인합니다. |