도매의신 - B2B 배송대행 도매 전문 쇼핑몰

도매의신 API 메뉴얼

도매의신 API 메뉴얼

안내: 본 문서는 도매의신 판매회원(공급사/판매자)을 위한 API 연동 가이드입니다.
API Key는 도매의신 운영자에게 문의하여 발급받으시기 바랍니다.

1. 상품정보 API

기본정보
- Method: POST
- Response Format: JSON
- 문자셋: UTF-8
- 특기사항: 너무 많은 요청시 도매의신 임의로 제한할 수 있습니다.

1.1 신규상품 요청

http://data.domesin.com/API/v13/item_list.php

파라미터필수타입설명
api_keyString도매의신에서 발급받은 API키
m_idString도매의신 회원아이디
pageint요청하는 페이지
start_datedateYYYY-mm-dd (예: 2018-01-01) 해당일자 00시00분 부터
end_datedateYYYY-mm-dd 해당일자 23시59분59초 까지 (NULL일경우 오늘)
rowsint페이지당 데이터수 (최대 500, 초과시 500으로 고정)
cidint도매의신 카테고리코드 (NULL일경우 모든상품)
vender_m_codeString도매의신 업체코드 (NULL일경우 전체상품)
is_optionint1: 선택옵션 있는 상품만, -1: 선택옵션 없는 상품만, 0/NULL: 전체
is_overseasint1: 해외직구 상품만, -1: 국내배송상품만, 0/NULL: 전체
item_sale_typeint1:VIP전용, 2:폐쇄몰전용, 3:파트너전용, 4:관리자전용, 0/NULL:일반상품

1.2 수정상품 요청

http://data.domesin.com/API/v13/item_change_list.php

파라미터필수타입설명
api_keyString도매의신에서 발급받은 API키
m_idString도매의신 회원아이디
pageint요청하는 페이지
start_datedateYYYY-mm-dd 해당일자 00시00분 부터
end_datedateYYYY-mm-dd 해당일자 23시59분59초 까지
rowsint페이지당 데이터수 (최대 500)
searchString'Y' 또는 'N' (N: 모든변경상품, Y: 상세조건에 해당하는 데이터)
c_inameint1: 상품명이 변경된 데이터
c_costint1: 가격이 변경된 데이터
c_statusintNULL: 모든판매상태, 0:재입고, 1:품절, 2:단종
c_contentint1: 상품상세설명이 변경된 데이터
c_deliveryint1: 배송정책이 변경된 데이터
c_list_optionint1: 상품선택옵션이 변경된 데이터
c_overseasint1: 해외배송상품 여부가 변경된 데이터

1.3 단품 정보 조회

http://data.domesin.com/API/v13/item_info.php

파라미터필수타입설명
api_keyString도매의신에서 발급받은 API키
m_idString도매의신 회원아이디
icodeString도매의신 상품코드 (예: TS10000001)

1.4 월간인기상품 요청

http://data.domesin.com/API/v13/item_last_month_hit.php

1.5 상품정보 응답 필드

필드명타입필수설명
codeStringNOT NULLAPI 결과 (성공시 '0000', 그외 에러)
messageString결과 메시지
total_countintNOT NULL전체 상품수
total_pageintNOT NULL전체 페이지수
current_pageintNOT NULL현재 페이지
items 배열
inameStringNOT NULL상품명
icodeStringNOT NULL도매의신 고유 상품코드
cidintNOT NULL도매의신 카테고리 코드
priceintNOT NULL판매가 (도매의신에서 판매회원에 공급하는 가격)
price_consumerint일반 소비자 가격
islimitintNOT NULL소비자가 준수여부 (0:자율판매, 1:판매가 준수)
limit_priceint판매준수 가격
taxintNOT NULL과세여부 (0:과세, 1:면세)
delivery_typeintNOT NULL배송구분 (0:기본배송, 1:무료, 2:착불, 3:수량별)
delivery_amountintNOT NULL배송비
r_delivery_amountintNOT NULL반품배송비
delivery_qtyint묶음배송수량
statusintNOT NULL판매상태 (0:판매중, 1:품절, 2:단종)
adultintNOT NULL성인상품여부 (0:전체이용가, 1:성인전용)
isreturnintNOT NULL반품가능여부 (1:반품가능, 0:반품불가)
is_overseasintNOT NULL해외직배송여부 (1:해외직배송, 0:국내배송)
icountryStringNOT NULL원산지 정보
makerStringNOT NULL제조사
brandString브랜드명
modelString모델명
keywordString상품 검색 키워드
contentText상품상세설명 (HTML)
imgArrayNOT NULL상품이미지 (최대 5개)
select_optionString상품선택옵션
text_optionString상품입력옵션
noticeText상품개별공지 (HTML)
reg_datetimedatetimeNOT NULL최초상품등록일 (YYYY-mm-dd HH:ii:ss)
up_datetimedatetimeNOT NULL마지막수정일시
cert_typeintNOT NULL상품인증타입 (0:인증대상아님, 1:인증대상, 2:상세설명에 표기)
certString상품인증코드
cert_noString상품인증번호
gosi_codeStringNOT NULL상품고시코드
gosi1~gosi22String상품고시 항목 (고시종류에 따라 다름)

2. 주문 API

주의사항:
- API키 및 아이디가 유출될 경우 악용될 수 있으므로 절대 외부에 공개하지 마세요.
- 도매의신 웹사이트 판매자 주문관리에 정기적으로 접속하여 주문정보를 확인하세요.
- 여러사람이 공유하는 주문시스템의 경우 사용을 권장하지 않습니다.
기본정보
- Method: POST (JSON)
- Response Format: JSON
- 문자셋: UTF-8

2.1 상품주문 요청

https://www.domesin.com/API/v11/order.php

테스트용: https://www.domesin.com/API/v11/order_request_test.php

참고: 테스트 URL로 먼저 테스트 후 정식 주문URL로 처리하세요. 테스트 주문은 결과값만 리턴하고 실제 주문은 처리되지 않습니다.
파라미터필수타입설명
api_keyString도매의신에서 발급받은 API키
m_idString도매의신 회원아이디
c_nameString수취인 이름
c_hpString수취인 휴대폰 번호
c_telString수취인 연락처 2
c_zipString수취인 우편번호
c_addrString수취인 주소1
c_addr_detailString수취인 상세주소
c_ship_memoString배송요청사항
c_memoString주문관리메모
c_memo2String기타 (솔루션 주문번호)
items 배열
items[].icodeString도매의신 상품코드
items[].option1String1차옵션 이름 (정확한 문자로 입력)
items[].option2String2차옵션 이름
items[].qtyint수량

2.2 주문 응답

필드명타입필수설명
codeStringNOT NULL주문코드 (성공시 '0000', 그외 에러)
messageString결과 메시지
order_codeStringNOT NULL장바구니 주문코드
item_amountintNOT NULL상품합계금액
delivery_amountintNOT NULL배송비 합계금액 (도서산간 추가배송비 포함)
order_list_detail 배열
order_list_codeintNOT NULL주문상품 개별원장번호 (주문상태 조회시 사용)
icodeStringNOT NULL주문상품 코드
inameStringNOT NULL주문상품 이름
qtyintNOT NULL주문상품 수량
item_amountintNOT NULL주문상품 단가
is_islandintNOT NULL도서산간 추가배송비 여부 (0:해당없음, 1:포함)

2.3 주문상태 조회

https://www.domesin.com/API/v11/order_status.php

파라미터필수타입설명
api_keyString도매의신에서 발급받은 API키
m_idString도매의신 회원아이디
order_codeString도매의신 주문코드

2.4 주문상태 조회 응답

필드명타입필수설명
codeStringNOT NULL결과코드
messageString결과 메시지
order_codeStringNOT NULL도매의신 주문코드
c_nameStringNOT NULL수취인 이름
order_list_detail 배열
order_list_codeintNOT NULL주문상품 개별원장번호
icodeStringNOT NULL주문상품 코드
inameStringNOT NULL주문상품 이름
qtyintNOT NULL주문상품 수량
statusStringNOT NULL주문상태 (신규주문, 배송준비중, 발송완료, 취소완료)
claim_statusString클레임 상태 (취소요청, 취소거절, 반품요청, 반품승인 등)
del_corpString배송업체 이름
del_noString배송송장번호

2.5 주문취소 요청

https://www.domesin.com/API/v11/order_cancel.php

주의: 주문취소는 '신규주문' 상태에서만 가능하며, 개별상품 취소로 진행하셔야 합니다.
파라미터필수타입설명
api_keyString도매의신에서 발급받은 API키
m_idString도매의신 회원아이디
order_codeString도매의신 주문코드 (장바구니)
order_list_codeint주문시 발급받은 상품별 주문코드

2.6 내 적립금 조회

https://www.domesin.com/API/v11/my_cash.php

파라미터필수타입설명
api_keyString도매의신에서 발급받은 API키
m_idString도매의신 회원아이디

3. 에러코드표

코드설명
0000성공
10API키 에러
11회원아이디 에러
12파라미터 page값 에러
13파라미터 start_date값 에러
14파라미터 search값 에러 ('Y' 또는 'N'으로 전달해 주세요)
16API 사용 권한 에러
17회원아이디 에러
18카테고리 cid 에러
20너무 많은 요청으로 일시적으로 차단된 상태입니다.
21이미 요청한 데이터를 처리중입니다. 결과 처리전 재요청은 하실 수 없습니다.
22도매의신 공급사코드 에러

4. 샘플 코드

4.1 상품정보 조회 (PHP)

<?php
$url = "http://data.domesin.com/API/v13/item_list.php";
$post_data["m_id"] = "회원아이디";
$post_data["api_key"] = "API키";
$post_data["page"] = 1;
$post_data["start_date"] = "2018-02-10";
$post_data["end_date"] = "2018-02-10";
$post_data["rows"] = 100;

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$data = curl_exec($ch);
curl_close($ch);

$data = json_decode($data, true);

if($data['code'] == "0000") {
    // 성공
    foreach($data['items'] as $item) {
        echo $item['icode'] . " : " . $item['iname'] . "\n";
    }
} else {
    // 실패
    echo "Error: " . $data['message'];
}
?>

4.2 상품주문 (PHP)

<?php
// 테스트용 URL (실제 주문은 order.php 사용)
$url = "https://www.domesin.com/API/v11/order_request_test.php";

$json = array(
    "api_key" => "도매의신 셀러API KEY",
    "m_id" => "도매의신 셀러아이디",
    "c_name" => "수취인",
    "c_hp" => "01012345678",
    "c_tel" => "02-345-6789",
    "c_zip" => "12345",
    "c_addr" => "경기도 부천시 원미구",
    "c_addr_detail" => "123번지 도매아파트 101동 101호",
    "c_ship_memo" => "부재시 경비실에 부탁합니다.",
    "c_memo" => "옥션아이디: test",
    "c_memo2" => "플레이오토 12345주문",
    "items" => array(
        array(
            "icode" => "TS10323180",
            "option1" => "레드",
            "option2" => "",
            "qty" => "2"
        ),
        array(
            "icode" => "TS10323711",
            "option1" => "소",
            "option2" => "",
            "qty" => "6"
        )
    )
);

$json_string = json_encode($json);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HEADER, FALSE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $json_string);
$data = curl_exec($ch);
curl_close($ch);

$data = json_decode($data, true);
print_r($data);
?>
문의: API Key 발급 및 기타 문의사항은 도매의신 운영자에게 연락해 주세요.

1. 상품등록 API

주의: 이 API는 공급사(vender) 전용입니다. 공급사 권한이 있는 회원만 사용 가능합니다.
테스트 URL로 먼저 검증 후 실제 등록을 진행하세요.
기본정보
- Method: POST (JSON)
- Content-Type: application/json
- Response Format: JSON
- 문자셋: UTF-8

1.1 상품등록 요청

https://www.domesin.com/API/v11/item_register.php

테스트용: https://www.domesin.com/API/v11/item_register_test.php

필수 파라미터

파라미터필수타입설명
api_keyString도매의신에서 발급받은 API키
m_idString도매의신 공급사 아이디
cidint도매의신 카테고리 코드 (최하위 카테고리)
inameString상품명 (최대 100자)
originString원산지 (예: 국내산, 해외|아시아|중국)
icompanyString제조사
keywordString검색 키워드 (콤마로 구분, 5개 이상)
costint공급가 (VAT포함)
taxint0:과세, 1:면세
adultint0:일반상품, 1:성인전용
statusint0:판매중, 1:품절, 2:단종
i_typeint0:새제품, 1:중고품
amount_gint소비자가
islimitint0:자율판매가, 1:판매가격준수
delivery_typeint0:기본배송, 1:무료배송, 2:착불배송, 3:수량별배송
delivery_amountint배송비
r_delivery_amountint반품배송비 (편도)
isreturnint0:반품불가, 1:반품가능
is_overseasStringY:해외직배송, 빈값:국내배송
cert_typeint0:인증대상아님, 1:인증대상, 2:상세설명에표기
i_contentString상품상세설명 (HTML)
imagesArray상품 이미지 URL 배열 (최대 5개, images[0]은 필수)
vender_codeString업체상품코드
item_sale_typeint0:일반, 1:VIP전용, 2:폐쇄몰전용, 3:파트너전용

선택 파라미터

파라미터타입기본값설명
iname_delString택배송장명
ibrandString브랜드명
imodelString모델명
amount_limitint0판매준수가 (islimit=1일때 필수)
delivery_qtyint0묶음배송수량 (delivery_type=3일때 필수)
raidint반품지 주소 ID (없으면 기본반품지 사용)
certString인증코드
cert_noString인증번호
noticeString상품공지 (HTML)
gosi_codeString상품고시코드
gosiArray상품고시정보 배열

선택옵션 (options)

파라미터타입설명
options.op_t1String옵션명1 (예: 색상)
options.op_t2String옵션명2 (예: 사이즈)
options.itemsArray옵션 항목 배열
options.items[].op_n1String옵션값1 (예: 레드)
options.items[].op_n2String옵션값2 (예: L)
options.items[].op_costint옵션추가금액 (0이면 기본가)
options.items[].op_soldoutint0:판매중, 1:품절

1.2 상품등록 응답

필드명타입설명
codeString결과코드 (성공: 0000)
messageString결과 메시지
iidint등록된 상품 고유번호
icodeString등록된 상품코드 (예: TS10000001)

2. 상품수정 API

주의: 상품수정 API는 공급사 본인의 상품만 수정 가능합니다.
수정 시 변경이력이 기록되며, 일부 항목은 관리자 승인이 필요할 수 있습니다.
기본정보
- Method: POST (JSON)
- Content-Type: application/json
- Response Format: JSON
- 문자셋: UTF-8

2.1 기본정보 수정

https://www.domesin.com/API/v11/vender_item_edit.php

파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
icodeString수정할 상품코드 (예: TS10000001)
inameString상품명 (최대 100자)
iname_delString택배송장명
cidint카테고리 코드 (최하위 카테고리)
originString원산지 (예: 국내산, 해외|아시아|중국)
icompanyString제조사
ibrandString브랜드명
imodelString모델명
keywordString검색 키워드 (콤마로 구분, 5개 이상)
costint공급가 (VAT포함)
amount_gint소비자가
taxint0:과세, 1:면세
adultint0:일반상품, 1:성인전용
islimitint0:자율판매가, 1:판매가격준수
amount_limitint판매준수가 (islimit=1일때)
i_contentString상품상세설명 (HTML)
noticeString상품개별공지 (HTML)
gosi_codeString상품고시코드
gosiArray상품고시정보 배열
cert_typeint0:인증대상아님, 1:인증대상, 2:상세설명에표기
certString인증코드
cert_noString인증번호
vender_codeString업체상품코드

2.2 썸네일/이미지 수정

https://www.domesin.com/API/v11/vender_item_thumbnail.php

파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
icodeString수정할 상품코드
imagesArray상품 이미지 URL 배열 (최대 5개)
images[0]String대표이미지 URL (필수, 최소 400x400)
images[1~4]String추가이미지 URL
replace_allint1: 모든 이미지 교체, 0: 기존 이미지 유지하고 추가 (기본: 1)
이미지 규격:
- 최소 크기: 400x400px (권장: 600x600 이상)
- 지원 형식: JPG, PNG
- 대표이미지(images[0])는 필수

2.3 옵션 수정

https://www.domesin.com/API/v11/vender_item_option.php

파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
icodeString수정할 상품코드
optionsObject옵션 정보
options.op_t1String1차 옵션명 (예: 색상)
options.op_t2String2차 옵션명 (예: 사이즈)
options.itemsArray옵션 항목 배열

options.items 배열 구조

파라미터필수타입설명
op_n1String1차 옵션값 (예: 레드)
op_n2String2차 옵션값 (예: L)
op_costint옵션추가금액 (기본: 0, 범위: 공급가의 ±50%)
op_soldoutint0: 판매중, 1: 품절
op_limitint옵션별 판매준수가
옵션 수정 규칙:
- 기본판매가와 동일한 가격(op_cost=0)의 옵션이 최소 1개 필요
- 옵션추가금액은 상품 공급가의 ±50%를 초과할 수 없음
- 중복된 옵션명 조합 불가

2.4 판매상태 변경 (품절/단종/재입고)

https://www.domesin.com/API/v11/vender_item_status.php

파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
icodeString수정할 상품코드
statusint판매상태 (0:판매중/재입고, 1:품절, 2:단종)

일괄 상태 변경 (동일 API로 items 배열 전송)

https://www.domesin.com/API/v11/vender_item_status.php

파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
itemsArray상품 상태 변경 배열
items[].icodeString상품코드
items[].statusint판매상태

2.5 배송설정 수정

https://www.domesin.com/API/v11/vender_item_delivery.php

파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
icodeString수정할 상품코드
delivery_typeint배송구분 (0:기본배송, 1:무료배송, 2:착불배송, 3:수량별배송)
delivery_amountint배송비 (무료배송 제외시 필수)
delivery_qtyint묶음배송수량 (수량별배송시 필수)
r_delivery_amountint반품배송비 (편도, 착불배송 제외시 필수)
isreturnint반품가능여부 (0:반품불가, 1:반품가능)
is_overseasString해외직배송여부 (Y:해외직배송, 빈값:국내배송)
raidint반품지 주소 ID
배송비 규칙:
- 무료배송(delivery_type=1): 배송비 자동 0원 처리
- 착불배송(delivery_type=2): 반품배송비 자동 0원 처리
- 수량별배송(delivery_type=3): 묶음배송수량(delivery_qty) 필수

3. 상품문의 관리 API

안내: 공급사 상품에 등록된 고객 문의를 조회하고 답변할 수 있습니다.

3.1 문의 목록 조회

https://www.domesin.com/API/v11/vender_qna.php

action: list

파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
pageint페이지 번호 (기본: 1)
rowsint페이지당 건수 (기본: 50, 최대: 200)
statusString답변상태 (all:전체, wait:미답변, done:답변완료)
start_datedate조회시작일 (YYYY-mm-dd)
end_datedate조회종료일 (YYYY-mm-dd)
icodeString특정 상품코드 문의만 조회

3.2 문의 답변 등록

https://www.domesin.com/API/v11/vender_qna.php

action: answer

파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
qidint문의 고유번호
a_contentString답변 내용
a_nameString답변자 이름
a_telString답변자 연락처
a_emailString답변자 이메일

4. 주문수집 API

주의: 공급사 주문수집 API는 판매자 주문 API와 다릅니다.
공급사는 본인 상품에 대한 주문만 조회할 수 있습니다.

4.1 주문 목록 조회

https://www.domesin.com/API/v11/vender_order_list.php

파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
pageint페이지 번호 (기본: 1)
rowsint페이지당 건수 (기본: 50, 최대: 500)
start_datedate조회시작일 (YYYY-mm-dd)
end_datedate조회종료일 (YYYY-mm-dd, 기본: 오늘)
o_statusint주문상태 (0:신규주문, 1:발송대기, 2:발송완료, 3:배송완료, 4:취소/반품)
search_typeString검색유형 (order_code, icode, d_name, d_hp)
search_keywordString검색어

4.2 주문 목록 응답 필드

필드명타입설명
codeString결과코드 (성공: 0000)
total_countint전체 주문수
total_pageint전체 페이지수
current_pageint현재 페이지
orders 배열
order_list_codeint주문상품 개별원장번호
order_codeString주문코드
icodeString상품코드
inameString상품명
option_nameString선택옵션명
qtyint주문수량
item_amountint상품금액
o_statusint주문상태
o_status_nameString주문상태명
d_nameString수취인명
d_hpString수취인 연락처
d_zipString우편번호
d_addrString배송주소
d_memoString배송메모
delivery_idxint택배사 코드
delivery_codeString송장번호
r_datetimedatetime주문일시
cancel_statusint취소상태 (0:정상, 1:취소요청, 2:취소완료, 3:취소거부)

5. 송장업데이트 API

5.1 단건 송장 등록

https://www.domesin.com/API/v11/vender_invoice.php

파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
order_list_codeint주문상품 개별원장번호
delivery_idxint택배사 코드
delivery_codeString송장번호

5.2 일괄 송장 등록 (동일 API로 invoices 배열 전송)

https://www.domesin.com/API/v11/vender_invoice.php

파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
invoicesArray송장 정보 배열
invoices[].order_list_codeint주문상품 개별원장번호
invoices[].delivery_idxint택배사 코드
invoices[].delivery_codeString송장번호

5.3 택배사 코드표

코드택배사명코드택배사명
1CJ대한통운2롯데택배
3우체국택배4한진택배
5로젠택배6경동택배
7대신택배8일양로지스
9합동택배10홈픽택배
11쿠팡로켓배송12GS편의점택배
13CU편의점택배14GSMNtoN
99기타
송장 등록 규칙:
- 발송대기(o_status=1) 상태의 주문만 송장 등록 가능
- 취소요청 중인 주문은 송장 등록 불가
- 송장 등록 시 주문상태가 자동으로 발송완료(o_status=2)로 변경

6. 주문상태변경 API

6.1 주문 상태 변경

https://www.domesin.com/API/v11/vender_order_status.php

파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
order_list_codeint주문상품 개별원장번호
o_statusint변경할 주문상태

6.2 주문상태 코드표

코드상태명설명
0신규주문결제 완료 후 초기 상태
1발송대기상품 준비중 (송장등록 대기)
2발송완료송장 등록 완료
3배송완료배송 완료 처리

6.3 취소 요청 처리 (준비중)

https://www.domesin.com/API/v11/vender_cancel.php

파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
order_list_codeint주문상품 개별원장번호
actionString처리유형 (approve:취소승인, reject:취소거부)
reject_reasonString거부 사유 (action=reject일때 권장)

6.4 취소상태 코드표

코드상태명설명
0정상취소 관련 없음
1취소요청고객이 취소 요청
2취소완료취소 승인됨
3취소거부공급사가 취소 거부
주문상태 변경 규칙:
- 신규주문(0) → 발송대기(1): 상품 준비 시작
- 발송대기(1) → 발송완료(2): 송장 등록 필수
- 취소요청(cancel_status=1) 상태에서는 취소승인 또는 취소거부만 가능
- 발송완료 이후에는 취소 불가 (반품으로 처리)

7. 에러코드표

코드설명
0000성공
10API키 에러
11회원아이디 에러
16API 사용 권한 에러 (공급사 권한 필요)
30상품등록 가능 수량 초과
31카테고리(cid) 미입력
32유효하지 않은 카테고리
33상품명(iname) 미입력
34상품명 100자 초과
35원산지(origin) 미입력
36제조사(icompany) 미입력
37키워드 5개 미만
38공급가(cost) 미입력
39~43배송정보 관련 에러
44대표이미지 미등록
45과세여부(tax) 미입력
46성인상품여부(adult) 미입력
47판매상태(status) 미입력
48상품구분(i_type) 미입력
49소비자가(amount_g) 미입력
50DB 등록 실패
51가격준수여부(islimit) 미입력
52배송정책(delivery_type) 미입력
53배송비(delivery_amount) 미입력
54반품배송비(r_delivery_amount) 미입력
55반품가능여부(isreturn) 미입력
56해외직배송여부(is_overseas) 미입력
57인증타입(cert_type) 미입력
58상품상세설명(i_content) 미입력
59판매타입(item_sale_type) 미입력
60업체상품코드(vender_code) 미입력
상품수정 관련
61상품코드(icode) 미입력
62상품을 찾을 수 없음
63수정 권한이 없음 (본인 상품만 수정 가능)
64옵션추가금액이 공급가의 ±50% 초과
65기본판매가 옵션 없음 (op_cost=0 필요)
66중복된 옵션항목 존재
67이미지 최소 크기 미달 (400x400 이상)
주문/송장 관련
70주문을 찾을 수 없음
71주문 조회 권한 없음
72발송대기 상태가 아니어서 송장 등록 불가
73취소요청 중인 주문은 송장 등록 불가
74택배사 코드 에러
75송장번호 미입력
76주문상태 변경 불가
77이미 취소된 주문
78취소요청 상태가 아님
문의관리 관련
80문의를 찾을 수 없음
81답변 권한 없음
82답변 내용 미입력

8. 샘플 코드

8.1 상품등록 (PHP)

<?php
$url = "https://www.domesin.com/API/v11/item_register.php";

$data = [
    "api_key" => "도매의신 API KEY",
    "m_id" => "도매의신 공급사아이디",
    "cid" => 364,                    // 카테고리 코드
    "iname" => "테스트 상품명",
    "origin" => "국내산",
    "icompany" => "제조사명",
    "keyword" => "키워드1, 키워드2, 키워드3, 키워드4, 키워드5",
    "cost" => 10000,                 // 공급가
    "tax" => 0,                      // 과세
    "adult" => 0,                    // 일반상품
    "status" => 0,                   // 판매중
    "i_type" => 0,                   // 새제품
    "amount_g" => 15000,             // 소비자가
    "islimit" => 0,                  // 자율판매가
    "delivery_type" => 0,            // 기본배송
    "delivery_amount" => 3000,       // 배송비
    "r_delivery_amount" => 3000,     // 반품배송비
    "isreturn" => 1,                 // 반품가능
    "is_overseas" => "",             // 국내배송
    "cert_type" => 0,                // 인증대상아님
    "vender_code" => "MY-PRODUCT-001", // 업체상품코드
    "item_sale_type" => 0,           // 일반상품
    "images" => [
        "https://example.com/image1.jpg",
        "https://example.com/image2.jpg"
    ],
    "i_content" => "<p>상품 상세설명 HTML</p>",
    "options" => [
        "op_t1" => "색상",
        "op_t2" => "",
        "items" => [
            ["op_n1" => "레드", "op_n2" => "", "op_cost" => 0, "op_soldout" => 0],
            ["op_n1" => "블루", "op_n2" => "", "op_cost" => 0, "op_soldout" => 0]
        ]
    ]
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

if ($result['code'] == '0000') {
    echo "등록 성공! 상품코드: " . $result['icode'];
} else {
    echo "등록 실패: " . $result['message'];
}
?>

8.2 상품 상태 일괄변경 (PHP)

<?php
$url = "https://www.domesin.com/API/v11/item_status_batch_update.php";

$data = [
    "api_key" => "도매의신 API KEY",
    "m_id" => "도매의신 공급사아이디",
    "items" => [
        ["icode" => "TS10000001", "status" => 1],  // 품절
        ["icode" => "TS10000002", "status" => 0],  // 재입고
        ["icode" => "TS10000003", "status" => 2]   // 단종
    ]
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);
?>

8.3 주문 목록 조회 (PHP)

<?php
$url = "https://www.domesin.com/API/v11/vender_order_list.php";

$data = [
    "api_key" => "도매의신 API KEY",
    "m_id" => "도매의신 공급사아이디",
    "page" => 1,
    "rows" => 50,
    "start_date" => "2025-05-01",
    "end_date" => "2025-05-08",
    "o_status" => 1  // 발송대기 주문만
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

if ($result['code'] == '0000') {
    foreach ($result['orders'] as $order) {
        echo "주문번호: " . $order['order_code'] . "\n";
        echo "상품: " . $order['iname'] . "\n";
        echo "수취인: " . $order['d_name'] . "\n";
        echo "---\n";
    }
}
?>

8.4 일괄 송장 등록 (PHP)

<?php
$url = "https://www.domesin.com/API/v11/vender_invoice_batch_update.php";

$data = [
    "api_key" => "도매의신 API KEY",
    "m_id" => "도매의신 공급사아이디",
    "invoices" => [
        [
            "order_list_code" => 12345,
            "delivery_idx" => 1,        // CJ대한통운
            "delivery_code" => "123456789012"
        ],
        [
            "order_list_code" => 12346,
            "delivery_idx" => 4,        // 한진택배
            "delivery_code" => "987654321098"
        ]
    ]
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

if ($result['code'] == '0000') {
    echo "성공: " . $result['success_count'] . "건\n";
    echo "실패: " . $result['fail_count'] . "건\n";
}
?>

8.5 취소 요청 처리 (PHP)

<?php
// 취소 승인
$url = "https://www.domesin.com/API/v11/vender_cancel_process.php";

$data = [
    "api_key" => "도매의신 API KEY",
    "m_id" => "도매의신 공급사아이디",
    "order_list_code" => 12345,
    "action" => "approve"  // 취소 승인
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

// 취소 거부
$data2 = [
    "api_key" => "도매의신 API KEY",
    "m_id" => "도매의신 공급사아이디",
    "order_list_code" => 12346,
    "action" => "reject",
    "reject_reason" => "이미 상품이 출고되어 취소가 불가합니다."
];

curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data2));
$response2 = curl_exec($ch);
curl_close($ch);
?>
문의: API Key 발급 및 기타 문의사항은 도매의신 운영자에게 연락해 주세요.

API 문의하기

안내: API 관련 문의사항을 게시판에 남겨주세요.