입고등록 API

Description

[POST] https://sa2.esmplus.com/efm/v1/api/service/RegisterWarehouseIn

판매자님의 물품을 스마일배송 물류센터로 입고등록 요청하는 API입니다. 입고등록을 진행하시려면 먼저 SKU등록 완료되어야 입고등륵이 가능합니다. 입고시 아래 URL에서 입고증을 출력하여 방문해야 합니다. 입고증이 없을 경우 입고가 불가합니다. (택배일 경우, 택배 내 입고증 출력물 필수첨부) http://efm.esmplus.com/Warehouse/WarehouseIn/Print?warehouseNoList=입고번호(다수일 경우 , 구분) ex) http://efm.esmplus.com/Warehouse/WarehouseIn/Print?warehouseNoList=131214485,131214486

 

Request Description

항목	항목명	필수여부	Type	Description
IwMthdType	입고방식	Y	int	입고방식 입력 1. 화물입고 2. 택배입고
InspectMthdType	검수방식	Y	int	검수방식 입력 1. 위탁검수 2. 판매자(화주)직접검수
WarehouseName	입고명	Y	string	최대 50byte 입력
TransInfoAd1	발송처정보 > 주소1	Y	string
TransInfoAd2	발송처정보 > 주소상세	Y	string
TransInfoHt	발송처정보 > 연락처	Y	string
IwScheduledDateType	입고예정일자유형	Y	int	입고예정일자를 시스템에서 가능한 날짜로 자동 선택받을 것인지 직접선택할 것인지 여부 1 : 가장 빠른 날짜 자동선택 2 : 직접입력
IwScheduledDate	입고예정일자		DateTime	입고예정일자유형>2: '직접입력'일 경우 필수 일시 직접입력 (DateTime) 오전에 입고 시 09시, 오후는 13시로 입력필요
IwDetail[] > SkuId	[]SKU번호	Y	long	입고요청할 SKU ID입력 택배입고는 1SKU : 1BOX로 분할되어 입고번호가 채번됨 송장별로 분할하여 중복 SKU 입력이 가능하나 1송장 안에 N SKU혼적 불가 택배입고는 입고요청 시, 20box이상 입고불가
IwDetail[] > IwScheduledQty	[]입고예정수량	Y	int	입고예정수량은 입수량 단위로 숫자로만 입력 가능 (입고예정수량과 실제 수량이 다른 경우 입고가 거부될 수 있음) 예) 판매단위 = 낱개이면 낱개 입수량으로 입력
IwDetail[] > ExpireDate	[]소비기한		string	소비기한 입력 상미(소비)기한 관리 SKU일 경우 필수입력 '화물입고'의 경우, 1SKU 당 최대 3개 까지의 소비기한 등록 가능 '택배입고'의 경우, 박스 별 소비기한을 입력 1Box 안 SKU의 소비기한은 동일해야함
IwDetail[] > BarcodeServiceYn	[]바코드부착	Y	string	유료서비스 Y : 서비스신청 N : 서비스신청 안 함
IwDetail[] > DeliveryCompCode	[]택배사코드		string	택배입고일 경우 필수입력 입고요청 시 아래 택배사만 제공 CJ대한통운 : 10013 우체국택배 : 10005 한진택배 : 10007 로젠택배 : 10003 롯데택배 : 10008 합동택배 : 10074 경동택배 : 10016 일양로지스 : 10015 기타택배 : 10034 화물입고일 경우 해당컬럼 입력하지 않음(null)
IwDetail[] > InvoiceNo	[]송장번호		string	송장번호 입력 택배입고일 경우 필수입력

JSON
{
  "IwMthdType": 0,
  "InspectMthdType": 0,
  "WarehouseName": "string",
  "TransInfoAd1": "string",
  "TransInfoAd2": "string",
  "TransInfoHt": "string",
  "IwScheduledDateType": 0,
  "IwScheduledDate": "2021-02-16T00:44:16.295Z",
  "IwDetail": [
    {
      "SkuId": 0,
      "IwScheduledQty": 0,
      "ExpireDate": "string",
      "BarcodeServiceYn": "string",
      "DeliveryCompCode": "string",
      "InvoiceNo": "string"
    }
  ]
}

 

Response Description

항목	항목명	Type	Description
ResultCode	결과코드	int	성공: 0 실패 :Error Massage 참고
Message	메시지	string
Data > RequestCount	요청건수	Int	판매자가 입고요청한 전체 건수
Data > SuccessCount	성공건수	Int	입고요청 성공한 건수
Data > SuccessList[] > WarehouseNo	[]성공한입고번호	long	입고요청 성공한 입고번호 리스트
Data > FailCount	실패건수	Int	입고요청 실패한 건수
Data > SuccessList[] > IwScheduledDate	[]성공한입고일자	DateTime	입고요청 성공한 입고의 입고예정일시
Data > FailReasons[] > WarehouseNo	[]실패한입고번호	Int	입고요청 실패한 입고번호 리스트
Data > SuccessList[] > IwDetail[] > SkuId	[]성공한SKU번호	long	입고요청 성공한 SKU번호 리스트
Data > FailReasons[] > IwScheduledDate	[]실패한입고일자	DateTime	입고요청 실패한 입고의 입고예정일시
Data > SuccessList[] > IwDetail[] > StorageDesc	[]성공한SKU번호의입고층명	string	입고요청 성공한 SKU번호의 물류센터입고층명
Data > FailReasons[] > IwDetail[] > SkuId	[]실패한SKU번호	long	입고요청 실패한 SKU번호 리스트
Data > SuccessList[] > IwDetail[] > StorageDesc	[]실패한SKU번호입고층명	string	입고요청 실패한 SKU번호의 물류센터입고층명
Data > FailReasons[] > Message	[]실패사유	string	입고요청 실패사유

JSON_Success

{
  "ResultCode": 0,
  "Message": "string",
  "Data": {
    "RequestCount": 0,
    "SuccessList": [
      {
        "WarehouseNo": 0,
        "IwScheduledDate": "2021-02-18T05:25:00.932Z",
        "IwDetail": [
          {
            "SkuId": 0,
            "StorageDesc": "string"
          }
        ]
      }
    ],
    "SuccessCount": 0,
    "FailReasons": [
      {
        "WarehouseNo": 0,
        "IwScheduledDate": "2021-02-18T05:25:00.932Z",
        "IwDetail": [
          {
            "SkuId": 0,
            "StorageDesc": "string"
          }
        ],
        "Message": "string"
      }
    ],
    "FailCount": 0
  }
}

 

Sample Code_Success

{
    "ResultCode": 0,
    "Message": "success",
    "Data": {
        "RequestCount": 1,
        "SuccessList": [
            {
                "WarehouseNo": 217779660,
                "IwScheduledDate": "2021-02-19T09:00:00+09:00",
                "IwDetail": [
                    {
                        "SkuId": 41347,
                        "StorageDesc": "스마일배송 동탄메가센터 3층 3R"
                    },
                    {
                        "SkuId": 41352,
                        "StorageDesc": "스마일배송 동탄메가센터 3층 3R"
                    }
                ]
            }
        ],
        "SuccessCount": 1,
        "FailReasons": [],
        "FailCount": 0
    }
}

 

Error Code

결과코드	메시지	원인
1400	입고방식은 필수입력 항목입니다. (1:화물입고, 2:택배입고)	IwMthdType > 입고방식 미입력 혹은 0 입력 시
1400	검수방식은 필수입력 항목입니다. (1:위탁검수, 2:직접검수)	InspectMthdType > 검수방식 미입력 혹은 0 입력 시
1400	입고명은 필수입력 항목입니다.	WarehouseName > 입고명 미입력 혹은 빈 문자열 입력 시
1400	발송처 기본주소는 필수입력 항목입니다.	TransInfoAd1 > 발송처 기본주소 미입력 혹은 빈 문자열 입력 시
1400	발송처 상세주소는 필수입력 항목입니다.	TransInfoAd2 > 발송처 기본주소 미입력 혹은 빈 문자열 입력 시
1400	발송처 담당자 연락처는 필수입력 항목입니다.	TransInfoHt > 발송처 담당자 연락처 미입력 혹은 빈 문자열 입력 시
1400	입고예정일자 입력유형은 자동선택(1), 직접입력(2)만 가능합니다.	IwScheduledDateType > 1, 2 이외의 값 입력 시
1400	입고예정일자유형이 직접입력(2)일 경우, 입고예정일자는 필수입력 항목입니다.	IwScheduledDateType = 2일 때, IwScheduledDate 미입력 시
1400	지난 일자에는 입고할 수 없습니다.	IwScheduledDate > 과거일자일 경우
1400	입고일 선택은 등록일 18:00 이전 기준 다음날부터 가능합니다.	IwScheduledDate > 입고등록 마감일자를 지났을 경우 (멀티채널 예외)
1400	주말(토,일) 및 공휴일은 입고요청 불가합니다.	IwScheduledDate > 영업일 이외 일자일 경우
1400	입고명은/는 50Byte까지만 입력 가능합니다.	WarehouseName > 입고명 50Byte 초과 시
1400	발송처 기본주소은/는 200Byte까지만 입력 가능합니다.	TransInfoAd1 > 발송처 기본주소 200Byte 초과 시
1400	발송처 상세주소은/는 200Byte까지만 입력 가능합니다.	TransInfoAd2 > 발송처 상세주소 200Byte 초과 시
1400	발송처 담당자 연락처은/는 50Byte까지만 입력 가능합니다.	TransInfoHt > 발송처 담당자 연락처 50Byte 초과 시
1400	입고방식이 유효하지 않습니다. (1:화물입고, 2:택배입고)	IwMthdType > 1, 2 이외의 값 입력 시
1400	검수방식이 유효하지 않습니다. (1:위탁검수, 2:직접검수)	InspectMthdType > 1, 2 이외의 값 입력 시
1400	택배입고는 직접검수가 불가능합니다.	IwMthdType = 2, InspectMthdType = 2 입력 시
1400	휴대폰은 '-'로 구분해서 010-0000-0000 형식으로 넣어주세요.	TransInfoHt > 발송처 담당자 연락처에 - 미포함시
1400	정확한 연락처 정보를 입력해 주세요.	TransInfoHt > 발송처 담당자 연락처가 전화번호 형식에 맞지 않을 시
1400	입고상세정보는 필수입력 항목입니다.	IwDetail > 입고상세정보가 null이거나 빈 값일 때
1400	SKU 번호가 유효하지 않습니다.	IwDetail > SkuId > SKU번호 미입력 혹은 0 입력 시
1400	입고예정수량은 0 이하를 허용하지 않으며 필수입력 항목입니다.	IwDetail > IwScheduledQty > 입고예정수량 미입력 혹은 0 이하 입력 시
1400	바코드부착서비스 여부는 필수입력 항목입니다.	IwDetail > BarcodeServiceYn > 바코드부착서비스 미입력 혹은 빈 문자열 입력 시
1400	바코드부착서비스는 부착(Y), 미부착(N)만 입력 가능합니다.	IwDetail > BarcodeServiceYn > 바코드부착서비스 Y, N 이외의 값 입력 시
1400	존재하지 않는 SKU번호입니다.	IwDetail > SkuId > 조회되지 않는 SKU번호 입력 시
1400	판매자의 SKU번호가 아닙니다.	IwDetail > SkuId > 해당판매자의 SKU번호가 아닐 경우
1400	입고 가능한 SKU 상태가 아닙니다.	IwDetail > SkuId > 입고대기/정상/품절/출고중지 상태의 SKU가 아닐 경우 (멀티채널 예외)
1400	택배입고가 아닐 경우, 중복 SKU 입력 불가입니다.	IwDetail > SkuId > 입고방식이 화물입고(1) 일 때
1400	소비기한 입력이 필수인 SKU입니다.	IwDetail > ExpireDate > 상미(소비)기한이 있는 SKU의 소비기한 미입력 시 (멀티채널 예외)
1400	소비기한 미관리 SKU는 소비기한 입력이 불가능합니다.	IwDetail > ExpireDate > 상미(소비)기한 미관리인 SKU의 소비기한 입력 시 (멀티채널 예외)
1400	센터에서 보유한 재고 포함 소비기한 갯수는 3개를 초과할 수 없습니다.	IwDetail > ExpireDate > 센터 재고 포함 동일 SKU의 소비기한이 3개를 초과할 경우 (멀티채널 예외)
1400	택배입고시 택배사코드는 필수입력 항목입니다.	IwDetail > DeliveryCompCode > 입고방식이 택배입고(2) 일 때 미입력 시
1400	택배사코드은/는 10Byte까지만 입력 가능합니다.	IwDetail > DeliveryCompCode > 제한값 초과하여 입력했을 경우
1400	유효하지 않은 택배사코드입니다. 가이드를 확인해주세요.	IwDetail > DeliveryCompCode > 지정 택배사코드 외 값 입력 시
1400	택배입고시 운송장번호는 필수입력 항목입니다.	IwDetail > InvoiceNo > 입고방식이 택배입고(2) 일 때 미입력 시
1400	운송장번호은/는 50Byte까지만 입력 가능합니다.	IwDetail > InvoiceNo > 제한값 초과하여 입력했을 경우
1400	운송장번호는 중복 입력 불가합니다.	IwDetail > DeliveryCompCode,InvoiceNo > 동일 입고요청 건에서 택배사/운송장번호 중복 건이 있을 경우
1400	택배입고 시 입고예정수량은 해당 SKU의 판매단위/입수량을 초과할 수 없습니다.	IwDetail > IwScheduledQty > 입고방식이 택배입고(2) 일 때 입고예정수량이 SKU 입수량을 초과했을 경우
1400	소비기한 잔여일이 입고예정일자 기준 입고가능한 상태가 아닙니다. 소비기한 혹은 입고예정일자를 변경해주시기 바랍니다.	입고예정일자(IwScheduledDate)와 소비기한(IwDetail > ExpireDate) 사이 잔여일이 입고제한일 미만일 경우
1400	화물입고 가능한 SKU 수를 초과하였습니다. 입고 SKU 수를 변경하거나 다른 일자를 선택해주세요.	입고수용량 초과
1400	화물입고 가능한 총 입고예정수량을 초과하였습니다. 입고예정수량을 변경하거나 다른 일자를 선택해주세요.	입고수용량 초과
1400	화물입고 가능한 SKU당 단위 입고예정수량을 초과하였습니다. 입고예정수량을 변경하거나 다른 일자를 선택해주세요.	입고수용량 초과
1400	택배입고 가능한 판매자 수를 초과하였습니다. 다른 일자를 선택해주세요.	입고수용량 초과
1400	택배입고 가능한 SKU 수를 초과하였습니다. 입고 SKU 수를 변경하거나 다른 일자를 선택해주세요.	입고수용량 초과
1400	택배입고 가능한 판매자 당 BOX 수량을 초과하였습니다. BOX 수를 변경하거나 다른 일자를 선택해주세요.	입고수용량 초과
1400	최초입고 가능한 SKU 수를 초과하였습니다. 입고 SKU 수를 변경하거나 다른 일자를 선택해주세요.	입고수용량 초과
1400	바코드부착서비스 가능한 입고예정수량을 초과하였습니다. 입고예정수량을 변경하거나 다른 일자를 선택해주세요.	입고수용량 초과
1400	현재일 기준 D+2개월 내 입고가능한 날짜가 없습니다. 입고수용량을 확인 후 입고예정수량을 변경하거나 관리자에게 문의해주시기 바랍니다.	IwScheduledDateType = 2일 때, 자동입력 가능한 입고예정일자가 없는 경우