본문 바로가기
스마일배송 API/SKU 관리

소비기한코드조회 API

Description
[POST] https://sa2.esmplus.com/efm/v1/api/service/GetExpireDaysLimitList
소비기한(상미기일)구간코드를 조회합니다.
변경일자 조회시 시작일 없이 종료일까지 조회할 경우 해당 일자까지의 최종데이터 조회되며
변경일자 구간으로 조회 시 해당 구간 내 변경된 이력만 조회됩니다.

 

Request Description

항목 항목명 필수여부 Type Description
ExpireDateManageCode 소비기한관리구분 Y int 카테고리 조회 시, 소비기한 관리구분에 따른 조회 가능
필수 or 선택 시 소비기한(상미기일)구간 중 택1하여 입력

ALL : 전체
1 : 소비기한 관리필수
2 : 소비기한 미관리
3 : 소비기한 관리선택
ExpireDaysLimitCode 소비기한(상미기일)코드   string 소비기한(상미기일) 특정코드를 보유한 카테고리 조회
ALL : 전체
단일코드 입력 가능
StartDate 변경일자 조회시작일   DateTime UpdDate의 조회 시작일 입력
EndDate 변경일자 조회종료일   DateTime UpdDate의 조회 종료일 입력
PageIndex 페이지번호 Y Int 정수: Page 구분
PageSize 페이지사이즈 Y Int 1페이지에 출력하려는 리스트 Max값
1000까지 지원 가능
JSON
{
  "ExpireDateManageCode": "ALL",
  "ExpireDaysLimitCode": "ALL",
  "StartDate": "2020-07-01T07:18:20.784Z",
  "EndDate": "2020-07-01T07:18:20.784Z",
  "PageIndex": 1,
  "PageSize": 100
}

 

Response Description

항목 항목명 Type Description
ResultCode 결과코드 int 성공: 0
실패 :Error Massage 참고
Message 메시지 string  
Data Data string  
Data > TotalCount 전체대상건수 int 조회조건 범위 전체 건수
Data > PageIndex Response PageNo int 조회시 입력한 PageNo
Data > PageSize Response PageSize Int 조회시 입력한 PageSize
Data > Data > ExpireDaysLimitCode 소비기한(상미기일)구간코드 int 해당카테고리에 설정가능한 소비기한(상미기일) 코드 내려감
Data > Data > ExpireDateManageCode 소비기한관리구분 int 1 : 소비기한 관리필수
2 : 소비기한 미관리
3 : 소비기한 관리선택
Data > Data > InsDate 등록일자 DateTime 소비기한(상미기일)코드의 등록일자 내려감
Data > Data > ExpireDateLimitName 소비기한(상미기일)명 string 소비기한(상미기일)명 내려감
Data > Data > UpdDate 최종변경일자 DateTime 소비기한(상미기일)코드 최종변경일자 내려감
Data > Data > ExpireDaysMax 소비기한(상미기일)최대일 int 소비기한(상미기일)코드의 최대일값 내려감
Data > Data > ExpireDaysMin 소비기한(상미기일)최소일 int 소비기한(상미기일)코드의 최소일값 내려감
Data > Data > IwLimitDay 입고제한일 int 소비기한(상미기일)코드의 입고제한일 내려감
Data > Data > OwLimitDay 출고제한일 int 소비기한(상미기일)코드의 출고제한일 내려감

 JSON_Success

{
  "ResultCode": 0,
  "Message": "",
  "Data": {
    "TotalCount": 0,
    "PageSize": 0,
    "PageIndex": 0,
    "Data": [
      {
        "ExpireDateManageCode": "",
        "ExpireDateLimitCode": 0,
        "ExpireDateLimitName": "",
        "ExpireDaysMax": 0,
        "ExpireDaysMin": 0,
        "IwLimitDay": 0,
        "OwLimitDay": 0,
        "InsDate": "2020-05-26T07:35:24.348Z",
        "UpdDate": "2020-05-26T07:35:24.348Z"
      }
    ]
  }
}

JSON_Fail

{
    "ResultCode": int,
    "Message": "string",
    "Data": null
}

Sample Code_Success

{
    "ResultCode": 0,
    "Message": "success",
    "Data": {
        "TotalCount": 1,
        "PageSize": 1,
        "PageIndex": 1,
        "Data": [
            {
                "ExpireDateManageCode": "3",
                "ExpireDateLimitCode": 10,
                "ExpireDateLimitName": "1년 6개월이상",
                "ExpireDaysMax": 9999,
                "ExpireDaysMin": 546,
                "IwLimitDay": 60,
                "OwLimitDay": 30,
                "InsDate": "2019-01-23T13:41:27.513",
                "UpdDate": "2020-03-09T12:51:54.323"
            }
        ]
    }
}

Sample Code_Fail

{
    "ResultCode": 1400,
    "Message": "소비기한관리구분은 전체(ALL), 필수(1), 미관리(2), 선택(3) 중에서만 조회 가능합니다.",
    "Data": null
}

 

Error Code

결과코드 메시지 원인
1400 소비기한관리구분은 전체(ALL), 필수(1), 미관리(2), 선택(3) 중에서만 조회 가능합니다. ExpireDaysLimitCode > 유효하지 않은 값 입력 시
1400 PageIndex는 1 이상이어야 합니다. Pageindex > 미입력 시
1400 PageSize는 1 이상이어야 합니다. PageSize > 미입력 시

 

'스마일배송 API > SKU 관리' 카테고리의 다른 글

SKU조회 API  (0) 2022.11.03
SKU상태변경 API  (0) 2022.11.03
SKU삭제 API  (0) 2022.11.03
SKU재고현황조회 API  (0) 2022.11.03
물류카테고리 조회 API  (0) 2022.10.07