유통기한코드조회 API – ESM Trading API

유통기한코드조회 API

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

Description
유통기한(상미기일)구간코드를 조회합니다<br>변경일자 조회 시, 시작일 없이 종료일까지 조회할 경우 해당 일자까지의 최종데이터 조회되며, 변경일자 구간으로 조회 시 해당 구간 내 변경된 이력만 조회됩니다
Request Description
G마켓 or 옥션ID로 조회합니다
항목항목명필수여부TypeDescription
ExpireDateManageCode유통기한관리구분Yint카테고리 조회 시, 유통기한 관리구분에 따른 조회 가능
필수 or 선택 시 유통기한(상미기일)구간 중 택1하여 입력

ALL : 전체
1 : 유통기한 관리필수
2 : 유통기한 미관리
3 : 유통기한 관리선택
ExpireDaysLimitCode유통기한(상미기일)코드string유통기한(상미기일) 특정코드를 보유한 카테고리 조회
ALL : 전체
단일코드 입력 가능
StartDate변경일자 조회시작일DateTimeUpdDate의 조회 시작일 입력
EndDate변경일자 조회종료일DateTimeUpdDate의 조회 종료일 입력
PageIndex페이지번호YInt정수: Page 구분
PageSize페이지사이즈YInt1페이지에 출력하려는 리스트 Max값
1000까지 지원 가능
JSONSample Code
{
  "ExpireDateManageCode": "ALL",
  "ExpireDaysLimitCode": "ALL",
  "StartDate": "2020-07-01T07:18:20.784Z",
  "EndDate": "2020-07-01T07:18:20.784Z",
  "PageIndex": 1,
  "PageSize": 100
}
{
  "ExpireDateManageCode": "ALL",
  "ExpireDaysLimitCode": "ALL",
  "StartDate": "2020-07-01T07:18:20.784Z",
  "EndDate": "2020-07-01T07:18:20.784Z",
  "PageIndex": 1,
  "PageSize": 100
}
Response Description
항목항목명TypeDescription
ResultCode 결과코드 int 성공: 0
실패 :Error Massage 참고
Message 메시지 string
Data Data string
Data > TotalCount전체대상건수int조회조건 범위 전체 건수
Data > PageIndexResponse PageNoint조회시 입력한 PageNo
Data > PageSizeResponse PageSizeInt조회시 입력한 PageSize
Data > Data > ExpireDaysLimitCode유통기한(상미기일)구간코드int해당카테고리에 설정가능한 유통기한(상미기일) 코드 내려감
Data > Data > ExpireDateManageCode유통기한관리구분int1 : 유통기한 관리필수
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유통기한(상미기일)코드의 출고제한일 내려감
JSONSample Code_SuccessSample Code_Fail
{
  "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"
      }
    ]
  }
}

{
    "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"
            }
        ]
    }
}


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



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