본문 바로가기

상품API40

상품 목록 조회 API Description상품 목록 조회 : [POST] https://sa2.esmplus.com/item/v1/goods/search등록된 2.0 상품 리스트 조회하는 API 입니다.ESM+ 상품관리에서와 같이 조건별로 등록된 상품을 조회해서 확인하실 수 있습니다.목록 조회시 분당 최대 30회 까지 호출 가능합니다. Request Description항목항목명필수여부TypeDescriptiongoodsNo[] 마스터번호 int siteGoodsNo[] 사이트 상품번호 string managedCode[] 판매자 관리코드 string sellStatus[] 판매상태 string11 : 판매 중21 : 판매 중지22 : 직권 중지31 : SKU 품절siteId[] 사이트 구분 string1 : 옥션2 : 지마..
판매자주소록 관리 API Description 등록 : [POST] https://sa2.esmplus.com/item/v1/sellers/address 수정 : [PUT] https://sa2.esmplus.com/item/v1/sellers/address/{addrNo} 조회 : [GET] https://sa2.esmplus.com/item/v1/sellers/address/{addrNo} 전체 조회 : [GET] https://sa2.esmplus.com/item/v1/sellers/addresses 출하지, 반품/교환 배송지 설정에 필요한 판매자 주소록 관리 API 입니다. 등록시 마스터 ID 하위 모든 사이트 판매자 ID 에서 사용할 수 있습니다. 배송템플릿 설정 위해서는 주소록, 출하지, 배송비 정책, 발송 정책을 차..
그룹생성/수정/삭제 API Description 그룹생성 : [POST] https://sa2.esmplus.com/item/v1/groups 그룹수정 : [PUT] https://sa2.esmplus.com/item/v1/groups/{groupNo} 그룹상품 개별등록 : [PUT] https://sa2.esmplus.com/item/v1/groups/{groupNo}/goods/{goodsNo} 그룹상품 복수등록 : [PUT] https://sa2.esmplus.com/item/v1/groups/{groupNo}/goods 그룹삭제 : [DELETE] https://sa2.esmplus.com/item/v1/groups/{groupNo} 2.0 상품의 경우 연관된 상품을 묶어 상품상세페이지에서 함께 노출하여 구매를 향상시킬 수..
추천옵션 관리 API Description등록/수정 : [PUT] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/recommended-options 조회 : [GET] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/recommended-options선택형 (2, 3개 조합 포함) / 텍스트형 / 계산형 옵션 등록/수정 할 수 있습니다.카테고리별 사용 가능한 주문옵션의 유형이 다르므로 추천옵션코드/선택항목코드 조회 API를 통해 조회된 코드를 사용합니다.선택형은 최대 50개까지, 조합형은 500개까지 등록 가능합니다.추천옵션은 G마켓/옥션 등록 카테고리 내 추천옵션 모두 허용시 등록/수정 가능 합니다. Request Description항목항목명필수..
추천옵션 항목 조회 API Description 카테고리별 추천옵션 조회 : [GET] https://sa2.esmplus.com/item/v1/options/recommended-opts?catCode={siteCatCode} 추천옵션별 선택항목 조회 : [GET] https://sa2.esmplus.com/item/v1/options/recommended-opts/{recommendedOptNo} 카테고리별 추천옵션 조회시 recommendedOptNo = 0 이 포함된 경우 해당 카테고리는 직접입력 옵션 허용됩니다. 선택형(2, 3개 조합 포함), 텍스트형 직접입력 허용 여부가 카테고리별로 다르니 등록 가능한 옵션 유형 확인하시길 바랍니다. 카테고리별 추천옵션 조회시 조회하는 사이트 ID 만 포함된 인증토큰으로 조회하셔야 합..
상품명 수정 API Description [PUT] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/goods-name 상품명을 수정하는 API입니다. 검색용 상품명은 10일 이내 판매이력이 없을 경우만 수정 가능하고 그 이후에는 수정 불가합니다. 수정 불가한 경우 별도 에러 발생하지 않으며 기존 상품명은 그대로 유지 됩니다. Request Description 항목 항목명 필수여부 Type Description goodsNo 마스터 상품번호 Y path 변경하고자 하는 마스터 상품번호 입력 kor 프로모션명 (공통, 지마켓) Y string - 검색용+프로모션용 최대 100byte 까지 가능 - 검색용은 등록 후 10일 경과 또는 10일 내 판매 발생시 수정 불가 promotion 프..
카테고리별 상품명 수정 가능 여부 조회 API Description [GET] https://sa2.esmplus.com/item/v1/goods/goods-name-policies?siteId={siteId}&siteCatCode={siteCatCode} G마켓, 옥션 사이트 카테고리별 상품명 수정 가능 여부 조회 가능합니다. (leaf 카테고리로 입력) 상품 동시 등록/수정시 G마켓, 옥션 카테고리별 모두 사용 Y 리턴된 경우 상품명 수정 가능 합니다. 카테고리별 정책 외 상품 등록 후 10일 미만이거나 10일 내 판매 이력 없으며 수정 가능 합니다. Request Description 항목 항목명 필수여부 Type Description siteId 사이트 구분 Y path 1 : 옥션 2 : 지마켓 siteCatCode 사이트 카테고리코드 Y ..
판매자할인 관리 API Description등록/수정 : [POST] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/seller-discounts 해제 : [DELETE] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/seller-discounts 조회 : [GET] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/seller-discounts사이트별 판매자부담 할인 금액을 정율/정액으로 설정할 수 있습니다.Request Description항목항목명필수여부TypeDescriptiongoodsNo마스터 상품번호Ypath변경하고자 하는 마스터 상품번호 입력sellerDiscount > isUse판매자할인 사용여부Y..
판매자지급 스마일캐시 API Description 등록 : [POST] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/cashback 수정 : [PUT] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/cashback 해제 : [DELETE] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/cashback 조회 : [GET] https://sa2.esmplus.com/item/v1/goods/{goodsNo}/customer-benefit/cashback 판매자 부담으로 구매자에게 스마일캐시 혜택을 제공할 수 있습니다. (결제금액..
사이트 카테고리별 등록 옵션 정보 조회 API Description[GET] https://sa2.esmplus.com/item/v1/goods/option-policies?siteId={siteId}&siteCatCode={siteCatCode}G마켓, 옥션 사이트 카테고리별 등록 가능 옵션 및 추가금 정보 조회 가능합니다. (leaf 카테고리로 입력)상품 동시 등록/수정시 G마켓, 옥션 카테고리별 주문옵션 모두 사용 Y 리턴된 옵션 유형에 대해서만 옵션 등록/수정 가능합니다.추가금 설정 범위는 판매가 1만원 이상 설정시 가능한 금액 범위이며1만원 미만 판매가 상품 경우 추가금 설정 가능한 카테고리 경우 아래 기준 공통 정책 적용 됩니다.- 2,000원 ~ 10,000원 : 판매가 기준  -50 ~ 100% 까지- 2,000원 미만 : 판매가 기준..