물류카테고리 조회 API – ESM Trading API

물류카테고리 조회 API

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

Description
물류카테고리 및 카테고리별 유통기한을 조회합니다
Request Description
G마켓 or 옥션ID로 조회합니다
항목항목명필수여부TypeDescription
SearchType조회조건Yint0 : 검색어 조건 없이 전체 카테고리 조회
1: 카테고리 명
2: 카테고리 코드
SearchString검색어stringSearchType > 1 or 2일 경우 필수
조회할 검색어 입력
ExpireDateManageCode유통기한관리구분Yint카테고리 조회 시, 유통기한 관리구분에 따른 조회 가능
필수 or 선택 시 유통기한(상미기일)구간 중 택1하여 입력

ALL : 전체
1 : 유통기한 관리필수
2 : 유통기한 미관리
3 : 유통기한 관리선택
ExpireDaysLimitCode유통기한(상미기일)코드string유통기한(상미기일) 특정코드를 보유한 카테고리 조회
ALL : 전체
단일코드 입력 가능
PageIndex페이지번호YInt정수: Page 구분
PageSize페이지사이즈YInt1페이지에 출력하려는 리스트 Max값
1000까지 지원 가능
JSONSample Code
{
  "SearchType": 0,
  "SearchString": "",
  "ExpireDateManageCode": "ALL",
  "ExpireDaysLimitCode": "ALL",
  "PageIndex": 1,
  "PageSize": 100
}
{
  "SearchType": 0,
  "SearchString": "",
  "ExpireDateManageCode": "ALL",
  "ExpireDaysLimitCode": "ALL",
  "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 > ExpireDaysLimitCodeList[]유통기한(상미기일)코드리스트int해당카테고리에 설정가능한 유통기한(상미기일) 코드 리스트 내려감
Data > Data > CategoryCode물류최하위카테고리코드string조회된 물류카테고리 Leaf코드 내려감
Data > Data > CategoryLevel카테고리구분string리프카테고리가 대/중/소분류 중 무엇인지 구분값 내려감
1 : 대분류
2 : 중분류
3 : 소분류
Data > Data > CategoryName1대분류카테고리명string조회된 물류 대분류카테고리명 내려감
Data > Data > CategoryName2중분류카테고리명string조회된 물류 중분류카테고리명 내려감
Data > Data > CategoryName3소분류카테고리명string조회된 물류 소분류카테고리명 내려감
Data > Data > ExpireDateManageCode유통기한관리구분int1 : 유통기한 관리필수
2 : 유통기한 미관리
3 : 유통기한 관리선택
Data > Data > InsDate등록일자DateTime물류최하위카테고리 코드의 등록일자 내려감
Data > Data > UpdDate최종변경일자DateTime물류최하위카테고리 코드 정보의 변경일자 내려감
JSONSample Code_SuccessSample Code_Fail
{
  "ResultCode": 0,
  "Message": "",
  "Data": {
    "TotalCount": 0,
    "PageSize": 0,
    "PageIndex": 0,
    "Data": [
      {
        "ExpireDaysLimitCodeList": [
          0
        ],
        "CategoryCode": "",
        "CategoryLevel": "",
        "CategoryName1": "",
        "CategoryName2": "",
        "CategoryName3": "",
        "ExpireDateManageCode": "",
        "InsDate": "2020-05-29T00:04:03.266Z",
        "UpdDate": "2020-05-29T00:04:03.266Z"
      }
    ]
  }
}
{
    "ResultCode": 0,
    "Message": "success",
    "Data": {
        "TotalCount": 3,
        "PageSize": 3,
        "PageIndex": 1,
        "Data": [
            {
                "ExpireDaysLimitList": [
                    5
                ],
                "CategoryCode": "C001009001",
                "CategoryLevel": "3",
                "CategoryName1": "식품",
                "CategoryName2": "커피/차류",
                "CategoryName3": "커피믹스/코코아",
                "ExpireDateManageCode": "1",
                "InsDate": "2018-11-01T11:12:39.013",
                "UpdDate": "2018-11-01T11:12:39.013"
            },
            {
                "ExpireDaysLimitList": [
                    5
                ],
                "CategoryCode": "C001009002",
                "CategoryLevel": "3",
                "CategoryName1": "식품",
                "CategoryName2": "커피/차류",
                "CategoryName3": "액상차류",
                "ExpireDateManageCode": "1",
                "InsDate": "2018-11-01T11:12:39.013",
                "UpdDate": "2018-11-01T11:12:39.013"
            },
            {
                "ExpireDaysLimitList": [
                    7,
                    8
                ],
                "CategoryCode": "C001009003",
                "CategoryLevel": "3",
                "CategoryName1": "식품",
                "CategoryName2": "커피/차류",
                "CategoryName3": "녹차/홍차/티백차",
                "ExpireDateManageCode": "1",
                "InsDate": "2018-11-01T11:12:39.013",
                "UpdDate": "2018-11-01T11:12:39.013"
            }
        ]
    }



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



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