상품번호(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
주문옵션정보 예시
순서 | 항목( 자료형, 필수여부) | 설명 |
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 | 약관 내용 |
순서 | 항목( 자료형, 필수여부) | 설명 |
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 | 약관 내용 |
버전기록
v4.3: 도매매 수량별할인 단가 표시 추가
v4.4: seller.vacation(판매자휴가기간), selectOpt 해시값, deli.feeExtra.useDeliPro(도서산간배송비 수량별비례), deli.merge(묶음배송), channel(도매꾹/도매매 판매여부), deli.dome/supply.type 금액비노출 옵션 추가
v4.5: allItem(공급사 본인 상품의 전체 상품 상태 조회) 기능 추가