도매꾹 Open API

상품상세정보

상품번호(no)를 기준으로 도매꾹·도매매의 특정 상품 1개에 대한 상세 정보를 조회하는 API입니다

상품번호(no)를 기준으로 도매꾹·도매매의 특정 상품 1개에 대한 상세 정보를 조회하는 API입니다.


권장ver: 4.5

Mode: getItemView

Method: GET

Endpoint: https://domeggook.com/ssl/api/

Request Example:

https://domeggook.com/ssl/api/?ver=4.5&mode=getItemView&aid={API_KEY}&no=12345678&om=json

주문옵션정보 예시

도매꾹_도매매_상품정보API_주문옵션_가격확인_ver4.5.docx
49.2KB

순서

항목( 자료형, 필수여부)

설명

1

ver (string,Y) 

API Version

2

mode (string,Y) 

API 호출 모드값 : getItemView

3

aid (string,Y) 

API Key

4

no (int,Y) 

열람하고자 하는 상품번호

※ 4.1 버전부터 도매꾹과 도매매 상품정보가 모두 표시되도록 수정되었으므로, market 파라미터는 필요하지 않음

5

om (string,Y) 

출력 형식 : json | xml

6

multiple (boolean,N) 

여러 개의 상품번호를 선택할지 여부

· true : 다중선택 - no 파라미터에 상품번호를 콤마(,)로 연결하여 최대 100개까지 입력 가능

· false : 단일선택 (기본값)

7

allItem (boolean,N) 

모든 상태의 상품 표시 여부 (승인대기,승인거부 상태 포함)

· true : 노출

· false : 비노출

※ sellerId 및 sId를 입력할 경우 allItem 항목으로 조회 가능 (공급사 본인의 상품일 경우)

※ 존재하지 않는 상품일 경우엔 40번 오류 노출

8

sellerId (string,N) 

공급사 아이디

※ allItem 항목을 조회할 경우에 필수 입력

9

sId (string,N) 

로그인 세션 아이디

※ allItem 항목을 조회할 경우에 필수 입력

순서

항목

자료형

설명

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

비공개 상품 여부

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.sample

int

샘플판매 단가

※ 본 항목이 없는 경우, 샘플판매를 하지 않는 상품임

20

price.sampleDiscountBasis

int

샘플할인 적용 기준가

※ 같은 판매자로부터 구매한 샘플할인판매 대상 상품의 도매가 합이 본 금액을 넘는 경우, 샘플구매시에도 샘플판매 단가가 아닌 도매판매 단가를 적용함

※ 본 항목이 없는 경우, 샘플할인판매 대상 상품이 아님

21

price.supply

int

도매매판매 단가 / 설정에 따라 자료형이 달라짐

· 정수형 : 구매수량과 상관없이 고정된 단가로 판매

· 문자열 : 구매수량에 따라 단가가 변경되는 수량별차등할인 적용 상품 (구분자 |와 +로 연결된 1행의 문자열)

 ex) 1+3800|20+3500|50+3300

   1~19개 3800원 / 20~49개 3500원 / 50개 이상 3300원

※ 본 항목이 없는 경우, 도매매에서 판매를 하지 않는 상품임

22

price.supplyOrg

int

도매매 할인 전 단가

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

23

price.ggook

int

꾹전용몰 단가 (꾹전용몰에 등록된 상품만 노출)

** 해당 항목 현재 사용 불가 **

24

price.resale

-

상품재판매 관련 정보

25

price.resale.minumum

int

최저판매준수가격

26

price.resale.Recommand

int

추천판매준수가격

27

_

-

28

qty

-

수량정보

29

qty.inventory

int

재고수량

30

qty.domeMoq

int

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

31

qty.domeLoq

int

도매꾹 최대구매수량(LOQ, Limitation of Order Quantity)

※ 본 항목이 없는 경우, 최대구매수량 제한이 없는 상품임

32

qty.domeUnit

int

도매꾹 구매단위

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

33

qty.sampleUnit

int

샘플구매단위

※ 2019년 7월 2일 샘플구매단위 기능이 폐지되어, 샘플구매 가능한 상품은 모두 낱개구매가 가능하게 되었습니다.

※ 현재 이 항목은 샘플구매가 가능한 모든 상품에서 1로 표시됩니다.

34

qty.supplyUnit

int

도매매 구매단위

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

35

qty.ggookUnit

int

꾹전용몰 구매단위

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

※ 꾹전용몰에 등록된 상품만 노출

36

_

-

37

deli

-

배송 관련 정보

38

deli.method

string

배송방법

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

39

deli.pay

int

배송비 부담주체

· 무료배송, 착불, 선결제, 구매자선택

40

deli.dome

-

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

41

deli.dome.type

string

도매 및 샘플구매 배송비 책정방식

· 고정배송비, 수량별차등, 수량별비례, 금액비노출

42

deli.dome.fee

int

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

43

deli.dome.tbl

int

도매 및 샘플구매 구매수량별 배송금액

수량별차등 및 수량별비례에서 사용하며, 양측의 해석방법이 다름

[수량별차등시 해석방법]

1+2500|20+2350|40+2100|60+2000

1~19개 2,500원 / 20~39개 2,350원 / 40~59개 2,100원 / 60개 이상 2,000원

[수량별비례 선택시 해석방법]

50+2500|100+2000

50개까지 2,500원 / 이후 100개마다 2,000원씩 추가

44

deli.supply

-

도매매 구매시 적용되는 배송비

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

45

deli.supply.pay

string

도매매배송비 부담주체

· 무료배송, 착불, 선결제, 구매자선택

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

46

deli.supply.type

string

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

47

deli.supply.fee

int

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

48

deli.supply.tbl

int

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

49

deli.ggook

int

꾹전용몰 구매시 적용되는 배송비

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

50

deli.ggook.type

string

꾹전용몰 배송비 책정방식 (deli.dome.type과 동일규칙을 이용)

51

deli.ggook.fee

int

꾹전용몰 배송비 금액 (deli.dome.fee와 동일규칙을 이용)

52

deli.ggook.tbl

string

꾹전용몰 배송비 금액 (deli.dome.tbl과 동일규칙을 이용)

53

deli.wating

string

상품준비기간

· 즉시배송가능

· 1일 소요

· 2일이상 소요

54

deli.periodDeli

int

상품준비기간 숫자값 (0 ~ 30)

※ 0은 즉시배송, 1은 내일배송을 의미

55

deli.sendAvg

double

평균발송일

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

56

deli.fastDeli

boolean

빠른배송 상품 여부

· true : 빠른배송 상품

· false : 해당없음

57

deli.merge.enable

string

묶음배송 가능여부

· y : 가능

· n : 불가능

· c : 조건부 가능

58

deli.merge.basePrice

int

위 조건(묶음배송 가능여부)이 조건부가능(c) 일 때,

기준금액 표기

※ 묶음배송 가능여부가 c일때 만 표기 됨

59

deli.shippingArea

int

출고지 번호

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

60

deli.feeExtra

-

지역별 추가배송비 정보

61

deli.feeExtra.jeju

int

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

62

deli.feeExtra.islands

int

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

63

deli.feeExtra.useDeliPro

boolean

도서산간배송비 수량별비례 적용여부

· true : 수량별비례 적용상품

· false : 해당없음

64

deli.fromOversea

boolean

해외직배송상품 여부

· true : 해외직배송상품

· false : 해당없음

65

deli.reqCcno

boolean

통관번호요구여부(해외배송상품에 한함)

· true : 통관번호 필요

· false : 해당없음

66

_

-

67

channel.dome

boolean

도매꾹 판매여부

· true : 판매 중

· false : 판매중 아님

68

channel.supply

boolean

도매매 판매여부

· true : 판매 중

· false : 판매중 아님

69

_

-

70

thumb

-

썸네일 이미지

71

thumb.small

string

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

72

thumb.large

string

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

73

thumb.original

string

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

74

thumb.smallPng

string

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

75

thumb.largePng

string

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

76

thumb.hash

string

썸네일 이미지의 해시값

썸네일 이미지의 바이너리 값을 md5() 함수의 인자로 넣어 구한 해시값으로, 32자리의 영문소문자와 숫자로 구성

서로 다른 두 이미지의 본 해시값이 같을 경우, 두 이미지는 같은 것이라고 간주할 수 있음

77

thumb.lastUpdate

date

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

78

_

-

79

desc

-

상품설명

80

desc.license

-

이미지 사용허용

81

desc.license.usable

boolean

이미지 사용허용 여부

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

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

82

desc.license.msg

string

이미지 사용허용 여부 설명

83

desc.notice

string

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

84

desc.comment

-

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

85

desc.comment.memo

string

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

86

desc.comment.date

date

상세설명 추가내용 작성일

87

desc.contents

-

상품상세내용

88

desc.contents.item

string

상품상세내용 - 상품정보

89

desc.contents.deli

string

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

90

desc.contents.event

string

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

91

desc.contents.otherItem

string

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

92

_

-

93

selectOpt

string

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

94

_

-

95

seller

-

판매자 정보

96

seller.id

int

판매자 아이디

97

seller.nick

int

판매자 닉네임

98

seller.type

string

사업자유형, 이하 4개 항목 중 하나가 표시됨

· 일반과세자 / 간이과세자 / 개인판매자 / 면세사업자

※ 간이/개인사업자의 경우 세금계산서 발급이 어려우므로, 재판매시 유의요망

99

seller.rank

int

판매등급

· 1~9

100

seller.good

boolean

우수판매자 여부

· true : 우수판매자

· false : 해당없음

101

seller.global

boolean

해외판매자 여부

· true : 해외판매자

· false : 국내판매자

102

seller.score

-

최근 180일간 작성된 구매후기 기준 판매자 만족도

103

seller.score.avg

int

판매자 평균만족도 (%)

104

seller.score.cnt

int

판매자 구매후기 건수

105

seller.company

-

사업자회원 정보

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

106

seller.company.name

string

사업자명

107

seller.company.boss

string

대표자명

108

seller.company.cno

string

사업자등록번호

109

seller.company.addr

string

사업장 주소

110

seller.company.phone

string

사업장 연락처

111

seller.vacation

-

판매자 휴가기간

112

seller.vacation.startDate

string

휴가 시작일

113

seller.vacation.endDate

string

휴가 종료일

114

seller.vacation.days

int

휴가기간(일)

115

_

-

116

benefits

-

구매시 혜택

117

benefits.sellerPoint

-

판매자 지급 포인트 정보

118

benefits.sellerPoint.type

string

판매자 지급 포인트 유형

· none : 지급 포인트 없음

· rate : 구매금액에 비례하여 포인트 지급

· fix : 구매개수에 비례하여 포인트 지급

119

benefits.sellerPoint.point

string

지급 포인트 금액 / 포인트 유형에 따라 단위가 다름

[rate] 구매금액의 % 단위

[fix] 포인트 금액 P 단위

※ 판매자 지급 포인트 유형이 none인 경우, 본 항목이 없음

120

benefits.sellerPoint.limitAmt

int

포인트 지급을 받기 위해 구매해야 하는 최소 금액

※ 판매자 지급 포인트 유형이 none인 경우, 본 항목이 없음

121

_

-

122

detail

int

상품 관련 각종정보

123

detail.size

string

상품크기(치수/용량)

124

detail.weight

string

상품무게(중량)

125

detail.country

string

원산지

126

detail.manufacturer

string

제조사

127

detail.model

string

모델명/규격(품명)

128

detail.safetyCert

string

안전인증 입력사항

129

detail.safetyCert.exem

string

KC인증면제정보 사용 여부

- 'Y' 또는 'N'

- 'N' 일 경우 아래 exemTitle, exemContent1(2) 항목은 출력하지 않음

130

detail.safetyCert.exemTitle

string

KC인증면제대상 타이틀

- exem이 'Y'일 경우에만 표시되며, 값이 없을 경우에는 '-' 출력

- 구매대행 또는 병행수입

131

detail.safetyCert.exemContent1

string

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

132

detail.safetyCert.exemContent2

string

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

133

detail.safetyCert.cert

string

KC인증정보 사용 여부

- 'Y' 또는 'N'

- 'N' 일 경우 아래 cert관련 항목은 출력하지 않음

134

detail.safetyCert.useImgUrl

string

KC인증 이미지 사용 여부

- 'Y' 또는 'N'

135

detail.safetyCert.imgUrl

string

KC인증 이미지 주소

136

detail.safetyCert.type

string

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

KC인증 상위 제목

137

detail.safetyCert.name

string

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

KC인증 하위 제목

138

detail.safetyCert.certType

string

KC인증 상위 제목

139

detail.safetyCert.certName

string

KC인증 하위 제목

140

detail.safetyCert.useNo

string

인증번호 사용 여부

- 'Y' 또는 'N'

141

detail.safetyCert.no

string

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

142

detail.safetyCert.useWarning

double

인증관련 경고메세지 사용 여부

- 'Y' 또는 'N'

143

detail.safetyCert.warning

string

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

144

detail.infoDuty

-

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

145

detail.infoDuty.type

string

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

146

detail.infoDuty.item

-

고시항목

147

detail.infoDuty.item.type

string

고시항목 유형

· item : 품목별 재화 등에 관한 정보

· transaction : 거래조건에 관한 정보 (모든 품목에 공통)

148

detail.infoDuty.item.name

string

고시항목명

149

detail.infoDuty.item.desc

string

고시내용

150

detail.oversea

boolean

전세계배송(해외판매) 가능여부

· true : 전세계배송 가능

· false : 전세계배송 불가능

151

detail.itemCustomCode

string

공급사상품코드

152

_

-

153

category

-

카테고리 정보

154

category.parents

-

해당 상품의 상위 카테고리

155

category.parents.elem

-

각 카테고리 항목

156

category.parents.elem.name

string

카테고리 이름

157

category.parents.elem.code

string

카테고리 코드

158

category.parents.elem.depth

int

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

159

category.current

int

해당 상품이 속한 카테고리

160

category.current.name

int

각 카테고리 항목

161

category.current.code

int

카테고리 이름

162

category.current.depth

int

카테고리 코드

163

_

-

164

popular

int

인기상품 정보

상품이 여러 인기상품 분류에 포함된 경우에도, 본 항목에는 1개의 인기상품 분류만 표시됨

※ 본 항목이 없는 경우, 인기상품에 포함되지 않음 상품임

165

popular.code

int

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

166

popular.name

int

랭크된 인기상품 분류

· 전체, 국산/국내산, 국외산, 그룹별

167

_

-

168

priceCompare

int

최저가 확인상품 정보

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

169

priceCompare.sole

boolean

타 사이트에서는 판매하지 않고 오직 도매꾹/도매매에서만 판매하는 단독판매 상품여부

단독판매 상품의 경우, 도매꾹/도매매 최저가 상품으로 간주함

· true : 단독판매 상품

· false : 단독판매 상품이 아님

170

priceCompare.max

int

가격비교 확인결과 일반가 (타 사이트에서 판매하는 동일상품의 가격 최대값)

※ 단독판매 상품의 경우, 본 항목이 없음

171

priceCompare.min

int

가격비교 확인결과 최저가 (타 사이트에서 판매하는 동일상품의 가격 최저값)

※ 단독판매 상품의 경우, 본 항목이 없음

172

priceCompare.dome

boolean

도매꾹 가격 최저가 여부

· true : 최저가

· false : 최저가가 아님

173

priceCompare.supply

boolean

도매매 가격 최저가 여부

· true : 최저가

· false : 최저가가 아님

174

_

-

175

contentsRenewal

string

교정 이미지 정보

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

176

_

-

177

return.addr

-

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

178

return.addr.no

int

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

179

return.addr.zipcode

string

반품 배송지 주소 우편번호

180

return.addr.address1

string

반품 배송지 주소1

181

return.addr.address2

string

반품 배송지 주소2

182

return.addr.phone

string

반품 배송지 연락처

183

return.addr.mobile

string

반품 배송지 휴대폰 번호

184

return.deliAmt

int

반품 배송비

185

return.deliAmtDouble

boolean

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

186

event

-

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

187

event.join

-

해당 상품이 포함된 기획전 번호 목록

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

188

event.join.no

int

기획전 번호

189

event.packDeli

boolean

묶음배송 상품전 포함상품 여부

· true : 묶음배송 상품전에 포함된 상품

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

190

dialog.msg.title

string

약관 제목

191

dialog.msg.content

string

약관 내용

JSON


순서

항목( 자료형, 필수여부)

설명

1

ver (string,Y) 

API Version

2

mode (string,Y) 

API 호출 모드값 : getItemView

3

aid (string,Y) 

API Key

4

no (int,Y) 

열람하고자 하는 상품번호

※ 4.1 버전부터 도매꾹과 도매매 상품정보가 모두 표시되도록 수정되었으므로,market 파라미터는 필요하지 않음

5

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

비공개 상품 여부

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.sample

int

샘플판매 단가

※ 본 항목이 없는 경우, 샘플판매를 하지 않는 상품임

20

price.sampleDiscountBasis

int

샘플할인 적용 기준가

※ 같은 판매자로부터 구매한 샘플할인판매 대상 상품의 도매가 합이 본 금액을 넘는 경우, 샘플구매시에도 샘플판매 단가가 아닌 도매판매 단가를 적용함

※ 본 항목이 없는 경우, 샘플할인판매 대상 상품이 아님

21

price.supply

int

도매매판매 단가 / 설정에 따라 자료형이 달라짐

· 정수형 : 구매수량과 상관없이 고정된 단가로 판매

· 문자열 : 구매수량에 따라 단가가 변경되는 수량별차등할인 적용 상품 (구분자 |와 +로 연결된 1행의 문자열)

 ex) 1+3800|20+3500|50+3300

   1~19개 3800원 / 20~49개 3500원 / 50개 이상 3300원

※ 본 항목이 없는 경우, 도매매에서 판매를 하지 않는 상품임

22

price.supplyOrg

int

도매매 할인 전 단가

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

23

price.ggook

int

꾹전용몰 단가 (꾹전용몰에 등록된 상품만 노출)

** 해당 항목 현재 사용 불가 **

24

price.resale

-

상품재판매 관련 정보

25

price.resale.minumum

int

최저판매준수가격

26

price.resale.Recommand

int

추천판매준수가격

27

_

-

28

qty

-

수량정보

29

qty.inventory

int

재고수량

30

qty.domeMoq

int

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

31

qty.domeLoq

int

도매꾹 최대구매수량(LOQ, Limitation of Order Quantity)

※ 본 항목이 없는 경우, 최대구매수량 제한이 없는 상품임

32

qty.domeUnit

int

도매꾹 구매단위

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

33

qty.sampleUnit

int

샘플구매단위

※ 2019년 7월 2일 샘플구매단위 기능이 폐지되어, 샘플구매 가능한 상품은 모두 낱개구매가 가능하게 되었습니다.

※ 현재 이 항목은 샘플구매가 가능한 모든 상품에서 1로 표시됩니다.

34

qty.supplyUnit

int

도매매 구매단위

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

35

qty.ggookUnit

int

꾹전용몰 구매단위

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

※ 꾹전용몰에 등록된 상품만 노출

36

_

-

37

deli

-

배송 관련 정보

38

deli.method

string

배송방법

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

39

deli.pay

int

배송비 부담주체

· 무료배송, 착불, 선결제, 구매자선택

40

deli.dome

-

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

41

deli.dome.type

string

도매 및 샘플구매 배송비 책정방식

· 고정배송비, 수량별차등, 수량별비례, 금액비노출

42

deli.dome.fee

int

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

43

deli.dome.tbl

int

도매 및 샘플구매 구매수량별 배송금액

수량별차등 및 수량별비례에서 사용하며, 양측의 해석방법이 다름

[수량별차등시 해석방법]

1+2500|20+2350|40+2100|60+2000

1~19개 2,500원 / 20~39개 2,350원 / 40~59개 2,100원 / 60개 이상 2,000원

[수량별비례 선택시 해석방법]

50+2500|100+2000

50개까지 2,500원 / 이후 100개마다 2,000원씩 추가

44

deli.supply

-

도매매 구매시 적용되는 배송비

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

45

deli.supply.pay

string

도매매배송비 부담주체

· 무료배송, 착불, 선결제, 구매자선택

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

46

deli.supply.type

string

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

47

deli.supply.fee

int

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

48

deli.supply.tbl

int

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

49

deli.ggook

int

꾹전용몰 구매시 적용되는 배송비

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

50

deli.ggook.type

string

꾹전용몰 배송비 책정방식 (deli.dome.type과 동일규칙을 이용)

51

deli.ggook.fee

int

꾹전용몰 배송비 금액 (deli.dome.fee와 동일규칙을 이용)

52

deli.ggook.tbl

string

꾹전용몰 배송비 금액 (deli.dome.tbl과 동일규칙을 이용)

53

deli.wating

string

상품준비기간

· 즉시배송가능

· 1일 소요

· 2일이상 소요

54

deli.periodDeli

int

상품준비기간 숫자값 (0 ~ 30)

※ 0은 즉시배송, 1은 내일배송을 의미

55

deli.sendAvg

double

평균발송일

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

56

deli.fastDeli

boolean

빠른배송 상품 여부

· true : 빠른배송 상품

· false : 해당없음

57

deli.merge.enable

string

묶음배송 가능여부

· y : 가능

· n : 불가능

· c : 조건부 가능

58

deli.merge.basePrice

int

위 조건(묶음배송 가능여부)이 조건부가능(c) 일 때,

기준금액 표기

※ 묶음배송 가능여부가 c일때 만 표기 됨

59

deli.shippingArea

int

출고지 번호

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

60

deli.feeExtra

-

지역별 추가배송비 정보

61

deli.feeExtra.jeju

int

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

62

deli.feeExtra.islands

int

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

63

deli.feeExtra.useDeliPro

boolean

도서산간배송비 수량별비례 적용여부

· true : 수량별비례 적용상품

· false : 해당없음

64

deli.fromOversea

boolean

해외직배송상품 여부

· true : 해외직배송상품

· false : 해당없음

65

deli.reqCcno

boolean

통관번호요구여부(해외배송상품에 한함)

· true : 통관번호 필요

· false : 해당없음

66

_

-

67

channel.dome

boolean

도매꾹 판매여부

· true : 판매 중

· false : 판매중 아님

68

channel.supply

boolean

도매매 판매여부

· true : 판매 중

· false : 판매중 아님

69

_

-

70

thumb

-

썸네일 이미지

71

thumb.small

string

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

72

thumb.large

string

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

73

thumb.original

string

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

74

thumb.smallPng

string

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

75

thumb.largePng

string

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

76

thumb.hash

string

썸네일 이미지의 해시값

썸네일 이미지의 바이너리 값을 md5() 함수의 인자로 넣어 구한 해시값으로, 32자리의 영문소문자와 숫자로 구성

서로 다른 두 이미지의 본 해시값이 같을 경우, 두 이미지는 같은 것이라고 간주할 수 있음

77

thumb.lastUpdate

date

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

78

_

-

79

desc

-

상품설명

80

desc.license

-

이미지 사용허용

81

desc.license.usable

boolean

이미지 사용허용 여부

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

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

82

desc.license.msg

string

이미지 사용허용 여부 설명

83

desc.notice

string

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

84

desc.comment

-

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

85

desc.comment.memo

string

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

86

desc.comment.date

date

상세설명 추가내용 작성일

87

desc.contents

-

상품상세내용

88

desc.contents.item

string

상품상세내용 - 상품정보

89

desc.contents.deli

string

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

90

desc.contents.event

string

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

91

desc.contents.otherItem

string

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

92

_

-

93

selectOpt

string

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

94

_

-

95

seller

-

판매자 정보

96

seller.id

int

판매자 아이디

97

seller.nick

int

판매자 닉네임

98

seller.type

string

사업자유형, 이하 4개 항목 중 하나가 표시됨

· 일반과세자 / 간이과세자 / 개인판매자 / 면세사업자

※ 간이/개인사업자의 경우 세금계산서 발급이 어려우므로, 재판매시 유의요망

99

seller.rank

int

판매등급

· 1~9

100

seller.good

boolean

우수판매자 여부

· true : 우수판매자

· false : 해당없음

101

seller.global

boolean

해외판매자 여부

· true : 해외판매자

· false : 국내판매자

102

seller.score

-

최근 180일간 작성된 구매후기 기준 판매자 만족도

103

seller.score.avg

int

판매자 평균만족도 (%)

104

seller.score.cnt

int

판매자 구매후기 건수

105

seller.company

-

사업자회원 정보

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

106

seller.company.name

string

사업자명

107

seller.company.boss

string

대표자명

108

seller.company.cno

string

사업자등록번호

109

seller.company.addr

string

사업장 주소

110

seller.company.phone

string

사업장 연락처

111

seller.vacation

-

판매자 휴가기간

112

seller.vacation.startDate

string

휴가 시작일

113

seller.vacation.endDate

string

휴가 종료일

114

seller.vacation.days

int

휴가기간(일)

115

_

-

116

benefits

-

구매시 혜택

117

benefits.sellerPoint

-

판매자 지급 포인트 정보

118

benefits.sellerPoint.type

string

판매자 지급 포인트 유형

· none : 지급 포인트 없음

· rate : 구매금액에 비례하여 포인트 지급

· fix : 구매개수에 비례하여 포인트 지급

119

benefits.sellerPoint.point

string

지급 포인트 금액 / 포인트 유형에 따라 단위가 다름

[rate] 구매금액의 % 단위

[fix] 포인트 금액 P 단위

※ 판매자 지급 포인트 유형이 none인 경우, 본 항목이 없음

120

benefits.sellerPoint.limitAmt

int

포인트 지급을 받기 위해 구매해야 하는 최소 금액

※ 판매자 지급 포인트 유형이 none인 경우, 본 항목이 없음

121

_

-

122

detail

int

상품 관련 각종정보

123

detail.size

string

상품크기(치수/용량)

124

detail.weight

string

상품무게(중량)

125

detail.country

string

원산지

126

detail.manufacturer

string

제조사

127

detail.model

string

모델명/규격(품명)

128

detail.safetyCert

string

안전인증 입력사항

129

detail.safetyCert.exem

string

KC인증면제정보 사용 여부

- 'Y' 또는 'N'

- 'N' 일 경우 아래 exemTitle, exemContent1(2) 항목은 출력하지 않음

130

detail.safetyCert.exemTitle

string

KC인증면제대상 타이틀

- exem이 'Y'일 경우에만 표시되며, 값이 없을 경우에는 '-' 출력

- 구매대행 또는 병행수입

131

detail.safetyCert.exemContent1

string

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

132

detail.safetyCert.exemContent2

string

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

133

detail.safetyCert.cert

string

KC인증정보 사용 여부

- 'Y' 또는 'N'

- 'N' 일 경우 아래 cert관련 항목은 출력하지 않음

134

detail.safetyCert.useImgUrl

string

KC인증 이미지 사용 여부

- 'Y' 또는 'N'

135

detail.safetyCert.imgUrl

string

KC인증 이미지 주소

136

detail.safetyCert.type

string

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

KC인증 상위 제목

137

detail.safetyCert.name

string

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

KC인증 하위 제목

138

detail.safetyCert.certType

string

KC인증 상위 제목

139

detail.safetyCert.certName

string

KC인증 하위 제목

140

detail.safetyCert.useNo

string

인증번호 사용 여부

- 'Y' 또는 'N'

141

detail.safetyCert.no

string

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

142

detail.safetyCert.useWarning

double

인증관련 경고메세지 사용 여부

- 'Y' 또는 'N'

143

detail.safetyCert.warning

string

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

144

detail.infoDuty

-

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

145

detail.infoDuty.type

string

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

146

detail.infoDuty.item

-

고시항목

147

detail.infoDuty.item.type

string

고시항목 유형

· item : 품목별 재화 등에 관한 정보

· transaction : 거래조건에 관한 정보 (모든 품목에 공통)

148

detail.infoDuty.item.name

string

고시항목명

149

detail.infoDuty.item.desc

string

고시내용

150

detail.oversea

boolean

전세계배송(해외판매) 가능여부

· true : 전세계배송 가능

· false : 전세계배송 불가능

151

detail.itemCustomCode

string

공급사상품코드

152

_

-

153

category

-

카테고리 정보

154

category.parents

-

해당 상품의 상위 카테고리

155

category.parents.elem

-

각 카테고리 항목

156

category.parents.elem.name

string

카테고리 이름

157

category.parents.elem.code

string

카테고리 코드

158

category.parents.elem.depth

int

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

159

category.current

int

해당 상품이 속한 카테고리

160

category.current.name

int

각 카테고리 항목

161

category.current.code

int

카테고리 이름

162

category.current.depth

int

카테고리 코드

163

_

-

164

popular

int

인기상품 정보

상품이 여러 인기상품 분류에 포함된 경우에도, 본 항목에는 1개의 인기상품 분류만 표시됨

※ 본 항목이 없는 경우, 인기상품에 포함되지 않음 상품임

165

popular.code

int

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

166

popular.name

int

랭크된 인기상품 분류

· 전체, 국산/국내산, 국외산, 그룹별

167

_

-

168

priceCompare

int

최저가 확인상품 정보

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

169

priceCompare.sole

boolean

타 사이트에서는 판매하지 않고 오직 도매꾹/도매매에서만 판매하는 단독판매 상품여부

단독판매 상품의 경우, 도매꾹/도매매 최저가 상품으로 간주함

· true : 단독판매 상품

· false : 단독판매 상품이 아님

170

priceCompare.max

int

가격비교 확인결과 일반가 (타 사이트에서 판매하는 동일상품의 가격 최대값)

※ 단독판매 상품의 경우, 본 항목이 없음

171

priceCompare.min

int

가격비교 확인결과 최저가 (타 사이트에서 판매하는 동일상품의 가격 최저값)

※ 단독판매 상품의 경우, 본 항목이 없음

172

priceCompare.dome

boolean

도매꾹 가격 최저가 여부

· true : 최저가

· false : 최저가가 아님

173

priceCompare.supply

boolean

도매매 가격 최저가 여부

· true : 최저가

· false : 최저가가 아님

174

_

-

175

contentsRenewal

string

교정 이미지 정보

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

176

_

-

177

return.addr

-

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

178

return.addr.no

int

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

179

return.addr.zipcode

string

반품 배송지 주소 우편번호

180

return.addr.address1

string

반품 배송지 주소1

181

return.addr.address2

string

반품 배송지 주소2

182

return.addr.phone

string

반품 배송지 연락처

183

return.addr.mobile

string

반품 배송지 휴대폰 번호

184

return.deliAmt

int

반품 배송비

185

return.deliAmtDouble

boolean

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

186

event

-

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

187

event.join

-

해당 상품이 포함된 기획전 번호 목록

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

188

event.join.no

int

기획전 번호

189

event.packDeli

boolean

묶음배송 상품전 포함상품 여부

· true : 묶음배송 상품전에 포함된 상품

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

190

dialog.msg.title

string

약관 제목

191

dialog.msg.content

string

약관 내용

v4.4 Response 예시는 v4.5와 동일합니다.

순서

항목( 자료형, 필수여부)

설명

1

ver (string,Y) 

API Version / "4.3" 입력

2

mode (string,Y) 

API 호출 모드값 / "getItemView"을 입력

3

aid (string,Y) 

API Key

4

no (int,Y) 

열람하고자 하는 상품번호

※ 4.1 버전부터 도매꾹과 도매매 상품정보가 모두 표시되도록 수정되었으므로, market 파라미터는 필요하지 않음

순서

항목

자료형

설명

1

basis

-

상품 기본정보

2

basis.no

int

상품번호

3

basis.status

string

상품 판매상태

· 판매중, 기간미지정, 승인대기, 승인거부, 기간종료, 판매종료, 아웃벌점 제재

4

basis.title

string

상품명(상품제목)

5

basis.nego

string

흥정 가능여부

· disable : 흥정 불가능 상품

· enable : 흥정 가능 상품

6

basis.adult

boolean

미성년자 열람불가 상품 여부

· true : 미성년자 열람불가

· false : 미성년자 열람가능

7

basis.dateStart

date

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

8

basis.dateEnd

date

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

9

basis.dateReg

date

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

10

basis.tax

string

상품 과세분류

· 과세상품 : 부가세가 과세되는 상품 (대부분의 상품)

· 면세상품 : 부가세가 면제되는 상품 (농수산물, 서적, 여성용품 등)

· 영세율상품 : 과세상품에 속하나 세율이 0%으로 지정되어 실질적으로 세금부과가 없는 상품 (장애인 관련 상품 등)

11

_

-

12

price

-

상품 가격정보

13

price.dome

-

도매판매 단가 / 설정에 따라 자료형이 달라짐

· 정수형 : 구매수량과 상관없이 고정된 단가로 판매

· 문자열 : 구매수량에 따라 단가가 변경되는 수량별차등할인 적용 상품 (구분자 |와 +로 연결된 1행의 문자열)

 ex) 1+3800|20+3500|50+3300

   1~19개 3800원 / 20~49개 3500원 / 50개 이상 3300원

※ 본 항목이 없는 경우, 도매꾹에서 판매를 하지 않는 상품임

14

price.domeOrg

-

도매판매 할인 전 단가

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

※ 본 항목의 자료형은 price.dome와 동일함

15

price.sample

int

샘플판매 단가

※ 본 항목이 없는 경우, 샘플판매를 하지 않는 상품임

16

price.sampleDiscountBasis

int

샘플할인 적용 기준가

※ 같은 판매자로부터 구매한 샘플할인판매 대상 상품의 도매가 합이 본 금액을 넘는 경우, 샘플구매시에도 샘플판매 단가가 아닌 도매판매 단가를 적용함

※ 본 항목이 없는 경우, 샘플할인판매 대상 상품이 아님

17

price.supply

int

도매매판매 단가 / 설정에 따라 자료형이 달라짐

· 정수형 : 구매수량과 상관없이 고정된 단가로 판매

· 문자열 : 구매수량에 따라 단가가 변경되는 수량별차등할인 적용 상품 (구분자 |와 +로 연결된 1행의 문자열)

 ex) 1+3800|20+3500|50+3300

   1~19개 3800원 / 20~49개 3500원 / 50개 이상 3300원

※ 본 항목이 없는 경우, 도매매에서 판매를 하지 않는 상품임

18

price.supplyOrg

int

도매매 할인 전 단가

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

19

price.ggook

int

꾹전용몰 단가

※ 꾹전용몰에 등록된 상품만 노출

20

price.resale

-

상품재판매 관련 정보

21

price.resale.minumum

int

최저판매준수가격

22

price.resale.Recommand

int

추천판매준수가격

23

_

-

24

qty

-

수량정보

25

qty.inventory

int

재고수량

26

qty.domeMoq

int

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

27

qty.domeLoq

int

도매꾹 최대구매수량(LOQ, Limitation of Order Quantity)

※ 본 항목이 없는 경우, 최대구매수량 제한이 없는 상품임

28

qty.domeUnit

int

도매꾹 구매단위

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

29

qty.sampleUnit

int

샘플구매단위

※ 2019년 7월 2일 샘플구매단위 기능이 폐지되어, 샘플구매 가능한 상품은 모두 낱개구매가 가능하게 되었습니다.

※ 현재 이 항목은 샘플구매가 가능한 모든 상품에서 1로 표시됩니다.

30

qty.supplyUnit

int

도매매 구매단위

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

31

qty.ggookUnit

int

꾹전용몰 구매단위

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

※ 꾹전용몰에 등록된 상품만 노출

32

_

-

33

deli

-

배송 관련 정보

34

deli.method

string

배송방법

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

35

deli.pay

int

배송비 부담주체

· 무료배송, 착불, 선결제, 구매자선택

36

deli.dome

-

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

37

deli.dome.type

string

도매 및 샘플구매 배송비 책정방식

· 고정배송비, 수량별차등, 수량별비례

38

deli.dome.fee

int

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

39

deli.dome.tbl

int

도매 및 샘플구매 구매수량별 배송금액

수량별차등 및 수량별비례에서 사용하며, 양측의 해석방법이 다름

[수량별차등시 해석방법]

1+2500|20+2350|40+2100|60+2000

1~19개 2,500원 / 20~39개 2,350원 / 40~59개 2,100원 / 60개 이상 2,000원

[수량별비례 선택시 해석방법]

50+2500|100+2000

50개까지 2,500원 / 이후 100개마다 2,000원씩 추가

40

deli.supply

-

도매매 구매시 적용되는 배송비

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

41

deli.supply.pay

string

도매매배송비 부담주체

· 무료배송, 착불, 선결제, 구매자선택

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

42

deli.supply.type

string

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

43

deli.supply.fee

int

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

44

deli.supply.tbl

int

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

45

deli.ggook

int

꾹전용몰 구매시 적용되는 배송비

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

46

deli.ggook.type

string

꾹전용몰 배송비 책정방식 (deli.dome.type과 동일규칙을 이용)

47

deli.ggook.fee

int

꾹전용몰 배송비 금액 (deli.dome.fee와 동일규칙을 이용)

48

deli.ggook.tbl

string

꾹전용몰 배송비 금액 (deli.dome.tbl과 동일규칙을 이용)

49

deli.wating

string

상품준비기간

· 즉시배송가능

· 1일 소요

· 2일이상 소요

50

deli.periodDeli

int

상품준비기간 숫자값 (0 ~ 30)

※ 0은 즉시배송, 1은 내일배송을 의미

51

deli.sendAvg

double

평균발송일

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

52

deli.fastDeli

boolean

빠른배송 상품 여부

· true : 빠른배송 상품

· false : 해당없음

53

deli.shippingArea

int

출고지 번호

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

54

deli.feeExtra

-

지역별 추가배송비 정보 (★확장정보)

55

deli.feeExtra.jeju

int

제주지역 배송시 추가배송비 (★확장정보)

56

deli.feeExtra.islands

int

도서산간지역 배송시 추가배송비 (★확장정보)

57

deli.fromOversea

boolean

해외직배송상품 여부

· true : 해외직배송상품

· false : 해당없음

58

deli.reqCcno

boolean

통관번호요구여부(해외배송상품에 한함)

· true : 통관번호 필요

· false : 해당없음

59

_

-

60

thumb

-

썸네일 이미지

61

thumb.small

string

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

62

thumb.large

string

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

63

thumb.original

string

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

64

thumb.smallPng

string

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

65

thumb.largePng

string

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

66

thumb.hash

string

썸네일 이미지의 해시값

썸네일 이미지의 바이너리 값을 md5() 함수의 인자로 넣어 구한 해시값으로, 32자리의 영문소문자와 숫자로 구성

서로 다른 두 이미지의 본 해시값이 같을 경우, 두 이미지는 같은 것이라고 간주할 수 있음

67

thumb.lastUpdate

date

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

68

_

-

69

desc

-

상품설명

70

desc.license

-

이미지 사용허용

71

desc.license.usable

boolean

이미지 사용허용 여부

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

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

72

desc.license.msg

string

이미지 사용허용 여부 설명

73

desc.notice

string

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

74

desc.comment

-

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

75

desc.comment.memo

string

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

76

desc.comment.date

date

상세설명 추가내용 작성일

77

desc.contents

-

상품상세내용

78

desc.contents.item

string

상품상세내용 - 상품정보

79

desc.contents.deli

string

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

80

desc.contents.event

string

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

81

desc.contents.otherItem

string

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

82

_

-

83

selectOpt

string

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

84

_

-

85

seller

-

판매자 정보

86

seller.id

int

판매자 아이디

87

seller.nick

int

판매자 닉네임

88

seller.type

string

사업자유형, 이하 4개 항목 중 하나가 표시됨

· 일반과세자 / 간이과세자 / 개인판매자 / 면세사업자

※ 간이/개인사업자의 경우 세금계산서 발급이 어려우므로, 재판매시 유의요망

89

seller.rank

int

판매등급

· 1~9

90

seller.good

boolean

우수판매자 여부

· true : 우수판매자

· false : 해당없음

91

seller.global

boolean

해외판매자 여부

· true : 해외판매자

· false : 국내판매자

92

seller.score

-

최근 180일간 작성된 구매후기 기준 판매자 만족도

93

seller.score.avg

int

판매자 평균만족도 (%)

94

seller.score.cnt

int

판매자 구매후기 건수

95

seller.company

-

사업자회원 정보

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

96

seller.company.name

string

사업자명

97

seller.company.boss

string

대표자명

98

seller.company.cno

string

사업자등록번호

99

seller.company.addr

string

사업장 주소

100

seller.company.phone

string

사업장 연락처

101

_

-

102

benefits

-

구매시 혜택

103

benefits.sellerPoint

-

판매자 지급 포인트 정보

104

benefits.sellerPoint.type

string

판매자 지급 포인트 유형

· none : 지급 포인트 없음

· rate : 구매금액에 비례하여 포인트 지급

· fix : 구매개수에 비례하여 포인트 지급

105

benefits.sellerPoint.point

string

지급 포인트 금액 / 포인트 유형에 따라 단위가 다름

[rate] 구매금액의 % 단위

[fix] 포인트 금액 P 단위

※ 판매자 지급 포인트 유형이 none인 경우, 본 항목이 없음

106

benefits.sellerPoint.limitAmt

int

포인트 지급을 받기 위해 구매해야 하는 최소 금액

※ 판매자 지급 포인트 유형이 none인 경우, 본 항목이 없음

107

_

-

108

detail

int

상품 관련 각종정보

109

detail.size

string

상품크기(치수/용량)

110

detail.weight

string

상품무게(중량)

111

detail.country

string

원산지

112

detail.manufacturer

string

제조사

113

detail.model

string

모델명/규격(품명)

114

detail.safetyCert

string

안전인증 입력사항

115

detail.safetyCert.exem

string

KC인증면제정보 사용 여부

- 'Y' 또는 'N'

- 'N' 일 경우 아래 exemTitle, exemContent1(2) 항목은 출력하지 않음

116

detail.safetyCert.exemTitle

string

KC인증면제대상 타이틀

- exem이 'Y'일 경우에만 표시되며, 값이 없을 경우에는 '-' 출력

- 구매대행 또는 병행수입

117

detail.safetyCert.exemContent1

string

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

118

detail.safetyCert.exemContent2

string

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

119

detail.safetyCert.cert

string

KC인증정보 사용 여부

- 'Y' 또는 'N'

- 'N' 일 경우 아래 cert관련 항목은 출력하지 않음

120

detail.safetyCert.useImgUrl

string

KC인증 이미지 사용 여부

- 'Y' 또는 'N'

121

detail.safetyCert.imgUrl

string

KC인증 이미지 주소

122

detail.safetyCert.type

string

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

KC인증 상위 제목

123

detail.safetyCert.name

string

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

KC인증 하위 제목

124

detail.safetyCert.certType

string

KC인증 상위 제목

125

detail.safetyCert.certName

string

KC인증 하위 제목

126

detail.safetyCert.useNo

string

인증번호 사용 여부

- 'Y' 또는 'N'

127

detail.safetyCert.no

string

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

128

detail.safetyCert.useWarning

double

인증관련 경고메세지 사용 여부

- 'Y' 또는 'N'

129

detail.safetyCert.warning

string

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

130

detail.infoDuty

-

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

131

detail.infoDuty.type

string

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

132

detail.infoDuty.item

-

고시항목

133

detail.infoDuty.item.type

string

고시항목 유형

· item : 품목별 재화 등에 관한 정보

· transaction : 거래조건에 관한 정보 (모든 품목에 공통)

134

detail.infoDuty.item.name

string

고시항목명

135

detail.infoDuty.item.desc

string

고시내용

136

detail.oversea

boolean

전세계배송(해외판매) 가능여부

· true : 전세계배송 가능

· false : 전세계배송 불가능

137

detail.itemCustomCode

string

공급사상품코드

138

_

-

139

category

-

카테고리 정보

140

category.parents

-

해당 상품의 상위 카테고리

141

category.parents.elem

-

각 카테고리 항목

142

category.parents.elem.name

string

카테고리 이름

143

category.parents.elem.code

string

카테고리 코드

144

category.parents.elem.depth

int

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

145

category.current

int

해당 상품이 속한 카테고리

146

category.current.name

int

각 카테고리 항목

147

category.current.code

int

카테고리 이름

148

category.current.depth

int

카테고리 코드

149

_

-

150

popular

int

인기상품 정보

상품이 여러 인기상품 분류에 포함된 경우에도, 본 항목에는 1개의 인기상품 분류만 표시됨

※ 본 항목이 없는 경우, 인기상품에 포함되지 않음 상품임

151

popular.code

int

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

152

popular.name

int

랭크된 인기상품 분류

· 전체, 국산/국내산, 국외산, 그룹별

153

_

-

154

priceCompare

int

최저가 확인상품 정보

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

155

priceCompare.sole

boolean

타 사이트에서는 판매하지 않고 오직 도매꾹/도매매에서만 판매하는 단독판매 상품여부

단독판매 상품의 경우, 도매꾹/도매매 최저가 상품으로 간주함

· true : 단독판매 상품

· false : 단독판매 상품이 아님

156

priceCompare.max

int

가격비교 확인결과 일반가 (타 사이트에서 판매하는 동일상품의 가격 최대값)

※ 단독판매 상품의 경우, 본 항목이 없음

157

priceCompare.min

int

가격비교 확인결과 최저가 (타 사이트에서 판매하는 동일상품의 가격 최저값)

※ 단독판매 상품의 경우, 본 항목이 없음

158

priceCompare.dome

boolean

도매꾹 가격 최저가 여부

· true : 최저가

· false : 최저가가 아님

159

priceCompare.supply

boolean

도매매 가격 최저가 여부

· true : 최저가

· false : 최저가가 아님

160

_

-

161

contentsRenewal

string

교정 이미지 정보

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

162

_

-

163

return.addr

-

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

164

return.addr.no

int

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

165

return.addr.zipcode

string

반품 배송지 주소 우편번호

166

return.addr.address1

string

반품 배송지 주소1

167

return.addr.address2

string

반품 배송지 주소2

168

return.addr.phone

string

반품 배송지 연락처

169

return.addr.mobile

string

반품 배송지 휴대폰 번호

170

return.deliAmt

int

반품 배송비

171

return.deliAmtDouble

boolean

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

172

event

-

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

173

event.join

-

해당 상품이 포함된 기획전 번호 목록

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

174

event.join.no

int

기획전 번호

175

event.packDeli

boolean

묶음배송 상품전 포함상품 여부

· true : 묶음배송 상품전에 포함된 상품

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

176

dialog.msg.title

string

약관 제목

177

dialog.msg.content

string

약관 내용

XML

버전기록

  • v4.3: 도매매 수량별할인 단가 표시 추가

  • v4.4: seller.vacation(판매자휴가기간), selectOpt 해시값, deli.feeExtra.useDeliPro(도서산간배송비 수량별비례), deli.merge(묶음배송), channel(도매꾹/도매매 판매여부), deli.dome/supply.type 금액비노출 옵션 추가

  • v4.5: allItem(공급사 본인 상품의 전체 상품 상태 조회) 기능 추가