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

도매의신 API 메뉴얼

도매의신 API 메뉴얼

📩 API 문의사항 desim@datscorp.com

도매의신 API란?

도매의신 API는 판매자공급사가 도매의신 플랫폼과 연동하여 상품정보 조회, 주문 처리, 재고 관리 등을 자동화할 수 있는 프로그래밍 인터페이스입니다.

상품 관리
신규상품 조회, 수정상품 동기화, 재고/가격 업데이트
주문 처리
자동 발주, 주문상태 조회, 송장번호 등록
실시간 연동
외부 솔루션, 쇼핑몰, ERP 시스템과 연동
CS 관리
1:1 문의 조회/답변, 취소/반품 처리

판매자 (셀러)

도매의신에서 상품을 소싱하여 오픈마켓, 스마트스토어 등에 판매하는 분들을 위한 API입니다. 상품정보 수집, 자동발주, 주문상태 확인 등의 기능을 제공합니다.

공급사 (벤더)

도매의신에 상품을 공급하는 업체를 위한 API입니다. 상품등록/수정, 주문수집, 송장등록, 취소/반품 처리 등의 기능을 제공합니다.

안내: 본 문서는 도매의신 판매회원(공급사/판매자)을 위한 API 연동 가이드입니다.
API Key는 상단의 API키 발급받기 탭에서 발급 방법을 확인하세요.
⚠️ 주의: API에 따라 호출 URL이 다를 수 있으니 꼭 호출URL을 확인해주세요!
읽기(조회): https://data.domesin.com/API/v11/ | 쓰기/수정: https://domesin.com/API/v11/

API키 발급받기

안내: 도매의신 API를 사용하려면 먼저 API키를 발급받아야 합니다.
회원 유형(판매자/공급사)에 따라 발급 방법이 다르니, 아래 안내를 참고해 주세요.

판매자용 API키 발급

판매회원(셀러)은 아래 절차에 따라 API키를 발급받을 수 있습니다.

1 도매의신 로그인 - 판매회원 계정으로 로그인합니다.
2 마이페이지 이동 - 상단 메뉴에서 마이페이지로 이동합니다.
3 내정보수정 클릭 - 왼쪽 하단 메뉴에서 내정보수정을 클릭합니다.
4 API키 생성 - 판매회원용 API키 생성 버튼을 클릭합니다.
발급 완료 - API키가 생성되어 화면에 표시됩니다.

공급사용 API키 발급

공급사(벤더)는 SCM 시스템을 통해 API키를 발급받을 수 있습니다.

1 공급사 SCM 접속 - 공급사 전용 SCM 시스템에 로그인합니다.
2 업체정보수정 이동 - 화면 하단의 업체정보수정 메뉴로 이동합니다.
3 API KEY 발급 클릭 - 페이지 하단의 API KEY 발급 버튼을 클릭합니다.
발급 완료 - API키가 생성되어 화면에 표시됩니다.
API키 관리 주의사항

  • 보안 유지: API키는 비밀번호와 같습니다. 절대 외부에 공개하거나 타인과 공유하지 마세요.
  • 유출 시 조치: API키가 유출된 경우, 즉시 재발급받아 기존 키를 무효화하세요.
  • 코드 관리: 소스코드에 API키를 직접 입력하지 말고, 환경변수나 설정파일을 사용하세요.
  • 요청 제한: 과도한 API 요청은 서비스 이용이 제한될 수 있습니다.

API키를 발급받으셨나요? 이제 위의 탭에서 판매자 API 또는 공급사 API 메뉴얼을 확인하세요.

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_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:일반상품

요청 샘플

POST http://data.domesin.com/API/v13/item_list.php
Content-Type: application/x-www-form-urlencoded

api_key=YOUR_API_KEY
&m_id=seller123
&page=1
&start_date=2025-05-01
&end_date=2025-05-25
&rows=100

응답 필드

필드명타입필수설명
codeString결과코드 (성공: "0000")
messageString결과 메시지
total_countint전체 상품수
total_pageint전체 페이지수
current_pageint현재 페이지
items[] 배열
icodeString도매의신 고유 상품코드
inameString상품명
iname_delString택배송장명
cidString카테고리 코드
icountryString원산지 (예: 국내산, 해외|아시아|중국)
makerString제조사
brandString브랜드명
modelString모델명
taxString과세여부 (0:과세, 1:면세)
vender_codeString공급사 상품코드
delivery_typeString배송구분 (0:기본, 1:무료, 2:착불, 3:수량별)
delivery_amountString배송비
priceString판매가 (회원등급별 공급가)
price_basicString기본 판매가
islimitString가격준수여부 (0:자율, 1:준수)
contentText상품상세설명 (HTML)
imgArray상품이미지 URL 배열
select_optionString선택옵션 문자열
statusString판매상태 (0:판매중, 1:품절, 2:단종)
adultString성인상품 (0:전체, 1:성인전용)
reg_datetimedatetime등록일시
up_datetimedatetime수정일시
isreturnString반품가능 (1:가능, 0:불가)
is_overseasint해외직배송 (1:해외, 0:국내)
cert_typeString인증타입 (0:대상아님, 1:인증대상, 2:상세표기)
gosi_codeString상품고시코드
item_sale_typeString판매유형 (0:일반, 1:VIP, 2:폐쇄몰, 3:파트너, 4:관리자)

응답 샘플

{
  "code": "0000",
  "message": "성공",
  "total_count": 125,
  "total_page": 2,
  "current_page": 1,
  "items": [
    {
      "icode": "TS10012345",
      "iname": "테스트 상품명",
      "iname_del": "택배송장명",
      "cid": "364",
      "icountry": "국내산",
      "maker": "제조사명",
      "brand": "브랜드명",
      "model": "모델명",
      "tax": "0",
      "vender_code": "TV100001",
      "delivery_type": "0",
      "delivery_amount": "3000",
      "price": "10000",
      "price_basic": "10000",
      "islimit": "0",
      "content": "<p>상품 상세설명 HTML</p>",
      "img": [
        "https://img.domesin.com/data/shop/297/TS10012345_main.jpg",
        "https://img.domesin.com/data/shop/297/TS10012345_sub1.jpg"
      ],
      "select_option": "[색상]\n레드==10000=0=0=0\n블루==10000=0=0=0\n",
      "status": "0",
      "adult": "0",
      "reg_datetime": "2025-01-15 10:30:00",
      "up_datetime": "2025-05-20 14:20:00",
      "isreturn": "1",
      "is_overseas": 0,
      "cert_type": "0",
      "gosi_code": "11",
      "item_sale_type": "0"
    }
  ]
}

1.2 수정상품 요청

POST application/x-www-form-urlencoded 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)
cidint도매의신 카테고리코드
vender_m_codeString공급사 코드
item_sale_typeint1:VIP전용, 2:폐쇄몰전용, 3:파트너전용, 4:관리자전용, 0/NULL:일반상품
searchString'Y' 또는 'N' (N: 모든변경상품, Y: 상세조건에 해당하는 데이터)
변경조건 필터 (search='Y' 일때 사용)
c_inameint1: 상품명이 변경된 데이터
c_costint1: 가격이 변경된 데이터
c_taxint1: 과세여부가 변경된 데이터
c_statusintNULL: 모든판매상태, 0:재입고, 1:품절, 2:단종
c_contentint1: 상품상세설명이 변경된 데이터
c_deliveryint1: 배송정책이 변경된 데이터
c_isreturnint1: 반품정책이 변경된 데이터
c_list_optionint1: 상품선택옵션이 변경된 데이터
c_limitint1: 가격준수 여부가 변경된 데이터
c_limit_priceint1: 판매준수가가 변경된 데이터
c_originint1: 원산지가 변경된 데이터
c_companyint1: 제조사가 변경된 데이터
c_adultint1: 성인상품 여부가 변경된 데이터
c_overseasint1: 해외배송상품 여부가 변경된 데이터

요청 샘플

POST http://data.domesin.com/API/v13/item_change_list.php
Content-Type: application/x-www-form-urlencoded

api_key=YOUR_API_KEY
&m_id=seller123
&page=1
&start_date=2025-05-01
&search=Y
&c_cost=1
&c_status=0

응답 필드

필드명타입필수설명
codeString결과코드 (성공: "0000")
messageString결과 메시지
total_countint전체 상품수
total_pageint전체 페이지수
current_pageint현재 페이지
items[] 배열 (1.1 신규상품과 동일 구조)

응답 샘플

{
  "code": "0000",
  "message": "",
  "total_count": 45,
  "total_page": 1,
  "current_page": 1,
  "items": [
    {
      "icode": "TS10012345",
      "iname": "수정된 상품명",
      "cid": "364",
      "icountry": "국내산",
      "maker": "제조사명",
      "tax": "0",
      "delivery_type": "0",
      "delivery_amount": "3000",
      "price": "10000",
      "status": "0",
      "up_datetime": "2025-05-20 14:20:00",
      "item_sale_type": "0"
    }
  ]
}

1.3 단품 정보 조회

POST application/x-www-form-urlencoded http://data.domesin.com/API/v13/item_info.php

요청 파라미터

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

요청 샘플

POST http://data.domesin.com/API/v13/item_info.php
Content-Type: application/x-www-form-urlencoded

api_key=YOUR_API_KEY
&m_id=seller123
&icode=TS10012345

응답 필드

필드명타입필수설명
codeString결과코드 (성공: "0000")
messageString결과 메시지
mb_pointString회원 포인트
items[] 배열 - 기본정보
icodeString도매의신 고유 상품코드
inameString상품명
cidString카테고리 코드
icountryString원산지 (예: 국내산, 해외|아시아|중국)
makerString제조사
brandString브랜드명
modelString모델명
keywordString검색 키워드 (콤마 구분)
마켓별 카테고리 경로
paString도매의신 판매카테고리 코드
pa_auctionString옥션 카테고리 경로
pa_gmarketStringG마켓 카테고리 경로
pa_11stString11번가 카테고리 경로
pa_interparkString인터파크 카테고리 경로
pa_storefarmString스토어팜 카테고리 경로
pa_tossString토스쇼핑 카테고리 경로
pa_lotteonString롯데온 카테고리 경로
이셀러스/ESM 카테고리 코드
esString이셀러스 기본 카테고리 코드
es_auctionString옥션 이셀러스 카테고리 코드
es_gmarketStringG마켓 이셀러스 카테고리 코드
esm_auctionStringESM 옥션 카테고리 코드
esm_gmarketStringESM G마켓 카테고리 코드
es_11stString11번가 이셀러스 카테고리 코드
es_interparkString인터파크 이셀러스 카테고리 코드
es_storefarmString스토어팜 이셀러스 카테고리 코드
es_coupangString쿠팡 이셀러스 카테고리 코드
domeggok_cateString도매꼭 카테고리 코드
toss_cateString토스쇼핑 카테고리 코드
lotteon_cateString롯데온 카테고리 코드
가격/배송 정보
taxString과세여부 (0:과세, 1:면세)
vender_codeString공급사 상품코드
delivery_typeString배송구분 (0:기본, 1:무료, 2:착불, 3:수량별)
delivery_amountString배송비
r_delivery_amountString반품배송비
delivery_qtyString묶음배송수량
priceString판매가 (회원등급별 공급가)
price_consumerString소비자가
islimitString가격준수여부 (0:자율, 1:준수)
limit_priceString가격준수가
상품 상태/옵션
contentText상품상세설명 (HTML)
imgArray상품이미지 URL 배열
select_optionString선택옵션 문자열
text_optionString입력옵션 문자열
noticeString상품공지
itypeString상품타입 (0:새상품, 1:중고)
statusString판매상태 (0:판매중, 1:품절, 2:단종)
adultString성인상품 (0:전체, 1:성인전용)
reg_datetimedatetime등록일시
up_datetimedatetime수정일시
isreturnString반품가능 (1:가능, 0:불가)
is_overseasint해외직배송 (1:해외, 0:국내)
인증/고시정보
cert_typeString인증타입 (0:대상아님, 1:인증대상, 2:상세표기)
certString인증유형 코드
cert_noString인증번호
gosi_codeString상품고시코드
gosi1~gosi22String상품고시 항목 (고시종류에 따라 다름)
item_sale_typeString판매유형 (0:일반, 1:VIP, 2:폐쇄몰, 3:파트너, 4:관리자)

응답 샘플

{
  "code": "0000",
  "message": "정상적으로 조회 되었습니다",
  "mb_point": "100000",
  "items": [
    {
      "icode": "TS14497347",
      "iname": "세면대 수전 다양한 각도 회전 연장 수도꼭지",
      "cid": "1478",
      "pa": "32120300",
      "pa_auction": "생활용품>샤워기/수전용품>기타샤워기/수전용품",
      "pa_gmarket": "생활용품>샤워기/수전용품>기타샤워기/수전용품",
      "pa_11st": "욕실용품>샤워기/수전>욕실/세면수전",
      "pa_interpark": "생활/수납/청소/욕실>샤워기/세면기/욕실편의>수도꼭지/수전/폽업/코브라>",
      "pa_storefarm": "생활/건강>욕실용품>샤워기/수전용품>수도/수전용품",
      "es": "351102000",
      "es_auction": "28561700",
      "es_gmarket": "300028890",
      "esm_auction": "",
      "esm_gmarket": "",
      "es_11st": "1006820",
      "es_interpark": "001830229006",
      "es_storefarm": "50002302",
      "es_coupang": "64517",
      "domeggok_cate": "6479",
      "icountry": "해외|아시아|중국",
      "maker": "UNK",
      "brand": "",
      "model": null,
      "tax": "0",
      "vender_code": "TV100544",
      "delivery_type": "0",
      "delivery_amount": "3000",
      "r_delivery_amount": null,
      "delivery_qty": "0",
      "keyword": "수전,세면대수전,욕실수전,주방수전,...",
      "price": "3570",
      "price_consumer": "",
      "islimit": "0",
      "limit_price": "0",
      "content": "<p align=\"center\"><img src=\"...\" /></p>",
      "img": [
        "https://img.domesin.com/data/shop/450/14497347_RKv5i.jpg"
      ],
      "select_option": "[선택]\n단일==3570=0=0=0\n",
      "text_option": "",
      "notice": "",
      "itype": "0",
      "status": "0",
      "adult": "0",
      "reg_datetime": "2025-07-24 13:35:37",
      "up_datetime": "2026-06-01 22:41:04",
      "isreturn": "1",
      "is_overseas": 0,
      "cert_type": "0",
      "cert": "0",
      "cert_no": "",
      "gosi_code": "35",
      "gosi1": "상세설명 참조",
      "gosi2": "상세설명 참조",
      "gosi3": "상세설명 참조",
      "gosi4": "상세설명 참조",
      "gosi5": "상세설명 참조",
      "gosi6": "상세설명 참조",
      "gosi7": "상세설명 참조",
      "gosi8": "상세설명 참조",
      "gosi9": "상품상세정보 참조",
      "gosi10": "상품상세정보 참조",
      "gosi11": "상품상세정보 참조",
      "gosi12": "상품상세정보 참조",
      "gosi13": "상품상세정보 참조",
      "gosi14": "상품상세정보 참조",
      "gosi15": "상품상세정보 참조",
      "gosi16": "상품상세정보 참조",
      "gosi17": "상품상세정보 참조",
      "gosi18": "상품상세정보 참조",
      "gosi19": "상품상세정보 참조",
      "gosi20": "상품상세정보 참조",
      "gosi21": "상품상세정보 참조",
      "gosi22": "상품상세정보 참조",
      "item_sale_type": "0"
    }
  ]
}
POST application/x-www-form-urlencoded http://data.domesin.com/API/v13/item_last_month_hit.php

요청 파라미터

파라미터필수타입설명
api_keyString도매의신에서 발급받은 API키
m_idString도매의신 회원아이디
pageint요청하는 페이지
rowsint페이지당 데이터수 (최대 500)

요청 샘플

POST http://data.domesin.com/API/v13/item_last_month_hit.php
Content-Type: application/x-www-form-urlencoded

api_key=YOUR_API_KEY
&m_id=seller123
&page=1
&rows=100

응답 필드

필드명타입필수설명
codeString결과코드 (성공: "0000")
messageString결과 메시지
total_countint전체 상품수
items[] 배열
rankint인기순위
icodeString상품코드
inameString상품명
priceint판매가
hit_countint조회수
order_countint주문수
imgString대표이미지 URL

응답 샘플

{
  "code": "0000",
  "message": "성공",
  "total_count": 100,
  "items": [
    {
      "rank": 1,
      "icode": "TS10012345",
      "iname": "인기상품1",
      "price": 15000,
      "hit_count": 5230,
      "order_count": 320,
      "img": "https://img.domesin.com/product/TS10012345_1.jpg"
    },
    {
      "rank": 2,
      "icode": "TS10012346",
      "iname": "인기상품2",
      "price": 12000,
      "hit_count": 4850,
      "order_count": 280,
      "img": "https://img.domesin.com/product/TS10012346_1.jpg"
    }
  ]
}

1.5 상품정보 응답 필드

필드명타입필수설명
codeStringNOT NULLAPI 결과 (성공시 '0000', 그외 에러)
messageString결과 메시지
mb_pointString회원 포인트 (item_info API에서만 반환)
total_countintNOT NULL전체 상품수 (item_list, item_change_list에서만)
total_pageintNOT NULL전체 페이지수 (item_list, item_change_list에서만)
current_pageintNOT NULL현재 페이지 (item_list, item_change_list에서만)
◼ items 배열 - 기본정보
icodevarchar(20)NOT NULL도매의신 고유상품 분류코드 (집결활용)
inamevarchar(100)NOT NULL상품이름
iname_delvarchar(100)택배송장명 (item_list, item_change_list에서만)
imodelvarchar(40)모델명
icompanyvarchar(40)제조사 이름
icountryvarchar(30)NOT NULL원산지 텍스트기록 (국내|강원도|양양)
ibrandvarchar(40)브랜드 이름
cidint(11)NOT NULL소속 카테고리 인덱스
sort_fullvarchar(255)소속 카테고리의 sort_full (상품검색에 활용하기 위함)
◼ 마켓별 카테고리 정보
paString도매의신 판매카테고리 코드
pa_auctionString옥션 카테고리 경로
pa_gmarketStringG마켓 카테고리 경로
pa_11stString11번가 카테고리 경로
pa_interparkString인터파크 카테고리 경로
pa_storefarmString스토어팜 카테고리 경로
pa_tossString토스쇼핑 카테고리 경로
pa_lotteonString롯데온 카테고리 경로
◼ 이셀러스 카테고리 코드
esString이셀러스 기본 카테고리 코드
es_auctionString옥션 이셀러스 카테고리 코드
es_gmarketStringG마켓 이셀러스 카테고리 코드
esm_auctionStringESM 옥션 카테고리 코드 (item_info에서만)
esm_gmarketStringESM G마켓 카테고리 코드 (item_info에서만)
es_11stString11번가 이셀러스 카테고리 코드
es_interparkString인터파크 이셀러스 카테고리 코드
es_storefarmString스토어팜 이셀러스 카테고리 코드
es_coupangString쿠팡 이셀러스 카테고리 코드
domeggok_cateString도매꼭 카테고리 코드 (item_info에서만)
toss_cateString토스쇼핑 카테고리 코드
lotteon_cateString롯데온 카테고리 코드
◼ 가격 정보
costint(11)NOT NULL공급원가
amount_gint(11)NOT NULL일반소비자가격
priceStringNOT NULL판매가 (회원등급에 따른 공급가격)
price_basicString기본 판매가 (item_list, item_change_list에서만)
price_consumerString일반 소비자 가격
islimittinyint(4)NOT NULL가격준수여부 (0:자율, 1:가격준수)
amount_limitint(11)islimit가 1일경우 가격준수가
amount_1int(11)회원레벨 1의 가격 (idx:2의 가격)
amount_2int(11)회원레벨 2의 가격 (idx:2의 가격)
amount_3int(11)회원레벨 3의 가격 (idx:2의 가격)
amount_4int(11)회원레벨 4의 가격 (idx:2의 가격)
amount_5int(11)회원레벨 5의 가격 (idx:2의 가격)
per1tinyint(4)상품가격1의 퍼센트
per2tinyint(4)상품가격2의 퍼센트
per3tinyint(4)상품가격3의 퍼센트
per4tinyint(4)상품가격4의 퍼센트
per5tinyint(4)상품가격5의 퍼센트
taxtinyint(4)NOT NULL과세여부 (0:과세, 1:면세)
pointint(11)구매시 지급 포인트
◼ 배송 정보
delivery_typetinyint(4)NOT NULL배송타입 (0:기본배송, 1:무료배송, 2:착불배송, 3:수량별배송)
delivery_amountint(11)NOT NULL배송비
delivery_qtyint(11)묶음배송수량 (수량별배송일 경우, 묶음배송수량)
r_delivery_amountint(11)반품배송비
i_delivery_contentmediumtext개별배송안내 (~미사용중)
is_overseaschar(1)NOT NULL해외직구여부 (Y:해외직배송, 그외:해외직배송일 경우 배송템플릿(delivery_tp)을 필수입력)
◼ 상품 상태 및 옵션
i_typetinyint(4)NOT NULL중고상품 여부 (1: 중고상품, 0:새상품)
statustinyint(4)NOT NULL상품판매상태 (0:정상판매, 1:일시품절, 2:게시중지, 3: 미승인(관리자승인대기중))
i_holdint(11)재고수량
i_hold_freetinyint(4)재고제한없이 무제한 판매 여부 (1: 무제한판매, 0: 재고수량기준판매)
is_opttinyint(4)NOT NULL상품구매 옵션(색상선택, 사이즈선택) 수
list_option_usetinyint(4)선택옵션에 있을 경우(1), 없을경우 (0)
text_option_usetinyint(4)입력옵션에 있을경우 : 1
select_optionString상품선택옵션 (아래 형식 참조)
select_option_basicString기본가 기준 선택옵션 (item_list, item_change_list에서만)
text_optionString상품입력옵션 (=로 구분)
◼ 이미지 정보
imgArrayNOT NULL상품이미지 URL 배열 (최대 10개)
photo_bigvarchar(256)큰이미지 파일명 (/data/shop/)
photo_middlevarchar(256)중간 이미지
photo_thumvarchar(256)작은 이미지
photo_qtytinyint(4)추가이미지 갯수
◼ 상품 상세
i_contenttext상품설명
i_content_typetinyint(4)상세설명 타입 (1:html, 0:텍스트) (~ 미사용중)
noticemediumtext상품공지
keywordvarchar(255)키워드 (콤마로 구분하여 5개 이상 등록해 주세요)
question_qtyint(11)상품문의 갯 수
comment_qtyint(11)댓글수
hitint(11)상품조회수
saleint(11)판매수
◼ 공급사 정보
vendervarchar(50)판다(상품공급사)코드
vender_m_codevarchar(8)판다 회원 코드
vender_codevarchar(20)판다사 자체관리코드
sort_pointint(11)상품추천자수 점수 - 높은숫자 우선
◼ 아이콘 및 추천 설정
use_icon1tinyint(4)아이콘1 사용유무 (1사용)
use_icon2tinyint(4)아이콘2 사용유무
use_icon3tinyint(4)아이콘3 사용유무
use_icon4tinyint(4)아이콘4 사용유무
use_icon5tinyint(4)아이콘5 사용유무
use_rectinyint(4)추천상품여부 (1:예)
use_newtinyint(4)신상품여부 (1:예)
use_specialtinyint(4)가특상품여부(1:예)
use_saletinyint(4)세일상품여부(1:예)
◼ 날짜 정보
reg_datetimedatetimeNOT NULL상품 최초 등록일시
up_datetimedatetimeNOT NULL상품정보 최종 수정일시
deltinyint(4)상품삭제여부(1:삭제, 0:정상)
apploval_datedate승인일자
◼ 인증 및 고시정보
cert_typetinyint(4)NOT NULL인증대상여부 ~ 0:인증대상 아님, 1: 인증대상, 2:상품상세설명표기
certtinyint(4)인증유형구분코드 (config_shop.html의 $config[cert_arr] 곤 정의된 순서 1,2,3,...)
cert_novarchar(30)인증유형에 따른 인증번호
gosi_codechar(3)NOT NULL상품고시 코드
gosimediumtext고시 구분자 ````` 로 구분저장으며 저장한다
gosi1~gosi22String상품고시 항목 (고시종류에 따라 다름, null 가능)
◼ 판매유형 및 기타
adulttinyint(4)NOT NULL성인전용여부 (1:성인전용, 0:전체이용가상품)
item_sale_typetinyint(4)NOT NULL$config[mb_pv_arr] = array('일반상품', 'VIP전용', '폐쇄몰전용', '파트너전용', '관리자전용');
isreturntinyint(4)NOT NULL반품가능여부 (1:가능, 0:반품불가)
oktinyint(4)관리자 승인여부 (0:미승인, 1:승인, 2:승인거부, 3:승인취소)
warntinyint(1)1:판매주의, 0:일반
a_saleint(11)판매건수
a_daydouble평균배송일
◼ 공급사 평가 정보
v_gradetinyint(1)공급사 현재등급
v_deal_perint(3)주문이행율
v_speedfloat출고속도
v_talk_perint(3)24시간 답변율
is_meditinyint(1)1:의료용품카테고리, 0:일반카테고리
is_healthtinyint(1)1:건강기능식품카테고리, 0:일반카테고리
is_insourcingtinyint(1)도산배송(내부물류창고)상품: 1, 0:공급사배송
◼ 쿠폰 정보
cp_amountint(7)쿠폰제공금액
cp_idxint(11)coupons_vender.idx, 값이 ~1일 경우 쿠폰발행 불가상품
cp_expiredate쿠폰 사용 만료일자

select_option 형식

선택옵션 문자열 형식:
[옵션명1=옵션명2]\n옵션값1=옵션값2=가격=준수가=기본가=품절상태\n...

예시 (1차옵션만):
[색상]\n레드==10000=0=0=0\n블루==10000=0=0=0\n

예시 (2차옵션 포함):
[색상=사이즈]\n레드=S=10000=0=0=0\n레드=M=10000=0=0=0\n블루=S=10000=0=0=0\n

각 필드 설명:
- 옵션값1: 1차 옵션값 (예: 레드)
- 옵션값2: 2차 옵션값 (없으면 빈값)
- 가격: 해당 옵션의 판매가
- 준수가: 판매준수 가격 (0이면 준수가 없음)
- 기본가: 기본 판매가
- 품절상태: 0:판매중, 1:품절

2. 주문 API

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

2.1 상품주문 요청

POST application/json https://domesin.com/API/v11/order.php

테스트용:

POST application/json https://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수량

요청 예시:

POST https://domesin.com/API/v11/order.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "seller123",
  "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": [
    {"icode": "TS10323180", "option1": "레드", "option2": "", "qty": 2},
    {"icode": "TS10323711", "option1": "소", "option2": "", "qty": 6}
  ]
}

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:포함)

응답 예시:

{
  "code": "0000",
  "message": "주문이 정상적으로 접수되었습니다.",
  "order_code": "ORD20250525001234",
  "item_amount": 32000,
  "delivery_amount": 6000,
  "order_list_detail": [
    {
      "order_list_code": 98765,
      "icode": "TS10323180",
      "iname": "테스트상품A [레드]",
      "qty": 2,
      "item_amount": 20000,
      "is_island": 0
    },
    {
      "order_list_code": 98766,
      "icode": "TS10323711",
      "iname": "테스트상품B [소]",
      "qty": 6,
      "item_amount": 12000,
      "is_island": 0
    }
  ]
}

2.3 주문상태 조회

POST application/json https://domesin.com/API/v11/order_status.php
파라미터필수타입설명
api_keyString도매의신에서 발급받은 API키
m_idString도매의신 회원아이디
order_codeString도매의신 주문코드

요청 예시:

POST https://domesin.com/API/v11/order_status.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "seller123",
  "order_code": "ORD20250525001234"
}

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배송송장번호

응답 예시:

{
  "code": "0000",
  "message": "조회 성공",
  "order_code": "ORD20250525001234",
  "c_name": "홍길동",
  "order_list_detail": [
    {
      "order_list_code": 98765,
      "icode": "TS10323180",
      "iname": "테스트상품A [레드]",
      "qty": 2,
      "status": "발송완료",
      "claim_status": "",
      "del_corp": "CJ대한통운",
      "del_no": "123456789012"
    },
    {
      "order_list_code": 98766,
      "icode": "TS10323711",
      "iname": "테스트상품B [소]",
      "qty": 6,
      "status": "배송준비중",
      "claim_status": "",
      "del_corp": "",
      "del_no": ""
    }
  ]
}

2.5 주문취소 요청

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

요청 예시:

POST https://domesin.com/API/v11/order_cancel.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "seller123",
  "order_code": "ORD20250525001234",
  "order_list_code": 98765
}

응답 예시:

{
  "code": "0000",
  "message": "주문취소가 접수되었습니다.",
  "order_code": "ORD20250525001234",
  "order_list_code": 98765,
  "cancel_status": "취소요청"
}

2.6 내 적립금 조회

POST application/x-www-form-urlencoded https://domesin.com/API/v11/my_cash.php
파라미터필수타입설명
api_keyString도매의신에서 발급받은 API키
m_idString도매의신 회원아이디

요청 예시:

POST https://domesin.com/API/v11/my_cash.php
Content-Type: application/x-www-form-urlencoded

api_key=YOUR_API_KEY
&m_id=seller123

응답 예시:

{
  "code": "0000",
  "message": "조회 성공",
  "m_id": "seller123",
  "cash": 150000,
  "point": 5000,
  "total_available": 155000
}

3. 에러코드표

코드설명
0000성공
상품정보 API (item_list, item_change_list, item_info)
0010API키 에러
0011회원정보에러 또는 사용권한이 없습니다
0013파라미터 start_date 오류 또는 미래일자
0014파라미터 search값 에러 ('Y' 또는 'N'으로 전달해 주세요)
0015존재하지 않는 상품코드입니다 (item_info)
0016API 전용상품 권한오류 또는 상품코드 미전달
0017API KEY Error (회원아이디 오류)
0018카테고리 cid 에러
0022공급사코드 에러
0100파라미터가 정상적으로 전달되지 않았습니다 (item_info)
0200사용권한이 없습니다 (item_info)
0300API KEY Error (item_info)
기타 공통
20너무 많은 요청으로 일시적으로 차단된 상태입니다
21이미 요청한 데이터를 처리중입니다

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://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 발급 및 기타 문의사항은 도매의신 운영자에게 연락해 주세요.

0. 기준정보 조회 API

기본정보
- Method: POST (JSON)
- Content-Type: application/json
- Endpoint: https://data.domesin.com/API/v11/vender_reference.php
- Response Format: JSON

0.1 공급사 정보 (action: vender_info)

공급사 기본 정보를 조회합니다.

파라미터타입필수설명
api_keyStringO공급사 API 키
m_idStringO공급사 회원 ID
actionStringO"vender_info"

요청 예시:

POST https://data.domesin.com/API/v11/vender_reference.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "action": "vender_info"
}

응답 예시:

{
  "code": "0000",
  "message": "조회 성공",
  "vender_info": {
    "m_id": "supplier123",
    "m_code": "V00123",
    "company_name": "테스트공급사",
    "ceo_name": "홍길동",
    "business_no": "123-45-67890",
    "tel": "02-1234-5678",
    "email": "supplier@example.com",
    "grade": "일반",
    "reg_datetime": "2024-01-15 10:00:00",
    "item_count": 150,
    "order_count_month": 320
  }
}

0.2 상품 수량 정보 (action: item_count)

공급사의 상품 수량 현황을 조회합니다.

파라미터타입필수설명
api_keyStringO공급사 API 키
m_idStringO공급사 회원 ID
actionStringO"item_count"

요청 예시:

POST https://data.domesin.com/API/v11/vender_reference.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "action": "item_count"
}

응답 예시:

{
  "code": "0000",
  "message": "조회 성공",
  "item_count": {
    "total": 150,
    "selling": 120,
    "soldout": 25,
    "discontinued": 5
  }
}

0.3 상품 목록 조회 (action: item_list)

공급사의 등록된 상품 목록을 조회합니다.

파라미터타입필수설명
api_keyStringO공급사 API 키
m_idStringO공급사 회원 ID
actionStringO"item_list"
statusString판매상태 (0:판매중, 1:품절, 2:단종, 빈값:전체)
cidString카테고리코드
searchString상품명/상품코드 검색어
vender_codeString업체상품코드 검색
pageInt페이지 번호 (기본값: 1)
rowsInt페이지당 개수 (기본값: 50, 최대: 100)

요청 예시:

POST https://data.domesin.com/API/v11/vender_reference.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "action": "item_list",
  "status": "0",
  "page": 1,
  "rows": 20
}

응답 예시:

{
  "code": "0000",
  "message": "조회 성공",
  "total_count": 150,
  "page": 1,
  "rows": 20,
  "total_page": 8,
  "list": [
    {
      "iid": 12345,
      "icode": "TS10012345",
      "vender_code": "MY-001",
      "iname": "테스트상품",
      "cid": "001001001",
      "cost": 10000,
      "amount_g": 20000,
      "status": 0,
      "status_text": "판매중",
      "delivery_type": 0,
      "delivery_amount": 3000,
      "stock": 100,
      "regtime": "2024-01-01 10:00:00",
      "edittime": "2024-06-01 15:30:00"
    }
  ]
}

0.4 카테고리 목록 (action: category)

상품 등록에 사용할 카테고리 목록을 조회합니다.

파라미터타입필수설명
api_keyStringO공급사 API 키
m_idStringO공급사 회원 ID
actionStringO"category"
depthInt카테고리 깊이 (1:대분류, 2:중분류, 3:소분류)
parent_cidString상위 카테고리 ID
searchString카테고리명 검색어

요청 예시:

POST https://data.domesin.com/API/v11/vender_reference.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "action": "category",
  "depth": 3,
  "parent_cid": "001001"
}

응답 예시:

{
  "code": "0000",
  "message": "조회 성공",
  "categories": [
    {
      "cid": "001",
      "name": "패션의류",
      "depth": 1,
      "parent_cid": ""
    },
    {
      "cid": "001001",
      "name": "여성의류",
      "depth": 2,
      "parent_cid": "001"
    },
    {
      "cid": "001001001",
      "name": "원피스",
      "depth": 3,
      "parent_cid": "001001"
    }
  ]
}

0.5 택배사 목록 (action: delivery)

송장 등록에 사용할 택배사 목록을 조회합니다.

파라미터타입필수설명
api_keyStringO공급사 API 키
m_idStringO공급사 회원 ID
actionStringO"delivery"

요청 예시:

POST https://data.domesin.com/API/v11/vender_reference.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "action": "delivery"
}

응답 예시:

{
  "code": "0000",
  "message": "조회 성공",
  "delivery_list": [
    {"idx": 1, "name": "CJ대한통운"},
    {"idx": 2, "name": "롯데택배"},
    {"idx": 3, "name": "우체국택배"},
    {"idx": 4, "name": "한진택배"},
    {"idx": 5, "name": "로젠택배"},
    {"idx": 6, "name": "경동택배"},
    {"idx": 7, "name": "대신택배"},
    {"idx": 8, "name": "일양로지스"},
    {"idx": 9, "name": "합동택배"},
    {"idx": 10, "name": "홈픽택배"},
    {"idx": 99, "name": "기타"}
  ]
}

0.6 반품지 목록 (action: return_address)

등록된 반품지/출고지 목록을 조회합니다.

파라미터타입필수설명
api_keyStringO공급사 API 키
m_idStringO공급사 회원 ID
actionStringO"return_address"

요청 예시:

POST https://data.domesin.com/API/v11/vender_reference.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "action": "return_address"
}

응답 예시:

{
  "code": "0000",
  "message": "조회 성공",
  "return_addresses": [
    {
      "raid": 1,
      "name": "기본반품지",
      "is_default": 1,
      "zip": "12345",
      "addr": "경기도 부천시 원미구",
      "addr_detail": "123번지 도매물류센터",
      "tel": "02-1234-5678",
      "manager": "김물류"
    },
    {
      "raid": 2,
      "name": "서울창고",
      "is_default": 0,
      "zip": "06123",
      "addr": "서울시 강남구 테헤란로",
      "addr_detail": "456번지 서울물류",
      "tel": "02-9876-5432",
      "manager": "이창고"
    }
  ]
}

1. 상품등록 API

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

1.1 상품등록 요청

POST application/json https://domesin.com/API/v11/item_register.php

테스트용:

POST application/json https://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 배열 (images[0] 필수, 400x400 이상). ※상품등록 단계에서는 대표이미지(images[0])가 반영됩니다. 추가이미지는 이 배열로 등록되지 않습니다. 추가이미지는 등록 후 [2.2 썸네일/이미지 수정 API]의 add_images로 등록하세요. (아래 슬롯 매핑표 참고)
vender_codeString업체상품코드
item_sale_typeint0:일반, 1:VIP전용, 2:폐쇄몰전용, 3:파트너전용

images 배열 슬롯 매핑

images 배열은 상품의 대표이미지 슬롯 5개에 순서대로 매핑됩니다. 상세페이지 하단에 나열되는 추가이미지와는 다른 영역입니다.

배열 위치매핑 슬롯비고
images[0]대표이미지 (photo_thum + photo_big)필수. 목록/상세에 노출되는 대표이미지
images[1]photo_middle상품수정 시 초기화될 수 있음 — 사용 비권장
images[2]photo_bigimages[0] 값을 덮어씀 — 사용 비권장
images[3]img4예비 슬롯
images[4]img5예비 슬롯
권장 사용법:
images에는 대표이미지 1장만 전송하고("images": ["대표이미지URL"]), 추가이미지는 상품등록 완료 후 [2.2 썸네일/이미지 수정 API]의 add_images로 등록하세요.
images에 2장 이상을 전송해도 추가이미지로는 등록되지 않습니다.

선택 파라미터

파라미터타입기본값설명
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:품절

요청 예시:

POST https://domesin.com/API/v11/item_register.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "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/main.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}
    ]
  }
}

1.2 상품등록 응답

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

응답 예시:

{
  "code": "0000",
  "message": "상품이 정상적으로 등록되었습니다.",
  "iid": 12345,
  "icode": "TS10012345"
}

2. 상품수정 API

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

2.1 기본정보 수정

POST application/json https://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업체상품코드

요청 예시:

POST https://domesin.com/API/v11/vender_item_edit.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "icode": "TS10012345",
  "iname": "수정된 상품명",
  "cost": 12000,
  "keyword": "새키워드1, 새키워드2, 새키워드3, 새키워드4, 새키워드5"
}

응답 예시:

{
  "code": "0000",
  "message": "상품 기본정보가 수정되었습니다.",
  "icode": "TS10012345",
  "updated_fields": ["iname", "cost", "keyword"]
}

2.2 썸네일/이미지 수정

POST application/json https://domesin.com/API/v11/vender_item_thumbnail.php
파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
icodeString수정할 상품코드 (iid로도 가능)
imagesArray대표이미지 교체용 URL 배열. images[0]이 대표이미지로 반영됩니다. ※추가이미지는 이 배열로 등록되지 않습니다. 추가이미지는 아래 add_images를 사용하세요.
images[0]String대표이미지 URL (최소 400x400)
add_imagesArray추가이미지 등록용 URL 배열. 상세페이지 추가이미지로 등록됩니다. 여러 장을 한 번에 전송할 수 있습니다.
delete_imagesArray삭제할 추가이미지 ID(photo_id) 배열. photo_id는 본 API 응답의 add_images[].photo_id 값입니다.
replace_allintimages 적용 방식. 1: 대표이미지 교체, 0: 비어있는 슬롯에만 추가 (기본: 1)
이미지 구분 안내:
- 대표이미지 수정 → images 배열 사용 (images[0]만 대표이미지로 반영)
- 추가이미지 등록 → add_images 배열 사용
- 추가이미지 삭제 → delete_images 배열에 추가이미지 ID(photo_id) 전달
※ images 배열의 [1]~[4] 항목은 추가이미지로 저장되지 않으므로, 추가이미지는 반드시 add_images로 전송해야 합니다.
추가이미지(add_images) 동작 안내:
- 기존 추가이미지는 그대로 유지되고 뒤에 덧붙습니다. (교체가 아닙니다)
- 전송한 URL을 서버가 직접 내려받아 저장하며, 작은 썸네일(300x300)은 자동으로 생성됩니다. 별도로 썸네일 URL을 보내실 필요가 없습니다.
- 확장자가 없는 URL도 처리됩니다. 서버가 실제 파일 내용으로 JPG/PNG/GIF를 판정합니다.
- 이미지가 아닌 응답(로그인페이지·에러페이지 등)은 저장하지 않고 건너뜁니다. 요청한 장수보다 saved_count가 적다면 응답의 debug 항목에서 실패한 URL을 확인하세요.
- 등록 결과는 응답의 add_images 목록으로 즉시 확인할 수 있습니다. (원본 URL·썸네일 URL·photo_id)
이미지 규격:
- 최소 크기: 400x400px (권장: 600x600 이상)
- 지원 형식: JPG, PNG, GIF
- 이미지 URL은 외부에서 접근 가능해야 합니다. (로그인·리퍼러 제한이 걸린 URL은 다운로드에 실패합니다)
- images / add_images / delete_images 중 최소 1개는 전달해야 합니다.

요청 예시:

POST https://domesin.com/API/v11/vender_item_thumbnail.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "icode": "TS10012345",
  "images": [
    "https://example.com/new_main.jpg"
  ],
  "replace_all": 1,
  "add_images": [
    "https://example.com/extra1.jpg",
    "https://example.com/extra2.jpg",
    "https://example.com/extra3.jpg"
  ],
  "delete_images": []
}

응답 예시:

{
  "code": "0000",
  "message": "이미지가 수정되었습니다.",
  "iid": 12345,
  "icode": "TS10012345",
  "saved_count": 4,
  "add_images": [
    {
      "photo_id": 1024,
      "image": "https://domesin.com/data/shop/2/10012345_aB3xZ.jpg",
      "thumbnail": "https://domesin.com/data/shop/2/10012345_aB3xZ_t.jpg"
    },
    {
      "photo_id": 1025,
      "image": "https://domesin.com/data/shop/2/10012345_kP9mQ.jpg",
      "thumbnail": "https://domesin.com/data/shop/2/10012345_kP9mQ_t.jpg"
    }
  ],
  "debug": ["add_images saved: 10012345_aB3xZ.jpg"]
}
응답 필드설명
saved_count이번 요청에서 실제로 저장된 이미지 수 (대표 + 추가)
add_images요청 처리 후 현재 등록되어 있는 추가이미지 전체 목록
add_images[].photo_id추가이미지 고유 ID. delete_images로 개별 삭제할 때 사용합니다.
add_images[].image등록된 원본 이미지 URL
add_images[].thumbnail자동 생성된 작은 썸네일(300x300) URL
debug처리 로그. 다운로드 실패 URL 확인용

추가이미지 삭제 예시:

POST https://domesin.com/API/v11/vender_item_thumbnail.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "icode": "TS10012345",
  "delete_images": [1024, 1025]
}

2.3 옵션 수정

POST application/json https://domesin.com/API/v11/vender_item_option.php
파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
icodeString수정할 상품코드 (iid로도 가능)
actionString옵션 처리 방식 (기본값: update)
replace: 기존 옵션 전체 삭제 후 items로 재등록
update: 개별 옵션 수정 (각 item에 oid 필수)
add: 옵션 추가
delete: 옵션 삭제 (options.delete_oids 배열)
optionsObject옵션 정보
options.op_t1String1차 옵션명 (예: 색상) — action=replace/add 시 필수
options.op_t2String2차 옵션명 (예: 사이즈)
options.itemsArray옵션 항목 배열
options.delete_oidsArray삭제할 옵션 ID(oid) 배열 (action=delete 시 사용)

options.items 배열 구조

파라미터필수타입설명
oidint옵션 고유번호. action=update(개별수정) 시 필수 (상품조회로 확인). replace/add 시에는 불필요
op_n1String1차 옵션값 (예: 레드)
op_n2String2차 옵션값 (예: L)
op_costint옵션추가금액 (기본: 0, 범위: 공급가의 ±50%)
op_soldoutint0: 판매중, 1: 품절
op_limitint옵션별 판매준수가
옵션 수정 규칙:
- 기본판매가와 동일한 가격(op_cost=0)의 옵션이 최소 1개 필요
- 옵션추가금액은 상품 공급가의 ±50%를 초과할 수 없음
- 중복된 옵션명 조합 불가
⚠ 옵션 전체 교체 시 action 필수:
상품등록 때처럼 op_t1 + items(oid 없이)로 옵션을 새로 지정해 전체를 교체하려면 반드시 "action": "replace"를 함께 전송해야 합니다.
action을 생략하면 기본값 update(개별 수정)로 동작하며, 이 경우 각 item에 oid가 없으면 수정 대상을 찾지 못해 아무것도 반영되지 않습니다(응답 result_count=0).

요청 예시 ① 전체 교체 (action=replace):

POST https://domesin.com/API/v11/vender_item_option.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "icode": "TS10012345",
  "action": "replace",
  "options": {
    "op_t1": "색상",
    "op_t2": "사이즈",
    "items": [
      {"op_n1": "레드", "op_n2": "S", "op_cost": 0, "op_soldout": 0},
      {"op_n1": "레드", "op_n2": "M", "op_cost": 0, "op_soldout": 0},
      {"op_n1": "레드", "op_n2": "L", "op_cost": 1000, "op_soldout": 0},
      {"op_n1": "블루", "op_n2": "S", "op_cost": 0, "op_soldout": 1}
    ]
  }
}

요청 예시 ② 개별 수정 (action=update, oid 필수):

POST https://domesin.com/API/v11/vender_item_option.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "icode": "TS10012345",
  "action": "update",
  "options": {
    "items": [
      {"oid": 1001, "op_cost": 2000, "op_soldout": 0},
      {"oid": 1002, "op_soldout": 1}
    ]
  }
}

응답 예시:

{
  "code": "0000",
  "message": "옵션이 수정되었습니다.",
  "iid": 12345,
  "icode": "TS10012345",
  "result_count": 4
}

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

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

요청 예시 (단건):

POST https://domesin.com/API/v11/vender_item_status.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "icode": "TS10012345",
  "status": 1
}

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

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

요청 예시 (일괄):

POST https://domesin.com/API/v11/vender_item_status.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "items": [
    {"icode": "TS10000001", "status": 1},
    {"icode": "TS10000002", "status": 0},
    {"icode": "TS10000003", "status": 2}
  ]
}

응답 예시 (단건):

{
  "code": "0000",
  "message": "판매상태가 변경되었습니다.",
  "icode": "TS10012345",
  "status": 1,
  "status_text": "품절"
}

응답 예시 (일괄):

{
  "code": "0000",
  "message": "일괄 상태변경 완료",
  "success_count": 3,
  "fail_count": 0,
  "results": [
    {"icode": "TS10000001", "status": 1, "result": "success"},
    {"icode": "TS10000002", "status": 0, "result": "success"},
    {"icode": "TS10000003", "status": 2, "result": "success"}
  ]
}

2.5 배송설정 수정

POST application/json https://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) 필수

요청 예시:

POST https://domesin.com/API/v11/vender_item_delivery.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "icode": "TS10012345",
  "delivery_type": 0,
  "delivery_amount": 3500,
  "r_delivery_amount": 3500,
  "isreturn": 1
}

응답 예시:

{
  "code": "0000",
  "message": "배송설정이 수정되었습니다.",
  "icode": "TS10012345",
  "delivery_type": 0,
  "delivery_amount": 3500,
  "r_delivery_amount": 3500
}

3. 1:1 문의 관리 API

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

3.1 문의 목록 조회

POST application/json https://domesin.com/API/v11/vender_qna.php

action: list

파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
pageint페이지 번호 (기본: 1)
rowsint페이지당 건수 (기본: 20, 최대: 100)
statusString답변상태 (공백:전체, 1:미답변, 2:답변완료)
start_datedate조회시작일 (YYYY-mm-dd, 기본: 1년전)
end_datedate조회종료일 (YYYY-mm-dd, 기본: 오늘)

요청 예시:

POST https://domesin.com/API/v11/vender_qna.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "action": "list",
  "status": "1",
  "page": 1,
  "rows": 20
}

응답 예시:

{
  "code": "0000",
  "message": "조회 성공",
  "total_count": 25,
  "page": 1,
  "rows": 20,
  "total_page": 2,
  "list": [
    {
      "idx": 12345,
      "icode": "TS10012345",
      "iname": "테스트상품",
      "m_id": "buyer123",
      "q_title": "배송 관련 문의드립니다",
      "q_content": "언제 발송 예정인가요?",
      "q_datetime": "2025-05-24 14:30:00",
      "status": 1,
      "status_text": "미답변",
      "a_content": "",
      "a_datetime": ""
    },
    {
      "idx": 12344,
      "icode": "TS10012346",
      "iname": "테스트상품2",
      "m_id": "buyer456",
      "q_title": "사이즈 문의",
      "q_content": "L사이즈 재입고 예정이 있나요?",
      "q_datetime": "2025-05-23 10:00:00",
      "status": 2,
      "status_text": "답변완료",
      "a_content": "안녕하세요, 다음주 입고 예정입니다.",
      "a_datetime": "2025-05-23 15:30:00"
    }
  ]
}

3.2 문의 답변 등록

POST application/json https://domesin.com/API/v11/vender_qna.php

action: answer

파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
idxint문의 고유번호 (목록조회의 idx)
a_contentString답변 내용

요청 예시:

POST https://domesin.com/API/v11/vender_qna.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "action": "answer",
  "idx": 12345,
  "a_content": "안녕하세요, 문의 주셔서 감사합니다. 해당 상품은 다음주 입고 예정입니다."
}

응답 예시:

{
  "code": "0000",
  "message": "답변이 등록되었습니다.",
  "idx": 12345,
  "a_datetime": "2025-05-25 10:30:00"
}

4. 주문수집 API

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

4.1 주문 목록 조회

POST application/json https://data.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검색어

요청 예시:

POST https://data.domesin.com/API/v11/vender_order_list.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "page": 1,
  "rows": 50,
  "start_date": "2025-05-01",
  "end_date": "2025-05-25",
  "o_status": 1
}

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:취소거부)

응답 예시:

{
  "code": "0000",
  "message": "조회 성공",
  "total_count": 85,
  "total_page": 2,
  "current_page": 1,
  "orders": [
    {
      "order_list_code": 98765,
      "order_code": "ORD20250525001234",
      "icode": "TS10012345",
      "iname": "테스트상품",
      "option_name": "색상: 레드 / 사이즈: L",
      "qty": 2,
      "item_amount": 20000,
      "o_status": 1,
      "o_status_name": "발송대기",
      "d_name": "홍길동",
      "d_hp": "010-1234-5678",
      "d_zip": "12345",
      "d_addr": "경기도 부천시 원미구 123번지 도매아파트 101동 101호",
      "d_memo": "부재시 경비실에 맡겨주세요",
      "delivery_idx": 0,
      "delivery_code": "",
      "r_datetime": "2025-05-25 09:30:00",
      "cancel_status": 0
    },
    {
      "order_list_code": 98764,
      "order_code": "ORD20250524001233",
      "icode": "TS10012346",
      "iname": "테스트상품2",
      "option_name": "",
      "qty": 1,
      "item_amount": 15000,
      "o_status": 2,
      "o_status_name": "발송완료",
      "d_name": "김철수",
      "d_hp": "010-9876-5432",
      "d_zip": "06123",
      "d_addr": "서울시 강남구 테헤란로 456번지",
      "d_memo": "",
      "delivery_idx": 1,
      "delivery_code": "123456789012",
      "r_datetime": "2025-05-24 14:00:00",
      "cancel_status": 0
    }
  ]
}

5. 송장업데이트 API

5.1 단건 송장 등록

POST application/json https://domesin.com/API/v11/vender_invoice.php
파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
order_list_codeint주문상품 개별원장번호
delivery_idxint택배사 코드
delivery_codeString송장번호

요청 예시:

POST https://domesin.com/API/v11/vender_invoice.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "order_list_code": 98765,
  "delivery_idx": 1,
  "delivery_code": "123456789012"
}

응답 예시:

{
  "code": "0000",
  "message": "송장이 등록되었습니다.",
  "order_list_code": 98765,
  "delivery_idx": 1,
  "delivery_code": "123456789012",
  "o_status": 2,
  "o_status_name": "발송완료"
}

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

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

요청 예시:

POST https://domesin.com/API/v11/vender_invoice.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "invoices": [
    {"order_list_code": 12345, "delivery_idx": 1, "delivery_code": "123456789012"},
    {"order_list_code": 12346, "delivery_idx": 4, "delivery_code": "987654321098"}
  ]
}

응답 예시:

{
  "code": "0000",
  "message": "일괄 송장등록 완료",
  "success_count": 2,
  "fail_count": 0,
  "results": [
    {
      "order_list_code": 12345,
      "result": "success",
      "delivery_code": "123456789012"
    },
    {
      "order_list_code": 12346,
      "result": "success",
      "delivery_code": "987654321098"
    }
  ]
}

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 주문 상태 변경

POST application/json https://domesin.com/API/v11/vender_order_status.php
파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
order_codeString주문코드 (주문목록 조회의 order_code)
o_statusint변경할 주문상태 (0 또는 1만 가능)

요청 예시:

POST https://domesin.com/API/v11/vender_order_status.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "order_code": "ORD20250525001234",
  "o_status": 1
}

응답 예시:

{
  "code": "0000",
  "message": "주문상태가 변경되었습니다.",
  "order_code": "ORD20250525001234",
  "o_status": 1,
  "o_status_name": "배송준비중"
}

6.2 주문상태 코드표

코드상태명설명
0신규주문결제 완료 후 초기 상태 (배송준비중 → 신규주문 변경시 사용)
1배송준비중주문확인 (신규주문 → 배송준비중 변경시 사용)
주문상태변경 규칙:
- 주문확인: o_status=1 (신규주문 → 배송준비중)
- 주문확인취소: o_status=0 (배송준비중 → 신규주문)
- 발송완료(2), 배송완료(3) 상태는 송장등록 API를 통해 변경

6.3 취소요청 목록 조회

POST application/json https://domesin.com/API/v11/vender_cancel.php

action: list

파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
actionString"list" 고정
start_dateString조회 시작일 (YYYY-MM-DD, 기본: 1개월전)
end_dateString조회 종료일 (YYYY-MM-DD, 기본: 오늘)
cancel_statusString취소상태 (1:취소요청, 2:취소승인, 0:전체, 기본:1)
pageint페이지 (기본: 1)
rowsint조회개수 (기본: 20, 최대: 100)

요청 예시:

POST https://domesin.com/API/v11/vender_cancel.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "action": "list",
  "cancel_status": "1",
  "page": 1,
  "rows": 20
}

응답 예시:

{
  "code": "0000",
  "message": "조회 성공",
  "total_count": 5,
  "page": 1,
  "rows": 20,
  "total_page": 1,
  "list": [
    {
      "order_code": "ORD20250525001234",
      "order_list_code": 98765,
      "icode": "TS10012345",
      "iname": "테스트상품",
      "option_name": "색상: 레드",
      "qty": 2,
      "item_amount": 20000,
      "cancel_status": 1,
      "cancel_status_text": "취소요청",
      "cancel_reason": "단순변심",
      "cancel_datetime": "2025-05-25 10:00:00",
      "d_name": "홍길동"
    }
  ]
}

6.4 취소요청 처리

POST application/json https://domesin.com/API/v11/vender_cancel.php

action: approve 또는 reject

파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
order_codeString주문코드 (목록조회의 order_code)
actionString처리유형 (approve:취소승인, reject:취소거부)
cancel_reasonString취소사유 (action=approve일때 필수)
delivery_idxint택배사코드 (action=reject일때 필수)
delivery_codeString송장번호 (action=reject일때 필수)

요청 예시 (취소승인):

POST https://domesin.com/API/v11/vender_cancel.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "order_code": "ORD20250525001234",
  "action": "approve",
  "cancel_reason": "고객 요청에 의한 취소"
}

요청 예시 (취소거부):

POST https://domesin.com/API/v11/vender_cancel.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "order_code": "ORD20250525001234",
  "action": "reject",
  "delivery_idx": 1,
  "delivery_code": "123456789012"
}

응답 예시 (취소승인):

{
  "code": "0000",
  "message": "취소가 승인되었습니다.",
  "order_code": "ORD20250525001234",
  "cancel_status": 2,
  "cancel_status_text": "취소완료"
}

응답 예시 (취소거부):

{
  "code": "0000",
  "message": "취소가 거부되었습니다. 송장이 등록되었습니다.",
  "order_code": "ORD20250525001234",
  "cancel_status": 3,
  "cancel_status_text": "취소불가",
  "delivery_idx": 1,
  "delivery_code": "123456789012"
}

6.5 반품요청 목록 조회

POST application/json https://domesin.com/API/v11/vender_return.php

action: list

파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
actionString"list" 고정
start_dateString조회 시작일 (YYYY-MM-DD, 기본: 1개월전)
end_dateString조회 종료일 (YYYY-MM-DD, 기본: 오늘)
return_statusString반품상태 (1:반품요청, 2:회수진행, 3:반품승인, 4:반품불가, 공백:1+2)
pageint페이지 (기본: 1)
rowsint조회개수 (기본: 20, 최대: 100)

요청 예시:

POST https://domesin.com/API/v11/vender_return.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "action": "list",
  "return_status": "1",
  "page": 1,
  "rows": 20
}

응답 예시:

{
  "code": "0000",
  "message": "조회 성공",
  "total_count": 3,
  "page": 1,
  "rows": 20,
  "total_page": 1,
  "list": [
    {
      "order_code": "ORD20250520001230",
      "order_list_code": 98760,
      "icode": "TS10012340",
      "iname": "테스트상품",
      "option_name": "색상: 블루",
      "qty": 1,
      "item_amount": 15000,
      "return_status": 1,
      "return_status_text": "반품요청",
      "return_reason": "상품 불량",
      "return_datetime": "2025-05-22 14:00:00",
      "d_name": "김철수"
    }
  ]
}

6.6 반품요청 처리

POST application/json https://domesin.com/API/v11/vender_return.php

action: collecting, approve 또는 reject

파라미터필수타입설명
api_keyString도매의신에서 발급받은 공급사 API키
m_idString도매의신 공급사 아이디
order_codeString주문코드 (목록조회의 order_code)
actionString처리유형 (collecting:회수진행, approve:반품승인, reject:반품거부)
reasonString처리사유 (action=reject일때 필수)

요청 예시 (회수진행):

POST https://domesin.com/API/v11/vender_return.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "order_code": "ORD20250520001230",
  "action": "collecting"
}

요청 예시 (반품승인):

POST https://domesin.com/API/v11/vender_return.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "order_code": "ORD20250520001230",
  "action": "approve"
}

요청 예시 (반품거부):

POST https://domesin.com/API/v11/vender_return.php
Content-Type: application/json

{
  "api_key": "YOUR_API_KEY",
  "m_id": "supplier123",
  "order_code": "ORD20250520001230",
  "action": "reject",
  "reason": "상품 사용 흔적으로 인해 반품이 불가합니다."
}

응답 예시 (회수진행):

{
  "code": "0000",
  "message": "회수진행 상태로 변경되었습니다.",
  "order_code": "ORD20250520001230",
  "return_status": 2,
  "return_status_text": "회수진행중"
}

응답 예시 (반품승인):

{
  "code": "0000",
  "message": "반품이 승인되었습니다.",
  "order_code": "ORD20250520001230",
  "return_status": 3,
  "return_status_text": "반품승인"
}

응답 예시 (반품거부):

{
  "code": "0000",
  "message": "반품이 거부되었습니다.",
  "order_code": "ORD20250520001230",
  "return_status": 4,
  "return_status_text": "반품불가",
  "reason": "상품 사용 흔적으로 인해 반품이 불가합니다."
}

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성공
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://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/main.jpg"   // 대표이미지 1장만. 추가이미지는 등록 후 vender_item_thumbnail.php 의 add_images 로 등록
    ],
    "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://domesin.com/API/v11/vender_item_thumbnail.php";

$data = [
    "api_key" => "YOUR_API_KEY",
    "m_id"    => "supplier123",
    "icode"   => "TS10012345",       // 상품등록 응답으로 받은 상품코드
    "add_images" => [
        "https://example.com/extra1.jpg",
        "https://example.com/extra2.jpg",
        "https://example.com/extra3.jpg"
    ]
];

$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['saved_count'] . "\n";

    // 등록 결과 확인 (원본 / 자동생성된 썸네일 / 삭제용 photo_id)
    foreach ($result['add_images'] as $img) {
        echo "photo_id : " . $img['photo_id']  . "\n";
        echo "원본     : " . $img['image']     . "\n";
        echo "썸네일   : " . $img['thumbnail'] . "\n";
    }

    // 요청 장수보다 saved_count 가 적으면 실패한 URL 확인
    if ($result['saved_count'] < count($data['add_images'])) {
        print_r($result['debug']);
    }
} else {
    echo "실패: " . $result['message'];
}
?>

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

<?php
$url = "https://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.4 주문 목록 조회 (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.5 일괄 송장 등록 (PHP)

<?php
$url = "https://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.6 취소 요청 처리 (PHP)

<?php
// 취소 승인
$url = "https://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 관련 문의사항을 게시판에 남겨주세요.