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} 상품 전환 : [POST] https://sa2.esmplus.com/item/v1/goods/convert-legacy-goods |
G마켓, 옥션 2.0 상품 등록/수정 합니다. 양사이트 동시 등록, 사이트별 개별 등록 모두 가능합니다. 2.0 상품은 마스터상품번호(goodsNo) 하위 사이트(G마켓/옥션) 상품번호 생성되며 수정시에는 마스터상품번호로 호출하며 주문/배송/클레임/정산 API는 사이트 번호 내려가기 때문에 모든 상품번호를 관리해야 합니다. 등록 후 바로 상품 수정 호출 시 에러 발생하며 2~3분 뒤 수정 가능합니다. 상품수정 API는 전체 정보 일괄 수정 경우만 사용하고 그 외 기능별 Partial API 로 수정 하면 됩니다. 전환 API는 전환 하는 사이트별 1.0 상품번호 추가해서 모든 정보 입력하여 전환 가능 합니다. |
Request Description
항목 | 항목명 | 필수여부 | Type | Description |
itemBasicInfo > goodsName > kor | 검색용 상품명 (국문) | Y | stirng | - 검색용+프로모션용 최대 100byte 까지 가능 - 검색용은 등록 후 10일 경과 또는 10일 내 판매 발생시 수정 불가 |
itemBasicInfo > goodsName > promotion | 프로모션명 (공통, 지마켓) | string | - 검색용 + 프로모션용 최대 100byte 까지 입력 가능 - 프로모션용은 상시 수정 가능 - 사이트별 입력시 지마켓 프로모션명 |
|
itemBasicInfo > goodsName > promotionType | 프로모션명 타입 | int | 0 : 공통 1 : 사이트별 미입력시 공통 입력으로 처리 |
|
itemBasicInfo > goodsName > promotionIac | 프로모션명 (옥션) | string | - 검색용 + 프로모션용 최대 100byte 까지 입력 가능 - 프로모션용은 상시 수정 가능 - 사이트별 입력시 옥션 프로모션명 |
|
itemBasicInfo > goodsName > eng | 영문상품명 | string | 최대 100byte 까지 가능 | |
itemBasicInfo > goodsName > chi | 중문상품명 | string | 최대 100byte 까지 가능 | |
itemBasicInfo > category > esm > catCode | ESM 카테고리 코드 | string | ESM 카테고리 코드 등록 | |
itemBasicInfo > category > site > siteType | G마켓/옥션 카테고리 사이트구분 | Y | int | 1 : 옥션 2 : G마켓 |
itemBasicInfo > category > site > catCode | G마켓/옥션 카테고리코드 | Y | string | G마켓/옥션 최하위(Leaf) 카테고리 코드 등록 |
itemBasicInfo > category > shop > siteType | 미니샵 카테고리 사이트구분 | int | 1 : 옥션 2 : G마켓 |
|
itemBasicInfo > category > shop > largeCatCode | 미니샵 대카테고리코드 | string | 미니샵 대카테고리 코드 등록 * 미니샵 카테고리 조회 API (참고) |
|
itemBasicInfo > category > shop > middleCatCode | 미니샵 중카테고리코드 | string | 미니샵 중카테고리 코드 등록 * 미니샵 카테고리 조회 API (참고) |
|
itemBasicInfo > category > shop > smallCatCode | 미니샵 소카테고리코드 | string | 미니샵 소카테고리 코드 등록 * 미니샵 카테고리 조회 API (참고) |
|
itemBasicInfo > book > isUseIsbnCode | (도서상품용) ISBN코드 사용여부 |
boolean | 도서 카테고리 등록시 필수 true : ISBN 코드 입력 false : ISBN 코드 미입력 |
|
itemBasicInfo > book > isbnCode | (도서상품용) ISBN코드 |
string | 도서 카테고리 등록시 필수 | |
itemBasicInfo > book > price | (도서상품용) 도서 정가 |
number | 도서 카테고리 등록시 필수 | |
itemBasicInfo > book > attributeCode | 사용하지 않음 | string | ||
itemBasicInfo > catalog > modelName | 모델명 | string | 상품 모델명 입력 | |
itemBasicInfo > catalog > brandNo | 브랜드코드 | int | 브랜드코드 조회 API로 확인 가능 (참고) | |
itemBasicInfo > catalog > barCode | 바코드 | string | 바코드 입력 | |
itemBasicInfo > catalog > epinCode | ESM 상품식별코드 | string | 등록/수정시 null 호출 | |
itemBasicInfo > goodsType | (G마켓용) 상품타입 |
int | 1 : 일반 배송 상품 2 : e쿠폰 상품 |
|
itemAddtionalInfo > buyableQuantity > type | 최대 구매 허용 수량 설정 | int | 0 : 구매수량 제한 없음 1 : 1회당 최대 구매수량 2 : ID당 최대 구매수량 3 : 기간당 최대 구매수량 * 최소구매수량 설정 별도 API 설정 (참고) |
|
itemAddtionalInfo > buyableQuantity > qty | 최대구매수량 | int | 최대 구매 허용 수량 1 ~ 999 입력 가능 |
|
itemAddtionalInfo > buyableQuantity > unitDate | 제한 기간 | int | 최대 구매 허용 수량 설정 = 3 경우 필수 1 ~ 209 입력 가능 |
|
itemAddtionalInfo > buyableQuantityPolicy > BuyableUnitCount | 배수 구매 설정 | int | - 당일배송 상품에서만 사용 가능 - 2 이상 설정 시 배수 설정 가능 |
|
itemAddtionalInfo > price > Gmkt | G마켓 판매가격 | Y | number | - 10원 이상 10억 미만 입력 가능 - 10원 단위로 입력 가능 |
itemAddtionalInfo > price > Iac | 옥션 판매가격 | Y | number | - 10원 이상 10억 미만 입력 가능 - 10원 단위로 입력 가능 |
itemAddtionalInfo > stock > Gmkt | G마켓 재고수량 | Y | int | - 1 ~ 99999까지 입력 가능, 0 설정 불가 - 옵션 등록시 옵션재고관리(true) 선택할 경우 본 수량 무시되고 옵션 재고합으로 산정 |
itemAddtionalInfo > stock > Iac | 옥션 재고수량 | Y | int | - 1 ~ 99999까지 입력 가능 0설정 불가 - 옵션 등록시 옵션재고관리(true) 선택할 경우 본 수량 무시되고 옵션 재고합으로 산정 |
itemAddtionalInfo > sellingPeriod > Gmkt | G마켓 판매기간 | Y | int | - G마켓 판매 기간 입력 - 입력 가능 기간 : -1(무제한), 15, 30, 60, 90 - 수정시 0 입력 경우 기존 기간 유지 - 조회 API 경우 남은 판매 기간 확인 가능 * ESM+ 판매기간 노출 (Beta) 상품 조회/수정 : 설정안함 상품관리2.0 : 9999-12-31 (365일+) |
itemAddtionalInfo > sellingPeriod > Iac | 옥션 판매기간 | Y | int | - 옥션 판매 기간 입력 - 입력 가능 기간 : -1(무제한), 15, 30, 60, 90 - 수정시 0 입력 경우 기존 기간 유지 - 조회 API 경우 남은 판매 기간 확인 가능 * ESM+ 판매기간 노출 (Beta) 상품 조회/수정 : 설정안함 상품관리2.0 : 9999-12-31 (365일+) |
itemAddtionalInfo > managedCode | 판매자 상품코드 | string | 관리 코드 or 자사몰 상품번호 입력 | |
itemAddtionalInfo > recommendedOpts > type | 추천옵션 타입 (옵션별 샘플은 https://etapi.gmarket.com/26 에서 확인 가능) |
Y | int | 0 : 옵션 미사용 1 : 선택형, independent로 입력 (2개 이상은 independents) 2 : 2개 조합형, combination으로 입력 3 : 3개 조합형, combination으로 입력 4 : 계산형, calculation 로 입력 5 : 텍스트형 6 : 선택형 + 텍스트형 7 : 2개 조합형 + 텍스트형 8 : 3개 조합형 + 텍스트형 9 : 선택형 + 계산형 * 선택형 50개, 조합형 500개까지 등록 가능 |
itemAddtionalInfo > recommendedOpts > isStockManage | 옵션재고관리 | Boolean | - 추천옵션 사용일 경우 필수 - 텍스트형 경우 false 로 연동 |
|
itemAddtionalInfo > recommendedOpts > inputType | 옵션 사이트별 설정 여부 | int | 0 : 공통 1 : 사이트별 |
|
itemAddtionalInfo > recommendedOpts > independent > recommendedOptNo | (선택형/조합형) 추천옵션코드 |
int | 추천옵션 사용일 경우 필수 카테고리별 추천옵션 조회 API에서 매칭된 코드 입력 (참고) |
|
itemAddtionalInfo > recommendedOpts > independent > recommendedOptName > koreanText | (선택형/조합형) 추천옵션명 (국문) 직접입력 |
string | 직접입력 허용 카테고리에 옵션명 직접입력 설정하는 경우 |
|
itemAddtionalInfo > recommendedOpts > independent > recommendedOptName > englishText | (선택형/조합형) 추천옵션명 (영문) 직접입력 |
string | ||
itemAddtionalInfo > recommendedOpts > independent > recommendedOptName > chineseText | (선택형/조합형) 추천옵션명 (중문) 직접입력 |
string | ||
itemAddtionalInfo > recommendedOpts > independent > recommendedOptName > japaneseText | (선택형/조합형) 추천옵션명 (일문) 직접입력 |
string | ||
itemAddtionalInfo > recommendedOpts > independent > recommendedOptName > exposeLanguage | 노출언어 선택 | int | 1 : 한국어 2 : 영어 한글 표시 3 : 영어 *조회 API 는 0 으로만 내려감 |
|
itemAddtionalInfo > recommendedOpts > independent > recommendedOptNo | (선택형/조합형) 추천옵션코드 |
int | 추천옵션 사용일 경우 필수 카테고리별 추천옵션 조회 API에서 매칭된 코드 입력 (참고) |
|
itemAddtionalInfo > recommendedOpts > independent > details > recommendedOptValueNo | (선택형/조합형) 추천옵션항목코드 |
int | 추천옵션 사용일 경우 필수 추천옵션별 선택항목 조회 API에서 매칭된 코드 입력 (참고) |
|
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 | 1 : 한국어 2 : 영어 한글 표시 3 : 영어 *조회 API 는 0 으로만 내려감 |
|
itemAddtionalInfo > recommendedOpts > independent > details > isSoldOut | (선택형/조합형) 품절여부 |
Boolean | 옵션의 품절 여부 제어 (옵션 재고 수량으로 제어하지 않음) true : 품절 false : 판매 |
|
itemAddtionalInfo > recommendedOpts > independent > details > isSoldOutSite > gmkt | (선택형/조합형) 품절여부 - 사이트별 G마켓 |
Boolean | G마켓 옵션의 품절 여부 제어 (옵션 재고 수량으로 제어하지 않음) true : 품절 false : 판매 ※ 사이트별 설정 (inputType : 1)인 경우 제어 가능 |
|
itemAddtionalInfo > recommendedOpts > independent > details > isSoldOutSite > iac | (선택형/조합형) 품절여부 - 사이트별 옥션 |
Boolean | 옥션 옵션의 품절 여부 제어 (옵션 재고 수량으로 제어하지 않음) true : 품절 false : 판매 ※ 사이트별 설정 (inputType : 1)인 경우 제어 가능 |
|
itemAddtionalInfo > recommendedOpts > independent > details > isDisplay | (선택형/조합형) 노출여부 |
Boolean | 옵션의 노출 여부 제어 true : 노출 false : 미노출 |
|
itemAddtionalInfo > recommendedOpts > independent > details > isDisplaySite > gmkt | (선택형/조합형) 노출여부 - 사이트별 G마켓 |
Boolean | G마켓 옵션의 노출 여부 제어 true : 노출 false : 미노출 ※ 사이트별 설정 (inputType : 1)인 경우 제어 가능 |
|
itemAddtionalInfo > recommendedOpts > independent > details > isDisplaySite > iac | (선택형/조합형) 노출여부 - 사이트별 G마켓 |
Boolean | 옥션 옵션의 노출 여부 제어 true : 노출 false : 미노출 ※ 사이트별 설정 (inputType : 1)인 경우 제어 가능 |
|
itemAddtionalInfo > recommendedOpts > independent > details > qty > iac | (선택형/조합형) 옥션 재고수량 |
int | 옥션 옵션 재고 수량 입력 | |
itemAddtionalInfo > recommendedOpts > independent > details > qty > gmkt | (선택형/조합형) G마켓 재고수량 |
int | G마켓 옵션 재고 수량 입력 | |
itemAddtionalInfo > recommendedOpts > independent > details > manageCode | (선택형/조합형) 판매자옵션관리코드 |
string | - 관리하는 옵션 코드 입력 - 20byte 이내 입력 가능 |
|
itemAddtionalInfo > recommendedOpts > independent > details > addAmnt | 주문옵션 추가금 | number | 2천원 미만 (0 ~ 100%) 1만원 미만 (-50 ~ 100%) 1만원이상 (기본값 -50 ~ 50%, 일부 카테고리 별도 정책) |
|
itemAddtionalInfo > recommendedOpts > independent > details > addAmntSite > gmkt | 주문옵션 추가금 - 사이트별 G마켓 | number | 2천원 미만 (0 ~ 100%) 1만원 미만 (-50 ~ 100%) 1만원이상 (기본값 -50 ~ 50%, 일부 카테고리 별도 정책) ※ 사이트별 설정 (inputType : 1)인 경우 제어 가능 |
|
itemAddtionalInfo > recommendedOpts > independent > details > addAmntSite > iac | 주문옵션 추가금 - 사이트별 옥션 | number | 2천원 미만 (0 ~ 100%) 1만원 미만 (-50 ~ 100%) 1만원이상 (기본값 -50 ~ 50%, 일부 카테고리 별도 정책) ※ 사이트별 설정 (inputType : 1)인 경우 제어 가능 |
|
itemAddtionalInfo > recommendedOpts > text > details > value > isDisplay | (텍스트형) 노출여부 |
Y | Boolean | true : 노출 false : 미노출 |
itemAddtionalInfo > recommendedOpts > text > details > value > recommendedOptNo | (텍스트형) 추천옵션코드 |
Y | int | 추천옵션별 선택항목 조회 API에서 매칭된 코드 입력 (참고) |
itemAddtionalInfo > recommendedOpts > calculation > name1 > kor | (계산형) 옵션명1 |
string | ||
itemAddtionalInfo > recommendedOpts > calculation > name2 > kor | (계산형) 옵션명2 |
string | ||
itemAddtionalInfo > recommendedOpts > calculation > minValue1 | (계산형) 옵션명1 (name 1) 판매 최소값 |
int | 1 이상 입력 가능 | |
itemAddtionalInfo > recommendedOpts > calculation > minValue2 | (계산형) 옵션명2 (name 2) 판매 최소값 |
int | 1 이상 입력 가능 | |
itemAddtionalInfo > recommendedOpts > calculation > maxValue1 | (계산형) 옵션명1 (name 1) 판매 최대값 |
int | 1 이상 입력 가능 | |
itemAddtionalInfo > recommendedOpts > calculation > maxValue2 | (계산형) 옵션명2 (name 2) 판매 최대값 |
int | 1 이상 입력 가능 | |
itemAddtionalInfo > recommendedOpts > calculation > unitPrice | (계산형) 단가 기준값 |
int | 1 이상 입력 가능 | |
itemAddtionalInfo > recommendedOpts > calculation > unitType | (계산형) 판매 단위 |
string | 입력 가능 단위 "mm", "cm", "m", "mg", "g", "kg", "ml", "l" |
|
itemAddtionalInfo > recommendedOpts > calculation > unitValue | (계산형) 판매 단위값 |
int | 1 이상 입력 가능 | |
itemAddtionalInfo > recommendedOpts > calculation > manageCode | (계산형) 옵션관리코드 |
string | 20byte 이내 입력 가능 | |
itemAddtionalInfo > inventoryCode | (G마켓용) G마켓 인벤토리 코드 |
string | (G마켓 상품용) 상품 정보가 변경된 시점(상품정보, 가격정보)에 등록된 code를 주문정보에 포함하여 전달함 |
|
itemAddtionalInfo > sellerShop > catCode | 판매자 카테고리코드 | string | 자사몰 카테고리 대/중/소/상세 코드 입력 * 추후 카테고리 자동 재분류를 위한 기준 자료로 활용 예정 |
|
itemAddtionalInfo > sellerShop > catName | 판매자 카테고리명 | string | 자사몰 카테고리 대/중/소/상세 합쳐서 전체 텍스트명 입력 * 추후 카테고리 자동 재분류를 위한 기준 자료로 활용 예정 |
|
itemAddtionalInfo > sellerShop > brandCode | 판매자 브랜드코드 | string | 자사몰 브랜드코드 * 추후 카테고리 자동 재분류를 위한 기준 자료로 활용 예정 |
|
itemAddtionalInfo > sellerShop > brandName | 판매자 브랜드명 | string | 자사몰 브랜드명 * 추후 카테고리 자동 재분류를 위한 기준 자료로 활용 예정 |
|
itemAddtionalInfo > expiryDate | 유효일 | date | YYYY-MM-DD 형태로 입력 | |
itemAddtionalInfo > manufacturedDate | 제조일(발행일) | date | - YYYY-MM-DD 형태로 입력 - 도서 경우 출판 발행일 제조일에 입력 필요 |
|
itemAddtionalInfo > origin > goodsType | 원산지상품 타입 | int | 0 : 원산지표시대상아님 (식품 카테고리 외) 1 : 상세설명참조 2 : 가공품 3 : 농산물 4 : 수산물 |
|
itemAddtionalInfo > origin > type | 원산지지역 타입 | int | 0 : 없음 1 : 국내산 2 : 수입산 3 : 기타 * 상세설명참조일 경우 0 ~ 3 모두 입력 가능 * 상품 조회 시 상세설명참조는 0으로 내려감 |
|
itemAddtionalInfo > origin > code | 원산지지역 코드 | string | 아래 조회 API 로 확인 https://etapi.gmarket.com/162 |
|
itemAddtionalInfo > origin > isMultipleOrigin | 복수원산지 여부 | 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 : 택배 2 : 직접배송 |
itemAddtionalInfo > shipping > companyNo | 택배사코드 | Y | int | - 배송방법 타입 1번 선택 시 입력 - 불가 택배사 코드 입력시 기타택배로 처리 * 택배사 리스트 조회 API (참고) |
itemAddtionalInfo > shipping > policy > placeNo | 출하지번호 | int | ||
itemAddtionalInfo > shipping > policy > feeType | 배송비 타입 | Y | int | 묶음배송비 또는 상품별 배송비 여부 설정 1 : 묶음배송비 2 : 상품별배송비 |
itemAddtionalInfo > shipping > policy > bundle > deliveryTmplId | 묶음배송비정책번호 | bigint | 묶음배송비 정책번호 입력 * 동일 출하지 경우 묶음배송 구매 가능하며, 묶음배송비 배송비가 작은 금액으로 기본 적용 |
|
itemAddtionalInfo > shipping > policy > each > feeType | 상품별배송비 타입 | int | 1 : 무료 2 : 유료 3 : 조건부무료 4 : 수량별차등 |
|
itemAddtionalInfo > shipping > policy > each > feePayType | 상품별배송비지불방법 | int | 1 : 선결제/착불 모두 가능 2 : 선결제만 가능 3 : 착불만 가능(옥션만 등록 시 설정 가능, 동시등록 또는 지마켓만 등록 시 불가) |
|
itemAddtionalInfo > shipping > policy > each > fee | 상품별배송비금액 | number | ||
itemAddtionalInfo > shipping > policy > each > details > Condition | 상품별배송비 조건 | int | 수량별차등인 경우 5단계까지 설정 가능 | |
itemAddtionalInfo > shipping > policy > each > details > FeeAmnt | 상품별배송비조건부금액 | int | 수량별 차등 경우 양사 등록 or G마켓 단일 등록 시 배송비할증 설정만 가능 카테고리별 최대 배송비까지만 입력 가능 |
|
itemAddtionalInfo > shipping > returnAndExchange > addrNo | (반품/교환 주소) 판매자주소번호 |
int | ||
itemAddtionalInfo > shipping > returnAndExchange > shippingCompany | (사용불가) | int | - 원배송 택배사와 동일하게 자동 설정 - 입력해도 처리되지 않음 |
|
itemAddtionalInfo > shipping > returnAndExchange > fee | 반품/교환 편도배송비 | number | - 미입력, 0 : 무료 - 금액입력 : 편도배송비로 반영 - 기본 최대 10,000원까지 설정 가능 (카테고리별 배송비 예외 카테고리) |
|
itemAddtionalInfo > shipping > dispatchPolicyNo > gmkt | (G마켓용) 발송정책번호 |
Y | int | G마켓 발송정책번호 입력 동시 등록시 옥션과 동일한 정책 번호 입력 |
itemAddtionalInfo > shipping > dispatchPolicyNo > iac | (옥션용) 발송정책번호 |
Y | int | 옥션 발송정책번호 입력 동시 등록시 지마켓과 동일한 정책 번호 입력 |
itemAddtionalInfo > shipping > visitAndTake > isUse | 방문수령 제공여부 | Boolean | 방문수령 서비스 가능한 상품 여부 입력 true : 방문수령 가능 false : 방문수령 불가 |
|
itemAddtionalInfo > shipping > visitAndTake > type | 방문수령혜택 | int | 1 : 구매자 혜택없음 2 : 가격할인 3 : 사은품 |
|
itemAddtionalInfo > shipping > visitAndTake > discount | 방문수령 가격할인 | number | 방문수령혜택 > 2 : 가격할인 일 경우 필수 가격할인(금액환불)할 금액 입력 |
|
itemAddtionalInfo > shipping > visitAndTake > gifts | 방문수령 사은품 | string | 방문수령혜택 > 3 : 사은품 일 경우 필수 사은품으로 제공할 혜택 텍스트입력 |
|
itemAddtionalInfo > shipping > visitAndTake > addrNo | 방문수령 주소번호 | int | ||
itemAddtionalInfo > shipping > quickService > isUse | 퀵서비스 제공여부 | Boolean | true : 가능 false : 불가 |
|
itemAddtionalInfo > shipping > quickService > companyName | 퀵서비스 업체명 | string | 퀵서비스 업체 텍스트 입력 | |
itemAddtionalInfo > shipping > quickService > phoneNo | 퀵서비스 연락처 | string | 숫자만 입력 | |
itemAddtionalInfo > shipping > quickService > shippingEnableRegionCode | 퀵서비스 제공지역 | string | Code 복수입력 가능 0100:서울, 0200:경기(전체), 0201 : 고양, 0202 : 고촌, 0203 : 곤지암, 0204 : 과천, 0205 : 광명, 0206 : 광주, 0207 : 교문리, 0208 : 구리, 0209 : 구성, 0210 : 군포, 0211 : 김포, 0212 : 부천, 0213 : 분당, 0214 : 성남, 0215 : 수원, 0216 : 수지, 0217 : 시흥, 0218 : 안산, 0219 : 안양, 0220 : 용인, 0221 : 의왕, 0222 : 의정부, 0223 : 이천, 0224 : 일산, 0225 : 지축, 0226 : 파주, 0227 : 하남, 0300:광주, 0400:대구, 0500:대전, 0600:부산, 0700:울산, 0800:인천 |
|
itemAddtionalInfo > shipping > backwoodsDeliveryYn | 제주/도서산간배송불가여부 | string | Y : 배송가능 N : 배송불가 * 권한 부여 경우만 설정 가능 |
|
itemAddtionalInfo > officialNotice > officialNoticeNo | 상품정보고시 상품군코드 | Y | int | 아래 url 내 조회 API 로 확인 https://etapi.gmarket.com/161 |
itemAddtionalInfo > officialNotice > details > officialNoticeItemelementCode | 상품정보고시 항목코드 | Y | string | 아래 url 내 조회 API 로 확인 https://etapi.gmarket.com/161 |
itemAddtionalInfo > officialNotice > details > value | 상품정보고시 값 | Y | string | 상품정보고시 값 |
itemAddtionalInfo > officialNotice > isExtraMark | 상품정보고시 추가입력여부 |
Y | Boolean | true : 추가입력고시 false : 추가입력 없음 |
itemAddtionalInfo > isAdultProduct | (청소년) 미성년자 구매 여부 |
Y | Boolean | true : 성인상품 false : 일반상품 |
itemAddtionalInfo > isYouthNotAvailable | (사용하지 않음) | Boolean | ||
itemAddtionalInfo > isVatFree | 부가세여부 | Y | Boolean | 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일 경우 필수 | |
itemAddtionalInfo > certInfo > iac > medicalInstrument > certId | (옥션용) 의료기기 판매신고 번호 |
string | 의료기기 인증 사용 여부 true일 경우 필수 | |
itemAddtionalInfo > certInfo > iac > medicalInstrument > itemLicenseId | (옥션용) 의료기기 품목 허가 번호 |
string | 의료기기 인증 사용 여부 true일 경우 필수 | |
itemAddtionalInfo > certInfo > iac > medicalInstrument > adDeliberationId | (옥션용) 의료기기 사전 광고 심의 번호 |
string | 의료기기 인증 사용여부 true일 경우 필수 | |
itemAddtionalInfo > certInfo > iac > broadcastEquipment > isAddtionalCondition | (옥션용) 방송통신기기인증정보상 품상세별도표기 |
Boolean | 방송통신기기 인증 사용 여부 true일 경우 필수 | |
itemAddtionalInfo > certInfo > iac > food > isUse | (옥션용) 식품제조가공업 입력사항 여부 |
Y | Boolean | true : 신고대상 false : 신고대상 아님 |
itemAddtionalInfo > certInfo > iac > food > certOfficeName | (옥션용) 신고기관명 |
string | ||
itemAddtionalInfo > certInfo > iac > food > certId | (옥션용) 신고번호 |
string | ||
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 : 안전인증 1 : 안전확인 2 : 공급자적합성확인 |
|
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 : 안전인증 1 : 안전확인 2 : 공급자적합성확인 |
|
itemAddtionalInfo > certInfo > safetyCerts > electric > mandatorySafetySign | 병행수입여부 | int | 0 : 해당사항없음 1 : 병행수입 2 : 구매대행 |
|
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 : 안전인증 1 : 안전확인 2 : 공급자적합성확인 |
|
itemAddtionalInfo > certInfo > safetyCerts > life > mandatorySafetySign | 병행수입여부 | int | 0 : 해당사항없음 1 : 병행수입 2 : 구매대행 |
|
itemAddtionalInfo > certInfo > safetyCerts > harmful > type | 위해우려제품인증 타입 | int | 설정 없을 경우 기본 상세설명 별도표기 설정 0 : 인증대상 1 : 인증대상아님 2 : 상세설명 별도표기 |
|
itemAddtionalInfo > certInfo > safetyCerts > harmful > certId | 통합자가검사번호 | string | type > 0 경우 필수 100byte 이내 입력 가능 |
|
itemAddtionalInfo > images > basicImgURL | 상품기본이미지 | Y | string | ESM+ 가이드 (참고) 사이즈: 최소 600x600, 권장 1000x1000 용량: 2MB 이하 포맷: jpg, png 옥션 경우 동일이미지 중복 사용 불가 |
itemAddtionalInfo > images > addtionalImg1URL ~ addtionalImg14URL | 상품추가이미지1~14 | string | 추가 이미지는 1 ~ 14 까지 설정 가능 옥션 경우 동일이미지 중복 사용 불가 |
|
itemAddtionalInfo > weight | (G마켓용) 상품무게(단위:kg) |
number | - 숫자로 입력(소수점 1자리 가능) - 최대 30kg까지 설정 가능 - 해외 주문 발생 경우 해외배송비 산정에 사용 - 미입력시 카테고리별 무게로 배송비 산정 |
|
itemAddtionalInfo > descriptions > kor > type | 상품상세정보 타입 | Y | int | 1 : contentID (추후제공) 2 : html |
itemAddtionalInfo > descriptions > kor > contentId | 상품상세정보 코드 | string | 상품상세정보 타입 1일 경우 필수(추후제공) | |
itemAddtionalInfo > descriptions > kor > html | 상품상세정보 html | Y | string | ESM+ 가이드 (참고) iframe, Script, 및 max-width 등은 사용 불가 |
itemAddtionalInfo > addonService > addonServiceUseType | 추가구성 사용여부 | Y | int | 0 : 사용하지 않음 1 : 사용 - 재고 관리 안 함 2 : 사용 - 재고 관리함 |
itemAddtionalInfo > addonService > addonServiceList > addonServiceType | 추가구성 항목타입 | Y | int | 1 : 선택형 2 : 판매자 입력형 3 : 텍스트형 4 : 직접입력 |
itemAddtionalInfo > addonService > addonServiceList > addonServiceSeq | 추가구성 항목 코드 | Y | int | 추가구성 항목 코드 입력 (참고) |
itemAddtionalInfo > addonService > addonServiceList > addonServiceValueSeq | 추가구성 항목값 코드 | Y | int | 추가구성 항목값 코드 입력 (참고) |
itemAddtionalInfo > addonService > addonServiceList > addonServiceName | 추가구성 항목 이름 | Y | string | 추가구성 선택형, 판매자 입력형 항목 이름 추가 |
itemAddtionalInfo > addonService > addonServiceList > addonServiceValueName | 추가구성 항목값 이름 | Y | string | 판매자 텍스트형일 경우, 추가구성 항목값 직접입력 |
itemAddtionalInfo > addonService > addonServiceList > addonServiceAmnt | 추가구성 추가금 | Y | Number | 추가구성 항목별 추가금(원)입력 |
itemAddtionalInfo > addonService > addonServiceList > sortSeq | 정렬순번 | Y | string | 1부터 양수로 노출순서 설정 가능 |
itemAddtionalInfo > addonService > addonServiceList > qtyInfo > isSoldOut | 추가구성 품절여부 | Y | Boolean | true : 품절 false : 품절 아님 |
itemAddtionalInfo > addonService > addonServiceList > qtyInfo > exposeYN | 추가구성 노출여부 | Boolean | true : 노출 false : 노출하지 않음 |
|
itemAddtionalInfo > addonService > addonServiceList > qtyInfo > qty > iac | 옥션 추가구성 재고 수량 | int | ||
itemAddtionalInfo > addonService > addonServiceList > qtyInfo > qty > gmkt | 지마켓 추가구성 재고 수량 | int | ||
itemAddtionalInfo > addonService > manageCode | 추가구성 관리코드 | string | ||
itemAddtionalInfo > goodsStatus | 상품상태 | int | 1 : 신상품 2 : 중고상품 |
|
itemAddtionalInfo > preSaleShippingDate | 옥션 예약판매 (예약 배송일) | date | - 옥션만 설정 가능 - 등록시 설정 가능, 수정시 설정 및 수정 불가 - 발송정책 당일발송, 순차발송 경우 설정 가능 - 등록일 이후 5일 ~ 1년 이내 설정이 가능 |
|
itemAddtionalInfo > isGift | 선물하기 상품 여부 | boolean | 선물하기 상품 여부 선택 true : 선물하기 가능 false : 선물하기 불가능 * 미입력/skip 시 default = true 로 등록됨 |
|
itemAddtionalInfo > Install > IsInstall | 예약설치 상품 여부 | boolean | 설치예약 상품 여부 선택 true: 설치예약 상품 false: 설치예약 상품 아님 * 예약설치 상품 권한 있을경우에만 설정 가능 * 상품등록시 해당 항목 미입력/skip 시, default IsInstall: false로 등록됨 |
|
itemAddtionalInfo > Install > InstallMakerId | 예약설치 상품 제조사코드 | long | 설치예약 상품 여부 true일 경우 필수 LG: 15405 삼성: 1897 |
|
itemAddtionalInfo > Install > InstallModelCode |
예약설치 상품 모델코드 | string | 설치예약 상품 여부 true일 경우 필수 * 설치예약상품 모델 코드가 없을 경우, 판매자 관리코드(managedCode)와 동일 값으로 입력 |
|
itemAddtionalInfo > eCoupon > moneyType | (G마켓용) e쿠폰가격 정액/정률 여부 | Y | int | 1 : 정액 2 : 정률 |
itemAddtionalInfo > eCoupon > price | (G마켓용) e쿠폰가격 | Y | money | |
itemAddtionalInfo > eCoupon > couponName | (G마켓용) e쿠폰명 | Y | string | |
itemAddtionalInfo > eCoupon > expireType | (G마켓용) 정산기간 | Y | int | 0 : 특정기간 1 : 자동기간 (구매완료 후 *일) |
itemAddtionalInfo > eCoupon > expire1StartDate | (G마켓용) 정산기간 특정 시작일 | Y | date | 특정기간 설정시 필수 |
itemAddtionalInfo > eCoupon > expire1EndDate | (G마켓용) 정산기간 특정 종료일 | Y | date | 특정기간 설정시 필수 |
itemAddtionalInfo > eCoupon > expire2Start | (G마켓용) 정산기간 자동 시작일 | Y | int | - 자동기간 설정시 필수 - 0 : 오늘부터 |
itemAddtionalInfo > eCoupon > expire2Duration | (G마켓용) 정산기간 자동 기간 | Y | int | 자동기간 설정시 필수 |
itemAddtionalInfo > eCoupon > useTermType | (G마켓용) 유효기간 | Y | int | 0 : 특정기간 1 : 자동기간 (구매완료 후 *일) |
itemAddtionalInfo > eCoupon > useTerm1StartDate | (G마켓용) 유효기간 특정 시작일 | Y | date | 특정기간 설정시 필수 |
itemAddtionalInfo > eCoupon > useTerm1EndDate | (G마켓용) 유효기간 특정 종료일 | Y | date | 특정기간 설정시 필수 |
itemAddtionalInfo > eCoupon > useTerm2Start | (G마켓용) 유효기간 자동 구매 이후일 | Y | int | - 자동기간 설정시 필수 - 0 : 오늘부터 |
itemAddtionalInfo > eCoupon > useTerm2Duration | (G마켓용) 유효기간 자동 사용 기간 | Y | int | - 자동기간 설정시 필수 |
itemAddtionalInfo > eCoupon > couponTemplate | (G마켓용) e쿠폰 인쇄용 템플릿 번호 | int | ||
itemAddtionalInfo > eCoupon > couponImageUrl | (G마켓용) e쿠폰 인쇄용 양식 URL | string | ||
itemAddtionalInfo > eCoupon > downloadTemplate | (G마켓용) e쿠폰 모바일용 템플릿 번호 | int | ||
itemAddtionalInfo > eCoupon > downloadImageUrl | (G마켓용) e쿠폰 모바일용 양식 URL | string | ||
itemAddtionalInfo > eCoupon > applyPlace | (G마켓용) 사용장소 | Y | string | |
itemAddtionalInfo > eCoupon > isInformByAddress | (G마켓용) 주소로 안내 여부 | boolean | ||
itemAddtionalInfo > eCoupon > isInformByURL | (G마켓용) URL 안내 여부 | boolean | ||
itemAddtionalInfo > eCoupon > url | (G마켓용) 안내 URL | string | ||
itemAddtionalInfo > eCoupon > applyPlacePriority | (G마켓용) 사용장소 우선 노출 선택 | int | ||
itemAddtionalInfo > eCoupon > mobileUseInfo | (G마켓용) 사용안내 | Y | string | 사용 관련 유의사항 기재 |
itemAddtionalInfo > eCoupon > mobileHelpDeskphoneNo | (G마켓용) 고객센터 | Y | string | 판매자 고객센터 번호 노출 (ex:1588-xxxx) |
itemAddtionalInfo > eCoupon > telephoneNo | (G마켓용) 연락처 | string | ||
itemAddtionalInfo > eCoupon > additionalBenefit | (G마켓용) 추가혜택 | string | ||
itemAddtionalInfo > eCoupon > hasRestrictCondition | (G마켓용) 사용제한조건 여부 | boolean | ||
itemAddtionalInfo > eCoupon > restrictCondition | (G마켓용) 사용제한조건 있음 경우 내용 | string | ||
itemAddtionalInfo > eCoupon > guide | (G마켓용) 찾아가는길 | Y | string | |
itemAddtionalInfo > eCoupon > publicationCorp | (G마켓용) 발행업체 | Y | string | |
itemAddtionalInfo > eCoupon > publicationCorpURL | (G마켓용) 발행업체 주소 | Y | string | |
itemAddtionalInfo > eCoupon > isCustomerNameView | (G마켓용) 회원명 노출 여부 | boolean | ||
itemAddtionalInfo > eCoupon > period | (옥션용) 유효기간 | Y | int | - 옥션 등록시에만 설정 가능 - 최대 365 까지 설정 가능 |
addtionalInfo > sellerDiscount > isUse | 판매자할인 사용여부 | Y | Boolean | 등록한 판매가 기준 할인 적용 true : 할인 적용 false : 할인미적용 * 옥션 경우 아래 gmkt Entity대신 iac 입력 |
addtionalInfo > sellerDiscount > gmkt > type | (G마켓/옥션용) 할인타입 |
int | 판매자할인 사용여부 true일 경우 필수 0 : 사용안함 1 : 정액 2 : 정률 |
|
addtionalInfo > sellerDiscount > gmkt > priceOrRate1 | (G마켓/옥션용) 할인액(율) |
number | 판매자할인 사용여부 true일 경우 필수 - 정액 설정시 : 최소 100원 이상,10원 단위 - 정률 설정시 : 판매가대비 70%까지 허용 |
|
addtionalInfo > sellerDiscount > gmkt > priceOrRate2 | (G마켓/옥션용) 할인액(율) 2 |
number | 권한이 있는 셀러만 설정 가능 |
|
addtionalInfo > sellerDiscount > gmkt > startDate | (G마켓/옥션용) 할인시작일자 |
date | 입력형식 YYYY-MM-DD |
|
addtionalInfo > sellerDiscount > gmkt > endDate | (G마켓/옥션용) 할인종료일자 |
date | 입력 형식 YYYY-MM-DD |
|
addtionalInfo > siteDiscount > gmkt | (G마켓용) 사이트부담 지원할인 |
Y | Boolean | G마켓 부담 사이트 할인 적용 여부 true : 적용 false : 적용하지 않음 |
addtionalInfo > siteDiscount > iac | (옥션용) 사이트부담 지원할인 |
Y | Boolean | 옥션 부담 사이트 할인 적용 여부 true : 적용 false : 적용하지 않음 |
addtionalInfo > gift | (사용불가) | |||
addtionalInfo > pcs > isUse | 가격비교사이트 상품 노출 여부 |
Y | Boolean | true : 노출함 false : 노출하지 않음 |
addtionalInfo > pcs > isUseIacPcsCoupon | (옥션용) 가격비교사이트 쿠폰적용여부 |
Y | Boolean | - 가격비교사이트에 상품할인적용 여부 - 가격비교사이트 상품 노출하지만 쿠폰 적용 안되도록 설정 가능 true : 적용 false : 미적용 |
addtionalInfo > pcs > isUseGmkPcsCoupon | (사용불가) (G마켓용) 가격비교사이트 쿠폰적용여부 |
Y | Boolean | - G마켓 쿠폰적용여부 설정 불가 - 상품 노출 여부만 가능 |
addtionalInfo > overseaSales > isAgree | (G마켓용) 해외판매여부 |
Y | Boolean | true : 해외판매 진행 false : 해외판매 진행하지 않음 |
isSell > gmkt | (G마켓용) 판매상태 변경 |
Y | Boolean | - 상품수정/전환 API 호출 시 설정 가능 - 등록시 상태 설정은 불가 true : 판매가능 상태 false : 판매중지 상태 |
isSell > iac | (옥션용) 판매상태 변경 |
Y | Boolean | - 상품수정/전환 API 호출 시 설정 가능 - 등록시 상태 설정은 불가 true : 판매가능 false : 판매중지 |
siteGoodsNo > gmkt | G마켓 1.0 상품번호 | Y | string | - 전환 API 사용시 해당 Entity 추가 - 전환하는 G마켓 1.0 상품번호 입력 - 1개의 상품번호만 입력하여 전환 가능 - 전환시 마스터번호 신규 생성 및 1.0 사이트 상품번호 그대로 유지 |
siteGoodsNo > iac | 옥션 1.0 상품번호 | Y | string | - 전환 API 사용시 해당 Entity 추가 - 전환하는 옥션 1.0 상품번호 입력 - 1개의 상품번호만 입력하여 전환 가능 - 전환시 마스터번호 신규 생성 및 1.0 사이트 상품번호 그대로 유지 |
isDisplayExclude | 노출대기여부 | Boolean | 상품조회 API 시 확인 가능한 항목 true : 노출대기 false : 노출대기 아님(정상) |
|
isEditableGoodsName | 상품명 수정 가능 여부 | Boolean | true : 수정 가능 false : 수정 불가능 |
Response Description
항목 | 항목명 | Type | Description |
goodsNo | 마스터상품번호 | int | |
SiteGoodsNo | 사이트상품번호 | string | 상품 정상 생성시 사이트상품번호 확인 가능 |
SiteGoodsComment | 사이트상품정보반영 결과 | string | |
resultCode | 결과코드 | int | 등록/수정 실패 경우 Error Code 확인 가능 |
message | 메시지 | string | 등록/수정 실패 케이스별 사유 메시지 확인 가능 |
JSON_Success
등록/수정/전환
{
"siteDetail": {
"gmkt": {
"SiteGoodsNo": "string",
"SiteGoodsComment": "string"
},
"iac": {
"SiteGoodsNo": "string",
"SiteGoodsComment": "string"
}
},
"goodsNo": 0,
"resultCode": 0,
"message": null
}
JSON_Fail
{
"resultCode": int,
"message": "string"
}
Sample Code_Success
등록/수정/전환
{
"siteDetail": {
"gmkt": {
"SiteGoodsNo": "2770898384",
"SiteGoodsComment": "Success"
},
"iac": {
"SiteGoodsNo": "C938588557",
"SiteGoodsComment": "Success"
}
},
"resultCode": 0,
"message": null,
"goodsNo": 2103374786
}
Sample Code_Fail
{
"resultCode":1000,
"message":"[InvalidApiRequestEx][GMKT]카테고리 코드가 없습니다.",
"data": null
}
Error Code
결과코드 | 메시지 | 원인 |
1000 | [InvalidApiRequestEx][GMKT]카테고리 코드가 없습니다 | 등록하려는 사이트의 사이트타입 오류일 경우 |
1000 | [InvalidApiRequestEx][\"영문 상품명(eng)은 최대 100byte까지 입력 가능합니다 | 영문상품명 100bytes 초과 작성했을 경우 |
1000 | 검색 상품명(kor) 최대 입력 길이를 초과하였습니다. | 검색용 상품명 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 | [GMKT] 판매기간은 -1(3PL상품 한정), 0, 15, 30, 60, 90만 가능합니다. [IAC] 판매기간은 -1(3PL상품 한정), 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 | [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 > 상품관리 API' 카테고리의 다른 글
상품 등록/수정/전환 전문 (sample 포함) (0) | 2023.06.28 |
---|---|
상품번호 조회 API (0) | 2023.06.28 |
상품삭제 API (0) | 2023.06.28 |
원산지 리스트 조회 API (0) | 2023.06.28 |
고시 정보 조회 API (0) | 2023.06.28 |