상품상세정보

Request

순서 항목 자료형 필수 여부 설명
1 ver string Y API Version / 항상 "4.1"을 입력
2 mode string Y API 호출 모드값 / 항상 "getItemView"을 입력
3 aid string Y API Key
4 no int Y 열람하고자 하는 상품번호
※ 4.1 버전부터 도매꾹과 도매매 상품정보가 모두 표시되도록 수정되었으므로, market 파라미터는 필요하지 않음

Response

순서 항목 자료형 설명
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 도매매 단가
※ 본 항목이 없는 경우, 도매매에서 판매를 하지 않는 상품임
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.domeUnit int 도매꾹 구매단위
ex) 본 항목이 3인 경우, 도매구매시 3개의 배수로만 구매가 가능
28 qty.sampleUnit int 샘플구매단위
※ 2019년 7월 2일 샘플구매단위 기능이 폐지되어, 샘플구매 가능한 상품은 모두 낱개구매가 가능하게 되었습니다.
※ 현재 이 항목은 샘플구매가 가능한 모든 상품에서 1로 표시됩니다.
29 qty.supplyUnit int 도매매 구매단위
ex) 본 항목이 2인 경우, 도매매 구매시 10개의 배수로만 구매가 가능
30 qty.ggookUnit 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+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원씩 추가
39 deli.supply - 도매매 구매시 적용되는 배송비
※ 본 항목이 없는 경우, 도매 및 샘플구매시 적용되는 배송비를 적용함
40 deli.supply.type string 도매매 구매 배송비 책정방식 (deli.dome.type과 동일규칙을 이용)
41 deli.supply.fee int 도매매 구매 배송비 책정방식 (deli.dome.fee와 동일규칙을 이용)
42 deli.supply.tbl int 도매매 구매 배송비 책정방식 (deli.dome.tbl과 동일규칙을 이용)
43 deli.ggook.type int 꾹전용몰 배송비 책정방식 (deli.dome.type과 동일규칙을 이용)
44 deli.ggook.fee int 꾹전용몰 배송비 금액 (deli.dome.fee와 동일규칙을 이용)
45 deli.ggook.tbl int 꾹전용몰 배송비 금액 (deli.dome.tbl과 동일규칙을 이용)
46 deli.wating string 상품준비기간
· 즉시배송가능
· 1일 소요
· 2일이상 소요
47 deli.periodDeli int 상품준비기간 숫자값 (0 ~ 30)
※ 0은 즉시배송, 1은 내일배송을 의미
48 deli.sendAvg double 평균발송일
ex) 본 항목이 0.7인 경우, 결제 후 평균 0.7일 내에 송장정보가 입력됨을 의미
49 deli.fastDeli boolean 빠른배송 상품 여부
· true : 빠른배송 상품
· false : 해당없음
50 deli.shippingArea int 출고지 번호
※ 출고지 번호가 동일한 상품간에는 묶음배송이 가능함
51 deli.feeExtra - 지역별 추가배송비 정보 (★확장정보)
52 deli.feeExtra.jeju int 제주지역 배송시 추가배송비 (★확장정보)
53 deli.feeExtra.islands int 도서산간지역 배송시 추가배송비 (★확장정보)
54 deli.fromOversea boolean 해외직배송상품 여부
· true : 해외직배송상품
· false : 해당없음
55 deli.reqCcno boolean 통관번호요구여부(해외배송상품에 한함)
· true : 통관번호 필요
· false : 해당없음
56 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
57 thumb - 썸네일 이미지
58 thumb.small string 소형 썸네일 URL (가로세로 150픽셀)
59 thumb.large string 대형 썸네일 UR L(가로세로 330픽셀)
60 thumb.original string 판매자가 업로드한 썸네일 원본 URL
61 thumb.smallPng string PNG 포맷으로 변환된 소형 썸네일 URL (가로세로 150픽셀)
62 thumb.largePng string PNG 포맷으로 변환된 대형 썸네일 URL (가로세로 330픽셀)
63 thumb.hash string 썸네일 이미지의 해시값

썸네일 이미지의 바이너리 값을 md5() 함수의 인자로 넣어 구한 해시값으로, 32자리의 영문소문자와 숫자로 구성
서로 다른 두 이미지의 본 해시값이 같을 경우, 두 이미지는 같은 것이라고 간주할 수 있음
64 thumb.lastUpdate date 썸네일 이미지가 변경된 최종일시
65 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
66 desc - 상품설명
67 desc.license - 이미지 사용허용
68 desc.license.usable boolean 이미지 사용허용 여부
· true : 상품설명에 사용된 이미지를 다른 마켓 및 샵에서 사용할 수 있음
· false : 상품설명에 사용된 이미지를 다른 마켓 및 샵에서 사용할 수 없음
69 desc.license.msg string 이미지 사용허용 여부 설명
70 desc.notice string 판매자 공지사항 / 판매자의 모든 상품 상단에 표시되는 내용
71 desc.comment - 상세설명 추가내용 / 판매자가 상품 상단에 작성한 메모(품절, 배송지연 관련 내용에 주로 사용)
72 desc.comment.memo string 상세설명 추가내용 작성내용
73 desc.comment.date date 상세설명 추가내용 작성일
74 desc.contents string 상품설명 내용
75 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
76 selectOpt string 상품 주문옵션 정보 (JSON 포맷) / 별도 문서 참고요망
77 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
78 seller - 판매자 정보
79 seller.id int 판매자 아이디
80 seller.nick int 판매자 닉네임
81 seller.type int 사업자유형
· 일반과세자
· 간이과세자
· 개인판매자
· 면세사업자
82 seller.rank int 판매등급
· 1~9
83 seller.good boolean 우수판매자 여부
· true : 우수판매자
· false : 해당없음
84 seller.global boolean 해외판매자 여부
· true : 해외판매자
· false : 국내판매자
85 seller.score - 최근 180일간 작성된 구매후기 기준 판매자 만족도
86 seller.score.avg int 판매자 평균만족도 (%)
87 seller.score.cnt int 판매자 구매후기 건수
88 seller.company - 사업자회원 정보
※ 본 항목이 없는 경우, 개인정회원임
89 seller.company.name string 사업자명
90 seller.company.boss string 대표자명
91 seller.company.cno string 사업자등록번호
92 seller.company.addr string 사업장 주소
93 seller.company.phone string 사업장 연락처
94 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
95 benefits - 구매시 혜택
96 benefits.sellerPoint - 판매자 지급 포인트 정보
97 benefits.sellerPoint.type string 판매자 지급 포인트 유형
· none : 지급 포인트 없음
· rate : 구매금액에 비례하여 포인트 지급
· fix : 구매개수에 비례하여 포인트 지급
98 benefits.sellerPoint.point string 지급 포인트 금액 / 포인트 유형에 따라 단위가 다름
[rate] 구매금액의 % 단위
[fix] 포인트 금액 P 단위
※ 판매자 지급 포인트 유형이 none인 경우, 본 항목이 없음
99 benefits.sellerPoint.limitAmt int 포인트 지급을 받기 위해 구매해야 하는 최소 금액
※ 판매자 지급 포인트 유형이 none인 경우, 본 항목이 없음
100 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
101 detail int 상품 관련 각종정보
102 detail.size string 상품크기(치수/용량)
103 detail.weight string 상품무게(중량)
104 detail.country string 원산지
105 detail.manufacturer string 제조사
106 detail.model string 모델명/규격(품명)
107 detail.safetyCert string 안전인증 입력사항
108 detail.safetyCert.exem string KC인증면제정보 사용 여부
- 'Y' 또는 'N'
- 'N' 일 경우 아래 exemTitle, exemContent1(2) 항목은 출력하지 않음
109 detail.safetyCert.exemTitle string KC인증면제대상 타이틀
- exem이 'Y'일 경우에만 표시되며, 값이 없을 경우에는 '-' 출력
- 구매대행 또는 병행수입
110 detail.safetyCert.exemContent1 string 면제대상 부가설명 #1(값이 없으면 '-' 출력)
111 detail.safetyCert.exemContent2 string 면제대상 부가설명 #2(값이 없으면 '-' 출력)
112 detail.safetyCert.cert string KC인증정보 사용 여부
- 'Y' 또는 'N'
- 'N' 일 경우 아래 cert관련 항목은 출력하지 않음
113 detail.safetyCert.useImgUrl string KC인증 이미지 사용 여부
- 'Y' 또는 'N'
114 detail.safetyCert.imgUrl string KC인증 이미지 주소
115 detail.safetyCert.type string ※주의 : 더 이상 사용하지 않는 항목입니다. certType을 사용해주세요.
KC인증 상위 제목
116 detail.safetyCert.name string ※주의 : 더 이상 사용하지 않는 항목입니다. certName을 사용해주세요.
KC인증 하위 제목
117 detail.safetyCert.certType string KC인증 상위 제목
118 detail.safetyCert.certName string KC인증 하위 제목
119 detail.safetyCert.useNo string 인증번호 사용 여부
- 'Y' 또는 'N'
120 detail.safetyCert.no string 인증번호(값이 없으면 '-' 출력)
121 detail.safetyCert.useWarning double 인증관련 경고메세지 사용 여부
- 'Y' 또는 'N'
122 detail.safetyCert.warning string 인증관련 경고메세지(값이 없으면 '-' 출력)
123 detail.infoDuty - <전자상거래 등에서의 상품정보제공 고시>(공정거래위원회 고시 제2012-49호)에 따른 의무고시 정보
124 detail.infoDuty.type string 품목명 / 공정거래위원회 고시에서 규정한 품목분류를 따름
125 detail.infoDuty.item - 고시항목
126 detail.infoDuty.item.type string 고시항목 유형
· item : 품목별 재화 등에 관한 정보
· transaction : 거래조건에 관한 정보 (모든 품목에 공통)
127 detail.infoDuty.item.name string 고시항목명
128 detail.infoDuty.item.desc string 고시내용
129 detail.oversea boolean 전세계배송(해외판매) 가능여부
· true : 전세계배송 가능
· false : 전세계배송 불가능
130 detail.itemCustomCode string 공급사상품코드
131 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
132 category - 카테고리 정보
133 category.parents - 해당 상품의 상위 카테고리
134 category.parents.elem - 각 카테고리 항목
135 category.parents.elem.name string 카테고리 이름
136 category.parents.elem.code string 카테고리 코드
137 category.parents.elem.depth int 카테고레 레벨 (1레벨이 가장 높은 카테고리임)
138 category.current int 해당 상품이 속한 카테고리
139 category.current.name int 각 카테고리 항목
140 category.current.code int 카테고리 이름
141 category.current.depth int 카테고리 코드
142 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
143 popular int 인기상품 정보
상품이 여러 인기상품 분류에 포함된 경우에도, 본 항목에는 1개의 인기상품 분류만 표시됨
※ 본 항목이 없는 경우, 인기상품에 포함되지 않음 상품임
144 popular.code int 랭크된 인기상품 분류의 코드
145 popular.name int 랭크된 인기상품 분류
· 전체, 국산/국내산, 국외산, 그룹별
146 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
147 priceCompare int 최저가 확인상품 정보
※ 본 항목이 없는 경우, 최저가 확인상품이 아님
148 priceCompare.sole boolean 타 사이트에서는 판매하지 않고 오직 도매꾹/도매매에서만 판매하는 단독판매 상품여부
단독판매 상품의 경우, 도매꾹/도매매 최저가 상품으로 간주함
· true : 단독판매 상품
· false : 단독판매 상품이 아님
149 priceCompare.max int 가격비교 확인결과 일반가 (타 사이트에서 판매하는 동일상품의 가격 최대값)
※ 단독판매 상품의 경우, 본 항목이 없음
150 priceCompare.min int 가격비교 확인결과 최저가 (타 사이트에서 판매하는 동일상품의 가격 최저값)
※ 단독판매 상품의 경우, 본 항목이 없음
151 priceCompare.dome boolean 도매꾹 가격 최저가 여부
· true : 최저가
· false : 최저가가 아님
152 priceCompare.supply boolean 도매매 가격 최저가 여부
· true : 최저가
· false : 최저가가 아님
153 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
154 contentsRenewal string 교정 이미지 정보
※ 본 항목이 없는 경우, 이미지 교정이 이루어지지 않은 상품임
155 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
156 return.addr - 반품 배송지 주소 (판매자가 배송지를 설정하지 않은 경우는 addr이 비어있음)
157 return.addr.no int 반품 배송지 출고지번호 (묶음배송 출고지번호와 공유)
158 return.addr.zipcode string 반품 배송지 주소 우편번호
159 return.addr.address1 string 반품 배송지 주소1
160 return.addr.address2 string 반품 배송지 주소2
161 return.addr.phone string 반품 배송지 연락처
162 return.addr.mobile string 반품 배송지 휴대폰 번호
163 return.deliAmt int 반품 배송비
164 return.deliAmtDouble boolean 반품 배송비 2배 적용 여부(무료배송 주문시)
165 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
166 event - 기획전 및 묶음배송 상품전 정보
167 event.join - 해당 상품이 포함된 기획전 번호 목록
※ 해당 상품이 포함된 기획전에 없는 경우, 본 항목은 비어있는 요소(empty element)로 표시됨
168 event.join.no int 기획전 번호
169 event.packDeli boolean 묶음배송 상품전 포함상품 여부
· true : 묶음배송 상품전에 포함된 상품
· false : 묶음배송 상품전에 포함되지 않은 상품
170 dialog.msg.title string 약관 제목
171 dialog.msg.content string 약관 내용

Response 예시