SKU조회 API – ESM Trading API

SKU조회 API

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

Description
판매자가 등록한 SKU 정보를 조회합니다
Request Description
G마켓 or 옥션ID로 조회합니다
항목항목명필수여부TypeDescription
SkuStatusCodeSKU상태YstringALL : 전체
SN100 : 정상
ST200 : 품절
ST299 : 출고중지
SI302 : 입고대기
SI300 : 검수대기
SI301 : 검수거부
SkuStockRatioStatusCode재고상태Ystring현재는 ALL 전체만 제공하며 나머지 항목 필터는 추후 제공예정

ALL :전체
ENOUGH : 충분
REFILL : 재고보충
SOON-SOLDOUT : 소진임박
SOLDOUT : 품절
LT-SOLDOUT : 장기품절
INACTIVITY : 부진
ETC : 기타
GoodsRegYneBay상품등록여부YstringALL : 전체
Y : SKU매칭상품 등록되어있음
N : SKU매칭상품 미등록
SearchTypeSKU검색조건YstringALL : 검색조건제한없이 모든 SKU조회
SKU_ID : SKU번호검색
BARCODE : SKU바코드검색
INS_DATE : 등록일날짜로조회
Upd_Date : 수정날짜로조회
SearchString검색어StringSKU검색조건 > SKU_ID or BARCODE 값일 경우 필수
조회하고자 하는 SKU 정보 입력
StartDate조회시작일자Date-TimeSKU검색조건 > INS_DATE or Upd_Date 값일 경우 필수
EndDate조회종료일자Date-TimeSKU검색조건 > INS_DATE or Upd_Date 값일 경우 필수
pageIndex페이지번호YInt정수: Page 구분
pageSize페이지사이즈YInt1페이지에 출력하려는 리스트 Max값
1000까지 지원 가능
JSONSample Code 1
{
  "SkuStatusCode": "string",
  "SkuStockRatioStatusCode": "string",
  "GoodsRegYn": "string",
  "SearchType": "string",
  "SearchString": "string",
  "StartDate": "2020-01-15T05:47:42.958Z",
  "EndDate": "2020-01-15T05:47:42.958Z",
  "PageIndex": 0,
  "PageSize": 0
}

{
  "SkuStatusCode": "ALL",
  "SkuStockRatioStatusCode": "ALL",
  "GoodsRegYn": "Y",
  "SearchType": "INS_DATE",
  "SearchString": "",
  "StartDate": "2020-01-01T00:00:00.000Z",
  "EndDate": "2020-01-15T23:59:59.999Z",
  "PageIndex": 1,
  "PageSize": 100
}

Response Description
항목항목명TypeDescription
ResultCode결과코드int성공: 0
실패 :Error Massage 참고
Message메시지string
Data > TotalCount전체대상건수Int조회조건 범위 전체 건수
Data > PageIndexResponse PageNoInt조회시 입력한 PageNo
Data > Data > SkuIdSKU번호StringeBay에서 채번한 SKU번호 내려감
Data > PageSizeResponse PageSizeInt조회시 입력한 PageSize
Data > Data > FreeGiftYn사은품여부IntY : 사은품
N : 본품
Data > Data > SkuNameSKU명string최대 50byte로, 판매자가 입력한 SKU명 내려감
Data > Data > StockNo상품관리코드(제품StockNo)string최대 100byte로, 판매자가 입력한 제품StockNo 내려감
EFM의 "제품StockNo" 항목
1P 등 SKU와 상품이 1:1 매칭되는 경우 상품을 관리하기 코드로 사용가능
SKU등록/수정 시, 중복체크 대상
Data > Data > SkuManageCodeSKU관리코드string최대 50byte로, 판매자가 입력한 SKU관리코드 내려감
EFM의 "관리코드"항목
Data > Data > OwUnitCode판매단위string판매자가 입력한 해당 SKU의 판매단위 내려감
4 : 낱개
14 : 팩
12 : 박스
Data > Data > OwUnitQty판매단위 입수량string판매자가 입력한 해당 판매단위의 입수량
Data > Data > EaQty낱개당 입수량Int판매자가 입력한 낱개당 입수량 내려감
Data > Data > PackQty팩입수량Int판매자가 입력한 팩당 입수량 내려감
Data > Data > BoxQty박스입수량Int판매자가 입력한 박스당 입수량 내려감
Data > Data > BundleType합포장여부string센터에서 검수 후, 해당 SKU 합포장 가능여부 내려감
B:합포장가능
I:합포장불가능
Data > Data > PackingNeedYn재포장여부string센터에서 검수 후, 해당 SKU 재포장 필요여부 내려감
Y: 재포장필요
N: 재포장불필요
Data > Data > ExpireDateDays상미(유통)기간string판매자가 입력한 해당 SKU의 상미(유통)기간 내려감
Data > Data > VolumnGradeCode체적등급stringeBay에서 지정한 체적등급 내려감
Data > Data > TplKeepGradeCode전월보관등급stringeBay에서 지정한 전월보관등급 내려감
Data > Data > DailyTplKeepGradeCode당월보관등급stringeBay에서 지정한 당월보관등급 내려감
Data > Data > InsDate등록일시Date-TimeYYYY-MM-DD hh:mm:ss 형식
Data > Data > UpdDate수정일시Date-TimeYYYY-MM-DD hh:mm:ss 형식
Data > Data > GoodsRegYneBay상품등록여부stringY : SKU매칭상품 등록되어있음
N : SKU매칭상품 미등록
Data > Data > BrandName브랜드명stringSKU등록시 브랜드코드입력한 브랜드의 브랜드 국문명 내려감
Data > Data > MakerName제조사명stringSKU등록시 제조사코드입력한 제조사 국문명 내려감
Data > Data > RepBarcode바코드string판매자가 입력했거나 판매자가 신청해서 eBay에서 채번한 바코드번호 내려감
Data > Data > SkuSupplyPriceSKU공급원가number-1: 미관리
정수 : 공급원가
Data > Data > CategoryCode물류최하위카테고리코드stringSKU등록된 물류카테고리 Leaf코드 내려감
Data > Data > CategoryCode1물류대분류카테고리코드stringSKU등록된 물류대분류 카테고리코드 내려감
Data > Data > CategoryCode2물류중분류카테고리코드stringSKU등록된 물류중분류 카테고리코드 내려감
Data > Data > CategoryCode3물류최하위카테고리코드stringSKU등록된 물류최하위 카테고리코드 내려감
Data > Data > CategoryName1대분류카테고리명stringSKU등록된 물류 대분류카테고리명 내려감
Data > Data > CategoryName2중분류카테고리명stringSKU등록된 물류 중분류카테고리명 내려감
Data > Data > CategoryName3소분류카테고리명stringSKU등록된 물류 소분류카테고리명 내려감
Data > Data > SkuStatusCodeSKU상태stringSN100 : 정상
ST200 : 품절
ST299 : 출고중지
SI302 : 입고대기
SI300 : 검수대기
SI301 : 검수거부
Data > Data > SkuStockRatioStatusCode 재고상태string추후 제공예정으로 현재 제공하지 않음
ENOUGH : 충분
REFILL : 재고보충
SOON-SOLDOUT : 소진임박
SOLDOUT : 품절
LT-SOLDOUT : 장기품절
INACTIVITY : 부진
ETC : 기타
JSONSample Code
{
  "ResultCode": 0,
  "Message": "string",
  "Data": {
    "TotalCount": 0,
    "PageSize": 0,
    "PageIndex": 0,
    "Data": [
      {
        "SkuId": 0,
        "SkuName": "string",
        "ItemManageCode": "string",
        "OwUnitCode": "string",
        "OwUnitQty": "string",
        "BundleType": "string",
        "PackingNeedYn": "string",
        "ExpireDateDays": "string",
        "VolumnGradeCode": "string",
        "TplKeepGradeCode": "string",
        "DailyTplKeepGradeCode": "string",
        "InsDate": "2020-02-19T23:55:13.375Z",
        "UpdDate": "2020-02-19T23:55:13.375Z",
        "GoodsRegYn": "string",
        "BrandName": "string",
        "MakerName": "string",
        "RepBarcode": "string",
        "SkuSupplyPrice": 0,
        "CategoryCode": "string",
        "CategoryCode1": "string",
        "CategoryCode2": "string",
        "CategoryCode3": "string",
        "CategoryName1": "string",
        "CategoryName2": "string",
        "CategoryName3": "string",
        "SkuStatusCode": "string",
        "EaQty": 0,
        "PackQty": 0,
        "BoxQty": 0,
        "StockNo": "string",
        "SkuStockRatioStatusCode": "string",
        "FreeGiftYn": "string"
      }
    ]
  }
}
{
    "ResultCode": 0,
    "Message": "success",
    "Data": {
        "TotalCount": 56,
        "PageSize": 100,
        "PageIndex": 1,
        "Data": [
            {
                "SkuId": 38733,
                "SkuName": "SKU명",
                "ItemManageCode": null,
                "OwUnitCode": "4",
                "OwUnitQty": "10",
                "BundleType": "B",
                "PackingNeedYn": "Y",
                "ExpireDateDays": "0",
                "VolumnGradeCode": "C",
                "TplKeepGradeCode": "D",
                "DailyTplKeepGradeCode": null,
                "InsDate": "2017-12-01T13:03:59.113",
                "UpdDate": "2020-01-23T10:37:55.917",
                "GoodsRegYn": "Y",
                "BrandName": null,
                "MakerName": null,
                "RepBarcode": "11111111111111",
                "SkuSupplyPrice": -1.0000,
                "CategoryCode": "C003005003",
                "CategoryCode1": "C003000000",
                "CategoryCode2": "C003005000",
                "CategoryCode3": "C003005003",
                "CategoryName1": "리빙/건강/반려동물",
                "CategoryName2": "제지류",
                "CategoryName3": "화장지/키친타올/기타",
                "SkuStatusCode": "ST299",
                "EaQty": 10,
                "PackQty": null,
                "BoxQty": 1,
                "StockNo": null,
                "SkuStockRatioStatusCode": null,
                "FreeGiftYn": null
                }
             ]
         }
}



Error Code
결과코드메시지원인
1400검색조건 입력 시 SKU번호(SKU_ID), 바코드(BARCODE), 등록일(INS_DATE), 수정일(UPD_DATE)만 유효합니다.SearchType > 유효하지 않은 값 입력 시
1400조회일자를 확인해주세요. 종료일자는 시작일자보다 과거일 수 없습니다.EndDate > 종료일자가 시작일자보다 과거일 경우