SKU등록/수정 API – ESM Trading API

SKU등록/수정 API

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

Description
SKU 정보를 등록/수정합니다.
Request Description
G마켓 or 옥션ID로 조회합니다
항목항목명필수여부TypeDescription
SkuIdSKU코드long기 등록된 SKU 정보 수정할 경우에만 필수입력
SkuTitleSKU타이틀YstringAPI로 SKU등록 시, [브랜드명]제조사명/SKU타이틀/중량/색상/모델명 각 항목별로 데이터 받은 후 Back에서 조합하여 SKU명으로 관리함
최대 20byte까지 등록가능하며, 전체 조합된 SKU명은 50byte까지 등록
조합 시, 분리된 데이터 표시를 위해 "/"로 구분하여 등록됨
Color색상stringSKU의 색상 입력
ModelName모델명string SKU의 모델명 입력
WeightText중량stringSKU의 중량 입력
BrandNo브랜드코드int상품API > 브랜드코드 조회 API로 조회한 브랜드코드 입력
바코드 등록한 경우, 바코드에 해당되는 브랜드코드 자동으로 우선 매칭됨
MakerNo제조사코드int상품API > 브랜드코드 조회 API로 조회한 제조사코드 입력
RepBarcode바코드stringSKU의 바코드 입력(실제 제품 표시된 바코드와 동일해야함)
숫자 또는 영문 최대 40byte까지 입력
바코드 중복 등록 및 수정불가
바코드 신규생성 요청할 경우 등록 시 "0"으로 입력하고, 등록 후 SKU조회 API에서 채번된 바코드정보 ('5891~)로 입력하여 수정

13/14자리 숫자 바코드는 EAN 공인바코드가 아닐 경우 SKU입고 불가할 수 있음
판매단위 '박스'일 경우 14자리 바코드 입력 필요
CategoryCode물류최하위카테고리코드Ystring물류 Leaf 카테고리 코드 입력
물류카테고리 조회 API를 통해 등록 가능한 전체 카테고리 코드 조회 가능
ExpireDaysLimitCode상미(유통)기일구간코드Yint카테고리별 유통기한에 따른 유효한 코드만 입력 가능
카테고리별 유통기한 조회 API를 통해 입력 가능한 값 조회 가능

-1: 자동입력(해당 카테고리의 최소상미기일 구간으로 자동 등록됨)
0: 미관리
1~:상미기일구간코드
ExpireDateDays상미(유통)기간int상미(유통)기일구간 '필수' 카테고리의 경우 필수입력
상미기일(유통기한) API에서 조회된 유통기한 코드 숫자 입력

카테고리 따른 유통기한(상미기일) 유효성 체크
-1 : 자동입력
0 : 미관리
상미기일(유통기한) 제조일로부터 N일 입력
최대 9999일까지 입력 가능
SkuSupplyPriceSKU공급원가Ydecimal10원 이상부터 숫자입력
-1 입력 시, SKU공급원가 미관리로 분류
WidthSKU 체적가로(cm)Ydecimal숫자만 입력
최대 삼변합(가로+세로+높이) 140cm까지, 중량 20,000g까지 입력 가능
VerticalSKU 체적세로(cm)Ydecimal숫자만 입력
최대 삼변합(가로+세로+높이) 140cm까지, 중량 20,000g까지 입력 가능
HeightSKU 체적높이(cm)Ydecimal숫자만 입력
최대 삼변합(가로+세로+높이) 140cm까지, 중량 20,000g까지 입력 가능
WeightSKU 체적중량(g)Ydecimal숫자만 입력
최대 삼변합(가로+세로+높이) 140cm까지, 중량 20,000g까지 입력 가능
OwUnitCode판매단위Yshort실제 출고될 판매단위 입력
4 : 낱개
14 : 팩
12 : 박스
OwUnitQty판매단위 입수량Yint판매단위 낱개 / 팩 선택 시, 박스당 입수량 숫자입력
최대 100000이하까지 입력가능
박스일 경우 1 고정 필수입력
EaQty낱개당 입수량int판매단위가 낱개일 경우, 박스 or 팩 안에 낱개가 몇 개가 들어가는지 입력
최대 100000이하까지 입력가능
박스일 경우 1 고정 필수입력
해당 SKU가 낱개일 경우, OwUnitQty와 동일값
PackQty팩입수량int판매단위가 팩일 경우, 박스 안에 몇 개가 들어가는지 입력
최대 100000이하까지 입력가능
박스일 경우 1 고정 필수입력
해당 SKU가 팩일 경우, OwUnitQty와 동일값
SkuUrl추가정보URLYstringSKU검수 시, 내부 관리자가 세부정보 확인가능한 URL입력
http://~ full URL 입력
http, https, ftp, mms 까지 허용
SkuDescSKU상세설명stringSKU 세부설명 Text로 입력
최대 300byte까지 입력
SkuManageCodeSKU관리코드Ystring최대 50byte까지 등록
StockNo상품관리코드(제품StockNo)Ystring영문/숫자만 가능하며 최대 100byte까지 등록
ESM의 "제품 stockNo"에 해당
중복여부 체크하며, 중복 값은 등록 불가함
FreeGiftYn사은품여부Ystring해당 SKU가 사은품인지 본품인지 여부 입력
Y : 사은품
N : 본품
JSONSample Code 1
{
  "SkuId": 0,
  "SkuTitle": "",
  "Color": "",
  "ModelName": "",
  "WeightText": "",
  "BrandNo": 0,
  "MakerNo": 0,
  "RepBarcode": "",
  "CategoryCode": "",
  "ExpireDaysLimitCode": 0,
  "ExpireDateDays": 0,
  "SkuSupplyPrice": 0,
  "OwUnitCode": 0,
  "OwUnitQty": 0,
  "EaQty": 0,
  "PackQty": 0,
  "Width": 0,
  "Vertical": 0,
  "Height": 0,
  "Weight": 0,
  "SkuUrl": "",
  "SkuDesc": "",
  "SkuManageCode": "",
  "StockNo": "",
  "FreeGiftYn": "N"
}


{
  "SkuId": 0,
  "SkuTitle": "SKU타이틀",
  "Color": "레드",
  "ModelName": "AQ14",
  "WeightText": "2매",
  "BrandNo": 1234,
  "MakerNo": 0,
  "RepBarcode": "0",
  "CategoryCode": "C001001001",
  "ExpireDaysLimitCode": -1,
  "ExpireDateDays": -1,
  "SkuSupplyPrice": 3000,
  "OwUnitCode": 12,
  "OwUnitQty": 1,
  "EaQty": 10,
  "PackQty": 1,
  "Width": 100,
  "Vertical": 11,
  "Height": 12,
  "Weight": 3,
  "SkuUrl": "http://item.gmarket.co.kr/Item?goodscode=",
  "SkuDesc": "SKU상세설명을 입력합니다",
  "SkuManageCode": "12345",
  "StockNo": "AAAA12345",
  "FreeGiftYn": "N"
}

Response Description
항목항목명TypeDescription
ResultCode 결과코드 int 성공: 0
실패 :Error Massage 참고
Message 메시지 string
Data Data string
Data > SkuIdSKU코드string 생성된 SkuId Return
JSONSample Code_Fail
{
  "ResultCode": 0,
  "Message": "",
  "Data": {
    "SkuId": 0
  }
}




[su_tab title="Sample Code_Success" disable="no" anchor="" url="" target="black" class=""]
[json]
{
    "ResultCode": 0,
    "Message": "success",
    "Data": {
        "SkuId": 42032
    }
}



{
    "ResultCode": 1400,
    "Message": "이미 존재하는 상품관리코드 입니다. : AAAA12345",
    "Data": null
}



Error Code
결과코드메시지원인
1400유효하지 않은 SKU입니다.SkuId > 입력한 상품관리코드가 존재하지 않는 SKU일 경우
1400제품StockNo은/는 100Byte까지만 입력 가능합니다. 입력값:{입력값} 길이:{입력길이N}StockNo > 100byte이상 입력 시도할 경우
1400이미 존재하는 상품관리코드 입니다. 입력값 : {입력값}StockNo > 중복된 값 입력 시도할 경우
1400제품StockNo는 필수입력 항목입니다StockNo > 미입력할 경우
1400상품관리코드는 영문과 숫자만 입력가능 합니다. 입력값 : {입력값}StockNo > 제한된 문자 입력할 경우
1400SKU명은/는 50Byte까지만 입력 가능합니다. 입력값:{입력값} 길이:{입력길이N}SkuTitle > 50byte이상 입력 시도할 경우
1400SKU타이틀은 필수입력 항목입니다.SkuTitle > 미입력할 경우
1400SKU명은 특수문자 입력이 불가합니다. 입력값 : {입력값}SkuName > 특수문자 입력할 경우
1400브랜드코드는 숫자만 입력 가능합니다. 입력값:{입력값}BrandNo > 빈 값 등록할 경우
1400잘못된 브랜드 아이디가 있습니다. [입력값]BrandNo > 존재하지 않는 값 등록할 경우
1400검수 이후 브랜드은(는) 변경할 수 없습니다. (현재값 : {현재값}, 입력값 : {입력값})BrandNo > 검수된 SKU의 브랜드 수정하려고 시도하는 경우
1400잘못된 제조사 아이디가 있습니다. [입력값]MakerNo > 존재하지 않는 값 등록할 경우
1400제조사코드는 숫자만 입력 가능합니다. 입력값:{입력값}MakerNo > 빈 값 등록할 경우
1400SKU 등록 후 바코드은(는) 변경할 수 없습니다. (현재값 : {SKU등록값}, 입력값 : {변경시도값})RepBarcode > 정보 변경 시도할 경우
1400[바코드] 동일한 바코드로 등록된 SKU(SKU번호)가 이미 존재합니다. 입력값 : {입력값}RepBarcode > 동일한 바코드로 등록 시도할 경우
1400바코드는 필수입력 항목입니다.RepBarcode > 미입력 할 경우
1400[바코드] 유효하지 않은 바코드 입니다. 입력값 : {입력값}RepBarcode > 유효하지 않은 값 입력할 경우
1400[바코드] '5891'로 시작하는 바코드는 등록하실 수 없습니다. 입력값 : {입력값}RepBarcode > 5891로 시작하는 바코드로 등록 시도할 경우
1400물류카테고리코드 오류입니다. 정확한 물류카테고리코드를 등록해주세요. 입력값 : {입력값}CategoryCode > 유효하지 않은 값 입력할 경우
1400물류카테고리코드는 필수입력 항목입니다.CategoryCode > 미입력 할 경우
1400공급원가는 최소 10원입니다. 관리하지 않을 경우(사은품 등) -1로 입력해주세요. 입력값 : {입력값}SkuSupplyPrice > 빈값 or 10원 미만으로 등록할 경우
1400상미기일구간이 자동(-1)일 경우 상미(유통)기간은 자동입력(-1)만 가능합니다. 입력값 : {입력값}ExpireDaysLimitCode > ExpireDateDays -1(자동입력)값으로 등록 후 특정날짜 입력할 경우, 해당 케이스는 -1만 등록 가능
1400상미기일구간 필수 카테고리입니다. 자동(-1) 혹은 상미기일구간을 선택해주세요.ExpireDaysLimitCode > 유통기한 필수카테고리인데 0 입력할 경우
1400선택할 수 없는 상미기일구간입니다. [현재입력카테고리코드] 카테고리는 3(6개월), 4(9개월) 중 선택 가능합니다. 입력값 : {입력값}ExpireDaysLimitCode > 카테고리별 유통기한 조회 API에서 조회된 코드 이외의 코드 연동할 경우
1400상미기일구간은 숫자만 입력 가능합니다. 입력값 : {입력값}ExpireDaysLimitCode > 문자입력할 경우
1400SKU 등록 후 판매단위은(는) 변경할 수 없습니다. (현재값 : {SKU등록값}, 입력값 : {변경시도값})OwUnitCode > 정보 변경 시도할 경우
1400판매단위는 필수입력 항목입니다. (4:낱개, 14:팩, 12:박스)OwUnitCode > 미입력할 경우
1400판매단위가 유효하지 않습니다. (4:낱개, 14:팩, 12:박스) 입력값 : {입력값}OwUnitCode > 유효하지 않은값 입력할 경우
1400판매단위가 박스일 경우, 판매단위 입수량(박스당 입수량)은 1만 가능합니다. 입력값 : {입력값}OwUnitQty > 판매단위 박스일 경우, 1 외 값 입력 시도할 경우
1400입수량은 0 이하를 허용하지 않으며 필수입력 항목입니다.OwUnitQty > 미입력 or 0 or 음수 입력할 경우
1400SKU 등록 후 낱개입수량은(는) 변경할 수 없습니다. (현재값 : {SKU등록값}, 입력값 : {변경시도값})EaQty > 정보 변경 시도할 경우
1400URL 형식이 아닙니다. 입력값 : {입력값}SkuUrl > http, https, ftp, mms 외의 문자로 시작
1400SKU 상세설명은/는 300Byte까지만 입력 가능합니다. 입력값 : {입력값} 길이 : {N}SkuDesc > 제한값 초과하여 입력했을 경우
1400SKU관리코드은/는 50Byte까지만 입력 가능합니다. 입력값 : {입력값} 길이 : {N}SkuManageCode > 제한값 초과하여 입력했을 경우
1400SKU 등록 후 팩입수량은(는) 변경할 수 없습니다. (현재값 : {SKU등록값}, 입력값 : {변경시도값})PackQty > 정보 변경 시도할 경우
1400SKU 등록 후 체적 가로은(는) 변경할 수 없습니다. (현재값 : {SKU등록값}, 입력값 : {변경시도값})Width > 정보 변경 시도할 경우
1400[체적] 가로는 0 이하를 허용하지 않으며 필수입력 항목입니다.Width > 미입력 or 0 or 음수 입력할 경우
1400SKU 등록 후 체적 세로은(는) 변경할 수 없습니다. (현재값 : {SKU등록값}, 입력값 : {변경시도값})Vertical > 정보 변경 시도할 경우
1400[체적] 세로는 0 이하를 허용하지 않으며 필수입력 항목입니다.Vertical > 미입력 or 0 or 음수 입력할 경우
1400SKU 등록 후 체적 높이은(는) 변경할 수 없습니다. (현재값 : {SKU등록값}, 입력값 : {변경시도값})Height > 정보 변경 시도할 경우
1400[체적] 높이는 0 이하를 허용하지 않으며 필수입력 항목입니다.Height > 미입력 or 0 or 음수 입력할 경우
1400[체적] 최대 '가로+세로+높이'= 삼변합 140(cm)까지의 상품만 가능합니다.Width+Vertical+Height > 삼변함 제한값 넘을 경우
1400SKU 등록 후 체적 중량은(는) 변경할 수 없습니다. (현재값 : {SKU등록값}, 입력값 : {변경시도값})Weight > 정보 변경 시도할 경우
1400[체적] 중량은 20,000g(=20kg) 까지의 상품만 가능합니다.Weight > 제한값 초과하여 입력할 경우
1400[체적] 중량은 0 이하를 허용하지 않으며 필수입력 항목입니다.Weight > 미입력 or 0 or 음수 입력할 경우
1400상미기일구간이 자동(-1)일 경우 상미(유통)기간은 자동입력(-1)만 가능합니다.ExpireDateDays > 상미기일구간을 자동입력으로 설정했는데, 특정 날짜 입력 시도할 경우
1400[유통기한 미관리] 상미(유통)기간은 미관리(0)로만 혹은 자동(-1)으로만 입력 가능합니다. 입력값 : {입력값}ExpireDateDays > 상미기일구간을 미관리로 설정했는데, 특정 날짜 입력 시도할 경우
1400사은품여부는 사은품(Y), 일반상품(N)만 입력 가능합니다. 입력값 : {입력값}FreeGiftYn > 소문자 or 허용하지 않는 문자 입력할 경우