도매꾹 Open API

상품등록 및 수정

상품을 신규 등록하거나 수정할 수 있는 API입니다

상품을 신규 등록하거나 수정할 수 있는 API입니다. (최대 10개까지 등록 가능)


권장 ver: 4.1

Mode: setItemBatch

Method: POST

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

Request Example:

하단 예시 참고

JSON
  • 상세한 상품등록 관련 항목은 여기 엑셀파일 참고

순서

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

설명

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 값은 공급사의 상품구분코드를 입력 - 총 10개 까지 입력이 가능하며, 아래의 내역을 배열로 작성하여 json 형태로 변환하여 입력 - json 문자열이 잘못된 경우에는 "유효하지 않은 입력데이타입니다"를 리턴함 - 각 내역의 입력은 "필드명(항목명) / 자료형 / 필수여부" 로 표시 (자세한 입력 내용은 문서 내 첨부된 엑셀파일 참고) itemNo(상품번호) / int / N (상품수정 시 필수) market(판매채널) / string / Y itemSection(판매방식) / string / Y secretItem(비공개상품) / string / Y itemTitle(상품명) / string / Y itemKeyword(키워드) / string / Y itemCategoryInt(카테고리 고유번호) / int / Y itemCountry(원산지) / string / Y itemCode(모델명) / string / Y itemCompany(제조사) / string / Y itemSafetyCert(안전인증정보) / string / Y onlyForAdult(성인상품여부) / string / Y itemSize(부피) / string / Y itemWeight(무게) / string / Y itemCustomCode(공급사상품코드) / string / N itemImage(대표이미지) / string / Y itemMemoItem(상품상세/상품정보) / string / Y itemMemoDeli / string / N itemMemoEve(상품상세/배송,교환,반품,AS정보)/ Int / string / N itemMemoOtherItem(상품상세/이벤트,사은품 등 상품홍보) / string / N imageAllow(상세이미지 사용 허용) / string / Y imageMemo(상세이미지 사용 허용 추가 텍스트)/ string / N(상세이미지 허용 시 필수) infoDutyType(상품정보제공고시 구분코드) / int / Y infoDuty(상품정보제공고시 세부항목) / string / Y infoDutyCommon(거래조건에 관한 정보) / string / Y comOnly(사업자전용상품) / string / N(판매채널이 "도매꾹"일 경우 필수) notDiscountAmt(도매꾹 할인전단가) / int / N(판매채널이 “도매꾹”일 경우 선택) itemPrice(도매꾹 판매단가) / string / N(판매채널이 "도매꾹"일 경우 필수) maxQty(도매꾹 최대판매수량) / int / N(판매채널이 "도매꾹"일 경우 필수) byUnitQty(배수단위판매) / string / N(판매채널이 "도매꾹"일 경우 필수) useNego(도매꾹 흥정허용) / string / N(판매채널이 "도매꾹"일 경우 필수) notDiscountAmtSupply(도매매 할인전단가) / int / N(판매채널이 “도매매”일 경우 선택) supplyAmt(도매매 판매단가) / int / N(판매채널이 "도매매"일 경우 필수) recomAmt0(도매매 최저판매준수가격) / int / N(판매채널이 "도매매"일 경우 필수) recomAmt1(도매매 추천판매준수가격) / int / N(판매채널이 "도매매"일 경우 필수) itemOptUse(주문옵션 사용여부) / string / Y itemOptType(주문옵션 유형) / string / N(주문옵션을 허용한 경우 필수) itemOptName(주문옵션 옵션명) / string / N(주문옵션을 허용한 경우 필수) itemOptValue(주문옵션 옵션값) / string / N(주문옵션을 허용한 경우 필수) itemOptDomPrice(주문옵션 도매꾹 추가금액) / string / N(판매채널이 "도매꾹" & 주문옵션을 허용한 경우 필수) itemOptSupPrice(주문옵션 도매매 추가금액) / string / N(판매채널이 "도매매" & 주문옵션을 허용한 경우 필수) itemOptQty(주문옵션 재고 초기값) / int / N(주문옵션이 조합형인 경우 필수) totalQty(재고수량) / int / N(단일상품 또는 독립형인 경우 필수) taxAdded(과세유형) / string / Y sellerPoint(판매자지급포인트) / string / N deliveryMethod(배송방법) / string / Y reqCcno(통관고유부호) / string / N(배송방법이 "해외직배송"인 경우 필수) deliveryPeriod(배송준비기간) / int / Y deliveryWho(도매꾹 배송비 부과기준) / string / N(판매채널이 "도매꾹"일 경우 필수) deliBuyerAmt(도매꾹 배송금액) / string / N(판매채널이 "도매꾹"일 경우 필수) deliveryWhoSupply(도매매 배송비 부과기준) / string / N(판매채널이 "도매매"일 경우 필수) deliBuyerAmtSupply(도매매 배송금액) / string / N(판매채널이 "도매매"일 경우 필수) deliMerge(묶음배송 설정) / string / N returnShippingArea(반품배송지) / string / Y returnDeliAmt(반품배송금액) / int / Y returnDeliAmtDouble(무료배송 시 왕복부과) / string / Y periodReg(상품등록기간) / int / Y useDisplay(상품진열여부) / string / Y

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

대량등록번호

  • 발급된 대량등록번호로 대량등록 상태확인 API 에서 상품의 등록 상태 확인 가능

    • 대량등록번호는 상품번호가 아니며, 실제 상품번호는 상태확인 API내 domeggook.data.itemNo 항목으로 확인 가능

XML

순서

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

설명

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

대량등록번호

XML