상품을 신규 등록하거나 수정할 수 있는 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 값은 공급사의 상품구분코드를 입력 - 총 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 | 대량등록번호
|
순서 | 항목(자료형, 필수여부) | 설명 |
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 | 대량등록번호 |