도매매 상품을
내 마이샵에 등록하기
두 개의 API 키를 연결하고, 상품 한 개를 직접 전송해 보세요.
회원 준비부터 상품 등록 확인까지 순서대로 안내합니다.
처음 연동하는 판매자용 · PC Chrome 권장 · 최종 확인 2026.10.20
연동 전에 준비하세요
마이샵 계정과 도매매 사업자회원 계정이 각각 필요합니다.
| 준비 항목 | 확인 방법 |
|---|---|
| 마이샵 계정 | 상품을 등록할 상점의 관리자에 로그인합니다. API 키를 발급한 계정과 전송기에 입력할 마이샵 이메일이 같아야 합니다. |
| 도매꾹·도매매 사업자회원 | 도매꾹 계정으로 도매매를 이용합니다. 회원가입과 본인 인증을 마친 뒤 사업자 인증을 신청하고, 사업자회원 승인 상태를 확인합니다. |
| 상품 카테고리 | 마이샵 관리자 상세 설정 → 카테고리에서 사용할 카테고리를 준비합니다. |
| 배송비 템플릿 | 마이샵 관리자 설정 → 배송 → 배송비 템플릿에 최소 한 개를 등록합니다. 다음 단계에서 자세히 설명합니다. |
도매매 계정이 아직 없다면
- 도매꾹 홈페이지에서 회원가입을 진행합니다. 필수 약관과 개인정보 안내를 확인하고 휴대폰 본인 인증을 완료합니다.
- 사업자 인증 화면에 사업자등록증 기준으로 업체 정보와 대표번호를 입력하고, 사업자등록증 사본을 첨부해 신청합니다.
- 승인 상태를 확인한 뒤 마이샵×도매매 전송기에 도매꾹 계정으로 로그인합니다. 도매꾹에 로그인돼 있어도 전송기에서 별도 로그인을 요청할 수 있습니다.
배송비 템플릿을 만드세요
연결 검사와 상품 전송에서 사용할 배송비 설정입니다.
- 마이샵 관리자에서 설정 → 배송을 엽니다.
- 기본 배송비 탭에서 상점에 맞는 기본 정책을 확인하고 저장합니다.
- 배송비 템플릿 탭으로 이동해 템플릿 추가를 누릅니다.
- 템플릿 이름, 기본 배송비, 무료배송 조건, 제주·도서산간 추가 배송비를 입력하고 추가를 누릅니다.
- 목록에 새 템플릿이 표시되는지 확인합니다. 전송 설정창에서 이 템플릿을 선택하게 됩니다.
금액은 설명용 예시입니다. 판매할 상품의 공급사 배송조건에 맞춰 설정하세요.
마이샵 API KEY를 복사하세요
마이샵에서 발급하는 키입니다. 다음 단계의 도매매 키와 구분해 주세요.
- 상품을 받을 마이샵 계정으로 로그인합니다.
- 상품 → 도매매 상품 가져오기를 엽니다. 홈 화면의 도매매 카드에서도 열 수 있습니다.
- 이미 발급된 KEY가 보이면 그 키를 사용합니다. 아직 없다면 KEY 발급을 누릅니다.
- 발급된 키의 복사 버튼을 누릅니다. 잠시 화면이 로딩 중이라면 발급 버튼을 반복해서 누르기 전에 기존 키가 표시되는지 확인합니다.
도매매 Open API 키를 발급하세요
도매꾹·도매매 계정에서 발급하는 두 번째 키입니다.
- 도매꾹 계정으로 로그인한 뒤 OPEN API 키 관리 화면을 엽니다. 도매매 전송기의 도매매API키관리 버튼에서도 접근할 수 있습니다.
- 현재 계정과 발급 목록을 확인합니다. 사용할 전용 키가 이미 있다면 새로 만들기 전에 기존 키를 확인합니다.
- API 키 발급을 누릅니다.
- 연동대상에서 도매매 부가서비스(일괄주문/전송기)를 선택합니다.
- 연동서비스에서 기타 도매매 서비스를 선택합니다.
- 담당자 성명과 이메일을 확인하고 개인정보 수집·이용 안내를 읽은 뒤 동의합니다.
- 발급 신청을 누릅니다. 완료 안내를 닫고 발급내역에 새 항목이 생겼는지 확인합니다.
- 해당 항목의 키 확인을 눌러 발급된 도매매 키를 복사합니다.
설명용 예시 · 실제 항목과 선택지는 상점 설정에 따라 달라질 수 있습니다.
도매매 화면에는 계정당 최대 5개까지 발급할 수 있다고 안내돼 있습니다. 이번 상품 전송 절차는 Open API 키로 진행했습니다. Private API의 로그인·주문·판매 관련 권한은 이 가이드에서 추가 신청하지 않습니다.
두 개의 키를 전송기에 등록하세요
상태체크 후 저장까지 마쳐야 입력한 키가 유지됩니다.
전송기 상단 마이샵전송기 → 마켓계정관리로 이동합니다. 화면의 두 계정관리 영역에 다음 값을 입력합니다.
| 전송기 입력 항목 | 어디에서 가져오나요? |
|---|---|
| 마이샵 로그인 이메일 | 마이샵 KEY를 발급한 계정의 로그인 이메일 |
| 마이샵 API KEY | 마이샵 관리자 → 상품 → 도매매 상품 가져오기에서 복사한 KEY |
| 도매매 ID | 현재 전송기에 로그인한 도매꾹·도매매 계정 확인 |
| 도매매 API KEY | 도매꾹·도매매 OPEN API 키 관리에서 복사한 키 |
메일 주소와 KEY 문구는 설명용 예시입니다. 본인 계정의 값을 입력하세요.
- 마이샵 이메일과 마이샵 API KEY를 입력한 뒤 상태체크를 누릅니다.
- 연결성공 안내가 나오면 확인창을 닫습니다. 오류가 나오면 해당 항목을 먼저 수정합니다.
- 도매매 ID를 확인하고 도매매 API KEY를 입력합니다.
- 화면 아래의 저장을 누르고 표시되는 안내를 확인합니다.
- 처리가 끝난 뒤 페이지를 새로고침합니다. 이메일과 두 키가 유지되는지 확인하면 저장 여부를 구분할 수 있습니다.
테스트할 상품 한 개를 찾으세요
처음에는 옵션이 단순한 상품 한 개로 전송 흐름을 확인하는 편이 쉽습니다.
- 전송기의 상품DB검색을 엽니다.
- 상품검색 기준을 상품번호 또는 상품명으로 선택합니다.
- 검색할 번호나 상품명을 입력한 뒤 추가를 누릅니다.
- 입력한 조건이 화면에 추가됐는지 확인하고 검색을 누릅니다.
- 검색 결과에서 상품명, 공급가, 옵션, 재고, 배송비 조건을 확인합니다.
- 상품의 전송 버튼을 누릅니다. 여러 상품을 선택하는 경우에는 선택상품전송하기를 이용합니다.
2026.10.20 검증 상품: A4 서류봉투. 상품의 판매 상태·가격·재고는 이후 달라질 수 있습니다.
전송 설정은 새 창으로 열립니다. 새 창이 보이지 않으면 PC Chrome에서 팝업 차단 여부를 확인하고, 도매매 사이트의 전송 창을 열 수 있도록 설정하세요.
전송 설정을 채우고 등록하세요
카테고리 매칭, 배송비 템플릿, 판매가를 확인한 뒤 등록합니다.
① 카테고리 선택 후 매칭
전시카테고리에서 마이샵에 만들어 둔 카테고리를 선택하고 카테고리매칭을 누릅니다. 상품 아래의 카테고리 칸이 실제 카테고리 이름으로 바뀌었는지 확인하세요. 테스트에서는 카테고리 테스트를 사용했습니다.
② 상품명과 상세페이지 옵션
- 상품명 앞문구 추가: 테스트 상품에는 [연동 테스트]처럼 알아보기 쉬운 표시를 넣을 수 있습니다.
- 상품명랜덤섞기: 필요할 때만 선택합니다. 전송 후 실제 등록된 상품명을 확인하세요.
- 배송대행·제3자정보제공 안내 이미지: 체크 여부에 따라 상품 상세페이지에 안내 이미지가 추가됩니다. 판매 방식과 상세페이지 구성을 확인해 선택합니다.
- 상품상세페이지 하단문구 / 상품명 제거 항목: 필요한 경우에만 입력합니다.
③ 배송비와 판매가
| 항목 | 설정 방법 |
|---|---|
| 배송비템플릿 | 2단계에서 만든 템플릿을 선택합니다. |
| 판매가요율 | 공급가에 곱할 비율입니다. 필수 항목이며, 입력 후 화면의 계산 결과를 확인합니다. |
| 옵션가요율 | 옵션 추가금액에 적용할 비율입니다. 옵션이 있는 상품은 기본 판매가와 별도로 확인합니다. |
| 추가금액 / 소비자가격 | 필요한 경우에만 설정합니다. 테스트에서는 각각 0을 입력했습니다. |
| 부가세 표시 / 100원단위 올림 | 화면의 선택값과 전송 후 실제 등록 가격을 함께 확인합니다. |
가격 계산 예시는 이번 테스트에서 사용한 값입니다. 실제 판매가는 공급가와 배송조건 등을 확인해 정하세요. 계산 결과가 0원으로 남아 있으면 요율을 다시 직접 입력하고 표시가 갱신되는지 확인합니다.
④ 마이샵에 등록
- 선택상품 수가 1개인지 확인합니다.
- 상품 아래에 카테고리가 매칭됐는지, 배송비 템플릿이 선택됐는지, 판매가가 의도한 값인지 확인합니다.
- 마이샵 상품등록하기를 누릅니다.
- 전송 완료 화면이 나올 때까지 전송 팝업을 유지합니다. 진행 중 창을 닫으면 전송이 중단될 수 있습니다.
- 결과에서 전송성공상품 1건 / 전송실패상품 0건과 도매매·마이샵 상품번호를 확인합니다.
마이샵에서 등록 결과를 확인하세요
전송 결과와 마이샵의 실제 상품 목록을 함께 확인하면 테스트가 끝납니다.
- 도매매에서 전송리스트로 이동을 누르거나 마이샵전송기 → 전송관리를 엽니다.
- 전송한 상품번호와 등록 내역이 표시되는지 확인합니다. 완료 여부가 불확실하면 재전송하기 전에 이력을 먼저 확인해 중복 등록을 피합니다.
- 마이샵 관리자에서 상품 → 전체를 열고 새로고침합니다.
- 방금 등록한 상품의 상품명·대표 이미지·판매가·재고를 확인합니다. 판매 전에 수정 화면에서 카테고리·배송비·상세페이지도 검토합니다.
- 테스트 상품을 눌러 숨기기(비노출)를 누릅니다. 새로고침 후에도 '비노출'로 표시되면 손님에게 보이지 않는 상태로 보관된 것입니다.
A4 서류봉투의 대표 이미지가 표시되고, 판매가 1,700원과 재고가 마이샵 상품 목록에 반영됐습니다. 테스트 상품은 비노출로 전환하고 새로고침 후 유지되는 것까지 확인했습니다.
도매매의 숫자 상품번호와 마이샵 상품 목록의 표시용 ID는 형태가 다를 수 있습니다. 상품명과 전송 이력의 번호를 함께 기록해 두면 찾기 쉽습니다.
문제가 생겼을 때
오류가 난 단계만 찾아 다시 확인하세요.
로그인했는데 다시 로그인하라고 나와요.
도매꾹, 도매매 마이샵전송기, 마이샵 관리자 각각의 로그인 상태를 확인합니다. 다른 브라우저로 바꾸면 그 브라우저에서 다시 로그인해야 할 수 있습니다. 전송기에는 사업자회원으로 승인된 도매꾹 계정을 사용합니다.
사업자 인증이 승인 대기 상태예요.
도매꾹의 사업자 인증 신청 상태와 제출한 정보를 확인합니다. 승인 완료 상태에서 전송기 이용을 진행하세요. 처리 기간은 해당 서비스 안내를 확인합니다.
“기본 배송비를 생성 후 다시 시도”라는 메시지가 나와요.
마이샵 배송 설정에서 기본 정책을 확인하고, 배송비 템플릿 탭에 실제 템플릿을 한 개 이상 추가합니다. 템플릿이 목록에 나타난 뒤 전송기에서 상태체크를 다시 실행합니다.
“연결성공”을 봤는데 새로고침하면 입력값이 사라져요.
이메일과 두 종류의 키를 맞는 칸에 입력했는지 확인하고, 계정관리 화면 아래의 저장까지 진행합니다. 안내 처리가 끝난 뒤 새로고침해 유지 여부를 확인합니다.
API 발급이나 상품 전송 버튼을 눌러도 새 창이 안 보여요.
PC Chrome에서 진행하고 주소창의 팝업 차단 표시를 확인합니다. 도매매 관련 사이트의 새 창이 열리도록 허용한 뒤 해당 버튼을 다시 사용합니다. 이미 열린 관리창이나 전송창도 확인하세요.
상품번호로 검색했는데 결과가 너무 많아요.
상품검색 기준을 상품번호로 선택하고 번호를 입력한 다음 추가를 누르세요. “상품번호 > 입력한 번호” 조건이 표시된 후 검색합니다.
카테고리를 선택했는데 “카테고리를 선택하세요”가 남아 있어요.
카테고리 선택 후 카테고리매칭 버튼까지 눌러야 합니다. 상품 아래 카테고리 칸에 선택한 이름이 표시되는지 확인하세요.
판매가가 0원으로 표시돼요.
필수 항목인 판매가요율을 확인합니다. 숫자를 직접 다시 입력하고 다른 칸으로 이동해 계산 결과가 갱신되는지 봅니다. 판매가가 확인된 뒤 등록하세요.
전송 완료 여부를 모르겠어요.
전송관리의 이력에서 해당 도매매 상품번호를 먼저 확인합니다. 마이샵에서도 전체 필터를 선택한 뒤 새로고침합니다. 이력이 확인되기 전에는 같은 상품을 반복 등록하지 마세요.
이미지나 상품 정보가 예상과 달라요.
원본 상품의 이미지·옵션·배송조건과 마이샵의 등록 내용을 비교합니다. 테스트 단계에서는 비노출로 두고 상품 수정 화면에서 검토한 뒤 판매 여부를 결정하세요.
오류 문의를 보낼 때 무엇을 준비하면 되나요?
발생한 단계, 오류 문구, 도매매 상품번호, 확인되는 마이샵 상품번호, 처리 시각을 준비하면 됩니다. 화면을 전달할 때 API 키 전체와 비밀번호는 가려 주세요.
이 순서만 기억하세요
배송비 템플릿 준비 → 키 두 개 발급 → 상태체크 → 저장 → 상품 검색의 추가 → 카테고리 매칭 → 상품 등록 → 마이샵 확인
마이샵 도매매 API 설정으로 이동 ↗