반품/교환입고 조회 API – ESM Trading API

반품/교환입고 조회 API

[POST] https://sa.esmplus.com/efm/v1/api/service/GetOuterclaimList

Description
반품/교환입고 등록된 주문을 조회하는 API입니다.
Request Description
G마켓 or 옥션ID로 조회합니다
항목항목명필수여부TypeDescription
SiteId사이트코드YInt하단 사이트 코드 참조
SearchType외부주문검색조건YstringOUTER_CART_NO : 외부장바구니번호
OUTER_ORDER_NO : 외부주문번호
SMILE_ORDER_NO : 스마일주문번호
CLAIM_DATE : 클레임등록일날짜로조회
WAREHOUSE_IN_DATE : 반품입고일날짜로조회
REPORTING_INS_DATE : 클레임리포팅등록일날짜로 조회
REPORTING_UPD_DATE : 클레임리포팅수정일날짜로 조회
SearchString주문상세검색string검색조건 > OUTER_CART_NO / OUTER_ORDER_NO / SMILE_ORDER_NO 선택 시 필수
이 때, 날짜검색조건 무시
StartDate조회시작일자Date-Time검색조건 > INS_DATE / WAREHOUSE_INS_DATE 일 경우 필수
EndDate조회종료일자Date-Time검색조건 > INS_DATE / WAREHOUSE_INS_DATE 일 경우 필수
ClaimStatus클레임상태YInt0 : 전체
1 : 반품입고신청
2 : 반품입고완료
3 : 교환입고신청
4 : 교환입고완료
5 : 클레임입고미신청 & 반품입고완료(5번은 추후 제공예정)
pageIndex페이지번호YInt정수: Page 구분
pageSize페이지사이즈YInt1페이지에 출력하려는 리스트 Max값
1000까지 지원 가능
JSONSample Code
{
  "SiteId": 0,
  "SearchType": "string",
  "SearchString": "string",
  "StartDate": "2020-01-29T05:26:48.957Z",
  "EndDate": "2020-01-29T05:26:48.957Z",
  "ClaimStatus": 0,
  "PageIndex": 0,
  "PageSize": 0
}

{
  "SiteId": 0,
  "SearchType": "INS_DATE",
  "SearchString": "",
  "StartDate": "2020-01-02T08:35:42.109Z",
  "EndDate": "2020-01-04T08:35:42.109Z",
  "ClaimStatus": 0,
  "PageIndex": 1,
  "PageSize": 100
}
사이트 코드
사이트 코드사이트 명비고
1옥션
2G마켓
311번가
4AK몰
5CJ오쇼핑(CJ몰)
6GS SHOP
7NS홈쇼핑(NS몰)
8SSG닷컴
9갤러리아몰
10디앤샵
11롯데닷컴
12롯데마트
13롯데홈쇼핑(롯데아이몰)
14신세계몰
15엘롯데
16위메프
17이마트
18인터파크
19티몬
20현대홈쇼핑
21홈앤쇼핑
22홈플러스
23기타기타 입력 시, SiteUserInput 컬럼에 사이트명 직접 입력해야함(필수)
24쿠팡
25G9
26G마켓 해외배송
27iStyle 24
28하프클럽
291300K
30WIZWID
31YES24
32네이버페이
33텐바이텐
34홈&쇼핑
35네이버쇼핑(스토어팜)
36골핑(B2B)
37제로투세븐
38POOM
39교보핫트랙스
40인터파크비즈마켓
41GS편의점(GS리테일)
42롯데홈쇼핑(신)
43현대홈쇼핑(신)
44신세계몰(신)
45이마트(신)
46후추통
47NS홈쇼핑(신)
48AKmall(신)
49다이소몰(신)
50CJOshopping(신)
51GS리테일(신)
52아이마켓
53다날쏘시오
54이랜드몰
55고도몰5
56제로투세븐(신)
57인터파크 비즈마켓
58인터파크 비즈마켓 (닷넷로그인)
59인터파크 비즈마켓 (웹프라자)
60인터파크 아이마켓
61카카오톡
62농협
63GSfresh(GS아이슈퍼)
64아이엠스쿨
65w베라
66베페몰
67바보사랑
68Y군
69다이소몰
70카카오몰
71펀샵
72뱅크앤컴퍼니
73티쳐몰
74전시몰
75얼리샵
76미소몰
77케이빔(고도몰)
78학교장터
79마켓인벤
80큐브릿지
81하이마트
82이베이
83온누리약국체인
84KM상사
85다코넷
86에이블커머스
87컴랜드시스템
88정훈테크
89인투컴퍼니
90코티니
91W쇼핑
92쇼핑엔티
93오늘의집
94SK스토아
95롯데온
96LF
97무신사
98Wconcept (더블유컨셉)
100문고리닷컴
101집꾸미기
102신세계TV쇼핑
10329cm
104패션플러스
105우먼스톡
106브랜디
107보리보리
108메이크샵
109화해
110스타일쉐어
111skinRX
112삼성카드몰
113삼성카드블루베리몰
114구독ON
115Grip
116아임웹
117롯데슈퍼
118홈쇼핑모아
119더현대
120SSG오픈마켓
121하이버
122농수산쇼핑몰
123베네피아
124에이블리
125온누리약국
999기타
Response Description
항목항목명TypeDescription
ResultCode 결과코드 int 성공: 0
실패 :Error Massage 참고
Message 메시지 string
Data > TotalCount전체대상건수Int조회조건 범위 전체 건수
Data > PageIndexResponse PageNoInt조회시 입력한 PageNo
Data > PageSizeResponse PageSizeInt조회시 입력한 PageSize
Data > Data > OrderDetail > SkuId[]Sku번호InteBay에서 채번한 SKU번호 내려감
Data > Data > OrderDetail > OwQty[]SKU총출고수량Int판매자가 등록한 SKU총출고수량
Data > Data > OrderDetail > BoxSize[]출고된 박스사이즈string출고된 박스사이즈 내려감
Data > Data > OrderDetail > DeliveryCompCode[]출고된 택배사코드string택배사별 5자리 코드 아래 택배사코드 참고
Data > Data > OrderDetail > InvoiceNo[]출고송장번호string해당 SKU 출고송장번호 내려감
Data > Data > OrderDetail > InvoiceIssueDate[]출고송장발급일시Date-Time해당 SKU 출고송장번호 발급일시 내려감
Data > Data > OrderDetail > InvoiceIssueDate[]상품관리코드string판매자가 입력한 상품관리코드 내려감
Data > Data > OrderDetail > InvoiceIssueDate[]SKU관리코드 string판매자가 입력한 SKU관리코드 내려감
Data > ClaimSeqNo클레임관리번호Int내부클레임관리번호 내려감
Data > EfmSeqNo내부주문관리번호Int내부주문관리번호 내려감
Data > SiteId사이트코드Int해당 스마일주문번호의 사이트코드 내려감
Data > SiteUserInput사이트직접입력string판매자가 사이트직접입력한 텍스트 내려감
Data > ClaimType클레임상태stringRT : 반품
EX : 교환
Data > DeliveryCompCode수거 택배사코드string수거한 택배사코드 내려감
Data > ClaimInvoiceNo수거 송장번호string수거한 송장번호 내려감
Data > DeliveryPayType선불/착불여부string판매자가 입력한 선불/착불여부 내려감
Y: 선불
N: 착불
Data > DeliveryExpenseeBay지불 반품/교환배송비Number착불일 경우, 이베이에서 지불한 반품/교환배송비 금액 내려감(추후제공)
Data > ClaimDate반품/교환입고일시Date-Time판매자가 입력한 외부주문 반품/교환입고요청한 일시
YYYY-MM-DD hh:mm:ss형식
Data > UpdDate반품/교환정보 업데이트일시Date-Time판매자가 입력한 외부주문 반품/교환입고정보 업데이트된 일시
YYYY-MM-DD hh:mm:ss형식
Data > SmileOrderNo스마일주문번호Int스마일주문번호 내려감
Data > OuterOrderNo외부주문번호string판매자가 입력한 외부주문번호 내려감
Data > BundleType합포장여부string센터에서 검수 후, 해당 SKU 합포장 가능여부 내려감
B : 합포장가능
I : 합포장불가능
Data > OuterCartNo외부장바구니번호string판매자가 입력한 외부장바구니 번호 내려감
Data > OuterGoodsNo외부상품번호string판매자가 입력한 외부상품 번호 내려감
Data > OrderDate주문일자Date-Time주문일자 내려감
Data > GoodsName상품명string판매자 입력한 상품명 내려감
Data > OptValue옵션명string판매자 입력한 옵션명 내려감
Data > RcverInfoNa수령인명string판매자 입력한 수령인명 내려감
Data > RcverInfoCp수령인휴대폰번호string판매자 입력한 수령인휴대폰번호 내려감
Data > RcverInfoHt수령인일반전화번호string판매자 입력한 수령인일반전화번호 내려감
Data > ZipCode수령인우편번호string판매자 입력한 수령인우편번호 내려감
Data > RcverInfoAd1수령인기본주소string판매자 입력한 수령인기본주소 내려감
Data > RcverInfoAd2수령인상세주소string판매자 입력한 수령인상세주소 내려감
Data > Memo수령인배송메모string판매자 입력한 수령인배송메모 내려감
Data > EfmCartSeqNo내부장바구니관리번호Int내부장바구니관리번호 내려감
Data > DeliveryReqDate출고요청일시Date-Time판매자가 출고요청처리한 일시 내려감
Data > ClaimStatus클레임상태Int1 : 반품입고신청
2 : 반품입고완료
3 : 교환입고신청
4 : 교환입고완료
5 : 클레임입고미신청 & 반품입고완료(5번은 추후 제공예정)
Data > WarehouseInDate수거일시Int스마일배송 센터에 수거 도착한 일시
Data > IsReportingReporting등록여부Int검수리포팅이 등록되었는지 여부
1.등록
2.미등록
Data > Reporting > ReturnChangeBlame이용료부담주체Int 반품교환배송비귀책
1:판매자
(센터사유 3~11 매칭)
2:eBay스마일센터
(센터사유 1~2 매칭
센터사유 1 (택배파손) : 이베이_택배사귀책
센터사유 2 (센터파손) : 이베이_운영사귀책)
3:기타
4:협의후 결정
5:미정 (Reporting 검수중으로 정해지지 않은 경우)
Data > Reporting > ReportingInsDateReporting 등록일시DateTime
Data > Reporting > ReportingUpdDateReporting 수정일시DateTime
Data > Reporting > DistrCenterClaimCode전체검수결과코드string담당자 별도 코드 문의(엑셀로 제공)
Data > Reporting > Memo결과상세string
Data > Reporting > ImageUrl1[]이미지1string
Data > Reporting > ImageUrl2[]이미지2string
Data > Reporting > ImageUrl3[]이미지3string
Data > Reporting > ImageUrl4[]이미지4string
Data > Reporting > ImageUrl5[]이미지5string
Data > Reporting > ClaimSkuDetail > SkuId[]SKU번호long해당 주문번호에 포함되는 SKU번호 내려감
Data > Reporting > ClaimSkuDetail > IwScheduledQty[]SKU반품/교환입고 예정수량int0 또는 정수
Data > Reporting > ClaimSkuDetail > IwDetrmQty[]SKU반품/교환입고 확정수량int0 또는 정수
Data > Reporting > ClaimSkuDetail > RestockYn[]양품화 가능여부stringY: 가능
N: 불가
JSONSample Code
{
  "ResultCode": 0,
  "Message": "string",
  "Data": {
    "TotalCount": 0,
    "PageSize": 0,
    "PageIndex": 0,
    "Data": [
      {
        "OrderDetail": [
          {
            "SkuId": 0,
            "OwQty": 0,
            "BoxSize": "string",
            "DeliveryCompCode": "string",
            "InvoiceNo": "string",
            "InvoiceIssueDate": "2020-02-03T06:58:22.537Z"
            "ItemManageCode": null,
            "StockNo": null
          }
        ],
        "ClaimSeqNo": 0,
        "EfmSeqNo": 0,
        "SiteId": 0,
        "SiteUserInput": "string",
        "ClaimType": "string",
        "DeliveryCompCode": "string",
        "ClaimInvoiceNo": "string",
        "DeliveryPayType": "string",
        "DeliveryExpense": 0,
        "ClaimDate": "2020-02-03T06:58:22.537Z",
        "UpdDate": "2020-02-03T06:58:22.537Z",
        "SmileOrderNo": 0,
        "OuterOrderNo": "string",
        "BundleType": "string",
        "OuterCartNo": 0,
        "OuterGoodsNo": "string",
        "OrderDate": "2020-02-03T06:58:22.537Z",
        "GoodsName": "string",
        "OptValue": "string",
        "RcverInfoNa": "string",
        "RcverInfoCp": "string",
        "RcverInfoHt": "string",
        "RcverInfoAd1": "string",
        "RcverInfoAd2": "string",
        "ZipCode": "string",
        "Memo": "string",
        "EfmCartSeqNo": 0,
        "DeliveryReqDate": "2020-02-03T06:58:22.537Z",
        "ClaimStatus": "string",
        "WarehouseInDate": "2020-02-03T06:58:22.537Z"
        "IsReporting": 0,
        "Reporting": {
          "ClaimSkuDetail": [
            {
              "EfmOrderNo": 0,
              "SkuId": 0,
              "IwScheduledQty": 0,
              "IwDetrmQty": 0,
              "RestockYn": "string",
              "WarehouseNo": 0
            }
          ],
          "DistrCenterClaimCode": "string",
          "Memo": "string",
          "ImageUrl1": "string",
          "ImageUrl2": "string",
          "ImageUrl3": "string",
          "ImageUrl4": "string",
          "ImageUrl5": "string",
          "InsDate": "2021-02-25T23:54:21.002Z",
          "UpdDate": "2021-02-25T23:54:21.002Z",
          "ReturnChangeBlame": 0
        }
      }
    ]
  }
}

{
    "ResultCode": 0,
    "Message": "success",
    "Data": {
        "TotalCount": 1,
        "PageSize": 100,
        "PageIndex": 1,
        "Data": [
            {
                "OrderDetail": [
                    {
                        "SkuId": 41741,
                        "OwQty": 1,
                        "BoxSize": null,
                        "DeliveryCompCode": null,
                        "InvoiceNo": null,
                        "InvoiceIssueDate": null
                        "ItemManageCode": null,
                        "StockNo": null
                    },
                    {
                        "SkuId": 41741,
                        "OwQty": 1,
                        "WarehouseNo": 217191730,
                        "BoxSize": null,
                        "DeliveryCompCode": null,
                        "InvoiceNo": null,
                        "InvoiceIssueDate": null
                        "ItemManageCode": null,
                        "StockNo": null
                    }
                ],
                "ClaimSeqNo": 10640,
                "EfmSeqNo": 3266032,
                "SiteId": 24,
                "SiteUserInput": null,
                "ClaimType": "RT",
                "DeliveryCompCode": "10032",
                "ClaimInvoiceNo": "1234",
                "DeliveryPayType": "Y",
                "DeliveryExpense": 0.0,
                "ClaimDate": "2020-01-03T17:28:51.35+09:00",
                "UpdDate": "2020-01-03T17:28:51.35+09:00",
                "SmileOrderNo": 408715,
                "OuterOrderNo": "13000059460401",
                "BundleType": "B",
                "OuterCartNo": 12345678945623123,
                "OuterGoodsNo": "B123456",
                "OrderDate": "2020-01-03T10:39:52.4+09:00",
                "GoodsName": "상품명",
                "OptValue": "색상1",
                "RcverInfoNa": "고객명",
                "RcverInfoCp": "010-1234-5678",
                "RcverInfoHt": "010-1111-2222",
                "RcverInfoAd1": "서울시 강남구 테헤란로 152",
                "RcverInfoAd2": "GFC 35층 ",
                "ZipCode": "15236",
                "Memo": "",
                "EfmCartSeqNo": 449574,
                "DeliveryReqDate": "2020-01-03T17:29:00+09:00",
                "ClaimStatus": "1",
                "WarehouseInDate": "2021-02-03T16:27:22.143",
                "IsReporting": 1,
                "Reporting": {
                    "ClaimSkuDetail": [
                        {
                            "EfmOrderNo": 3312982,
                            "SkuId": 42460,
                            "IwScheduledQty": 1,
                            "IwDetrmQty": 1,
                            "RestockYn": "Y",
                            "WarehouseNo": 217705046
                        }
                    ],
                    "DistrCenterClaimCode": "4",
                    "Memo": "메모",
                    "ImageUrl1": "/inbound/return/reporting/3312982-3/photo1.png",
                    "ImageUrl2": null,
                    "ImageUrl3": null,
                    "ImageUrl4": null,
                    "ImageUrl5": null,
                    "InsDate": "2021-02-03T16:01:17.99",
                    "UpdDate": "2021-02-03T16:01:17.99",
                    "ReturnChangeBlame": 1
                }
            }
        ]
    }
}
택배사코드
택배사코드택배사명비고
10001G마켓/옥션 지정택배 코드판매자가 처리는 불가하나 반품조회/교환조회 Response로 내려갈 수 있음
10003로젠택배
10005우체국택배
10006등기우편상품 등록/수정시 사용 불가
발송처리시 사용 가능
10007한진택배
10008롯데택배
10013CJ대한통운
10014대신택배
10015일양택배
10016경동택배
10017천일택배
10022DHL
10023FEDEX
10024일반우편
10027LG전자물류
10028삼성전자물류
10031(G마켓)직접배달
10032(G마켓)자체배송구매자 배송조회 불가
제한코드로 해당 코드 사용 필요시 협의 필요
10034기타택배
10035방문수령상품 등록/수정시 사용 불가
발송처리시 사용 가능
10036EMS
10039호남택배
10041USPS
10042UPS
10043GSMNTON
10044WarpEx
10045성원글로벌
10050건영택배
10051WIZWA
10072CJ국제특송
10073편의점택배(GS25)
10074합동택배
10075롯데국제특송
10077SLX
10078동부대우전자/대우전자
10079범한판토스
10080GPS LOGIX
10081한의사랑택배
10082세방택배
10084쉽트랙
10085ACI
10097Qxpress
10098현대글로비스
10089택배사미정
10099부릉
10056(해외)DPD해외배송 전용 택배사/G마켓만 지원
10086GSfresh당일배송 마트판매자 전용
10087롯데fresh당일배송 마트판매자 전용
10048홈플러스당일배송 마트판매자 전용
10096롯데마트당일배송 마트판매자 전용
10100이마트몰당일배송 마트판매자 전용
Error Code
결과코드메시지원인
1400검색조건 입력 시 외부장바구니번호(OUTER_CART_NO), 외부주문번호(OUTER_ORDER_NO), 스마일주문번호(SMILE_ORDER_NO), 클레임일자(CLAIM_DATE), 반품입고일자(WAREHOUSE_IN_DATE)만 유효합니다.SearchType > 유효하지 않은 값 입력 시