1. 상품정보 API
기본정보
- Method: POST
- Response Format: JSON
- 문자셋: UTF-8
- 특기사항: 너무 많은 요청시 도매의신 임의로 제한할 수 있습니다.
1.1 신규상품 요청
POST
application/x-www-form-urlencoded
http://data.domesin.com/API/v13/item_list.php
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 API키 |
| m_id | ● | String | 도매의신 회원아이디 |
| page | ● | int | 요청하는 페이지 |
| start_date | ● | date | YYYY-mm-dd (예: 2018-01-01) 해당일자 00시00분 부터 |
| end_date | | date | YYYY-mm-dd 해당일자 23시59분59초 까지 (NULL일경우 오늘) |
| rows | | int | 페이지당 데이터수 (최대 500, 초과시 500으로 고정) |
| cid | | int | 도매의신 카테고리코드 (NULL일경우 모든상품) |
| vender_m_code | | String | 도매의신 업체코드 (NULL일경우 전체상품) |
| is_option | | int | 1: 선택옵션 있는 상품만, -1: 선택옵션 없는 상품만, 0/NULL: 전체 |
| is_overseas | | int | 1: 해외직구 상품만, -1: 국내배송상품만, 0/NULL: 전체 |
| item_sale_type | | int | 1:VIP전용, 2:폐쇄몰전용, 3:파트너전용, 4:관리자전용, 0/NULL:일반상품 |
1.2 수정상품 요청
POST
application/x-www-form-urlencoded
http://data.domesin.com/API/v13/item_change_list.php
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 API키 |
| m_id | ● | String | 도매의신 회원아이디 |
| page | ● | int | 요청하는 페이지 |
| start_date | ● | date | YYYY-mm-dd 해당일자 00시00분 부터 |
| end_date | | date | YYYY-mm-dd 해당일자 23시59분59초 까지 |
| rows | | int | 페이지당 데이터수 (최대 500) |
| search | ● | String | 'Y' 또는 'N' (N: 모든변경상품, Y: 상세조건에 해당하는 데이터) |
| c_iname | | int | 1: 상품명이 변경된 데이터 |
| c_cost | | int | 1: 가격이 변경된 데이터 |
| c_status | | int | NULL: 모든판매상태, 0:재입고, 1:품절, 2:단종 |
| c_content | | int | 1: 상품상세설명이 변경된 데이터 |
| c_delivery | | int | 1: 배송정책이 변경된 데이터 |
| c_list_option | | int | 1: 상품선택옵션이 변경된 데이터 |
| c_overseas | | int | 1: 해외배송상품 여부가 변경된 데이터 |
1.3 단품 정보 조회
POST
application/x-www-form-urlencoded
http://data.domesin.com/API/v13/item_info.php
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 API키 |
| m_id | ● | String | 도매의신 회원아이디 |
| icode | ● | String | 도매의신 상품코드 (예: TS10000001) |
1.4 월간인기상품 요청
POST
application/x-www-form-urlencoded
http://data.domesin.com/API/v13/item_last_month_hit.php
1.5 상품정보 응답 필드
| 필드명 | 타입 | 필수 | 설명 |
| code | String | NOT NULL | API 결과 (성공시 '0000', 그외 에러) |
| message | String | | 결과 메시지 |
| total_count | int | NOT NULL | 전체 상품수 |
| total_page | int | NOT NULL | 전체 페이지수 |
| current_page | int | NOT NULL | 현재 페이지 |
| items 배열 |
| iname | String | NOT NULL | 상품명 |
| icode | String | NOT NULL | 도매의신 고유 상품코드 |
| cid | int | NOT NULL | 도매의신 카테고리 코드 |
| price | int | NOT NULL | 판매가 (도매의신에서 판매회원에 공급하는 가격) |
| price_consumer | int | | 일반 소비자 가격 |
| islimit | int | NOT NULL | 소비자가 준수여부 (0:자율판매, 1:판매가 준수) |
| limit_price | int | | 판매준수 가격 |
| tax | int | NOT NULL | 과세여부 (0:과세, 1:면세) |
| delivery_type | int | NOT NULL | 배송구분 (0:기본배송, 1:무료, 2:착불, 3:수량별) |
| delivery_amount | int | NOT NULL | 배송비 |
| r_delivery_amount | int | NOT NULL | 반품배송비 |
| delivery_qty | int | | 묶음배송수량 |
| status | int | NOT NULL | 판매상태 (0:판매중, 1:품절, 2:단종) |
| adult | int | NOT NULL | 성인상품여부 (0:전체이용가, 1:성인전용) |
| isreturn | int | NOT NULL | 반품가능여부 (1:반품가능, 0:반품불가) |
| is_overseas | int | NOT NULL | 해외직배송여부 (1:해외직배송, 0:국내배송) |
| icountry | String | NOT NULL | 원산지 정보 |
| maker | String | NOT NULL | 제조사 |
| brand | String | | 브랜드명 |
| model | String | | 모델명 |
| keyword | String | | 상품 검색 키워드 |
| content | Text | | 상품상세설명 (HTML) |
| img | Array | NOT NULL | 상품이미지 (최대 5개) |
| select_option | String | | 상품선택옵션 |
| text_option | String | | 상품입력옵션 |
| notice | Text | | 상품개별공지 (HTML) |
| reg_datetime | datetime | NOT NULL | 최초상품등록일 (YYYY-mm-dd HH:ii:ss) |
| up_datetime | datetime | NOT NULL | 마지막수정일시 |
| cert_type | int | NOT NULL | 상품인증타입 (0:인증대상아님, 1:인증대상, 2:상세설명에 표기) |
| cert | String | | 상품인증코드 |
| cert_no | String | | 상품인증번호 |
| gosi_code | String | NOT NULL | 상품고시코드 |
| gosi1~gosi22 | String | | 상품고시 항목 (고시종류에 따라 다름) |
2. 주문 API
주의사항:
- API키 및 아이디가 유출될 경우 악용될 수 있으므로 절대 외부에 공개하지 마세요.
- 도매의신 웹사이트 판매자 주문관리에 정기적으로 접속하여 주문정보를 확인하세요.
- 여러사람이 공유하는 주문시스템의 경우 사용을 권장하지 않습니다.
기본정보
- Method: POST (JSON)
- Response Format: JSON
- 문자셋: UTF-8
2.1 상품주문 요청
POST
application/json
https://data.domesin.com/API/v11/order.php
테스트용:
POST
application/json
https://data.domesin.com/API/v11/order_request_test.php
참고: 테스트 URL로 먼저 테스트 후 정식 주문URL로 처리하세요. 테스트 주문은 결과값만 리턴하고 실제 주문은 처리되지 않습니다.
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 API키 |
| m_id | ● | String | 도매의신 회원아이디 |
| c_name | ● | String | 수취인 이름 |
| c_hp | ● | String | 수취인 휴대폰 번호 |
| c_tel | | String | 수취인 연락처 2 |
| c_zip | ● | String | 수취인 우편번호 |
| c_addr | ● | String | 수취인 주소1 |
| c_addr_detail | ● | String | 수취인 상세주소 |
| c_ship_memo | | String | 배송요청사항 |
| c_memo | | String | 주문관리메모 |
| c_memo2 | | String | 기타 (솔루션 주문번호) |
| items 배열 |
| items[].icode | ● | String | 도매의신 상품코드 |
| items[].option1 | | String | 1차옵션 이름 (정확한 문자로 입력) |
| items[].option2 | | String | 2차옵션 이름 |
| items[].qty | ● | int | 수량 |
2.2 주문 응답
| 필드명 | 타입 | 필수 | 설명 |
| code | String | NOT NULL | 주문코드 (성공시 '0000', 그외 에러) |
| message | String | | 결과 메시지 |
| order_code | String | NOT NULL | 장바구니 주문코드 |
| item_amount | int | NOT NULL | 상품합계금액 |
| delivery_amount | int | NOT NULL | 배송비 합계금액 (도서산간 추가배송비 포함) |
| order_list_detail 배열 |
| order_list_code | int | NOT NULL | 주문상품 개별원장번호 (주문상태 조회시 사용) |
| icode | String | NOT NULL | 주문상품 코드 |
| iname | String | NOT NULL | 주문상품 이름 |
| qty | int | NOT NULL | 주문상품 수량 |
| item_amount | int | NOT NULL | 주문상품 단가 |
| is_island | int | NOT NULL | 도서산간 추가배송비 여부 (0:해당없음, 1:포함) |
2.3 주문상태 조회
POST
application/json
https://data.domesin.com/API/v11/order_status.php
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 API키 |
| m_id | ● | String | 도매의신 회원아이디 |
| order_code | ● | String | 도매의신 주문코드 |
2.4 주문상태 조회 응답
| 필드명 | 타입 | 필수 | 설명 |
| code | String | NOT NULL | 결과코드 |
| message | String | | 결과 메시지 |
| order_code | String | NOT NULL | 도매의신 주문코드 |
| c_name | String | NOT NULL | 수취인 이름 |
| order_list_detail 배열 |
| order_list_code | int | NOT NULL | 주문상품 개별원장번호 |
| icode | String | NOT NULL | 주문상품 코드 |
| iname | String | NOT NULL | 주문상품 이름 |
| qty | int | NOT NULL | 주문상품 수량 |
| status | String | NOT NULL | 주문상태 (신규주문, 배송준비중, 발송완료, 취소완료) |
| claim_status | String | | 클레임 상태 (취소요청, 취소거절, 반품요청, 반품승인 등) |
| del_corp | String | | 배송업체 이름 |
| del_no | String | | 배송송장번호 |
2.5 주문취소 요청
POST
application/json
https://data.domesin.com/API/v11/order_cancel.php
주의: 주문취소는 '신규주문' 상태에서만 가능하며, 개별상품 취소로 진행하셔야 합니다.
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 API키 |
| m_id | ● | String | 도매의신 회원아이디 |
| order_code | ● | String | 도매의신 주문코드 (장바구니) |
| order_list_code | ● | int | 주문시 발급받은 상품별 주문코드 |
2.6 내 적립금 조회
POST
application/x-www-form-urlencoded
https://data.domesin.com/API/v11/my_cash.php
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 API키 |
| m_id | ● | String | 도매의신 회원아이디 |
3. 에러코드표
| 코드 | 설명 |
| 0000 | 성공 |
| 10 | API키 에러 |
| 11 | 회원아이디 에러 |
| 12 | 파라미터 page값 에러 |
| 13 | 파라미터 start_date값 에러 |
| 14 | 파라미터 search값 에러 ('Y' 또는 'N'으로 전달해 주세요) |
| 16 | API 사용 권한 에러 |
| 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://data.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 상품등록 요청
POST
application/json
https://data.domesin.com/API/v11/item_register.php
테스트용:
POST
application/json
https://data.domesin.com/API/v11/item_register_test.php
필수 파라미터
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 API키 |
| m_id | ● | String | 도매의신 공급사 아이디 |
| cid | ● | int | 도매의신 카테고리 코드 (최하위 카테고리) |
| iname | ● | String | 상품명 (최대 100자) |
| origin | ● | String | 원산지 (예: 국내산, 해외|아시아|중국) |
| icompany | ● | String | 제조사 |
| keyword | ● | String | 검색 키워드 (콤마로 구분, 5개 이상) |
| cost | ● | int | 공급가 (VAT포함) |
| tax | ● | int | 0:과세, 1:면세 |
| adult | ● | int | 0:일반상품, 1:성인전용 |
| status | ● | int | 0:판매중, 1:품절, 2:단종 |
| i_type | ● | int | 0:새제품, 1:중고품 |
| amount_g | ● | int | 소비자가 |
| islimit | ● | int | 0:자율판매가, 1:판매가격준수 |
| delivery_type | ● | int | 0:기본배송, 1:무료배송, 2:착불배송, 3:수량별배송 |
| delivery_amount | ● | int | 배송비 |
| r_delivery_amount | ● | int | 반품배송비 (편도) |
| isreturn | ● | int | 0:반품불가, 1:반품가능 |
| is_overseas | ● | String | Y:해외직배송, 빈값:국내배송 |
| cert_type | ● | int | 0:인증대상아님, 1:인증대상, 2:상세설명에표기 |
| i_content | ● | String | 상품상세설명 (HTML) |
| images | ● | Array | 상품 이미지 URL 배열 (최대 5개, images[0]은 필수) |
| vender_code | ● | String | 업체상품코드 |
| item_sale_type | ● | int | 0:일반, 1:VIP전용, 2:폐쇄몰전용, 3:파트너전용 |
선택 파라미터
| 파라미터 | 타입 | 기본값 | 설명 |
| iname_del | String | | 택배송장명 |
| ibrand | String | | 브랜드명 |
| imodel | String | | 모델명 |
| amount_limit | int | 0 | 판매준수가 (islimit=1일때 필수) |
| delivery_qty | int | 0 | 묶음배송수량 (delivery_type=3일때 필수) |
| raid | int | | 반품지 주소 ID (없으면 기본반품지 사용) |
| cert | String | | 인증코드 |
| cert_no | String | | 인증번호 |
| notice | String | | 상품공지 (HTML) |
| gosi_code | String | | 상품고시코드 |
| gosi | Array | | 상품고시정보 배열 |
선택옵션 (options)
| 파라미터 | 타입 | 설명 |
| options.op_t1 | String | 옵션명1 (예: 색상) |
| options.op_t2 | String | 옵션명2 (예: 사이즈) |
| options.items | Array | 옵션 항목 배열 |
| options.items[].op_n1 | String | 옵션값1 (예: 레드) |
| options.items[].op_n2 | String | 옵션값2 (예: L) |
| options.items[].op_cost | int | 옵션추가금액 (0이면 기본가) |
| options.items[].op_soldout | int | 0:판매중, 1:품절 |
1.2 상품등록 응답
| 필드명 | 타입 | 설명 |
| code | String | 결과코드 (성공: 0000) |
| message | String | 결과 메시지 |
| iid | int | 등록된 상품 고유번호 |
| icode | String | 등록된 상품코드 (예: TS10000001) |
2. 상품수정 API
주의: 상품수정 API는 공급사 본인의 상품만 수정 가능합니다.
수정 시 변경이력이 기록되며, 일부 항목은 관리자 승인이 필요할 수 있습니다.
기본정보
- Method: POST (JSON)
- Content-Type: application/json
- Response Format: JSON
- 문자셋: UTF-8
2.1 기본정보 수정
POST
application/json
https://data.domesin.com/API/v11/vender_item_edit.php
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 공급사 API키 |
| m_id | ● | String | 도매의신 공급사 아이디 |
| icode | ● | String | 수정할 상품코드 (예: TS10000001) |
| iname | | String | 상품명 (최대 100자) |
| iname_del | | String | 택배송장명 |
| cid | | int | 카테고리 코드 (최하위 카테고리) |
| origin | | String | 원산지 (예: 국내산, 해외|아시아|중국) |
| icompany | | String | 제조사 |
| ibrand | | String | 브랜드명 |
| imodel | | String | 모델명 |
| keyword | | String | 검색 키워드 (콤마로 구분, 5개 이상) |
| cost | | int | 공급가 (VAT포함) |
| amount_g | | int | 소비자가 |
| tax | | int | 0:과세, 1:면세 |
| adult | | int | 0:일반상품, 1:성인전용 |
| islimit | | int | 0:자율판매가, 1:판매가격준수 |
| amount_limit | | int | 판매준수가 (islimit=1일때) |
| i_content | | String | 상품상세설명 (HTML) |
| notice | | String | 상품개별공지 (HTML) |
| gosi_code | | String | 상품고시코드 |
| gosi | | Array | 상품고시정보 배열 |
| cert_type | | int | 0:인증대상아님, 1:인증대상, 2:상세설명에표기 |
| cert | | String | 인증코드 |
| cert_no | | String | 인증번호 |
| vender_code | | String | 업체상품코드 |
2.2 썸네일/이미지 수정
POST
application/json
https://data.domesin.com/API/v11/vender_item_thumbnail.php
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 공급사 API키 |
| m_id | ● | String | 도매의신 공급사 아이디 |
| icode | ● | String | 수정할 상품코드 |
| images | ● | Array | 상품 이미지 URL 배열 (최대 5개) |
| images[0] | ● | String | 대표이미지 URL (필수, 최소 400x400) |
| images[1~4] | | String | 추가이미지 URL |
| replace_all | | int | 1: 모든 이미지 교체, 0: 기존 이미지 유지하고 추가 (기본: 1) |
이미지 규격:
- 최소 크기: 400x400px (권장: 600x600 이상)
- 지원 형식: JPG, PNG
- 대표이미지(images[0])는 필수
2.3 옵션 수정
POST
application/json
https://data.domesin.com/API/v11/vender_item_option.php
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 공급사 API키 |
| m_id | ● | String | 도매의신 공급사 아이디 |
| icode | ● | String | 수정할 상품코드 |
| options | ● | Object | 옵션 정보 |
| options.op_t1 | ● | String | 1차 옵션명 (예: 색상) |
| options.op_t2 | | String | 2차 옵션명 (예: 사이즈) |
| options.items | ● | Array | 옵션 항목 배열 |
options.items 배열 구조
| 파라미터 | 필수 | 타입 | 설명 |
| op_n1 | ● | String | 1차 옵션값 (예: 레드) |
| op_n2 | | String | 2차 옵션값 (예: L) |
| op_cost | | int | 옵션추가금액 (기본: 0, 범위: 공급가의 ±50%) |
| op_soldout | | int | 0: 판매중, 1: 품절 |
| op_limit | | int | 옵션별 판매준수가 |
옵션 수정 규칙:
- 기본판매가와 동일한 가격(op_cost=0)의 옵션이 최소 1개 필요
- 옵션추가금액은 상품 공급가의 ±50%를 초과할 수 없음
- 중복된 옵션명 조합 불가
2.4 판매상태 변경 (품절/단종/재입고)
POST
application/json
https://data.domesin.com/API/v11/vender_item_status.php
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 공급사 API키 |
| m_id | ● | String | 도매의신 공급사 아이디 |
| icode | ● | String | 수정할 상품코드 |
| status | ● | int | 판매상태 (0:판매중/재입고, 1:품절, 2:단종) |
일괄 상태 변경 (동일 API로 items 배열 전송)
POST
application/json
https://data.domesin.com/API/v11/vender_item_status.php
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 공급사 API키 |
| m_id | ● | String | 도매의신 공급사 아이디 |
| items | ● | Array | 상품 상태 변경 배열 |
| items[].icode | ● | String | 상품코드 |
| items[].status | ● | int | 판매상태 |
2.5 배송설정 수정
POST
application/json
https://data.domesin.com/API/v11/vender_item_delivery.php
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 공급사 API키 |
| m_id | ● | String | 도매의신 공급사 아이디 |
| icode | ● | String | 수정할 상품코드 |
| delivery_type | ● | int | 배송구분 (0:기본배송, 1:무료배송, 2:착불배송, 3:수량별배송) |
| delivery_amount | | int | 배송비 (무료배송 제외시 필수) |
| delivery_qty | | int | 묶음배송수량 (수량별배송시 필수) |
| r_delivery_amount | | int | 반품배송비 (편도, 착불배송 제외시 필수) |
| isreturn | | int | 반품가능여부 (0:반품불가, 1:반품가능) |
| is_overseas | | String | 해외직배송여부 (Y:해외직배송, 빈값:국내배송) |
| raid | | int | 반품지 주소 ID |
배송비 규칙:
- 무료배송(delivery_type=1): 배송비 자동 0원 처리
- 착불배송(delivery_type=2): 반품배송비 자동 0원 처리
- 수량별배송(delivery_type=3): 묶음배송수량(delivery_qty) 필수
3. 1:1 문의 관리 API
안내: 공급사에게 등록된 1:1 문의를 조회하고 답변할 수 있습니다.
3.1 문의 목록 조회
POST
application/json
https://data.domesin.com/API/v11/vender_qna.php
action: list
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 공급사 API키 |
| m_id | ● | String | 도매의신 공급사 아이디 |
| page | | int | 페이지 번호 (기본: 1) |
| rows | | int | 페이지당 건수 (기본: 20, 최대: 100) |
| status | | String | 답변상태 (공백:전체, 1:미답변, 2:답변완료) |
| start_date | | date | 조회시작일 (YYYY-mm-dd, 기본: 1년전) |
| end_date | | date | 조회종료일 (YYYY-mm-dd, 기본: 오늘) |
3.2 문의 답변 등록
POST
application/json
https://data.domesin.com/API/v11/vender_qna.php
action: answer
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 공급사 API키 |
| m_id | ● | String | 도매의신 공급사 아이디 |
| idx | ● | int | 문의 고유번호 (목록조회의 idx) |
| a_content | ● | String | 답변 내용 |
4. 주문수집 API
주의: 공급사 주문수집 API는 판매자 주문 API와 다릅니다.
공급사는 본인 상품에 대한 주문만 조회할 수 있습니다.
4.1 주문 목록 조회
POST
application/json
https://data.domesin.com/API/v11/vender_order_list.php
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 공급사 API키 |
| m_id | ● | String | 도매의신 공급사 아이디 |
| page | | int | 페이지 번호 (기본: 1) |
| rows | | int | 페이지당 건수 (기본: 50, 최대: 500) |
| start_date | ● | date | 조회시작일 (YYYY-mm-dd) |
| end_date | | date | 조회종료일 (YYYY-mm-dd, 기본: 오늘) |
| o_status | | int | 주문상태 (0:신규주문, 1:발송대기, 2:발송완료, 3:배송완료, 4:취소/반품) |
| search_type | | String | 검색유형 (order_code, icode, d_name, d_hp) |
| search_keyword | | String | 검색어 |
4.2 주문 목록 응답 필드
| 필드명 | 타입 | 설명 |
| code | String | 결과코드 (성공: 0000) |
| total_count | int | 전체 주문수 |
| total_page | int | 전체 페이지수 |
| current_page | int | 현재 페이지 |
| orders 배열 |
| order_list_code | int | 주문상품 개별원장번호 |
| order_code | String | 주문코드 |
| icode | String | 상품코드 |
| iname | String | 상품명 |
| option_name | String | 선택옵션명 |
| qty | int | 주문수량 |
| item_amount | int | 상품금액 |
| o_status | int | 주문상태 |
| o_status_name | String | 주문상태명 |
| d_name | String | 수취인명 |
| d_hp | String | 수취인 연락처 |
| d_zip | String | 우편번호 |
| d_addr | String | 배송주소 |
| d_memo | String | 배송메모 |
| delivery_idx | int | 택배사 코드 |
| delivery_code | String | 송장번호 |
| r_datetime | datetime | 주문일시 |
| cancel_status | int | 취소상태 (0:정상, 1:취소요청, 2:취소완료, 3:취소거부) |
5. 송장업데이트 API
5.1 단건 송장 등록
POST
application/json
https://data.domesin.com/API/v11/vender_invoice.php
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 공급사 API키 |
| m_id | ● | String | 도매의신 공급사 아이디 |
| order_list_code | ● | int | 주문상품 개별원장번호 |
| delivery_idx | ● | int | 택배사 코드 |
| delivery_code | ● | String | 송장번호 |
5.2 일괄 송장 등록 (동일 API로 invoices 배열 전송)
POST
application/json
https://data.domesin.com/API/v11/vender_invoice.php
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 공급사 API키 |
| m_id | ● | String | 도매의신 공급사 아이디 |
| invoices | ● | Array | 송장 정보 배열 |
| invoices[].order_list_code | ● | int | 주문상품 개별원장번호 |
| invoices[].delivery_idx | ● | int | 택배사 코드 |
| invoices[].delivery_code | ● | String | 송장번호 |
5.3 택배사 코드표
| 코드 | 택배사명 | 코드 | 택배사명 |
| 1 | CJ대한통운 | 2 | 롯데택배 |
| 3 | 우체국택배 | 4 | 한진택배 |
| 5 | 로젠택배 | 6 | 경동택배 |
| 7 | 대신택배 | 8 | 일양로지스 |
| 9 | 합동택배 | 10 | 홈픽택배 |
| 11 | 쿠팡로켓배송 | 12 | GS편의점택배 |
| 13 | CU편의점택배 | 14 | GSMNtoN |
| 99 | 기타 | | |
송장 등록 규칙:
- 발송대기(o_status=1) 상태의 주문만 송장 등록 가능
- 취소요청 중인 주문은 송장 등록 불가
- 송장 등록 시 주문상태가 자동으로 발송완료(o_status=2)로 변경
6. 주문상태변경 API
6.1 주문 상태 변경
POST
application/json
https://data.domesin.com/API/v11/vender_order_status.php
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 공급사 API키 |
| m_id | ● | String | 도매의신 공급사 아이디 |
| order_code | ● | String | 주문코드 (주문목록 조회의 order_code) |
| o_status | ● | int | 변경할 주문상태 (0 또는 1만 가능) |
6.2 주문상태 코드표
| 코드 | 상태명 | 설명 |
| 0 | 신규주문 | 결제 완료 후 초기 상태 (배송준비중 → 신규주문 변경시 사용) |
| 1 | 배송준비중 | 주문확인 (신규주문 → 배송준비중 변경시 사용) |
주문상태변경 규칙:
- 주문확인: o_status=1 (신규주문 → 배송준비중)
- 주문확인취소: o_status=0 (배송준비중 → 신규주문)
- 발송완료(2), 배송완료(3) 상태는 송장등록 API를 통해 변경
6.3 취소요청 목록 조회
POST
application/json
https://data.domesin.com/API/v11/vender_cancel.php
action: list
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 공급사 API키 |
| m_id | ● | String | 도매의신 공급사 아이디 |
| action | ● | String | "list" 고정 |
| start_date | | String | 조회 시작일 (YYYY-MM-DD, 기본: 1개월전) |
| end_date | | String | 조회 종료일 (YYYY-MM-DD, 기본: 오늘) |
| cancel_status | | String | 취소상태 (1:취소요청, 2:취소승인, 0:전체, 기본:1) |
| page | | int | 페이지 (기본: 1) |
| rows | | int | 조회개수 (기본: 20, 최대: 100) |
6.4 취소요청 처리
POST
application/json
https://data.domesin.com/API/v11/vender_cancel.php
action: approve 또는 reject
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 공급사 API키 |
| m_id | ● | String | 도매의신 공급사 아이디 |
| order_code | ● | String | 주문코드 (목록조회의 order_code) |
| action | ● | String | 처리유형 (approve:취소승인, reject:취소거부) |
| cancel_reason | △ | String | 취소사유 (action=approve일때 필수) |
| delivery_idx | △ | int | 택배사코드 (action=reject일때 필수) |
| delivery_code | △ | String | 송장번호 (action=reject일때 필수) |
6.5 반품요청 목록 조회
POST
application/json
https://data.domesin.com/API/v11/vender_return.php
action: list
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 공급사 API키 |
| m_id | ● | String | 도매의신 공급사 아이디 |
| action | ● | String | "list" 고정 |
| start_date | | String | 조회 시작일 (YYYY-MM-DD, 기본: 1개월전) |
| end_date | | String | 조회 종료일 (YYYY-MM-DD, 기본: 오늘) |
| return_status | | String | 반품상태 (1:반품요청, 2:회수진행, 3:반품승인, 4:반품불가, 공백:1+2) |
| page | | int | 페이지 (기본: 1) |
| rows | | int | 조회개수 (기본: 20, 최대: 100) |
6.6 반품요청 처리
POST
application/json
https://data.domesin.com/API/v11/vender_return.php
action: collecting, approve 또는 reject
| 파라미터 | 필수 | 타입 | 설명 |
| api_key | ● | String | 도매의신에서 발급받은 공급사 API키 |
| m_id | ● | String | 도매의신 공급사 아이디 |
| order_code | ● | String | 주문코드 (목록조회의 order_code) |
| action | ● | String | 처리유형 (collecting:회수진행, approve:반품승인, reject:반품거부) |
| reason | △ | String | 처리사유 (action=reject일때 필수) |
6.7 취소상태 코드표
| 코드 | 상태명 | 설명 |
| 0 | 정상 | 취소 관련 없음 |
| 1 | 취소요청 | 고객이 취소 요청 |
| 2 | 취소완료 | 취소 승인됨 |
| 3 | 취소불가 | 공급사가 취소 거부 |
| 4 | 취소철회 | 고객이 취소 요청 철회 |
6.8 반품상태 코드표
| 코드 | 상태명 | 설명 |
| 0 | 정상 | 반품 관련 없음 |
| 1 | 반품요청 | 고객이 반품 요청 |
| 2 | 회수진행중 | 반품 상품 회수 진행중 |
| 3 | 반품승인 | 반품 승인 및 환불 완료 |
| 4 | 반품불가 | 공급사가 반품 거부 |
| 5 | 반품철회 | 고객이 반품 요청 철회 |
주문상태 변경 규칙:
- 신규주문(0) → 발송대기(1): 상품 준비 시작
- 발송대기(1) → 발송완료(2): 송장 등록 필수
- 취소요청(cancel_status=1) 상태에서는 취소승인 또는 취소거부만 가능
- 발송완료 이후에는 취소 불가 (반품으로 처리)
- 반품요청(return_status=1) 상태에서는 회수진행, 반품승인, 반품거부 가능
7. 에러코드표
| 코드 | 설명 |
| 0000 | 성공 |
| 10 | API키 에러 |
| 11 | 회원아이디 에러 |
| 16 | API 사용 권한 에러 (공급사 권한 필요) |
| 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) 미입력 |
| 50 | DB 등록 실패 |
| 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://data.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://data.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://data.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://data.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://data.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 발급 및 기타 문의사항은 도매의신 운영자에게 연락해 주세요.