상품을 신규 등록하거나 수정할 수 있는 API입니다. (최대 10개까지 등록 가능)
권장 ver: 4.1
Mode: setItemBatch
Method: POST
Endpoint: https://domeggook.com/ssl/api/
Request Example:
하단 예시 참고
상세한 상품등록 관련 항목은 여기 엑셀파일 참고
단위가격 입력이 필요한 카테고리도 위 파일 내 [단위가격 표시의무 카테고리] 시트에 제공
순서 | 항목(자료형, 필수여부) | 설명 |
1 | mode (string,Y) | API 호출 모드: setItemBatch |
2 | ver (double,Y) | API 버전: 4.1 |
3 | id (string,Y) | 회원 아이디 |
4 | aid (string,Y) | API 키 |
5 | sId (string,Y) | 로그인 API 호출로 발급되는 sId |
6 | model (string,Y) | 상품등록 : "insert" / 상품수정 : "update" |
7 | item[key] (string,Y) | 상품내역 - item[key] 에서 key 값은 공급사의 상품구분코드를 입력
|
8 | oe (string,N) | 응답 메시지의 문자 인코딩 “euc-kr”(기본값) 또는 “utf-8” |
9 | om (string,N) | 응답 메세지의 출력 포맷 “xml”(기본값) 또는 “json” |
순서 | 항목 | 자료형 | 설명 |
|---|---|---|---|
1 | domeggook.key | string | 입력한 공급사 상품구분코드 |
2 | domeggook.result | string | 성공여부 ( 성공시: SUCCESS / 실패시: 에러코드) |
3 | domeggook.no | int | 대량등록번호
|
순서 | 항목(자료형, 필수여부) | 설명 |
1 | mode (string,Y) | API 호출 모드: setItemBatch |
2 | id (string,Y) | 회원 아이디 |
3 | aid (string,Y) | API 키 |
4 | sId (string,Y) | 로그인 API 호출로 발급되는 sId |
5 | model (string,Y) | 상품등록 : "insert" / 상품수정 : "update" |
6 | itemNo (int,N) | 상품번호 |
7 | market (string,Y) | 판매채널 |
8 | itemSection (string,Y) | 판매방식 |
9 | secretItem (string,Y) | 비공개상품 |
10 | itemTitle (string,Y) | 상품명 |
11 | itemKeyword (string,Y) | 키워드 |
12 | itemCategoryInt (int,Y) | 카테고리 고유번호 |
13 | itemCountry (string,Y) | 원산지 |
14 | itemCode (string,Y) | 모델명 |
15 | itemCompany (string,Y) | 제조사 |
16 | itemSafetyCert (string,Y) | 안전인증정보 |
17 | onlyForAdult (string,Y) | 성인인증필요여부 |
18 | itemSize (string,Y) | 부피 |
19 | itemWeight (string,Y) | 무게 |
20 | itemCustomCode (string,Y) | 공급사상품코드 |
21 | itemImage (string,Y) | 대표이미지 |
22 | itemMemoItem (string,Y) | 상품상세 / 상품정보 |
23 | itemMemoDeli (string,N) | 상품상세 / 배송,교환,반품,A/S 정보 |
24 | itemMemoEvent (string,N) | 상품상세 / 이벤트, 사은품 등 상품홍보 |
25 | itemMemoOtherItem (string,N) | 상품상세 / 내 다른 판매상품 홍보 |
26 | imageAllow (string,Y) | 상세이미지 사용 허용 |
27 | imageMemo (string,Y) | 상세이미지 사용 허용 추가 텍스트 |
28 | infoDutyType (int,Y) | 상품정보제공고시 구분코드 |
29 | infoDuty (string,Y) | 상품정보제공고시 세부항목 |
30 | infoDutyCommon (string,Y) | 거래조건에 관한 정보 |
31 | comOnly (string,Y) | 도매꾹 / 사업자전용상품 |
32 | notDiscountAmt (int,N) | 도매꾹 / 할인전단가 |
33 | itemPrice (string,Y) | 도매꾹 / 판매단가 |
34 | maxQty (int,N) | 도매꾹 / 최대판매수량 |
35 | byUnitQty (string,Y) | 도매꾹 / 배수단위판매 |
36 | useNego (string,Y) | 도매꾹 / 가격흥정 허용 |
37 | notDiscountAmtSupply (int,N) | 도매매 / 할인전단가 |
38 | supplyAmt (string,Y) | 도매매 / 판매단가 |
39 | recomAmt0 (int,N) | 도매매 / 최저판매준수가격 |
40 | recomAmt1 (int,N) | 도매매 / 추천판매준수가격 |
41 | itemOptUse (string,Y) | 주문옵션 / 사용여부 |
42 | itemOptType (string,Y) | 주문옵션 / 유형 |
43 | itemOptName (string,Y) | 주문옵션 / 옵션명 |
44 | itemOptValue (string,Y) | 주문옵션 / 옵션값 |
45 | itemOptDomPrice (string,Y) | 주문옵션 / 도매꾹 옵션추가금액 |
46 | itemOptSupPrice (string,Y) | 주문옵션 / 도매매 옵션추가금액 |
47 | itemOptQty (int,Y) | 주문옵션 / 재고 초기값 |
48 | totalQty (int,Y) | 재고수량 |
49 | taxAdded (string,Y) | 과세유형 |
50 | sellerPoint (string,N) | 판매자지급포인트 |
51 | deliveryMethod (string,Y) | 배송방법 |
52 | enableOutbound (string,Y) | 전세계배송 가능 여부 |
53 | reqCcno (string,N) | 통관고유부호 |
54 | deliveryPeriod (int,Y) | 배송준비기간 |
55 | deliveryWho (string,Y) | 도매꾹 / 배송비부과기준 |
56 | deliBuyerAmt (string,Y) | 도매꾹 / 배송금액 |
57 | deliveryWhoSupply (string,Y) | 도매매 / 배송비부과기준 |
58 | deliBuyerAmtSupply (string,Y) | 도매매 / 배송금액 |
59 | deliMerge (string,Y) | 묶음배송 설정 |
60 | returnShippingArea (string,Y) | 반품배송지 |
61 | returnDeliAmt (int,Y) | 반품배송금액 |
62 | returnDeliAmtDouble (string,Y) | 무료배송시 왕복부과 |
63 | periodReg (int,Y) | 상품등록기간 |
64 | useDisplay (string,Y) | 즉시진열여부 |
65 | oe (string,N) | 응답 메시지의 문자 인코딩 “euc-kr”(기본값) 또는 “utf-8” |
66 | om (string,N) | 응답 메세지의 출력 포맷 “xml”(기본값) 또는 “json” |
순서 | 항목 | 자료형 | 설명 |
|---|---|---|---|
1 | domeggook.result | string | 성공여부 ( 성공시: SUCCESS / 실패시: 에러코드) |
2 | domeggook.no | int | 대량등록번호 |
버전 기록
v4.1 (최신버전)
최초버전(2025.07.10)
단위가격 정보 입력 항목 추가(2026.05.06)
labeledPrice(단위가격 사용여부), useLabeledPrice(단위가격정보)