WMS

셀메이트

카페24와 셀메이트를 연동하여 주문 관리 업무를 자동화할 수 있습니다.

주요기능

카페24와 셀메이트 연동으로 주문 관리를 자동화합니다. [주문 조회·취소]와 교환/반품 신청이 가능하며, 부분 배송에 따른 발송 예정일 안내와 게시판 연동 기능을 추가로 지원합니다.

사용 방법

1. 셀메이트 사이트 내에서 API Key를 허용하기

[사용자 관리] - [외부 연동 관리] - [제휴 서비스 관리] 탭에서 채널톡 활성화해 주시면 됩니다.

2. 셀메이트 앱 설치 및 연동하기

[채널 설정] → [연동] → [앱스토어]에서 셀메이트 앱을 설치해 주세요.

아래의 내용을 입력 후 저장해 주세요.

도메인: 셀메이트 도메인
셀메이트 사이트 내 [사용자 관리] - [도메인 정보]를 클릭해 확인하실 수 있습니다.

셀메이트 OAuth 로그인 화면에서 로그인을 진행해주세요
- 사용자 아이디
- 비밀번호

연동이 완료되었습니다.

반품 수거접수용 계정 등록하기(선택)

[설정] 화면에서 반품 수거접수에 사용할 관리자 ID와 비밀번호를 입력해주세요.
등록한 관리자 계정이 OTP를 사용하는 계정이라면, [OTP Secret] 입력란에 OTP Secret을 추가로 입력해주세요.

OTP Secret이란?

Google Authenticator 등에서 매번 바뀌는 6자리 인증번호가 아니라, 그 인증번호를 생성하는 데 사용되는 Base32 형식의 장기 비밀키입니다. 셀메이트 관리자 페이지에 로그인 시, OTP Secret 화면에서 확인되는 키를 입력해 주세요.

3. 카페24 앱에서 WMS 설정 변경하기

경로: [채널설정] → [연동] → [앱스토어] → [카페24 앱] 선택
(아직 카페24 앱을 설치하지 않았다면 설치를 먼저 진행해주세요)
[태스크/커맨드 설정]에서 WMS 설정을 [셀메이트]로 변경해 주세요.

셀메이트 앱 설치 및 설정이 완료되지 않으면 카페24앱에서 WMS를 셀메이트로 변경할 수 없습니다. 반드시 셀메이트 설치 및 설정 완료 후 카페24 앱 설정 순서로 진행해 주세요.

3. 취소, 교환, 반품 설정하기 (선택사항)

주문취소, 교환, 반품에 대한 처리 방식을 선택해주세요.
1. 취소 처리

취소 완료	취소 신청
신용카드, 간편결제(네이버페이, 카카오페이 등), 예치금, 적립금, 쿠폰을 통해 결제한 주문 건 중 고객이 주문 상품 전체에 대한 취소를 진행하는 경우 환불(PG사 취소)까지 자동 처리됩니다. 무통장입금를 포함하는 주문이거나, 고객이 부분 취소를 진행하는 경우 → 팀 멤버 확인 후 수동으로 환불이 진행됩니다 결제 수단에 따른 환불 진행 여부는 추후 변경될 수 있습니다.	모든 주문 취소 건은 카페24에서 직접 확인 후 수동으로 환불 처리를 해주셔야 합니다.

취소 완료

취소 신청

신용카드, 간편결제(네이버페이, 카카오페이 등), 예치금, 적립금, 쿠폰을 통해 결제한 주문 건 중 고객이 주문 상품 전체에 대한 취소를 진행하는 경우 환불(PG사 취소)까지 자동 처리됩니다.
무통장입금를 포함하는 주문이거나, 고객이 부분 취소를 진행하는 경우 → 팀 멤버 확인 후 수동으로 환불이 진행됩니다
결제 수단에 따른 환불 진행 여부는 추후 변경될 수 있습니다.

모든 주문 취소 건은 카페24에서 직접 확인 후 수동으로 환불 처리를 해주셔야 합니다.

WMS (셀메이트)를 연동하지 않은 경우, ‘취소완료’ 옵션 선택시 [취소 완료 범위]를 추가로 설정해주셔야 합니다.

4가지 항목 다중 선택 가능 : 상품 준비중, 배송 준비중, 배송 보류, 배송대기

b. 교환/반품 시 불량, 오배송 처리

신청	신청 대기
교환/반품 사유가 '상품 불량' 혹은 '오배송'인 경우, 고객이 교환/반품 요청 시 바로 신청(카페24 내의 ‘반품 신청’, ‘교환 신청’ 상태)이 완료됩니다.	교환/반품 사유가 '상품 불량' 혹은 '오배송'인 경우, 담당자가 수신함 대화창에서 고객이 첨부한 사진을 먼저 확인 후 수동으로 신청을 수락할 수 있습니다.

[신청 대기] 옵션 사용시 - 담당자의 교환/반품 수동 수락 절차

고객 요청: 고객이 채팅창에서 교환 또는 반품을 접수합니다.
정보 확인: 수신함 대화창에 나타난 상세 내역과 고객이 첨부한 사진을 검토합니다.
수락 클릭: 대화창 내 [교환 신청 수락] 또는 [반품 신청 수락] 버튼을 클릭합니다.
최종 완료: 팝업창에서 [수락] 버튼을 한 번 더 누르면 신청이 최종 완료됩니다.

c. 반품 주소

고객이 택배를 직접 발송할 경우 교환/반품 상품을 받아 볼 주소를 입력해 주세요.

발송 예정일 관련 설정을 진행해 주세요.

❶ 부분 배송 : 부분 배송 정책을 사용할지에 대한 여부를 선택해 주세요.

사용하신다면, 부분 배송 기준일과 부분 배송 최소 금액을 설정해 주시면 됩니다.

❷ 부분 배송 기준일

주문 당일은 기준일에 포함되지 않습니다.
예를 들어, 부분 배송 기준일을 3일로 설정했고, 고객이 월요일에 A, B을 구매했지만 B가 품절이 된 경우
- 주문일(월요일)로부터 3일(목요일)까지는 부분 배송이 진행되지 않습니다.
  - B가 목요일에 재입고 예정일 경우 : A, B 모두 목요일에 일괄 발송 (부분 배송 X)
  - B가 금요일에 재입고 예정일 경우: A만 먼저 부분 발송, B를 금요일에 발송

❸ 부분 배송 최소 금액

입력한 금액 이상의 결제 건에 대해서만 부분 배송이 진행됩니다.

프론트 커맨드 활성화하기

'커맨드' 메뉴에서 사용하고자 하시는 커맨드를 ON으로 켜주시면 됩니다.

4. 태스크 활성화

[고객] 탭 → [서포트] → [설정] → [태스크] → [카페24 폴더] → [주문조회], [주문취소] 태스크 > 우측 ... 버튼 클릭 > 퍼블리시 버튼을 누르면 적용됩니다.

5. 제공되는 함수

셀메이트가 지원하는 기능은 호출 방식에 따라 두 가지로 나뉩니다.

① ALF 태스크에서 직접 호출하는 함수

고객 응대 중 [ALF 태스크]가 직접 호출해서 대화방에 결과를 안내하는 함수입니다.

기능	설명	함수명
주문 조회 (전화번호)	고객이 채팅에서 입력한 전화번호로 주문 내역을 조회합니다.	`getOrdersByPhone`
반품 수거접수	택배사에 반품 상품 수거를 접수합니다.	`takebackOrder`

② 카페24 허브 – 셀메이트 WMS 연동 확장 함수

카페24 허브가 셀메이트를 WMS(입출고 관리 시스템)로 연동했을 때, 허브 쪽에서 호출해 주문 상태를 동기화하는 함수입니다. 대화방에서 직접 호출되는 기능이 아니라, 카페24 관리자단에서 처리한 주문 변경이 셀메이트에 반영되도록 하는 역할입니다.

기능	설명	함수명
주문 조회	주문번호 등 조건으로 주문 내역을 조회하는 기본 조회 기능입니다.	`core.getOrders`
주문 취소	주문을 취소합니다.	`cancel.cancelOrder`
취소 복원	취소된 주문을 원래 상태로 복원합니다.	`cancel.restoreOrder`
반품 처리	주문을 반품 상태로 변경합니다.	`return.returnOrder`
반품 복원	반품 상태의 주문을 원래 상태로 복원합니다.	`return.restoreOrder`
교환 처리	교환을 접수합니다.	`exchange.exchangeOrder`
교환 복원	접수된 교환을 원래 상태로 복원합니다.	`exchange.restoreOrder`
배송지 변경	이미 접수된 주문의 배송지를 변경합니다.	`edit.changeShippingAddress`
쇼핑몰 ID 조회	연동된 쇼핑몰의 ID를 조회합니다.	`core.getShopId`
지원 커머스 플랫폼 조회	셀메이트가 지원하는 커머스 플랫폼 목록을 조회합니다.	`metadata.getSupportedCommerces`
설정 동기화	저장된 연동 설정을 최신 상태로 동기화합니다.	`syncStoredConfig`
설정 삭제	저장된 연동 설정을 삭제합니다.	`deleteStoredConfig`

return.returnOrder(반품 상태 변경)와 takebackOrder(택배사 수거 접수)는 별개 함수이지만, 먼저 return.returnOrder를 호출할 필요는 없습니다. takebackOrder가 필요한 경우 내부에서 반품 상태 변경을 함께 처리하므로, 실제 수거 접수 시에는 takebackOrder만 호출하면 됩니다.

❶ 반품 수거접수(takebackOrder) 상세 동작

이미 진행 중인 수거 접수가 있는 경우, 추가로 접수하지 않고 alreadyRequested로 반환됩니다. 철회된 접수건에 대해서만 다시 접수가 진행됩니다.
주문에 포함된 상품 중 취소되었거나 반품할 수 없는 상품은 제외하고, 접수 가능한 상품만 처리됩니다.
함수는 기본적으로 success, status, message를 반환하며, 상황에 따라 code, items, itemResults, excludedItems가 추가로 반환됩니다.
안내 문구는 위 반환값에 따라 ALF 태스크에서 분기 처리를 설정해야 합니다. 특히 아래 상태는 반드시 구분해 안내해주세요.

상태(status)	의미
`alreadyRequested`	신규 접수 없이 기존 활성 접수를 확인한 상태
`partial`	`success=false`여도 일부 상품은 실제로 접수된 상태
`unknown`	요청이 전달됐을 수 있으나 결과를 확인하지 못한 상태

사용 조건

관리자 계정의 ID와 비밀번호가 필요합니다.
OTP를 사용하는 계정은 OTP Secret이 추가로 필요합니다.

이지어드민

카페24 앱과 이지어드민을 연동하여 주문 관리 업무를 자동화할 수 있습니다.

주요 기능

카페24와 이지어드민을 연동하여 주문 관리 업무를 자동화할 수 있습니다. 카페24 앱 태스크 중 [주문 조회]와 [주문 취소]를 이용할 수 있고 추가로 송장번호가 이미 발급된 주문에 대해서도 취소 가능 여부를 설정할 수 있습니다.

사용 방법

1. 이지어드민 앱 설치하기

[채널 설정] → [연동] → [앱스토어]에서 이지 어드민 앱을 설치해 주세요.

2. 설정 값 입력하기

아래의 내용을 입력 후 저장해 주세요.

도메인: 이지어드민 도메인
아이디: 이지어드민 로그인 아이디
비밀번호: 이지언드민 로그인 비밀번호
API 파트너키: 이지 어드민으로부터 Open API를 구매하신 partner_key
API 업체키 (도메인키): 이지 어드민으로부터 Open API를 구매하신 domain_key

3. 카페24 앱에서 WMS 설정 변경하기

경로: [채널설정] → [연동] → [앱스토어] → [카페24 허브 앱] 선택
[태스크/커맨드 설정]에서 WMS 설정을 [이지어드민]으로 변경해 주세요.

이지 어드민 앱 설치 및 설정이 완료되지 않으면 카페24앱에서 WMS를 이지 어드민으로 변경할 수 없습니다. 반드시 이지 어드민 설치 및 설정 완료 후 카페24 앱 설정 순서로 진행해 주세요.

4. 송장번호 발급 후 취소 옵션 설정하기 (선택사항)

송장번호 발급 후 취소 허용 여부를 회사 정책에 맞게 설정해 주세요.
- ON: 송장번호 발급 후에도 고객 요청 시 주문 취소 가능
- OFF: 송장번호 발급 후에는 주문 취소 불가

5. 주문 취소, 주문 조회 태스크를 퍼블리시 합니다.

[고객] 탭 → [서포트] → [설정] → [태스크] → [카페24 허브 폴더] → [주문조회], [주문취소] 태스크 > 우측 ... 버튼 클릭 > 퍼블리시 버튼을 누르면 적용됩니다.

[채널 설정] → [연동] → [앱스토어]에서 사방넷 앱을 설치해 주세요.

2. 로그인 ID, 로그인 비밀번호 입력하기

사방넷(sabangnet.co.kr)에 로그인할 때 사용하는 아이디와 비밀번호를 입력합니다.
사방넷 비밀번호 변경 시, 채널톡 설정 화면에서 새 정보로 다시 저장이 필요해요.

3. OTP QR 이미지 업로드하기

사방넷 계정에 설정된 OTP(2단계 인증) QR 이미지를 업로드합니다.
사방넷에서 OTP를 처음 등록할 때 표시되는 QR 코드 화면의 이미지를 업로드해주세요. 이미 등록한 경우에는 사방넷 설정에서 OTP를 재설정하면 새 QR 이미지를 발급받을 수 있습니다.
- Google Authenticator 앱 등록 시 보이는 QR 화면을 캡처한 이미지
- 사방넷에서 OTP를 재설정하면서 새로 발급받은 QR 이미지
- 지원 형식: PNG, JPG, WebP (QR 코드가 선명하게 보여야 합니다.)

참고해주세요.

사방넷 2단계 인증은 2가지 종류가 있습니다.

Google OTP를 선택해 진행해주세요. 알림톡으로 인증하면 정확하게 연동이 되지 않습니다.