본문 바로가기
스마일배송 API/입고 | 반출

입고등록 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일 때, 자동입력 가능한 입고예정일자가 없는 경우

 

'스마일배송 API > 입고 | 반출' 카테고리의 다른 글

입고요청취소 API  (0) 2022.11.03
입고현황조회 API  (0) 2022.11.03
입고수용량조회 API  (0) 2022.11.03
반출요청 API  (0) 2022.11.03
반출요청취소 API  (0) 2022.11.03