|
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: 설치예약 상품 false: 설치예약 상품 아님 * 예약설치 상품 권한 있을경우에만 설정 가능 * 상품등록시 해당 항목 미입력/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이나, 예약설치 상품 제조사코드 또는 예약설치 상품 모델코드를 입력하지 않은 경우 |
'스마일배송 API > 상품 등록, 수정' 카테고리의 다른 글
| 스마일배송(3PL) 추천옵션 관리 API (0) | 2022.10.11 |
|---|---|
| 스마일배송(3PL) 가격/판매상태 관리 API (0) | 2022.10.11 |