상품상세정보

Request

순서 항목 자료형 필수 여부 설명
1 ver string Y API Version / 항상 "4.0"을 입력
2 mode string Y API 호출 모드값 / 항상 "getItemView"을 입력
3 aid string Y API Key
4 market string Y 서비스 코드를 입력
· dome : 도매꾹
· supply : 도매매
5 no int Y 열람하고자 하는 상품번호

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.tax string 상품 과세분류
· 과세상품 : 부가세가 과세되는 상품 (대부분의 상품)
· 면세상품 : 부가세가 면제되는 상품 (농수산물, 서적, 여성용품 등)
· 영세율상품 : 과세상품에 속하나 세율이 0%으로 지정되어 실질적으로 세금부과가 없는 상품 (장애인 관련 상품 등)
10 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
11 price - 상품 가격정보
12 price.dome - 도매판매 단가 / 설정에 따라 자료형이 달라짐
· 정수형 : 구매수량과 상관없이 고정된 단가로 판매
· 문자열 : 구매수량에 따라 단가가 변경되는 수량별차등할인 적용 상품 (구분자 |와 +로 연결된 1행의 문자열)
　ex) 1+3800|20+3500|50+3300
　　　1~19개 3800원 / 20~49개 3500원 / 50개 이상 3300원

※ 본 항목이 없는 경우, 도매꾹에서 판매를 하지 않는 상품임
13 price.domeOrg - 도매판매 할인 전 단가
※ 본 항목이 없는 경우, 할인 전 가격이 설정되지 않은 일반상품임
※ 본 항목의 자료형은 price.dome와 동일함
14 price.sample int 샘플판매 단가
※ 본 항목이 없는 경우, 샘플판매를 하지 않는 상품임
15 price.sampleDiscountBasis int 샘플할인 적용 기준가
※ 같은 판매자로부터 구매한 샘플할인판매 대상 상품의 도매가 합이 본 금액을 넘는 경우, 샘플구매시에도 샘플판매 단가가 아닌 도매판매 단가를 적용함
※ 본 항목이 없는 경우, 샘플할인판매 대상 상품이 아님
16 price.supply int 도매매 단가
※ 본 항목이 없는 경우, 도매매에서 판매를 하지 않는 상품임
17 price.supplyOrg int 도매매 할인 전 단가
※ 본 항목이 없는 경우, 할인 전 가격이 설정되지 않은 일반상품임
18 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
19 qty - 수량정보
20 qty.inventory int 재고수량
21 qty.domeMoq int 도매꾹 최소구매수량(MOQ, Minimum Order Quantity)
22 qty.domeUnit int 도매꾹 구매단위
ex) 본 항목이 3인 경우, 도매구매시 3개의 배수로만 구매가 가능
23 qty.sampleUnit int 샘플구매단위
※ 2019년 7월 2일 샘플구매단위 기능이 폐지되어, 샘플구매 가능한 상품은 모두 낱개구매가 가능하게 되었습니다.
※ 현재 이 항목은 샘플구매가 가능한 모든 상품에서 1로 표시됩니다.
24 qty.supplyUnit int 도매매 구매단위
ex) 본 항목이 2인 경우, 도매매 구매시 10개의 배수로만 구매가 가능
25 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
26 deli - 배송 관련 정보
27 deli.method string 배송방법
· 택배, 소포등기, 퀵서비스, 화물배달, 일반우편, 수출입통관배송, 방문수령/직접배송
28 deli.pay int 배송비 부담주체
· 무료배송, 착불, 선결제, 구매자선택
29 deli.dome - 도매 및 샘플구매시 적용되는 배송비
30 deli.dome.type string 도매 및 샘플구매 배송비 책정방식
· 고정배송비, 수량별차등, 수량별비례
31 deli.dome.fee int 도매 및 샘플구매 배송금액 / 고정배송비인 경우에만 사용
32 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원씩 추가
33 deli.supply - 도매매 구매시 적용되는 배송비
※ 본 항목이 없는 경우, 도매 및 샘플구매시 적용되는 배송비를 적용함
34 deli.supply.type string 도매매 구매 배송비 책정방식 (deli.dome.type과 동일규칙을 이용)
35 deli.supply.fee int 도매매 구매 배송비 책정방식 (deli.dome.fee와 동일규칙을 이용)
36 deli.supply.tbl int 도매매 구매 배송비 책정방식 (deli.dome.tbl과 동일규칙을 이용)
37 deli.wating string 상품준비기간
· 즉시배송가능
· 1일 소요
· 2일이상 소요
38 deli.periodDeli int 상품준비기간 숫자값 (0 ~ 30)
※ 0은 즉시배송, 1은 내일배송을 의미
39 deli.sendAvg double 평균발송일
ex) 본 항목이 0.7인 경우, 결제 후 평균 0.7일 내에 송장정보가 입력됨을 의미
40 deli.fastDeli boolean 빠른배송 상품 여부
· true : 빠른배송 상품
· false : 해당없음
41 deli.shippingArea int 출고지 번호
※ 출고지 번호가 동일한 상품간에는 묶음배송이 가능함
42 deli.feeExtra - 지역별 추가배송비 정보 (★확장정보)
43 deli.feeExtra.jeju int 제주지역 배송시 추가배송비 (★확장정보)
44 deli.feeExtra.islands int 도서산간지역 배송시 추가배송비 (★확장정보)
45 deli.fromOversea boolean 해외직배송상품 여부
· true : 해외직배송상품
· false : 해당없음
46 deli.reqCcno boolean 통관번호요구여부(해외배송상품에 한함)
· true : 통관번호 필요
· false : 해당없음
47 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
48 thumb - 썸네일 이미지
49 thumb.small string 소형 썸네일 URL (가로세로 150픽셀)
50 thumb.large string 대형 썸네일 UR L(가로세로 330픽셀)
51 thumb.smallPng string PNG 포맷으로 변환된 소형 썸네일 URL (가로세로 150픽셀)
52 thumb.largePng string PNG 포맷으로 변환된 대형 썸네일 URL (가로세로 330픽셀)
53 thumb.original string 판매자가 업로드한 썸네일 원본 URL
54 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
55 desc - 상품설명
56 desc.license - 이미지 사용허용
57 desc.license.usable boolean 이미지 사용허용 여부
· true : 상품설명에 사용된 이미지를 다른 마켓 및 샵에서 사용할 수 있음
· false : 상품설명에 사용된 이미지를 다른 마켓 및 샵에서 사용할 수 없음
58 desc.license.msg string 이미지 사용허용 여부 설명
59 desc.notice string 판매자 공지사항 / 판매자의 모든 상품 상단에 표시되는 내용
60 desc.comment - 상세설명 추가내용 / 판매자가 상품 상단에 작성한 메모(품절, 배송지연 관련 내용에 주로 사용)
61 desc.comment.memo string 상세설명 추가내용 작성내용
62 desc.comment.date date 상세설명 추가내용 작성일
63 desc.contents string 상품설명 내용
64 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
65 selectOpt string 상품 주문옵션 정보 (JSON 포맷) / 별도 문서 참고요망
66 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
67 seller - 판매자 정보
68 seller.id int 판매자 아이디
69 seller.nick int 판매자 닉네임
70 seller.type string 사업자유형, 이하 4개 항목 중 하나가 표시됨
· 일반과세자 / 간이과세자 / 개인판매자 / 면세사업자

※ 간이/개인사업자의 경우 세금계산서 발급이 어려우므로, 재판매시 유의요망
71 seller.rank int 판매등급
· 1~9
72 seller.good boolean 우수판매자 여부
· true : 우수판매자
· false : 해당없음
73 seller.global boolean 해외판매자 여부
· true : 해외판매자
· false : 국내판매자
74 seller.score - 최근 180일간 작성된 구매후기 기준 판매자 만족도
75 seller.score.avg int 판매자 평균만족도 (%)
76 seller.score.cnt int 판매자 구매후기 건수
77 seller.company - 사업자회원 정보
※ 본 항목이 없는 경우, 개인정회원임
78 seller.company.name string 사업자명
79 seller.company.boss string 대표자명
80 seller.company.cno string 사업자등록번호
81 seller.company.addr string 사업장 주소
82 seller.company.phone string 사업장 연락처
83 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
84 benefits - 구매시 혜택
85 benefits.sellerPoint - 판매자 지급 포인트 정보
86 benefits.sellerPoint.type string 판매자 지급 포인트 유형
· none : 지급 포인트 없음
· rate : 구매금액에 비례하여 포인트 지급
· fix : 구매개수에 비례하여 포인트 지급
87 benefits.sellerPoint.point string 지급 포인트 금액 / 포인트 유형에 따라 단위가 다름
[rate] 구매금액의 % 단위
[fix] 포인트 금액 P 단위
※ 판매자 지급 포인트 유형이 none인 경우, 본 항목이 없음
88 benefits.sellerPoint.limitAmt int 포인트 지급을 받기 위해 구매해야 하는 최소 금액
※ 판매자 지급 포인트 유형이 none인 경우, 본 항목이 없음
89 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
90 detail int 상품 관련 각종정보
91 detail.country string 원산지
92 detail.model string 모델명/규격(품명)
93 detail.manufacturer string 제조사
94 detail.weight string 상품무게(중량)
95 detail.size string 상품크기(치수/용량)
96 detail.safetyCert - 안전인증 입력사항
97 detail.safetyCert.exem string KC인증면제정보 사용 여부
- 'Y' 또는 'N'
- 'N' 일 경우 아래 exemTitle, exemContent1(2) 항목은 출력하지 않음
98 detail.safetyCert.exemTitle string KC인증면제대상 타이틀
- exem이 'Y'일 경우에만 표시되며, 값이 없을 경우에는 '-' 출력
- 구매대행 또는 병행수입
99 detail.safetyCert.exemContent1 string 면제대상 부가설명 #1(값이 없으면 '-' 출력)
100 detail.safetyCert.exemContent2 string 면제대상 부가설명 #2(값이 없으면 '-' 출력)
101 detail.safetyCert.cert string KC인증정보 사용 여부
- 'Y' 또는 'N'
- 'N' 일 경우 아래 cert관련 항목은 출력하지 않음
102 detail.safetyCert.useImgUrl string KC인증 이미지 사용 여부
- 'Y' 또는 'N'
103 detail.safetyCert.imgUrl string KC인증 이미지 주소
104 detail.safetyCert.type string ※주의 : 더 이상 사용하지 않는 항목입니다. certType을 사용해주세요.
KC인증 상위 제목
105 detail.safetyCert.name string ※주의 : 더 이상 사용하지 않는 항목입니다. certName을 사용해주세요.
KC인증 하위 제목
106 detail.safetyCert.certType string KC인증 상위 제목
107 detail.safetyCert.certName string KC인증 하위 제목
108 detail.safetyCert.useNo string 인증번호 사용 여부
- 'Y' 또는 'N'
109 detail.safetyCert.no string 인증번호(값이 없으면 '-' 출력)
110 detail.safetyCert.useWarning string 인증관련 경고메세지 사용 여부
- 'Y' 또는 'N'
111 detail.safetyCert.warning string 인증관련 경고메세지(값이 없으면 '-' 출력)
112 detail.infoDuty - <전자상거래 등에서의 상품정보제공 고시>(공정거래위원회 고시 제2012-49호)에 따른 의무고시 정보
113 detail.infoDuty.type string 품목명 / 공정거래위원회 고시에서 규정한 품목분류를 따름
114 detail.infoDuty.item - 고시항목
115 detail.infoDuty.item.type string 고시항목 유형
· item : 품목별 재화 등에 관한 정보
· transaction : 거래조건에 관한 정보 (모든 품목에 공통)
116 detail.infoDuty.item.name string 고시항목명
117 detail.infoDuty.item.desc string 고시내용
118 detail.oversea boolean 전세계배송(해외판매) 가능여부
· true : 전세계배송 가능
· false : 전세계배송 불가능
119 detail.itemCustomCode string 공급사상품코드
120 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
121 category - 카테고리 정보
122 category.parents - 해당 상품의 상위 카테고리
123 category.parents.elem - 각 카테고리 항목
124 category.parents.elem.name string 카테고리 이름
125 category.parents.elem.code string 카테고리 코드
126 category.parents.elem.depth int 카테고레 레벨 (1레벨이 가장 높은 카테고리임)
127 category.current int 해당 상품이 속한 카테고리
128 category.current.name int 각 카테고리 항목
129 category.current.code int 카테고리 이름
130 category.current.depth int 카테고리 코드
131 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
132 popular int 인기상품 정보
상품이 여러 인기상품 분류에 포함된 경우에도, 본 항목에는 1개의 인기상품 분류만 표시됨
※ 본 항목이 없는 경우, 인기상품에 포함되지 않음 상품임
133 popular.code int 랭크된 인기상품 분류의 코드
134 popular.name int 랭크된 인기상품 분류
· 전체, 국산/국내산, 국외산, 그룹별
135 soleSales boolean 단독판매 여부 (단독판매가 아닌 경우 파라미터가 노출되지 않음)
136 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
137 return.addr - 반품 배송지 주소 (판매자가 배송지를 설정하지 않은 경우는 addr이 비어있음)
138 return.addr.no int 반품 배송지 출고지번호 (묶음배송 출고지번호와 공유)
139 return.addr.zipcode string 반품 배송지 주소 우편번호
140 return.addr.address1 string 반품 배송지 주소1
141 return.addr.address2 string 반품 배송지 주소2
142 return.addr.phone string 반품 배송지 연락처
143 return.addr.mobile string 반품 배송지 휴대폰 번호
144 return.deliAmt int 반품 배송비
145 return.deliAmtDouble boolean 반품 배송비 2배 적용 여부(무료배송 주문시)
146 _ - ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
147 gamseong - 감성유통상품 정보(감성유통 상품일 경우에만 추가)
148 gamseong.title string 감성유통상품 타이틀
149 gamseong.url string 감성유통 목록 페이지 링크
(목록에서 해당 상품으로 스크롤)
150 gamseong.img string 감성유통 상품 이미지 url
151 gamseong.width int 감성유통 이미지 가로 길이(px)
152 gamseong.height int 감성유통 이미지 세로 길이(px)
153 dialog.msg.title string 약관 제목
154 dialog.msg.content string 약관 내용

Response 예시