반출현황조회 API – ESM Trading API

반출현황조회 API

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

Description
판매자가 등록한 반출번호의 반출현황을 조회하는 API입니다.
Request Description
G마켓 or 옥션ID로 조회합니다
항목항목명필수여부TypeDescription
WarehouseStatus반출상태YInt반출번호의 반출진행상태
ALL : 전체
1 : 반출신청완료
2 : 반출진행중
3 : 반출완료
4 : 반출요청취소
SearchType조회조건YstringALL : 전체
WAREHOUSE_NO : 반출번호로 조회
SKU_ID : SKU번호로 조회
REGISTER_DATE : 반출등록일자 조회
CANCEL_DATE : 반출취소일자 조회
COMPLETE_DATE : 반출완료일자 조회
WISH_DATE : 반출희망일자 조회
SearchString상세검색string검색조건 > WAREHOUSE_NO / SKU_ID 선택 시 필수
이 때, 날짜검색조건 무시
StartDate조회시작일자Date-Time검색조건 일자 조회일 경우 필수
EndDate조회종료일자Date-Time검색조건 일자 조회일 경우 필수
pageIndex페이지번호YInt정수: Page 구분
pageSize페이지사이즈YInt1페이지에 출력하려는 리스트 Max값
1000까지 지원 가능
JSONSample Code
{
  "WarehouseStatus": "ALL",
  "SearchType": "ALL",
  "SearchString": "",
  "StartDate": "2021-02-18T16:32:12.785Z",
  "EndDate": "2021-02-18T16:32:12.785Z",
  "PageIndex": 1,
  "PageSize": 100
}
{
  "WarehouseStatus": "ALL",
  "SearchType": "ALL",
  "SearchString": "",
  "StartDate": "2021-02-18T00:00:00.000Z",
  "EndDate": "2021-02-19T00:00:00.000Z",
  "PageIndex": 1,
  "PageSize": 100
}
Response Description
항목항목명TypeDescription
ResultCode 결과코드 int 성공: 0
실패 :Error Massage 참고
Message 메시지 string
Data > TotalCount 전체대상건수Int 조회조건 범위 전체 건수
Data > PageIndexResponse PageNoInt조회시 입력한 PageNo
Data > PageSizeResponse PageSizeInt조회시 입력한 PageSize
Data > WarehouseOutNo반출번호long조회된 반출번호 내려감
Data > WarehouseStatus반출상태Int1 : 반출신청완료
2 : 반출진행중
3 : 반출완료
4 : 반출요청취소
Data > WarehouseName반출명string판매자가 입력한 반출명 내려감
Data > RcverInfoNa반출담당자성함string판매자가 입력한 담당자성함 내려감
Data > InsDate반출등록일시DateTime
Data > RcverInfoHt반출담당자연락처string판매자가 입력한 담당자연락처 내려감
Data > OutWishDate반출희망일시DateTime
Data > RcverInfoCp반출담당자휴대폰번호string판매자가 입력한 담당자휴대폰번호 내려감
Data > CompleteDate반출완료일시DateTime
Data > ZipCode반출택배주소 우편번호string판매자가 입력한 반출할 주소 우편번호 내려감
Data > CancelDate반출취소일시DateTime
Data > RcverAddress반출택배주소string판매자가 입력한 반출할 주소 내려감
Data > OutCode반출방식Int판매자가 선택한 반출방식 내려감
1. 택배반출
2. 차량반출(AJU)
3. 차량반출(KPP)
4. 방문(직접회수)
Data > StorageType창고구분Int
Data > StorageDesc창고명string
Data > OutDetail > SkuId[]SKU번호long반출된 SKU번호 내려감
Data > OutDetail > SkuStockCode[]SKU재고유형string반출된 SKU재고유형 내려감
SA : 판매가능재고
UP : 신규주문재고
HS : 일반보류재고
RH : 반품보류재고
EH : 유통기한보류재고
Data > OutDetail > OutReqQty[]SKU반출요청수량string반출된 SKU반출요청수량 내려감
Data > OutDetail > OutDetrmQty[]SKU반출수량string반출된 SKU반출수량 내려감
Data > OutDetail > DeliveryCompCode[]택배사명string스마일배송 물류센터에서 발송한 택배사명 내려감(택배사코드는 나중에 적용됨)
Data > OutDetail > InvoiceNo[]송장번호string스마일배송 물류센터에서 발송한 송장번호 내려감
Data > OutDetail > Memo[]메모string스마일배송 물류센터에서 입력한 메모 내려감
Data > IwDetail > SkuId[]SKU번호long입고된 SKU번호 내려감
Data > IwDetail > SkuName[]SKU명string입고된 SKU명 내려감
Data > IwDetail > StockQty[]현재수량Int해당 SKU의 현재수량 내려감
Data > IwDetail > IwScheduledQty[]입고예정수량Int해당 SKU의 입고예정수량 내려감
Data > IwDetail > IwDetrmQty[]입고완료수량Int해당 SKU의 입고완료수량 내려감
Data > IwDetail > IwReasonCode[]입고오류코드string해당 SKU의 입고오류코드 내려감
해당 SKU의 입고오류코드 내려감
OR : 과입고
PR : 부분 미입고
NR :
전체 미입고
ES : 바코드스캔오류
EB 바코드오류
ER : 오입고(타상품 입고)
EE :유통기한오류
EU :입수오류
ET : 출고타입오류
D : 파손
EC : 기타
CR : 입고취소
Data > IwDetail > IwReasonMsg[]입고오류사유string해당 SKU의 입고오류사유 내려감
Data > StorageType창고구분string입고된 창고구분 내려감
Data > StorageDesc창고명string입고된 창고명 내려감
JSONSample Code
{
  "ResultCode": 0,
  "Message": "string",
  "Data": {
    "TotalCount": 0,
    "PageSize": 0,
    "PageIndex": 0,
    "Data": [
      {
        "OutDetail": [
          {
            "SkuId": 0,
            "SkuName": "string",
            "SkuStockCode": "string",
            "OutReqQty": 0,
            "OutDetrmQty": 0,
            "DeliveryCompCode": "string",
            "InvoiceNo": "string",
            "Memo": "string"
          }
        ],
        "WarehouseOutNo": 0,
        "WarehouseStatus": 0,
        "WarehouseName": "string",
        "RcverInfoNa": "string",
        "RcverInfoHt": "string",
        "RcverInfoCp": "string",
        "ZipCode": "string",
        "RcverAddress": "string",
        "OutCode": 0,
        "StorageType": 0,
        "StorageDesc": "string",
        "InsDate": "2021-02-18T16:32:12.946Z",
        "OutWishDate": "2021-02-18T16:32:12.946Z",
        "CompleteDate": "2021-02-18T16:32:12.946Z",
        "CancelDate": "2021-02-18T16:32:12.946Z"
      }
    ]
  }
}
{
    "ResultCode": 0,
    "Message": "success",
    "Data": {
        "TotalCount": 1,
        "PageSize": 100,
        "PageIndex": 1,
        "Data": [
            {
                "OutDetail": [
                    {
                        "SkuId": 41347,
                        "SkuName": "SKU명",
                        "SkuStockCode": "SA",
                        "OutReqQty": 1,
                        "OutDetrmQty": 0,
                        "DeliveryCompCode": null,
                        "InvoiceNo": null,
                        "Memo": ""
                    }
                ],
                "WarehouseOutNo": 217781630,
                "WarehouseStatus": 1,
                "WarehouseName": "반출명",
                "RcverInfoNa": "인수자",
                "RcverInfoHt": "010-1234-5678",
                "RcverInfoCp": "070-1234-5678",
                "ZipCode": "27858",
                "RcverAddress": "서울특별시 강남구 테헤란로 인수자앞",
                "OutCode": 2,
                "StorageType": 14,
                "StorageDesc": "스마일배송 동탄메가센터 3층 3R",
                "SkuStockType": 1,
                "InsDate": "2021-02-19T00:34:15.173",
                "OutWishDate": "2021-02-25T12:00:00",
                "CompleteDate": null,
                "CancelDate": null
            }
        ]
    }
}
Error Code
결과코드메시지원인
1400반출상태는 필수 입력값입니다. 반출상태 전체일 경우 ALL을 입력해주세요.WarehouseStatus > 반출상태 미입력 혹은 빈 값 입력 시
1400유효하지 않은 반출상태입니다.WarehouseStatus > 유효하지 않은 반출상태 입력 시
1400조회일자를 확인해주세요. 시작일자가 유효하지 않습니다.StartDate > SearchType이 일자(DATE)일 때 시작일자 미입력 시
1400조회일자를 확인해주세요. 종료일자가 유효하지 않습니다.EndDate > SearchType이 일자(DATE)일 때 종료일자 미입력 시
1400조회일자를 확인해주세요. 종료일자는 시작일자보다 과거일 수 없습니다.EndDate > 종료일자가 시작일자보다 과거일 경우
1400검색어가 필수인 검색조건입니다. 검색어를 입력해주세요.SearchType > 검색어가 필요한 검색조건(입고번호, SKU번호 등)일 때 검색어 미입력 시