본문 바로가기
스마일배송 API/상품 등록, 수정

스마일배송(3PL) 상품 등록/수정/조회 API

 

Description
상품등록 : [POST] https://sa2.esmplus.com/item/v1/goods
상품수정 : [PUT] https://sa2.esmplus.com/item/v1/goods/{goodsNo}
상품조회 : [GET] https://sa2.esmplus.com/item/v1/goods/{goodsNo}
G마켓/옥션 2.0 스마일배송 상품을 등록합니다.
상품등록 성공시 바로 판매 가능한 상태로 진행되고, 실패시 실패 사유에 따라 정보 확인 및 수정 통해 재등록 필요합니다.

상품이 등록되면 일괄 수정으로 수정 진행할 수 있고 기능별 수정 API를 사용하여 부분 정보 수정이 가능합니다.

수정 API는 전체 정보 일괄 수정할 경우에만 사용하도록 하고 그 외는 기능별 수정 가능한 Partial API로 각 정보를 수정합니다.

Request Description

항목 항목명 필수여부 Type Description
itemBasicInfo > goodsName > eng 영문상품명   string 다국어 상품명은 검색용, 프로모션용 상품명 구분없이 100byte까지 입력 가능
itemBasicInfo > goodsName > chi 중문상품명   string 다국어 상품명은 검색용, 프로모션용 상품명 구분없이 100byte까지 입력 가능
itemBasicInfo > goodsName > jpn 일문상품명   string 다국어 상품명은 검색용, 프로모션용 상품명 구분없이 100byte까지 입력 가능
itemBasicInfo > goodsName > kor 검색용 국문상품명 Y Stirng 구매자에게 ESM브랜드명 + 검색용 상품명 + 프로모션용 상품명순으로 노출됨
검색용 + 프로모션용 최대 50byte까지 입력 가능하며 ESM브랜드는 입력글자수 제한에 미포함됨
검색용 상품명은 10 이내 판매이력이 없을 경우만 수정 가능하고 이후에는 수정 불가함
itemBasicInfo > goodsName > promotion 프로모션용 국문상품명   string  
itemBasicInfo > category > site >siteType G마켓/옥션 카테고리 사이트구분 Y int G마켓/옥션 카테고리 등록을 위한 사이트 선택
1.
옥션
2. G
마켓
itemBasicInfo > category > site > catCode G마켓/옥션 카테고리코드 Y int G마켓/옥션에서 제공하는 최하위(Leaf)카테고리 코드 등록
*G
마켓/옥션 카테고리 조회 API 참고
itemBasicInfo > category > shop > siteType 미니샵 카테고리 사이트구분   int 미니샵 카테고리 등록을 위한 사이트 선택
미니샵 카테고리 세팅은 ESM에서 판매자가 설정 가능하고 API 미니샵 카테고리 지정 반영됨
1.
옥션
2. G
마켓
itemBasicInfo > category > shop > largeCatCode 미니샵 대카테고리코드   int 미니샵 대카테고리 코드 등록
*
미니샵 카테고리 조회 API 참고
itemBasicInfo > category > shop > middleCatCode 미니샵 중카테고리코드   int 미니샵 중카테고리 코드 등록
*
미니샵 카테고리 조회 API 참고
itemBasicInfo > category > shop > smallCatCode 미니샵 소카테고리코드   int 미니샵 소카테고리 코드 등록
*
미니샵 카테고리 조회 API 참고
itemBasicInfo > category > esm > catCode ESM 카테고리 코드 Y int ESM 카테고리 코드 등록
* ESM
카테고리 조회 API 참고
itemBasicInfo > book > isUseIsbnCode (도서상품용)
ISBN
코드 사용여부
  Boolean *도서상품일 경우 필수
도서상품은 ISBN 코드를 입력하거나 도서참고가격 연동 필요
true : ISBN
코드 입력
false :ISBN
코드 미입력
itemBasicInfo > book > isbnCode (도서상품용)ISBN코드   string *도서상품일 경우 필수
itemBasicInfo > book > price (도서상품용)참고가격   int *도서상품일 경우 필수
ISBN
코드를 입력하지 않을 경우, 참고가격 필수
참고가격 입력 , 상품 가격이 참고가격 로직 반영된 가격체계 노출됨
itemBasicInfo > book > attributeCode (도서상품용/G마켓전용)
추가등록 카테고리
  string *도서상품일 경우 필수
링크 xml 도서 카테고리 CLASS_VALUE 항목으로 입력
http://tpl.gmarket.co.kr/v1/Category/Category.xml
itemBasicInfo > catalog > modelName 모델명   string 상품의 모델명 입력
itemBasicInfo > catalog > brandNo 브랜드코드   int 브랜드코드 조회 API 조회한 브랜드코드 입력
itemBasicInfo > catalog > barCode 바코드   string 상품의 바코드 입력
itemBasicInfo > catalog > epinCode ESM 상품분류코드   string 현재 API 제공하지 않아 null 호출
itemBasicInfo > is3PL 상품종류(3PL) Y boolean 상품등록을 위한 상품종류 선택
true: 3PL
상품
false:
일반상품
itemAddtionalInfo > buyableQuantity > type 구매수량제한 타입 Y int 구매수량제한 타입 설정
0. nolimit :
구매수량 제한 없음,
1. OneTime : 1
회당 최대 구매수량,
2.max : ID
최대 구매수량,
3.Day :
기간당 최대 구매수량,
itemAddtionalInfo > buyableQuantity > qty 최대구매수량   int 구매수량제한 타입이 1~3 경우 필수
*3PL
상품일 경우, 매핑된 SKU 합포장 여부에 따라 상품의 최대구매구매수량제한 타입이 1~3 경우 필수
*
최대구매허용수량 미설정 , 최대구매허용수량은 SKU판매단위 입수량으로 자동 제한됨. 허용수량이 결정됨
합포장 가능SKU , 최대구매허용수량은 판매자 직접 설정/미설정 가능.
합포장 불가SKU , 최대구매허용수량은 SKU판매단위 입수량으로 자동 제한됨.
itemAddtionalInfo > buyableQuantity > unitDate 제한기간   int 구매수량제한 타입이 3 경우 필수
itemAddtionalInfo > price > Gmkt G마켓 판매가격 Y number G마켓에서 판매될 금액 입력(십억이상 입력 불가)
10
원단위로 등록
판매자할인 등록 ,
판매가격 기준으로 할인 적용됨
itemAddtionalInfo > price > Iac 옥션 판매가격 Y number 옥션에서 판매될 금액 입력(십억이상 입력 불가)
10
원단위로 등록
판매자할인 등록 , 판매가격 기준으로 할인 적용됨
itemAddtionalInfo > stock > Gmkt G마켓 재고수량 Y int G마켓에서 판매할 재고 입력
1~99999
까지 입력 가능
3PL
상품은 해당 항목값 입력 필수이나, 연동된 SKU 재고로 자동 연동됨
itemAddtionalInfo > stock > Iac 옥션 재고수량 Y int 옥션에서 판매할 재고 입력
1~99999
까지 입력 가능
3PL
상품은 해당 항목값 입력 필수이나, 연동된 SKU 재고로 자동 연동됨
itemAddtionalInfo > sellingPeriod > Gmkt G마켓 판매기간 Y int G마켓에서 판매할 기간 입력
-1:
무제한
3PL
상품은 -1: 무제한 입력 가능
, 해당 API GET 조회시, YYYYMMDD 판매종료날짜가 99991231 내려감
itemAddtionalInfo > sellingPeriod > Iac 옥션 판매기간 Y int 옥션에서 판매할 기간 입력
-1:
무제한
3PL
상품은 -1: 무제한 입력 가능
, 해당 API GET 조회시, YYYYMMDD 판매종료날짜가 99991231 내려감
itemAddtionalInfo > managedCode 판매자 상품코드 Y string 해당 상품의 판매자가 관리할 고유 코드 입력 or 자사몰 상품번호 입력
itemAddtionalInfo > recommendedOpts > type 추천옵션 타입
(ESM
주문옵션)
Y int 추천옵션 사용여부
0:
옵션미사용
1:
선택형(최대 20개까지 가능)/independent
2: 2
개조합형(최대 200개까지 가능)/combination
*
추천옵션 타입이 선택형일 경우, independent / 2 조합형일 경우, combination 항목값으로 필수 연동
*
추천옵션은 상품의 G/A 카테고리가 모두 추천옵션 허용 경우만 등록/수정 가능
* 3PL
상품은 텍스트형 옵션 사용 불가
*
옵션 가능개수는 추후 변경될 있음
itemAddtionalInfo > recommendedOpts > isStockManage 옵션재고관리   Boolean 추천옵션 사용일 경우 필수
itemAddtionalInfo > recommendedOpts > independent > recommendedOptNo (선택형/조합형)
추천옵션코드
  int 추천옵션 사용일 경우 필수
추천옵션코드조회 API에서 매칭된 코드 입력
추천옵션코드 조회 : [GET] https://sa.esmplus.com/item/v1/options/recommended-opts?catCode={siteCatCode}
itemAddtionalInfo > recommendedOpts > independent > recommendedOptValueNo (선택형/조합형)
추천옵션항목코드
  int 추천옵션 사용일 경우 필수
추천옵션선택항목코드조회 API에서 매칭된 코드 입력
추천옵션 선택항목코드 조회 : [GET] https://sa.esmplus.com/item/v1/options/recommended-opts/{recommendedOptNo}
itemAddtionalInfo > recommendedOpts > independent > details > recommendedOptValue > koreanText (선택형/조합형)
추천옵션항목
(
국문)직접입력
  string 추천옵션항목코드를 사용하지 않고 직접입력할 경우
*
색상 직접입력 허용된 추천옵션코드에서만 사용 가능
itemAddtionalInfo > recommendedOpts > independent > details > recommendedOptValue > chineseText (선택형/조합형)
추천옵션항목
(
중문)직접입력
  string  
itemAddtionalInfo > recommendedOpts > independent > details > recommendedOptValue > englishText (선택형/조합형)
추천옵션항목
(
영문)직접입력
  string  
itemAddtionalInfo > recommendedOpts > independent > details > recommendedOptValue > japaneseText (선택형/조합형)
추천옵션항목
(
일문)직접입력
  string  
itemAddtionalInfo > recommendedOpts > independent > details > recommendedOptValue > exposeLanguage 노출언어 선택   int 옵션 다국어 , 구매자에게 노출되고 싶은 언어 선택
*
조회 , 무조건 0으로 내려감
1 :
한국어
2:
영어한글표시
3:
영어

직접입력한 경우, 영어한글표시가 없기때문에 한국어가 영어한글표시로 들어감
itemAddtionalInfo > recommendedOpts > independent > isSoldOut (선택형/조합형)
품절여부
  Boolean 추천옵션 사용일 경우 필수
옵션의 품절여부 제어(옵션 재고수량으로 제어하지 않음)
true :
품절
false :
판매
itemAddtionalInfo > recommendedOpts > independent > isDisplay (선택형/조합형)
노출여부
  Boolean 추천옵션 사용일 경우 필수
옵션의 노출여부 제어
true :
노출
false :
미노출
itemAddtionalInfo > recommendedOpts > independent > details > qty > iac (선택형/조합형)
옥션 재고수량
  int 추천옵션 사용일 경우 필수
1~99999
설정
*3PL
상품은 입력한 값이 무시되고 해당 SKU 재고가 자동으로 연동됩니다.
itemAddtionalInfo > recommendedOpts > independent > details > qty > gmkt (선택형/조합형)
G
마켓 재고수량
  int 추천옵션 사용일 경우 필수
1~99999
설정
*3PL
상품은 입력한 값이 무시되고 해당 SKU 재고가 자동으로 연동됩니다.
itemAddtionalInfo > recommendedOpts > independent > details > manageCode (선택형/조합형)
판매자옵션관리코드
  string 추천옵션 사용일 경우 필수
해당 옵션의 판매자가 관리하는 코드 입력
itemAddtionalInfo > recommendedOpts > text (텍스트형) 추천옵션 정보 Y   3PL상품은 텍스트형 옵션 사용불가함으로 null 호출
itemAddtionalInfo > orderOpts > type 옵션 타입 (ESM 주문옵션) Y int 주문옵션 사용여부
0:
옵션미사용
* 3PL
상품은 주문옵션 사용 불가하여 0으로 입력
itemAddtionalInfo > orderOpts > isStockManage 옵션재고관리   Boolean 3PL상품은 주문옵션 사용을 지원하지 않아 false 호출
itemAddtionalInfo > orderOpts > independent (선택형) 주문옵션 정보     3PL상품은 주문옵션 사용을 지원하지 않아 null 호출
itemAddtionalInfo > orderOpts > combination (조합형) 주문옵션 정보     3PL상품은 주문옵션 사용을 지원하지 않아 null 호출
itemAddtionalInfo > orderOpts > text (텍스트형) 주문옵션 정보     3PL상품은 주문옵션 사용을 지원하지 않아 null 호출
itemAddtionalInfo > inventoryCode (G마켓용)
G
마켓 인벤토리 코드
  string (G마켓 상품용)
상품 정보가 변경된 시점(상품정보 , 가격정보) 등록된 code 주문정보에 포함하여 전달함
itemAddtionalInfo > sellerShop > catCode 판매자 카테고리코드 Y string 판매자 자사몰 카테고리 ///상세 코드 입력
*
추후 카테고리 자동 재분류를 위한 기준으로 정확하게 입력
itemAddtionalInfo > sellerShop > catName 판매자 카테고리명 Y string 판매자 자사몰 카테고리 ///상세 합쳐서 전체 텍스트명 입력
*
추후 카테고리 자동 재분류를 위한 기준으로 정확하게 입력
itemAddtionalInfo > sellerShop > brandCode 판매자 브랜드코드 Y string 판매자 자사몰 브랜드코드
*
추후 카테고리 자동 재분류를 위한 기준으로 정확하게 입력
itemAddtionalInfo > sellerShop > brandName 판매자 브랜드명 Y string 판매자 자사몰 브랜드명
*
추후 카테고리 자동 재분류를 위한 기준으로 정확하게 입력
itemAddtionalInfo > expiryDate 유효일   string 카테고리에 따라 필수 입력
itemAddtionalInfo > manufacturedDate 제조일   string 카테고리에 따라 필수 입력
도서상품일 경우, 도서출판년월일을 제조일에 입력
itemAddtionalInfo > origin > goodsType 원산지상품 타입 Y int 해당 상품 유형 타입 입력
0:
원산지표시대상아님(식품이외),
1:
상세설명참조,
2:
가공품,
3:
농산물,
4:
수산물
itemAddtionalInfo > origin > type 원산지지역 타입 Y int 원산지지역 타입 입력
0:
없음,
1:
국내산,
2:
수입산,
3:
기타

*
상세설명참조일 경우 0~3 모두 입력 가능함
, 상품조회 , 상세설명참조는 0으로 내려감
itemAddtionalInfo > origin > code 원산지지역 코드   string 원산지지역 상세코드 입력
원산지 코드 리스트 다운로드
itemAddtionalInfo > origin > isMultipleOrigin 복수원산지 여부 Y Boolean 단순 복수원산지 여부 체크 기능/추가 입력 정보 받지 않음
true :
복수원산지 상품
false :
단일원산지 상품
itemAddtionalInfo > capacity > vol (옥션상품용)
용량/규격
  string 주문 선택별로 용량이 다른 상품일 경우 등록함
itemAddtionalInfo > capacity > unit (옥션상품용)
용량/규격 단위
  int 아래 단위 선택하여 1 입력
0 :
없음 / 1 : m / 2 : g / 3 : kg / 4 : / 5 : 리터 / 6 : ml / 7 : mm / 8 : 마리 / 9 : / 10 : p / 11 : cm
12 : box / 13 : mg / 14 :
/ 15 : / 16 : 캅셀 / 17 : 캡슐 / 18 : / 19 : / 20 : / 21 : 100g
itemAddtionalInfo > shipping > type 배송방법 타입 Y int 배송방식 타입 입력
1 :
택배소포
1
입력 스마일배송으로 적용됨
itemAddtionalInfo > shipping > companyNo 택배사코드 Y int 택배사코드 입력
임의 값으로 입력 가능함
입력한 값은 무시되고 스마일물류센터 정보로 자동 적용됩니다.
itemAddtionalInfo > shipping > policy > placeNo 출하지번호 Y int 출하지 번호 입력
임의 값으로 입력 가능함
입력한 값은 무시되고 스마일물류센터 정보로 자동 적용됩니다.
itemAddtionalInfo > shipping > policy > feeType 배송비 타입 Y int 묶음배송비 설정
1 :
묶음배송비
itemAddtionalInfo > shipping > policy > bundle > deliveryTmplId 묶음배송비정책번호 Y int 해당 상품의 묶음배송비 정책번호 입력
임의 값으로 입력 가능함
입력한 해당 값은 무시되고 3PL상품의 기본값으로 자동 적용됩니다.
itemAddtionalInfo > shipping > policy > each 상품별배송비 타입 Y   현재 제공하지 않아 null 호출
itemAddtionalInfo > shipping > policy > is3plDeliveryFeeFree 무료배송 설정여부 Y boolean 상품을 무료배송으로 설정할지 선택
true:
무료배송
false:
유료배송
*
합포장불가 SKU 연동시, true: 무료배송만 선택 가능합니다.
itemAddtionalInfo > shipping > returnAndExchange 반품/교환 정보 Y int null 호출 가능
*null
입력 스마일물류센터 정보로 자동 적용됩니다.
itemAddtionalInfo > shipping > dispatchPolicyNo > gmkt (G마켓용)
발송타입정책번호
Y int 해당 상품의 발송타입정책번호 입력
임의 값으로 입력 가능함
입력한 해당 값은 무시되고 3PL상품의 기본값으로 자동 적용됩니다.
itemAddtionalInfo > shipping > dispatchPolicyNo > iac (옥션용)
발송타입정책번호
Y int 해당 상품의 발송타입정책번호 입력
임의 값으로 입력 가능함
입력한 해당 값은 무시되고 3PL상품의 기본값으로 자동 적용됩니다.
itemAddtionalInfo > shipping > generalPost 일반우편 정보 Y   3PL상품은 지원하지 않아 null 호출
itemAddtionalInfo > shipping > visitAndTake 방문수령 정보 Y   3PL상품은 지원하지 않아 null 호출
itemAddtionalInfo > shipping > quickService 퀵서비스 정보 Y   3PL상품은 지원하지 않아 null 호출
itemAddtionalInfo > shipping > backwoodsDeliveryYn 제주/도서산간배송불가여부 Y   3PL상품은 지원하지 않아 null 호출
itemAddtionalInfo > officialNotice > officialNoticeNo 상품정보고시 상품군코드 Y int 고시정보 리스트 다운로드
itemAddtionalInfo > officialNotice > details > officialNoticeItemelementCode 상품정보고시 항목코드 Y string 고시정보 리스트 다운로드
itemAddtionalInfo > officialNotice > details > value 상품정보고시 Y string 상품정보고시
itemAddtionalInfo > officialNotice > isExtraMark 상품정보고시
추가입력여부
Y Boolean true : 추가입력고시
false :
추가입력 없음
itemAddtionalInfo > isAdultProduct 성인상품여부 Y Boolean 성인인증을 하기 전까지 상품이미지 비노출 처리됨
true:
성인상품, false : 일반상품
*ESM>
청소년구매불가 상품이면 성인상품여부 무조건 true 연동
itemAddtionalInfo > isYouthNotAvailable 청소년구매불가여부 Y Boolean "\성인인증을 하기 전에도 상품이미지는 노출처리 되나, 구매시점 성인인증 필요
Ex)
주류
true:
청소년구매불가상품, false : 일반상품
itemAddtionalInfo > isVatFree 부가세여부 Y Boolean 반드시 면세상품일 경우에만 true 설정하고, 일반 과세상품은 false 설정
true:
부가세 면세상품
false:
부가세 과세상품
itemAddtionalInfo > certInfo > gmkt > certId (G마켓용)
인증정보코드
  string 상품과 관련된 인증/보증/증명 정보 입력
의료기기/방송통신기기/식품제조가공업/건강식품인증/친환경
상품일 경우 인증정보 입력
itemAddtionalInfo > certInfo > gmkt > licenseSeq (G마켓용)
영업허가/신고증
  string 영업허가/신고코드 입력
itemAddtionalInfo > certInfo > iac > medicalInstrument > isUse (옥션용)
의료기기 인증 사용 여부
Y Boolean true : 신고대상
false:
신고대상 아님
itemAddtionalInfo > certInfo > iac > medicalInstrument > certOfficeName (옥션용)
의료기기 판매신고기관명
  string 의료기기 인증 사용 여부 true 경우 필수
itemAdditionalInfo > certInfo > iac > medicalInstrument > certId (옥션용)
의료기기 판매신고 번호
  string 의료기기 인증 사용 여부 true 경우 필수
itemAdditionalInfo > certInfo > iac > medicalInstrument > itemLicenseId (옥션용)
의료기기 품목 허가 번호
  string 의료기기 인증 사용 여부 true 경우 필수
itemAdditionalInfo > certInfo > iac > medicalInstrument > adDeliberationId (옥션용)
의료기기 사전 광고 심의 번호
  string 의료기기 인증 사용여부 true 경우 필수
itemAddtionalInfo > certInfo > iac > broadcastEquipment > isAddtionalCondition (옥션용)
방송통신기기인증정보상
품상세별도표기
  string 방송통신기기 인증 사용 여부 true 경우 필수
itemAddtionalInfo > certInfo > iac > food > isUse (옥션용)
식품제조가공업
입력사항 여부
Y Boolean true : 신고대상
false:
신고대상 아님
itemAddtionalInfo > certInfo > iac > food > certOfficeName (옥션용)
신고기관명
  string 식품제조가공업 입력 사용 여부 true 경우 필수
itemAddtionalInfo > certInfo > iac > food > certId (옥션용)
신고번호
  string 식품제조가공업 입력 사용 여부 true 경우 필수
itemAddtionalInfo > certInfo > iac > healthFood > isUse (옥션용)
건강기능식품인증여부
Y Boolean true : 신고대상
false:
신고대상 아님
itemAddtionalInfo > certInfo > iac > healthFood > certOfficeName (옥션용)
건강기능식품판매업
신고기관명
  string 건강기능식품 인증여부 true 경우 필수
itemAddtionalInfo > certInfo > iac > healthFood > certId (옥션용)
신고번호
  string 건강기능식품 인증여부 true 경우 필수
itemAddtionalInfo > certInfo > iac > healthFood > adDeliberationNo (옥션용)
사전광고 심의번호
  string 건강기능식품 인증여부 true 경우 필수
itemAddtionalInfo > certInfo > iac > environmentFriendly > isUse (옥션용)
친환경 인증여부
  Boolean true : 친환경 인증상품
false:
친환경 인증상품 아님
itemAddtionalInfo > certInfo > iac > environmentFriendly > certId (옥션용)
친환경 인증번호
  string 친환경 인증여부 true 경우 필수
itemAddtionalInfo > certInfo > safetyCerts > child > type 통합어린이인증 타입 Y int 통합인증대상 상품 아닐경우 "인증대상아님"으로 입력
0:
인증대상,
1:
인증대상아님,
2:
상품상세별도표기
itemAddtionalInfo > certInfo > safetyCerts > child > details > certId 통합어린이인증코드   string 인증코드 입력
itemAddtionalInfo > certInfo > safetyCerts > child > details > certTargetCode 통합어린이인증품목   int 통합어린이인증 타입 0번일 경우 필수
아래 인증품목중 해당하는 품목 입력
0:
안전인증,
1:
안전확인,
3:
공급자적합성확인
itemAddtionalInfo > certInfo > safetyCerts > electric > type 통합전기인증 타입 Y int 통합인증대상 상품 아닐경우 "인증대상아님"으로 입력
0:
인증대상,
1:
인증대상아님,
2:
상품상세별도표기
itemAddtionalInfo > certInfo > safetyCerts > electric > details > certId 통합전기인증코드   string 인증코드 입력
itemAddtionalInfo > certInfo > safetyCerts > electric > details > certTargetCode 통합전기인증품목   int 통합전기인증 타입 0번일 경우 필수
아래 인증품목중 해당하는 품목 입력
0:
안전인증,
1:
안전확인,
3:
공급자적합성확인
itemAddtionalInfo > certInfo > safetyCerts > electric > mandatorySafetySign 병행수입여부   string 0: UnknownOrNone 해당사항없음
1: ParallelImport
병행수입
2: BuyingAgent
구매대행
itemAddtionalInfo > certInfo > safetyCerts > life > type 통합생활용품인증 타입 Y int 통합인증대상 상품 아닐경우 "인증대상아님"으로 입력
0:
인증대상,
1:
인증대상아님,
2:
상품상세별도표기
itemAddtionalInfo > certInfo > safetyCerts > life > details > certId 통합생활용품인증코드   string 인증코드 입력
itemAddtionalInfo > certInfo > safetyCerts > life > details > certTargetCode 통합생활용품인증품목   int 통합생활용품인증 타입 0번일 경우 필수
아래 인증품목중 해당하는 품목 입력
0:
안전인증,
1:
안전확인,
3:
공급자적합성확인
itemAddtionalInfo > certInfo > safetyCerts > life > mandatorySafetySign 병행수입여부   string 0: UnknownOrNone 해당사항없음
1: ParallelImport
병행수입
2: BuyingAgent
구매대행
itemAddtionalInfo > certInfo > safetyCerts > harmful > type 통합위해우려제품인증
타입
  int 설정 없을 경우, 해당 카테고리는 무조건 Default "상세설명에 별도표기" 설정됨
0:
인증대상,
1:
인증대상아님,
2:
상품상세별도표기
itemAddtionalInfo > certInfo > safetyCerts > harmful > certId 통합자가검사번호   string type > 0번일 경우 필수
인증코드 입력
100byte
itemAddtionalInfo > images > basicImgURL 상품기본이미지 Y string 최소 600x600 / 권장 1000x1000
itemAddtionalInfo > images > addtionalImg1URL 상품추가이미지1   string  
itemAddtionalInfo > images > addtionalImg2URL 상품추가이미지2   string  
itemAddtionalInfo > images > addtionalImg3URL 상품추가이미지3   string  
itemAddtionalInfo > weight (G마켓용)
상품무게(단위:kg)
  string 숫자로 입력(소수점 1자리 가능)
상품무게 항목은 해외에서 주문이 발생한 경우, 해외배송비 산정에 사용됨
미입력 , G마켓이 설정한 카테고리별 무게로 해외배송비 산정
최대 30kg까지 설정 가능함
itemAddtionalInfo > descriptions > kor > type 상품상세정보 타입 Y int 1:contentID(추후제공)
2:html
itemAddtionalInfo > descriptions > kor > contentId 상품상세정보 코드   string 상품상세정보 타입 1 경우 필수(추후제공)
itemAddtionalInfo > descriptions > kor > html 상품상세정보 html Y string 상품상세 Html 입력
iframe, Script,
max-width 등은 사용 불가
itemAddtionalInfo > skuInfo > skuId SKU 코드 Y string 상품에 연동할 SKU코드 입력
*
최대 5개까지 SKU 입력가능
*
합포장가능 SKU 합포장 불가능SKU 동시 매칭 불가
*
과세SKU 과세끼리/면세SKU 면세끼리/미설정SKU 미설정끼리 복수 매핑 가능
itemAddtionalInfo > skuInfo > owQty SKU 출고방식 Y long 주문수량 1개당, 출고할 SKU 갯수입력
itemAddtionalInfo > addonService 추가구성 사용여부 Y   3PL상품은 추가구성 사용을 지원하지 않아 null 호출
itemAddtionalInfo > isGift 선물하기 상품 여부   Boolean 선물하기 상품 여부 선택
true : 선물하기 가능
false : 선물하기 불가능
* 미입력/skip 시 default = true 로 등록
itemAddtionalInfo > Install InstallMakerId 예약설치 상품 여부   boolean 설치예약 상품 여부 선택
true: 설치예약 상품
f
alse: 설치예약 상품 아님
* 예약설치 상품 권한 있을경우에만 설정 가능
* 상품등록시 해당 항목 미입력/skip 시, default IsInstall: false로 등록됨
itemAddtionalInfo > Install InstallModelCode
예약설치 상품 제조사코드   long 설치예약 상품 여부 true일 경우 필수
LG: 15405
삼성: 1897
itemAddtionalInfo > Install InstallModelCode
예약설치 상품 모델코드   string 설치예약 상품 여부 true일 경우 필수
설치예약상품 모델 코드가 없을 경우판매자 관리코드(managedCode)와 동일 값으로 입력
addtionalInfo > sellerDiscount > isUse 판매자할인 사용여부 Y Boolean 상품가격에서 추가로 판매자 할인 적용할 경우 입력
위에 등록한 G판매가격/A판매가격에서 할인 적용됨
true :
할인적용,
false :
할인미적용

*
옥션 할인일 경우, 아래 ""gmkt"" Entity대신 ""iac"" 입력
addtionalInfo > sellerDiscount > gmkt > type (G마켓/옥션용)
할인타입
  int 판매자할인 사용여부 true 경우 필수
0:
사용안함,
1:
정액,
2:
정률
*
type
0으로 지정 , 다른 값을 보내지 않거나, null 호출 "iac":
{ "type": "0", "priceOrRate1": 0, "priceOrRate2": 0, "startDate": 2018-06-21T03:12:47.461Z", "endDate": "2018-06-30T03:12:47.461Z" }
(X)
"iac":
{ "type": "0" }
(O)
addtionalInfo > sellerDiscount > gmkt > priceOrRate1 (G마켓/옥션용)
할인액()
  number 판매자할인 사용여부 true 경우 필수
최소 100 이상, 10원단위 입력, 판매가대비 70%까지 허용
addtionalInfo > sellerDiscount > gmkt > priceOrRate2 (G마켓/옥션용)
할인액()_SD2
  number 권한이 있는 셀러만 사용 가능
최소 100 이상, 10원단위 입력, 판매가대비 70%까지 허용
addtionalInfo > sellerDiscount > gmkt > startDate (G마켓/옥션용)
할인시작일자
  date 판매자할인 사용여부 true 경우 필수
입력형식 YYYY-MM-DD 가능 (시간 설정은 현재 제공하지 않음)
addtionalInfo > sellerDiscount > gmkt > endDate (G마켓/옥션용)
할인종료일자
  date 판매자할인 사용여부 true 경우 필수
입력형식 YYYY-MM-DD 또는
(
시간 설정은 현재 제공하지 않음)
addtionalInfo > siteDiscount > gmkt (G마켓용)
사이트부담 지원할인
Y Boolean G마켓에서 부담하는 사이트 할인을 적용할지 여부
true :
적용
false :
적용하지 않음
addtionalInfo > siteDiscount > iac (옥션용)
사이트부담 지원할인
Y Boolean 옥션에서 부담하는 사이트 할인을 적용할지 여부
true :
적용
false :
적용하지 않음
addtionalInfo > pcs > isUse 가격비교사이트
상품등록여부
Y Boolean 가격비교사이트 노출여부
true :
등록(노출됨)
false :
등록하지 않음(미노출)
addtionalInfo > pcs > isUseIacPcsCoupon (옥션용)
가격비교사이트
쿠폰적용여부
Y Boolean 다나와, 에누리 외부 가격비교사이트에 상품할인적용여부를 선택함
true :
적용
false:
미적용

가격비교사이트 상품은 등록하면서 쿠폰적용은 안되도록 설정 가능함
addtionalInfo > pcs > isUseGmkPcsCoupon (G마켓용)
가격비교사이트
쿠폰적용여부
Y Boolean G마켓은 쿠폰적용여부 변경 불가
true
연동하고 상품등록 여부로 노출 여부 설정만 가능
addtionalInfo > overseaSales > isAgree (G마켓용)
해외판매여부
Y Boolean 해외판매 진행 , 해외배송대행/고객응대/해외마케팅 지원 혜택이 있고, 진행하지 않을 경우 수출 대상에서 제외됨
해외판매대행 이용료 추가 부과됨
true :
해외판매 진행
false:
해외판매 진행하지 않음
isSell > gmkt (G마켓용)
판매상태 변경
Y Boolean 상품수정 API 해당 Entity추가
true :
판매가능 상태로 전환
false :
판매중지 상태로 전환
*
중지상태로 1개월 유지할 경우 삭제됨
판매중지 상태로 정보 호출 반영되지 않음
isSell > iac (옥션용)
판매상태 변경
Y Boolean 상품수정 API 해당 Entity추가
true :
판매가능 상태로 전환
false :
판매중지 상태로 전환
*
중지상태로 1개월 유지할 경우 삭제됨
isDisplayExclude 노출대기여부   string 상품조회 API에서만 내려가는 항목
true :
노출대기상태
false :
노출대기상태 아님(정상상태)
JSON
{
  "itemBasicInfo": {
    "goodsName": {
      "eng": "string",
      "chi": "string",
      "jpn": "string",
      "kor": "string",
      "promotion": "string"
    },
    "category": {
      "site": [
        {
          "siteType": "UnKnown",
          "catCode": "string"
        }
      ],
      "shop": [
        {
          "siteType": "UnKnown",
          "largeCatCode": "string",
          "middleCatCode": "string",
          "smallCatCode": "string"
        }
      ],
      "esm": {
        "catCode": "string"
      }
    },
    "book": {
      "isUseIsbnCode": true,
      "isbnCode": "string",
      "price": 0,
      "attributeCode": "string"
    },
    "catalog": {
      "modelName": "string",
      "brandNo": 0,
      "barCode": "string",
      "epinCode": [
        0
      ]
    },
    "is3PL": true
  },
  "itemAddtionalInfo": {
    "buyableQuantity": {
      "type": "Unlimited",
      "qty": 0,
      "unitDate": 0
    },
    "price": {
      "Gmkt": 0,
      "Iac": 0
    },
    "stock": {
      "Gmkt": 0,
      "Iac": 0
    },
    "recommendedOpts": {
      "type": "Unknown",
      "isStockManage": true,
      "independent": {
        "details": [
          {
            "recommendedOptValueNo": 0,
            "recommendedOptValue": {
              "koreanText": "string",
              "englishText": "string",
              "chineseText": "string",
              "japaneseText": "string",
              "exposeLanguage": "Unknown"
            },
            "isSoldOut": true,
            "isDisplay": true,
            "qty": {
              "iac": 0,
              "gmkt": 0
            },
            "manageCode": "string",
            "epinCode": 0,
            "skuInfo": [
              {
                "skuId": 0,
                "owQty": 0
              }
            ]
          }
        ],
        "recommendedOptNo": 0
      },
      "combination": {
        "details": [
          {
            "recommendedOptValueNo1": 0,
            "recommendedOptValueNo2": 0,
            "recommendedOptValue1": {
              "koreanText": "string",
              "englishText": "string",
              "chineseText": "string",
              "japaneseText": "string",
              "exposeLanguage": "Unknown"
            },
            "recommendedOptValue2": {
              "koreanText": "string",
              "englishText": "string",
              "chineseText": "string",
              "japaneseText": "string",
              "exposeLanguage": "Unknown"
            },
            "isSoldOut": true,
            "isDisplay": true,
            "qty": {
              "iac": 0,
              "gmkt": 0
            },
            "manageCode": "string",
            "epinCode": 0,
            "skuInfo": [
              {
                "skuId": 0,
                "owQty": 0
              }
            ]
          }
        ],
        "recommendedOptNo1": 0,
        "recommendedOptNo2": 0
      },
      "text": {
        "details": [
          {
            "recommendedOptNo": 0,
            "isDisplay": true,
            "Value": "string"
          }
        ]
      }
    },
    "orderOpts": {
      "type": "Unknown",
      "isStockManage": true,
      "independent": [
        {
          "name": {
            "kor": "string",
            "eng": "string",
            "chi": "string",
            "jpn": "string"
          },
          "details": [
            {
              "value": {
                "kor": "string",
                "eng": "string",
                "chi": "string",
                "jpn": "string"
              },
              "isSoldOut": true,
              "isDisplay": true,
              "qty": {
                "iac": 0,
                "gmkt": 0
              },
              "manageCode": "string",
              "epinCode": 0
            }
          ]
        }
      ],
      "combination": {
        "name1": {
          "kor": "string",
          "eng": "string",
          "chi": "string",
          "jpn": "string"
        },
        "name2": {
          "kor": "string",
          "eng": "string",
          "chi": "string",
          "jpn": "string"
        },
        "details": [
          {
            "value1": {
              "kor": "string",
              "eng": "string",
              "chi": "string",
              "jpn": "string"
            },
            "value2": {
              "kor": "string",
              "eng": "string",
              "chi": "string",
              "jpn": "string"
            },
            "isSoldOut": true,
            "isDisplay": true,
            "qty": {
              "iac": 0,
              "gmkt": 0
            },
            "manageCode": "string",
            "epinCode": 0
          }
        ]
      },
      "text": [
        {
          "name": {
            "kor": "string",
            "eng": "string",
            "chi": "string",
            "jpn": "string"
          },
          "isDisplay": true
        }
      ]
    },
    "sellingPeriod": {
      "Gmkt": 0,
      "Iac": 0
    },
    "managedCode": "string",
    "inventoryCode": "string",
    "sellerShop": {
      "catCode": "string",
      "catName": "string",
      "brandCode": "string",
      "brandName": "string"
    },
    "expiryDate": "2022-01-06T06:10:55.639Z",
    "manufacturedDate": "2022-01-06T06:10:55.639Z",
    "origin": {
      "goodsType": "None",
      "type": "Unknown",
      "code": "string",
      "isMultipleOrigin": true
    },
    "capacity": {
      "vol": "string",
      "unit": 0
    },
    "shipping": {
      "type": "Unknown",
      "companyNo": 0,
      "policy": {
        "placeNo": 0,
        "feeType": "Unknown",
        "bundle": {
          "deliveryTmplId": "string"
        },
        "each": {
          "feeType": "Unknown",
          "feePayType": "Unknown",
          "fee": 0,
          "baseFee": 0,
          "details": [
            {
              "FeeAmnt": 0,
              "Condition": 0
            }
          ]
        },
        "is3plDeliveryFeeFree": true
      },
      "returnAndExchange": {
        "addrNo": "string",
        "shippingCompany": "string",
        "fee": 0
      },
      "dispatchPolicyNo": {
        "gmkt": 0,
        "iac": 0
      },
      "generalPost": {
        "isUse": true,
        "price": 0
      },
      "visitAndTake": {
        "isUse": true,
        "type": "Unknown",
        "discount": 0,
        "gifts": "string",
        "addrNo": "string"
      },
      "quickService": {
        "isUse": true,
        "companyName": "string",
        "phoneNo": "string",
        "shippingEnableRegionCode": "string"
      },
      "backwoodsDeliveryYn": "string"
    },
    "officialNotice": {
      "officialNoticeNo": 0,
      "details": [
        {
          "officialNoticeItemelementCode": "string",
          "value": "string",
          "isExtraMark": true
        }
      ]
    },
    "isAdultProduct": true,
    "isYouthNotAvailable": true,
    "isVatFree": true,
    "certInfo": {
      "gmkt": {
        "certId": [
          "string"
        ],
        "licenseSeq": [
          0
        ]
      },
      "iac": {
        "medicalInstrument": {
          "isUse": true,
          "certOfficeName": "string",
          "certId": "string",
          "itemLicenseId": "string",
          "adDeliberationId": "string"
        },
        "broadcastEquipment": {
          "isUse": true,
          "certId": "string",
          "isAddtionalCondition": true
        },
        "food": {
          "isUse": true,
          "certOfficeName": "string",
          "certId": "string"
        },
        "healthFood": {
          "isUse": true,
          "certOfficeName": "string",
          "certId": "string",
          "adDeliberationNo": "string"
        },
        "environmentFriendly": {
          "isUse": true,
          "certId": "string"
        }
      },
      "safetyCerts": {
        "child": {
          "details": [
            {
              "certId": "string",
              "certTargetCode": "SafeCert"
            }
          ],
          "type": "RequireCert"
        },
        "electric": {
          "mandatorySafetySign": "UnknownOrNone",
          "details": [
            {
              "certId": "string",
              "certTargetCode": "SafeCert"
            }
          ],
          "type": "RequireCert"
        },
        "life": {
          "mandatorySafetySign": "UnknownOrNone",
          "details": [
            {
              "certId": "string",
              "certTargetCode": "SafeCert"
            }
          ],
          "type": "RequireCert"
        },
        "harmful": {
          "certId": [
            "string"
          ],
          "type": "RequireCert"
        }
      }
    },
    "images": {
      "basicImgURL": "string",
      "addtionalImg1URL": "string",
      "addtionalImg2URL": "string",
      "addtionalImg3URL": "string"
    },
    "weight": 0,
    "descriptions": {
      "kor": {
        "type": "ContentId",
        "contentId": "string",
        "html": "string"
      }
    },
    "addonService": {
      "addonServiceList": [
        {
          "addonServiceType": 0,
          "addonServiceSeq": 0,
          "addonServiceName": "string",
          "addonServiceValueSeq": 0,
          "addonServiceValueName": "string",
          "addonServiceAmnt": 0,
          "sortSeq": 0,
          "qtyInfo": {
            "isSoldOut": true,
            "exposeYN": true
          }
        }
      ],
      "addonServiceUseType": 0
    },
    "skuInfo": [
      {
        "skuId": 0,
        "owQty": 0
      }
    ],
    "isGift": true,
    "install": {
      "IsInstall": true,
      "InstallMakerId": 0,
      "InstallModelCode": "string"
    },
  },
  "addtionalInfo": {
    "sellerDiscount": {
      "isUse": true,
      "gmkt": {
        "type": "Unknown",
        "priceOrRate1": 0,
        "priceOrRate2": 0,
        "startDate": "2022-01-06T06:10:55.640Z",
        "endDate": "2022-01-06T06:10:55.640Z"
      },
      "iac": {
        "type": "Unknown",
        "priceOrRate1": 0,
        "priceOrRate2": 0,
        "startDate": "2022-01-06T06:10:55.640Z",
        "endDate": "2022-01-06T06:10:55.640Z"
      }
    },
    "siteDiscount": {
      "gmkt": true,
      "iac": true
    },
    "gift": {
      "name": "string"
    },
    "pcs": {
      "isUse": true,
      "isUseIacPcsCoupon": true,
      "isUseGmkPcsCoupon": true
    },
    "overseaSales": {
      "isAgree": true
    }
  }
}

 

Response Description

항목 항목명 Type Description
goodsNo 마스터상품번호 int 마스터상품번호 기준으로 G마켓/옥션의 상품정보를 업데이트
SiteGoodsNo 사이트상품번호 int Object : gmkt이면 G마켓 관련 정보 / iac 옥션 관련 정보
상품이 정상적으로 생성되면 사이트상품번호가 채번됨
사이트상품번호 기준으로 주문~정산까지 데이터 묶임
SiteGoodsComment 사이트상품정보반영 결과 string  
resultCode 결과코드 int 0: 성공
나머지 : 실패
message 메시지 string 성공 or 실패사유
data 데이터 object  

JSON_Success

{
  "siteDetail": {
    "gmkt": {
      "SiteGoodsNo": "string",
      "SiteGoodsComment": "string"
    },
    "iac": {
      "SiteGoodsNo": "string",
      "SiteGoodsComment": "string"
    }
  },
  "resultCode": 0,
  "message": "string",
  "goodsNo": 0
}

JSON_Fail

{
   "ResultCode": 0,
   "Message": "string",
   "Data": {}
}

Sample Code_Success

등록/수정
{
    "siteDetail": {
        "gmkt": {
            "SiteGoodsNo": "1100371577",
            "SiteGoodsComment": "Success"
        },
        "iac": {
            "SiteGoodsNo": "C200028305",
            "SiteGoodsComment": "Success"
        }
    },
    "resultCode": 0,
    "message": null,
    "goodsNo": 2300112635
}

조회
{
  "isSell": {
    "gmkt": true,
    "iac": true
  },
  "isDisplayExclude": true,
  "itemBasicInfo": {
    "goodsName": {
      "eng": "string",
      "chi": "string",
      "jpn": "string",
      "kor": "string",
      "promotion": "string"
    },
    "category": {
      "site": [
        {
          "siteType": "UnKnown",
          "catCode": "string"
        }
      ],
      "shop": [
        {
          "siteType": "UnKnown",
          "largeCatCode": "string",
          "middleCatCode": "string",
          "smallCatCode": "string"
        }
      ],
      "esm": {
        "catCode": "string"
      }
    },
    "book": {
      "isUseIsbnCode": true,
      "isbnCode": "string",
      "price": 0,
      "attributeCode": "string"
    },
    "catalog": {
      "modelName": "string",
      "brandNo": 0,
      "barCode": "string",
      "epinCode": [
        0
      ]
    },
    "is3PL": true
  },
  "itemAddtionalInfo": {
    "buyableQuantity": {
      "type": "Unlimited",
      "qty": 0,
      "unitDate": 0
    },
    "price": {
      "Gmkt": 0,
      "Iac": 0
    },
    "stock": {
      "Gmkt": 0,
      "Iac": 0
    },
    "recommendedOpts": {
      "type": "Unknown",
      "isStockManage": true,
      "independent": {
        "details": [
          {
            "recommendedOptValueNo": 0,
            "recommendedOptValue": {
              "koreanText": "string",
              "englishText": "string",
              "chineseText": "string",
              "japaneseText": "string",
              "exposeLanguage": "Unknown"
            },
            "isSoldOut": true,
            "isDisplay": true,
            "qty": {
              "iac": 0,
              "gmkt": 0
            },
            "manageCode": "string",
            "epinCode": 0,
            "skuInfo": [
              {
                "skuId": 0,
                "owQty": 0
              }
            ]
          }
        ],
        "recommendedOptNo": 0
      },
      "combination": {
        "details": [
          {
            "recommendedOptValueNo1": 0,
            "recommendedOptValueNo2": 0,
            "recommendedOptValue1": {
              "koreanText": "string",
              "englishText": "string",
              "chineseText": "string",
              "japaneseText": "string",
              "exposeLanguage": "Unknown"
            },
            "recommendedOptValue2": {
              "koreanText": "string",
              "englishText": "string",
              "chineseText": "string",
              "japaneseText": "string",
              "exposeLanguage": "Unknown"
            },
            "isSoldOut": true,
            "isDisplay": true,
            "qty": {
              "iac": 0,
              "gmkt": 0
            },
            "manageCode": "string",
            "epinCode": 0,
            "skuInfo": [
              {
                "skuId": 0,
                "owQty": 0
              }
            ]
          }
        ],
        "recommendedOptNo1": 0,
        "recommendedOptNo2": 0
      },
      "text": {
        "details": [
          {
            "recommendedOptNo": 0,
            "isDisplay": true,
            "Value": "string"
          }
        ]
      }
    },
    "orderOpts": {
      "type": "Unknown",
      "isStockManage": true,
      "independent": [
        {
          "name": {
            "kor": "string",
            "eng": "string",
            "chi": "string",
            "jpn": "string"
          },
          "details": [
            {
              "value": {
                "kor": "string",
                "eng": "string",
                "chi": "string",
                "jpn": "string"
              },
              "isSoldOut": true,
              "isDisplay": true,
              "qty": {
                "iac": 0,
                "gmkt": 0
              },
              "manageCode": "string",
              "epinCode": 0
            }
          ]
        }
      ],
      "combination": {
        "name1": {
          "kor": "string",
          "eng": "string",
          "chi": "string",
          "jpn": "string"
        },
        "name2": {
          "kor": "string",
          "eng": "string",
          "chi": "string",
          "jpn": "string"
        },
        "details": [
          {
            "value1": {
              "kor": "string",
              "eng": "string",
              "chi": "string",
              "jpn": "string"
            },
            "value2": {
              "kor": "string",
              "eng": "string",
              "chi": "string",
              "jpn": "string"
            },
            "isSoldOut": true,
            "isDisplay": true,
            "qty": {
              "iac": 0,
              "gmkt": 0
            },
            "manageCode": "string",
            "epinCode": 0
          }
        ]
      },
      "text": [
        {
          "name": {
            "kor": "string",
            "eng": "string",
            "chi": "string",
            "jpn": "string"
          },
          "isDisplay": true
        }
      ]
    },
    "sellingPeriod": {
      "Gmkt": 0,
      "Iac": 0
    },
    "managedCode": "string",
    "inventoryCode": "string",
    "sellerShop": {
      "catCode": "string",
      "catName": "string",
      "brandCode": "string",
      "brandName": "string"
    },
    "expiryDate": "2022-01-06T06:10:55.996Z",
    "manufacturedDate": "2022-01-06T06:10:55.996Z",
    "origin": {
      "goodsType": "None",
      "type": "Unknown",
      "code": "string",
      "isMultipleOrigin": true
    },
    "capacity": {
      "vol": "string",
      "unit": 0
    },
    "shipping": {
      "type": "Unknown",
      "companyNo": 0,
      "policy": {
        "placeNo": 0,
        "feeType": "Unknown",
        "bundle": {
          "deliveryTmplId": "string"
        },
        "each": {
          "feeType": "Unknown",
          "feePayType": "Unknown",
          "fee": 0,
          "baseFee": 0,
          "details": [
            {
              "FeeAmnt": 0,
              "Condition": 0
            }
          ]
        },
        "is3plDeliveryFeeFree": true
      },
      "returnAndExchange": {
        "addrNo": "string",
        "shippingCompany": "string",
        "fee": 0
      },
      "dispatchPolicyNo": {
        "gmkt": 0,
        "iac": 0
      },
      "generalPost": {
        "isUse": true,
        "price": 0
      },
      "visitAndTake": {
        "isUse": true,
        "type": "Unknown",
        "discount": 0,
        "gifts": "string",
        "addrNo": "string"
      },
      "quickService": {
        "isUse": true,
        "companyName": "string",
        "phoneNo": "string",
        "shippingEnableRegionCode": "string"
      },
      "backwoodsDeliveryYn": "string"
    },
    "officialNotice": {
      "officialNoticeNo": 0,
      "details": [
        {
          "officialNoticeItemelementCode": "string",
          "value": "string",
          "isExtraMark": true
        }
      ]
    },
    "isAdultProduct": true,
    "isYouthNotAvailable": true,
    "isVatFree": true,
    "certInfo": {
      "gmkt": {
        "certId": [
          "string"
        ],
        "licenseSeq": [
          0
        ]
      },
      "iac": {
        "medicalInstrument": {
          "isUse": true,
          "certOfficeName": "string",
          "certId": "string",
          "itemLicenseId": "string",
          "adDeliberationId": "string"
        },
        "broadcastEquipment": {
          "isUse": true,
          "certId": "string",
          "isAddtionalCondition": true
        },
        "food": {
          "isUse": true,
          "certOfficeName": "string",
          "certId": "string"
        },
        "healthFood": {
          "isUse": true,
          "certOfficeName": "string",
          "certId": "string",
          "adDeliberationNo": "string"
        },
        "environmentFriendly": {
          "isUse": true,
          "certId": "string"
        }
      },
      "safetyCerts": {
        "child": {
          "details": [
            {
              "certId": "string",
              "certTargetCode": "SafeCert"
            }
          ],
          "type": "RequireCert"
        },
        "electric": {
          "mandatorySafetySign": "UnknownOrNone",
          "details": [
            {
              "certId": "string",
              "certTargetCode": "SafeCert"
            }
          ],
          "type": "RequireCert"
        },
        "life": {
          "mandatorySafetySign": "UnknownOrNone",
          "details": [
            {
              "certId": "string",
              "certTargetCode": "SafeCert"
            }
          ],
          "type": "RequireCert"
        },
        "harmful": {
          "certId": [
            "string"
          ],
          "type": "RequireCert"
        }
      }
    },
    "images": {
      "basicImgURL": "string",
      "addtionalImg1URL": "string",
      "addtionalImg2URL": "string",
      "addtionalImg3URL": "string"
    },
    "weight": 0,
    "descriptions": {
      "kor": {
        "type": "ContentId",
        "contentId": "string",
        "html": "string"
      }
    },
    "addonService": {
      "addonServiceList": [
        {
          "addonServiceType": 0,
          "addonServiceSeq": 0,
          "addonServiceName": "string",
          "addonServiceValueSeq": 0,
          "addonServiceValueName": "string",
          "addonServiceAmnt": 0,
          "sortSeq": 0,
          "qtyInfo": {
            "isSoldOut": true,
            "exposeYN": true
          }
        }
      ],
      "addonServiceUseType": 0
    },
    "skuInfo": [
      {
        "skuId": 0,
        "owQty": 0
      }
    ],
    "isGift": true,
    "install": {
      "IsInstall": true,
      "InstallMakerId": 0,
      "InstallModelCode": "string"
    },
  },
  "addtionalInfo": {
    "sellerDiscount": {
      "isUse": true,
      "gmkt": {
        "type": "Unknown",
        "priceOrRate1": 0,
        "priceOrRate2": 0,
        "startDate": "2022-01-06T06:10:55.997Z",
        "endDate": "2022-01-06T06:10:55.997Z"
      },
      "iac": {
        "type": "Unknown",
        "priceOrRate1": 0,
        "priceOrRate2": 0,
        "startDate": "2022-01-06T06:10:55.997Z",
        "endDate": "2022-01-06T06:10:55.998Z"
      }
    },
    "siteDiscount": {
      "gmkt": true,
      "iac": true
    },
    "gift": {
      "name": "string"
    },
    "pcs": {
      "isUse": true,
      "isUseIacPcsCoupon": true,
      "isUseGmkPcsCoupon": true
    },
    "overseaSales": {
      "isAgree": true
    }
  }
}

Sample Code_Fail

{
    "ResultCode": 1000,
    "Message": "잘 못된 발송정책 번호 입니다.",
    "data": null
}

Error Code

결과코드 메시지 원인
1000 스마일 배송상품으로 전환 불가능한 계정입니다. 3PL 상품등록 가능 판매자가 아니며, 상품 등록/수정을 시도한 경우
3000 유효하지 않은 SKU_ID 입니다.(SkuId) 다른 판매자의 SkuId 입력한 경우
10000 [InvalidApiRequestEx]스마일 배송상품은 SKU번호랑 출고방식이 필수입력 항목입니다. SKU코드나 SKU출고방식 값을 입력하지 않았을 경우
3000 중복된 SKU(skuID)입니다. 동일한 skuID를 2개 이상 중복 입력한 경우
1000 묶음배송(합포장)이 가능한 SKU와 불가능한 SKU는 동시에 등록하실 수 없습니다.\n묶음배송 가능한 SKU만 등록해 주시거나, 묶음배송 불가능한 SKU만 등록해 주시기 바랍니다. skuID의 합포장 여부가 상이한 경우
1000  "매핑된 SKU(skuID)는 합포장 불가 SKU이며, 무료배송만 선택 가능합니다. (무료배송 여부 : False)", 합포장 불가 sku 이나 is3plDeliveryFeeFree": false 로 연동한 경우
1000 SKU를 본상품/주문옵션 둘다 매핑시 등록이 불가능합니다. SKU를 본상품/주문옵션 둘다 매핑한 경우
1000 [InvalidApiRequestEx][본품 SKU정보] 스마일 배송상품은 SKU번호랑 출고방식이 필수입력 항목입니다 owQty값 미입력한 경우
1000 [InvalidApiRequestEx][본품 SKU정보] 스마일 배송상품은 SKU번호랑 출고방식이 필수입력 항목입니다 skuID값 미입력한 경우
1000 SKU번호는 최대 5개까지 입력 가능합니다. skuID 5개 이상 입력한 경우
1000 [InvalidApiRequestEx]3PL 상품의 무료배송 설정여부는 필수입력 항목입니다. is3plDeliveryFeeFree 항목 누락한 경우
1000 [InvalidApiRequestEx][GMKT]카테고리 코드가 없습니다 등록하려는 사이트의 사이트타입 오류일 경우
1000 [InvalidApiRequestEx][\"영문 상품명(eng)은 최대 100byte까지 입력 가능합니다 < ₩ 영문상품명 100bytes 초과 작성했을 경우
1000 검색용 상품명은 최대 50Byte까지 저장 가능합니다 < 검색용 상품명 100bytes 초과 작성했을 경우
1000 [InvalidApiRequestEx][IAC]잘 못 된 카테고리 코드입니다 < {호출카테고리번호} 호출한 카테고리가 제공하지 않는 카테고리 코드일 경우
1000 [InvalidApiRequestEx]ISBN Code와 도서 정가를 동시에 입력하실 수 없습니다 < ISBN 코드와 참고가격 항목을 동시에 입력한 경우
1000 [InvalidApiRequestEx][₩"Type 필드는 0에서 3 사이에 있어야 합니다 < ₩ 구매수량제한타입의 타입 잘 못 입력한 경우
1000 [InvalidApiRequestEx][₩"최대 구매 허용 수량(qty)은 0보다 크고, 999를 넘지 않는 수를 입력해주세요 < ₩ 최대 구매허용 수량 초과되었을 경우
1000 [InvalidApiRequestEx][₩"최대 구매 허용 일자는 0초과, 210미만의 수를 입력해주세요 < ₩ 기간당 구매수량 구매허용일자 범위 초과했을 경우
3000 값이 너무 크거나 작아 Int32 형식에 맞지 않습니다 < 판매가격 범위 초과했을 경우
1000 [InvalidApiRequestEx][₩"Iac 필드는 1에서 99999 사이에 있어야 합니다 < ₩ 판매재고수량 범위 초과했을 경우
1000 [IAC] 판매기간은 0, 15, 30, 60, 90만 가능합니다 < ₩ 판매기간을 잘 못 입력했을 경우
1000 [InvalidApiRequestEx][₩"추천 옵션 타입(type)이 잘 못 되었습니다 < (0: 사용 안함, 1: 독립형(1개 선택형), 2: 복합형(2개 선택형))₩ 추천옵션타입 잘 못 입력했을 경우
1000 주문선택사항이 최소 1개 이상 판매되어야 합니다 < 모든 추천옵션 품절여부/노출여부를 모두 true/false로 설정했을 경우
1000 [InvalidApiRequestEx][₩"[IAC] 재고수량은 1~99999로 설정해 주세요 < ₩ 추천옵션 재고수량 초과 입력했을 경우
1000 [InvalidApiRequestEx][₩"상품종류(goodsType)값이 잘 못 되었습니다 < (0: 원산지 표시대상 아님, 1: 상세설명 참조, 2: 가공품) 원산지 상품타입을 잘 못 입력했을 경우
1000 [InvalidApiRequestEx][₩"원산지 타입(type)이 잘 못 되었습니다 < (0: 없음, 1: 국내, 2: 해외, 3,4,5: 기타()₩ 원산지 타입을 잘 못 입력했을 경우
1000 [InvalidApiRequestEx][₩"배송 방법(type)이 잘 못 되었습니다 < ₩ 배송방법 타입 잘 못 입력했을 경우
1000 ShipmentPlaceNo 오류, ShipmentPlaceNo: {출하지번호} 출하지번호 존재하지 않는 번호나 잘 못 입력했을 경우
1000 [InvalidApiRequestEx][₩"Invalid character after parsing property name < Expected ':' but got: ₩₩₩" < Path 'addtionalInfo < siteDiscount', line 285, position 4 < ₩",₩"feeType는 묶음 배송비(1)만 설정 가능합니다 < 배송비 타입 잘 못 입력했을 경우
1000 잘못된 parameter 요청 (값이 없거나 비어있습니다)shippingPolicy 묶음배송비 정책번호 존재하지 않는 번호나 잘 못 입력했을 경우
1000 ESM에 저장된 반품 주소지 정보가 없습니다 < 문의바랍니다 < 반품 주소지번호 오류일 경우
1000 시퀀스에 요소가 없습니다 반품교환 택배사 코드가 존재하지 않는 번호나 잘 못 입력했을 경우
1000 <12>-잘 못된 발송정책 번호 입니다 < 발송정책번호 존재하지 않는 번호나 잘 못 입력했을 경우
1000 [InvalidApiRequestEx][₩"Type 필드는 0에서 3 사이에 있어야 합니다 < ₩ 방문수령혜택 타입 오류일 경우
1000 <21>-상품 고시 필수 정보가 입력되지 않았습니다 < (누락고시번호) 상품 고시 필수정보 누락했을 경우
1000 판매자 즉시할인 값은 판매가의 70% 까지만 입력 가능합니다 < (1000000000 < 0) 판매자할인 정액 초과 입력했을 경우
1000 [InvalidApiRequestEx][IAC] 판매자 부담할인 정률 설정의 경우 1~70%까지 입력이 가능합니다 < 판매자할인 정률 초과 입력했을 경우
1000 ":"[InvalidApiRequestEx]일문 상품명(jpn)은 최대 100byte까지 입력 가능합니다 < 일문상품명 100bytes 초과 작성했을 경우
1000 [InvalidApiRequestEx][IAC]카테고리 코드가 없습니다 < 옥션 카테고리 코드 입력하지 않았을 경우
1000 옥션 또는 지마켓 하나의 상품번호만 입력해주세요 2.0상품전환API에서 옥션/지마켓 상품번호 모두 입력했거나, 입력하지 않았을 경우
1000 상품 등록/수정 중 오류가 발생하였습니다. 존재하지 않는 카테고리에 등록/수정 시도시
1000 제주/도서산간지역 배송 여부를 배송 불가로 변경할 권한이 없습니다. 제주/도서산간지역 배송불가 설정 권한이 없는데 불가로 설정하려고 시도할 경우
1000 [G/A] 설치예약상품 등록 권한이 없거나등록 가능한 카테고리가 아닙니다. G/A 동시 등록시판매자가 예약설치 상품 등록 권한이 없으나예약설치 관련 항목을 입력한 경우
G/A 동시 등록시예약설치 대상 카테고리가 아닌 카테고리코드를 입력한 경우
1000 [A] 설치예약상품 등록 권한이 없거나등록 가능한 카테고리가 아닙니다. A 단일 등록시판매자가 예약설치 상품 등록 권한이 없으나예약설치 관련 항목을 입력한 경우
A 단일 등록시예약설치 대상 카테고리가 아닌 카테고리코드를 입력한 경우
1000 [G] 설치예약상품 등록 권한이 없거나등록 가능한 카테고리가 아닙니다. G 단일 등록시판매자가 예약설치 상품 등록 권한이 없으나예약설치 관련 항목을 입력한 경우
G 단일 등록시예약설치  대상 카테고리가 아닌 카테고리코드를 입력한 경우
1000 설치상품 모델코드는 100자 이하로 입력해주세요. 예약설치 상품 모델코드 값에 100자 초과 입력한 경우
1000 설치상품 제조사에 허용된 제조사 코드를 입력해주세요. 예약설치 상품 제조사코드가 아닌 값을 입력한 경우
1000 [G/A] 설치예약 상품은 일반 상품으로 수정이 불가합니다. G/A 동시 수정시예약설치 상품 여부를 true 에서 false로 수정을 시도한 경우
1000 [A] 설치예약 상품은 일반 상품으로 수정이 불가합니다. A 단일 수정시예약설치 상품 여부를 true 에서 false로 수정을 시도한 경우
1000 [G] 설치예약 상품은 일반 상품으로 수정이 불가합니다. G 단일 수정시예약설치 상품 여부를 true 에서 false로 수정을 시도한 경우
1000 설치예약 상품은 설치예약 상품 제조사코드가 필수입력 항목입니다. 예약설치 상품 여부(IsInstall) true이나예약설치 상품 제조사코드 또는 예약설치 상품 모델코드를 입력하지 않은 경우