상품상세정보조회(ES 기반)

1

ver (string,Y) 

API Version: 4.0

2

mode (string,Y) 

API 호출 모드값 : getItemViewES

3

aid (string,Y) 

API Key

4

no (int,Y) 

열람하고자 하는 상품번호※ 여러 개의 상품을 조회할 경우 comma(,)로 나열하여 입력

최대 100개까지 조회 가능

• EX>1234567,1234568...

5

market (string,N) 

접속한 시장정보(dome or supply)

6

allItem (boolean,N) 

모든 상태의 상품 표시 여부 (승인대기,승인거부 상태 포함)· true : 노출· false : 비노출※ sellerId 및 sId를 입력할 경우 allItem 항목으로 조회 가능 (공급사 본인의 상품일 경우)※ 존재하지 않는 상품일 경우 출력값 없음

7

sellerId (string,N) 

공급사 아이디※ allItem 항목을 조회할 경우에 필수 입력

8

sId (string,N) 

로그인 세션 아이디※ allItem 항목을 조회할 경우에 필수 입력

9

om (string,Y) 

출력 형식 : json | xml

1

basis

-

상품 기본정보

2

basis.no

int

상품번호

3

basis.status

string

상품 판매상태· 판매중,기간종료, 판매종료

4

basis.title

string

상품명(상품제목)

5

basis.keywords

-

상품 키워드

6

basis.keywords.kw

string

상품 키워드 개별 단어

7

basis.section

string

상품 판매방식· 직접판매: 공급사 본인이 직접 상품을 판매· MD홍보대행: MD홍보대행 공급사 인증을 통해 홍보대행으로 상품을 판매

8

basis.nego

string

흥정 가능여부· disable : 흥정 불가능 상품· enable : 흥정 가능 상품

9

basis.adult

boolean

미성년자 열람불가 상품 여부· true : 미성년자 열람불가· false : 미성년자 열람가능

10

basis.dateStart

date

상품 판매 시작일 (YYYY-mm-dd HH:ii:ss)

11

basis.dateEnd

date

상품 판매 종료일 (YYYY-mm-dd HH:ii:ss)

12

basis.dateReg

date

상품 등록일 (YYYY-mm-dd HH:ii:ss)

13

basis.secretItem

string

비공개 상품 여부("공개" or "비공개")

14

basis.tax

string

상품 과세분류· 과세상품 : 부가세가 과세되는 상품 (대부분의 상품)· 면세상품 : 부가세가 면제되는 상품 (농수산물, 서적, 여성용품 등)· 영세율상품 : 과세상품에 속하나 세율이 0%으로 지정되어 실질적으로 세금부과가 없는 상품 (장애인 관련 상품 등)

15

_

-

▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒

16

price

-

상품 가격정보

17

price.dome

-

도매판매 단가 / 설정에 따라 자료형이 달라짐· 정수형 : 구매수량과 상관없이 고정된 단가로 판매· 문자열 : 구매수량에 따라 단가가 변경되는 수량별차등할인 적용 상품 (구분자 |와 +로 연결된 1행의 문자열)　ex) 1+3800|20+3500|50+3300　　　1~19개 3800원 / 20~49개 3500원 / 50개 이상 3300원※ 본 항목이 없는 경우, 도매꾹에서 판매를 하지 않는 상품임

18

price.domeOrg

-

도매판매 할인 전 단가※ 본 항목이 없는 경우, 할인 전 가격이 설정되지 않은 일반상품임※ 본 항목의 자료형은 price.dome와 동일함

19

price.supply

int

도매매판매 단가 / 설정에 따라 자료형이 달라짐· 정수형 : 구매수량과 상관없이 고정된 단가로 판매· 문자열 : 구매수량에 따라 단가가 변경되는 수량별차등할인 적용 상품 (구분자 |와 +로 연결된 1행의 문자열)　ex) 1+3800|20+3500|50+3300　　　1~19개 3800원 / 20~49개 3500원 / 50개 이상 3300원※ 본 항목이 없는 경우, 도매매에서 판매를 하지 않는 상품임

20

price.supplyOrg

int

도매매 할인 전 단가※ 본 항목이 없는 경우, 할인 전 가격이 설정되지 않은 일반상품임

21

price.resale

-

상품재판매 관련 정보

22

price.resale.minumum

int

최저판매준수가격

23

price.resale.recommand

int

추천판매준수가격

24

_

-

▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒

25

qty

-

수량정보

26

qty.inventory

int

재고수량

27

qty.domeMoq

int

도매꾹 최소구매수량(MOQ, Minimum Order Quantity)

28

qty.domeLoq

int

도매꾹 최대구매수량(LOQ, Limitation of Order Quantity)※ 본 항목이 없는 경우, 최대구매수량 제한이 없는 상품임

29

qty.domeUnit

int

도매꾹 구매단위ex) 본 항목이 3인 경우, 도매구매시 3개의 배수로만 구매가 가능

30

qty.supplyUnit

int

도매매 구매단위ex) 본 항목이 2인 경우, 도매매 구매시 2의 배수로만 구매가 가능

31

_

-

▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒

32

deli

-

배송 관련 정보

33

deli.method

string

배송방법· 택배, 소포등기, 퀵서비스, 화물배달, 일반우편, 수출입통관배송, 방문수령/직접배송

34

deli.pay

int

배송비 부담주체· 무료배송, 착불, 선결제, 구매자선택

35

deli.dome

-

도매 및 샘플구매시 적용되는 배송비

36

deli.dome.type

string

도매 및 샘플구매 배송비 책정방식· 고정배송비, 수량별차등, 수량별비례, 금액비노출

37

deli.dome.fee

int

도매 및 샘플구매 배송금액 / 고정배송비인 경우에만 사용

38

deli.dome.tbl

int

도매 및 샘플구매 구매수량별 배송금액수량별차등 및 수량별비례에서 사용하며, 양측의 해석방법이 다름[수량별차등시 해석방법]1+2500|20+2350|40+2100|60+20001~19개 2,500원 / 20~39개 2,350원 / 40~59개 2,100원 / 60개 이상 2,000원[수량별비례 선택시 해석방법]50+2500|100+200050개까지 2,500원 / 이후 100개마다 2,000원씩 추가

39

deli.supply

-

도매매 구매시 적용되는 배송비※ 본 항목이 없는 경우, 도매 및 샘플구매시 적용되는 배송비를 적용함

40

deli.supply.pay

string

도매매배송비 부담주체· 무료배송, 착불, 선결제, 구매자선택※ 본 항목이 없는 경우, 도매 및 샘플구매시 적용되는 배송 부담주체를 적용함

41

deli.supply.type

string

도매매 구매 배송비 책정방식 (deli.dome.type과 동일규칙을 이용)

42

deli.supply.fee

int

도매매 구매 배송비 책정방식 (deli.dome.fee와 동일규칙을 이용)

43

deli.supply.tbl

int

도매매 구매 배송비 책정방식 (deli.dome.tbl과 동일규칙을 이용)

44

deli.wating

string

상품준비기간· 즉시배송가능· 1일 소요· 2일이상 소요

45

deli.periodDeli

int

상품준비기간 숫자값 (0 ~ 30)※ 0은 즉시배송, 1은 내일배송을 의미

46

deli.sendAvg

double

평균발송일ex) 본 항목이 0.7인 경우, 결제 후 평균 0.7일 내에 송장정보가 입력됨을 의미

47

deli.fastDeli

boolean

빠른배송 상품 여부· true : 빠른배송 상품· false : 해당없음

48

deli.merge.enable

string

묶음배송 가능여부· y : 가능· n : 불가능· c : 조건부 가능

49

deli.merge.basePrice

int

위 조건(묶음배송 가능여부)이 조건부가능(c) 일 때,기준금액 표기※ 묶음배송 가능여부가 c일때 만 표기 됨

50

deli.shippingArea

int

출고지 번호※ 출고지 번호가 동일한 상품간에는 묶음배송이 가능함

51

deli.feeExtra

-

지역별 추가배송비 정보

52

deli.feeExtra.jeju

int

제주지역 배송시 추가배송비

53

deli.feeExtra.islands

int

도서산간지역 배송시 추가배송비

54

deli.feeExtra.useDeliPro

boolean

도서산간배송비 수량별비례 적용여부· true : 수량별비례 적용상품· false : 해당없음

55

deli.fromOversea

boolean

해외직배송상품 여부· true : 해외직배송상품· false : 해당없음

56

deli.reqCcno

boolean

통관번호요구여부(해외배송상품에 한함)· true : 통관번호 필요· false : 해당없음

57

_

-

▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒

58

channel.dome

boolean

도매꾹 판매여부· true : 판매 중· false : 판매중 아님

59

channel.supply

boolean

도매매 판매여부· true : 판매 중· false : 판매중 아님

60

_

-

▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒

61

thumb

-

썸네일 이미지

62

thumb.small

string

소형 썸네일 URL (가로세로 150픽셀)

63

thumb.large

string

대형 썸네일 UR L(가로세로 330픽셀)

64

thumb.original

string

판매자가 업로드한 썸네일 원본 URL

65

thumb.smallPng

string

PNG 포맷으로 변환된 소형 썸네일 URL (가로세로 150픽셀)

66

thumb.largePng

string

PNG 포맷으로 변환된 대형 썸네일 URL (가로세로 330픽셀)

67

thumb.hash

string

썸네일 이미지의 해시값썸네일 이미지의 바이너리 값을 md5() 함수의 인자로 넣어 구한 해시값으로, 32자리의 영문소문자와 숫자로 구성서로 다른 두 이미지의 본 해시값이 같을 경우, 두 이미지는 같은 것이라고 간주할 수 있음

68

thumb.lastUpdate

date

썸네일 이미지가 변경된 최종일시

69

_

-

▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒

70

desc

-

상품설명

71

desc.license

-

이미지 사용허용

72

desc.license.usable

boolean

이미지 사용허용 여부· true : 상품설명에 사용된 이미지를 다른 마켓 및 샵에서 사용할 수 있음· false : 상품설명에 사용된 이미지를 다른 마켓 및 샵에서 사용할 수 없음

73

desc.license.msg

string

이미지 사용허용 여부 설명

74

desc.notice

string

판매자 공지사항 / 판매자의 모든 상품 상단에 표시되는 내용

75

desc.comment

-

상세설명 추가내용 / 판매자가 상품 상단에 작성한 메모(품절, 배송지연 관련 내용에 주로 사용)

76

desc.comment.memo

string

상세설명 추가내용 작성내용

77

desc.comment.date

date

상세설명 추가내용 작성일

78

desc.contents

-

상품상세내용

79

desc.contents.item

string

상품상세내용 - 상품정보

80

desc.contents.deli

string

상품상세내용 - 배송,교환,반품,A/S 정보

81

desc.contents.event

string

상품상세내용 - 이벤트, 사은품 등 상품홍보

82

desc.contents.otherItem

string

상품상세내용 - 내 다른 판매상품 홍보

83

_

-

▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒

84

selectOpt

string

상품 주문옵션 정보 (JSON 포맷) / 별도 문서 참고요망

85

_

-

▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒

86

seller

-

판매자 정보

87

seller.id

int

판매자 아이디

88

seller.nick

int

판매자 닉네임

89

seller.type

string

사업자유형, 이하 4개 항목 중 하나가 표시됨· 일반과세자 / 간이과세자 / 개인판매자 / 면세사업자※ 간이/개인사업자의 경우 세금계산서 발급이 어려우므로, 재판매시 유의요망

90

seller.rank

int

판매등급· 1~9

91

seller.good

boolean

우수판매자 여부· true : 우수판매자· false : 해당없음

92

seller.global

boolean

해외판매자 여부· true : 해외판매자· false : 국내판매자

93

seller.company

-

사업자회원 정보※ 본 항목이 없는 경우, 개인정회원임

94

seller.company.name

string

사업자명

95

seller.company.boss

string

대표자명

96

seller.company.cno

string

사업자등록번호

97

seller.company.addr

string

사업장 주소

98

seller.company.phone

string

사업장 연락처

99

seller.vacation

-

판매자 휴가기간

100

seller.vacation.startDate

string

휴가 시작일

101

seller.vacation.endDate

string

휴가 종료일

102

seller.vacation.days

int

휴가기간(일)

103

_

-

▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒

104

benefits

-

구매시 혜택

105

benefits.sellerPoint

-

판매자 지급 포인트 정보

106

benefits.sellerPoint.type

string

판매자 지급 포인트 유형· none : 지급 포인트 없음· rate : 구매금액에 비례하여 포인트 지급· fix : 구매개수에 비례하여 포인트 지급

107

benefits.sellerPoint.point

string

지급 포인트 금액 / 포인트 유형에 따라 단위가 다름[rate] 구매금액의 % 단위[fix] 포인트 금액 P 단위※ 판매자 지급 포인트 유형이 none인 경우, 본 항목이 없음

108

benefits.sellerPoint.limitAmt

int

포인트 지급을 받기 위해 구매해야 하는 최소 금액※ 판매자 지급 포인트 유형이 none인 경우, 본 항목이 없음

109

_

-

▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒

110

detail

int

상품 관련 각종정보

111

detail.size

string

상품크기(치수/용량)

112

detail.weight

string

상품무게(중량)

113

detail.country

string

원산지

114

detail.manufacturer

string

제조사

115

detail.model

string

모델명/규격(품명)

116

detail.safetyCert

string

안전인증 입력사항

117

detail.safetyCert.exem

string

KC인증면제정보 사용 여부- 'Y' 또는 'N'- 'N' 일 경우 아래 exemTitle, exemContent1(2) 항목은 출력하지 않음

118

detail.safetyCert.exemTitle

string

KC인증면제대상 타이틀- exem이 'Y'일 경우에만 표시되며, 값이 없을 경우에는 '-' 출력- 구매대행 또는 병행수입

119

detail.safetyCert.exemContent1

string

면제대상 부가설명 #1(값이 없으면 '-' 출력)

120

detail.safetyCert.exemContent2

string

면제대상 부가설명 #2(값이 없으면 '-' 출력)

121

detail.safetyCert.cert

string

KC인증정보 사용 여부- 'Y' 또는 'N'- 'N' 일 경우 아래 cert관련 항목은 출력하지 않음

122

detail.safetyCert.useImgUrl

string

KC인증 이미지 사용 여부- 'Y' 또는 'N'

123

detail.safetyCert.imgUrl

string

KC인증 이미지 주소

124

detail.safetyCert.type

string

※주의 : 더 이상 사용하지 않는 항목입니다. certType을 사용해주세요.KC인증 상위 제목

125

detail.safetyCert.name

string

※주의 : 더 이상 사용하지 않는 항목입니다. certName을 사용해주세요.KC인증 하위 제목

126

detail.safetyCert.certType

string

KC인증 상위 제목

127

detail.safetyCert.certName

string

KC인증 하위 제목

128

detail.safetyCert.useNo

string

인증번호 사용 여부- 'Y' 또는 'N'

129

detail.safetyCert.no

string

인증번호(값이 없으면 '-' 출력)

130

detail.safetyCert.useWarning

double

인증관련 경고메세지 사용 여부- 'Y' 또는 'N'

131

detail.safetyCert.warning

string

인증관련 경고메세지(값이 없으면 '-' 출력)

132

detail.infoDuty

-

<전자상거래 등에서의 상품정보제공 고시>(공정거래위원회 고시 제2012-49호)에 따른 의무고시 정보

133

detail.infoDuty.type

string

품목명 / 공정거래위원회 고시에서 규정한 품목분류를 따름

134

detail.infoDuty.item

-

고시항목

135

detail.infoDuty.item.type

string

고시항목 유형· item : 품목별 재화 등에 관한 정보· transaction : 거래조건에 관한 정보 (모든 품목에 공통)

136

detail.infoDuty.item.name

string

고시항목명

137

detail.infoDuty.item.desc

string

고시내용

138

detail.oversea

boolean

전세계배송(해외판매) 가능여부· true : 전세계배송 가능· false : 전세계배송 불가능

139

detail.itemCustomCode

string

공급사상품코드

140

_

-

▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒

141

category

-

카테고리 정보

142

category.parents

-

해당 상품의 상위 카테고리

143

category.parents.elem

-

각 카테고리 항목

144

category.parents.elem.name

string

카테고리 이름

145

category.parents.elem.code

string

카테고리 코드

146

category.parents.elem.depth

int

카테고레 레벨 (1레벨이 가장 높은 카테고리임)

147

category.current

int

해당 상품이 속한 카테고리

148

category.current.name

int

각 카테고리 항목

149

category.current.code

int

카테고리 이름

150

category.current.depth

int

카테고리 코드

151

_

-

▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒

152

popular

int

인기상품 정보상품이 여러 인기상품 분류에 포함된 경우에도, 본 항목에는 1개의 인기상품 분류만 표시됨※ 본 항목이 없는 경우, 인기상품에 포함되지 않음 상품임

153

popular.code

int

랭크된 인기상품 분류의 코드

154

popular.name

int

랭크된 인기상품 분류· 전체, 국산/국내산, 국외산, 그룹별

155

_

-

▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒

156

priceCompare

int

최저가 확인상품 정보※ 본 항목이 없는 경우, 최저가 확인상품이 아님

157

priceCompare.sole

boolean

타 사이트에서는 판매하지 않고 오직 도매꾹/도매매에서만 판매하는 단독판매 상품여부단독판매 상품의 경우, 도매꾹/도매매 최저가 상품으로 간주함· true : 단독판매 상품· false : 단독판매 상품이 아님

158

priceCompare.max

int

가격비교 확인결과 일반가 (타 사이트에서 판매하는 동일상품의 가격 최대값)※ 단독판매 상품의 경우, 본 항목이 없음

159

priceCompare.min

int

가격비교 확인결과 최저가 (타 사이트에서 판매하는 동일상품의 가격 최저값)※ 단독판매 상품의 경우, 본 항목이 없음

160

priceCompare.dome

boolean

도매꾹 가격 최저가 여부· true : 최저가· false : 최저가가 아님

161

priceCompare.supply

boolean

도매매 가격 최저가 여부· true : 최저가· false : 최저가가 아님

162

_

-

▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒

163

contentsRenewal

string

교정 이미지 정보※ 본 항목이 없는 경우, 이미지 교정이 이루어지지 않은 상품임

164

_

-

▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒

165

return

-

반품 관련정보

166

return.addr

-

반품 배송지 주소 (판매자가 배송지를 설정하지 않은 경우는 addr이 비어있음)

167

return.addr.no

int

반품 배송지 출고지번호 (묶음배송 출고지번호와 공유)

168

return.addr.zipcode

string

반품 배송지 주소 우편번호

169

return.addr.address1

string

반품 배송지 주소1

170

return.addr.address2

string

반품 배송지 주소2

171

return.addr.phone

string

반품 배송지 연락처

172

return.addr.mobile

string

반품 배송지 휴대폰 번호

173

return.deliAmt

int

반품 배송비

174

return.deliAmtDouble

boolean

반품 배송비 2배 적용 여부(무료배송 주문시)

175

_

▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒

176

event

-

기획전 및 묶음배송 상품전 정보

177

event.join

-

해당 상품이 포함된 기획전 번호 목록※ 해당 상품이 포함된 기획전에 없는 경우, 본 항목은 비어있는 요소(empty element)로 표시됨

178

event.join.no

int

기획전 번호

179

event.packDeli

boolean

묶음배송 상품전 포함상품 여부· true : 묶음배송 상품전에 포함된 상품· false : 묶음배송 상품전에 포함되지 않은 상품

180

-