반출요청 API

Description

[POST] https://sa2.esmplus.com/efm/v1/api/Service/RegisterWarehouseOut

스마일배송 물류센터에 입고 또는 반출필요한 SKU의 반출을 등록하는 API입니다.

 

Request Description

항목	항목명	필수여부	Type	Description
SkuStockType	SKU대상유형	Y	Int	반출할 SKU 대상 선택(SKU상태별 각각 요청 등록) 1: 판매가능재고 SKU직접입력 2: 반품보류재고 전체 반출 3: 파손보류재고 전체 반출 4: 소비기한보류재고 전체 반출 동일한 상태의 SKU만 요청 가능
OutWishDate	반출희망일	Y	DateTime	반출요청일은 영업일 기준 최소 D+5일부터 가능 (단, VF 판매자 당일반출 가능) YYYY-MM-DD hh:mm:ss 유형으로 입력하면 입력된 시간의 오전, 오후에 따라 자동으로 오전/오후로 입력됨 주말은 반출 불가
OutCode	반출방식	Y	Int	1. 택배반출 2. 차량반출(AJU) 3. 차량반출(KPP) 4. 방문(직접회수)
WarehouseName	반출명	Y	string	반출명 입력(최대 50Byte)
RcverInfoNa	담당자성함	Y	string	담당자성함 입력(최대 50Byte)
RcverInfoHt	담당자전화번호	Y	string	담당자전화번호 입력
RcverInfoCp	담당자휴대폰번호	Y	string	담당자휴대폰번호 입력
ZipCode	택배반출주소 우편번호		string	택배반출일 경우에만 필수입력
RcverInfoAd1	택배반출주소1		string	택배반출일 경우에만 필수입력 (최대 200Byte)
RcverInfoAd2	택배반출주소2		string	택배반출일 경우에만 필수입력 (최대 250Byte)
OutDetail > SkuId	[]SKU번호		long	SKU대상유형 1번일 경우 필수입력 반출하려는 SKU번호 입력 병렬로 다수 입력 가능
OutDetail >OutReqQty	[]반출요청수량		Int	SKU직접입력시 수량 설정 필요
OutDetail >Memo	[]요청사항		string	각 SKU별 반출요청사항 입력가능

JSON
{
  "SkuStockType": 0,
  "OutWishDate": "2021-02-18T15:31:44.734Z",
  "OutCode": 0,
  "WarehouseName": "",
  "RcverInfoNa": "",
  "RcverInfoHt": "",
  "RcverInfoCp": "",
  "ZipCode": "",
  "RcverInfoAd1": "",
  "RcverInfoAd2": "",
  "OutDetail": [
    {
      "SkuId": 0,
      "OutReqQty": 0,
      "Memo": ""
    }
  ]
}

 

Response Description

항목	항목명	Type	Description
ResultCode	결과코드	int	성공: 0 실패 :Error Massage 참고
Message	메시지	string
Data > RequestCount	요청건수	Int	판매자가 반출요청한 전체 SKU건수
Data > SuccessCount	성공건수	Int	반출요청 성공한 SKU건수
Data > SuccessList[] > WarehouseOutNo	[]성공한반출번호	long	반출요청 성공한 반출번호 리스트
Data > FailCount	실패건수	Int	반출요청 실패한 건수
Data > SuccessList[] > OutDetail[] > SkuId	[]성공한SKU번호	long	반출요청 성공한 SKU번호 리스트
Data > FailReasons[] > WarehouseOutNo	[]실패한반출번호	Int	반출요청 실패한 반출번호 리스트
Data > FailReasons[] > IwDetail[] > SkuId	[]실패한SKU번호	long	반출요청 실패한 SKU번호 리스트
Data > FailReasons[] > Message	[]실패사유	string	반출요청 실패사유

 JSON_Success

{
  "ResultCode": 0,
  "Message": "",
  "Data": {
    "RequestCount": 0,
    "SuccessList": [
      {
        "WarehouseOutNo": 0,
        "OutDetail": [
          {
            "SkuId": 0
          }
        ]
      }
    ],
    "SuccessCount": 0,
    "FailReasons": [
      {
        "WarehouseOutNo": 0,
        "OutDetail": [
          {
            "SkuId": 0
          }
        ],
        "Message": ""
      }
    ],
    "FailCount": 0
  }
}

 

Sample Code_Success

{
    "ResultCode": 0,
    "Message": "success",
    "Data": {
        "RequestCount": 1,
        "SuccessList": [
            {
                "WarehouseOutNo": 217781630,
                "OutDetail": [
                    {
                        "SkuId": 41347
                    }
                ]
            }
        ],
        "SuccessCount": 1,
        "FailReasons": [],
        "FailCount": 0
    }
}

Error Code

결과코드	메시지	원인
1400	SKU대상유형은 필수입력 항목입니다. (1:판매가능재고, 2:반품보류재고, 3:파손보류재고, 4:소비기한보류재고)	SkuStockType > SKU대상유형 미입력 혹은 0 입력 시
1400	SKU대상유형이 유효하지 않습니다. (1:판매가능재고, 2:반품보류재고, 3:파손보류재고, 4:소비기한보류재고)	SkuStockType > 유효하지 않은 값 입력 시
1400	반출가능한 해당 유형의 재고가 없습니다. SKU대상유형을 확인해주세요.	SkuStockType > 반출가능 재고가 없을 경우
1400	반출방식이 유효하지 않습니다. (1:택배반출, 2:차량반출(AJU), 3:차량반출(KPP), 4:방문(직접회수))	OutCode > 유효하지 않은 값 입력 시
1400	반출명은 필수입력 항목입니다.	WarehouseName > 반출명 미입력 혹은 빈 문자열 입력 시
1400	담당자 성함은 필수입력 항목입니다.	RcverInfoNa > 담당자 성함 미입력 혹은 빈 문자열 입력 시
1400	담당자 연락처는 필수입력 항목입니다.	RcverInfoHt > 담당자 연락처 미입력 혹은 빈 문자열 입력 시
1400	담당자 휴대폰번호는 필수입력 항목입니다.	RcverInfoCp > 담당자 휴대폰번호 미입력 혹은 빈 문자열 입력 시
1400	우편번호는 필수입력 항목입니다.	ZipCode > 우편번호 미입력 혹은 빈 문자열 입력 시
1400	기본주소는 필수입력 항목입니다.	RcverInfoAd1 > 기본주소 미입력 혹은 빈 문자열 입력 시
1400	상세주소는 필수입력 항목입니다.	RcverInfoAd2 > 기본주소 미입력 혹은 빈 문자열 입력 시
1400	반출명은/는 50Byte까지만 입력 가능합니다.	WarehouseName > 반출명 50Byte 초과 시
1400	담당자 이름은/는 200Byte까지만 입력 가능합니다.	RcverInfoNa > 담당자 이름 50Byte 초과 시
1400	기본주소은/는 200Byte까지만 입력 가능합니다.	RcverInfoAd1 > 기본주소 200Byte 초과 시
1400	상세주소은/는 250Byte까지만 입력 가능합니다.	RcverInfoAd2 > 상세주소 250Byte 초과 시
1400	전화번호는 '-'로 구분해서 010-0000-0000 형식으로 넣어주세요.	RcverInfoHt > 담당자 연락처에 - 미포함시
1400	정확한 연락처 정보를 입력해 주세요	RcverInfoHt > 전화번호 형식에 맞지 않을 경우
1400	휴대폰은 '-'로 구분해서 010-0000-0000 형식으로 넣어주세요.	RcverInfoCp > 담당자 휴대폰번호에 - 미포함시
1400	정확한 휴대폰 정보를 입력해 주세요	RcverInfoCp > 전화번호 형식에 맞지 않을 경우
1400	스마일배송 미결제 이용료가 있을 경우 보류재고 반출만 가능합니다. 미결제 이용료 결제 후 반출 요청 진행해주시기 바랍니다.	SkuStockType=1 (판매가능재고)일 때, 판매자 이용료 미결제 내역이 있을 경우
1400	판매가능재고 반출의 경우 SKU 입력은 필수입니다.	OutDetail > SkuStockType=1 (판매가능재고)일 때 미입력
1400	SKU 번호가 유효하지 않습니다.	OutDetail > SkuId > SkuStockType=1 (판매가능재고)일 때 SKU번호 미입력 or 0 or 음수 입력 시
1400	존재하지 않는 SKU번호입니다.	OutDetail > SkuId > SkuStockType=1 (판매가능재고)일 때 유효하지 않은 SKU번호 입력 시
1400	판매자의 SKU번호가 아닙니다.	OutDetail > SkuId > SkuStockType=1 (판매가능재고)일 때 다른 판매자의 SKU번호 입력 시
1400	반출 가능한 SKU 상태가 아닙니다.	OutDetail > SkuId > SkuStockType=1 (판매가능재고)일 때 입력 SKU번호 상태가 정상, 품절, 출고중지 외의 상태일 시
1400	반출 가능한 판매가능재고 수량이 없습니다.	OutDetail > SkuId > SkuStockType=1 (판매가능재고)일 때 반출 가능한 판매가능재고가 없을 경우
1400	반출요청수량은 0 이하를 허용하지 않으며 필수입력 항목입니다.	OutDetail > OutReqQty > SkuStockType=1 (판매가능재고)일 때 반출요청수량 미입력 혹은 0 이하 입력 시
1400	반출 가능한 판매가능재고 수량을 초과했습니다.	OutDetail > OutReqQty > SkuStockType=1 (판매가능재고)일 때 잔여 판매가능재고 수량보다 초과 입력 시
1400	요청사항은/는 200Byte까지만 입력 가능합니다.	OutDetail > Memo > 요청사항 200Byte 초과 시