Search
Duplicate

Cafe24 API 연동 가이드

참고사항 현재 스마트십 앱은 카페24 마켓스토어 정책에 의해 제한적으로 운영되고 있습니다. 앱 설치 전까지 카페24에서 발생한 주문을 배송 등록하고 싶으시다면, 아래 링크를 참고해서 엑셀 또는 수동 등록을 진행해주시기 바랍니다. 상품 등록하기 (스마트 배송)

API 연동이란?

스마트십 시스템이 쇼핑몰의 주문을 가져오고, 주문 확인 및 발송 처리를 원격으로 하기 위해서는 API 연결이 필요합니다. 본 문서는 Cafe24 서비스에 대한 API 연결 설정 방법을 설명합니다.
스마트십이 쇼핑몰의 API를 사용할 때에는 판매자의 접근 권한을 필요로 합니다. 접속 시에 판매자의 로그인 인증 정보를 스마트십이 직접 저장할 수는 없기에, ‘API 키’라는 별도로 인증된 정보를 입력해야 합니다. API 키는 쇼핑몰별로 ‘파트너 키’, ‘비밀 키’ 등의 이름으로 불리기도 합니다.
준비사항
Cafe24 서비스에 대한 API 연결 설정을 위해서는 다음의 정보가 필요합니다.
•
샵 ID : Cafe24 로그인 ID

스마트십에 Cafe24 API 설정하기

1. Cafe24 앱스토어에서 스마트십 설치하기

1.
앱 > 마이앱을 눌러주세요.
2.
[앱스토어 바로가기] 클릭 후 ‘큐익스프레스 스마트십’ 앱을 설치해주세요.
3.
‘큐익스프레스 스마트십’ 앱을 눌러주세요.
앱 클릭 시 스마트십과의 연동이 진행되며, 이때 스마트십 계정이 없으신 경우는 신규 계정으로, 스마트십 계정이 있으시다면 기존 계정과 연결하실 수 있습니다.

2. 스마트십에서 설정 마무리하기

Cafe24의 앱스토어에서 스마트십 앱을 설치하신 후, 연동까지 완료되면 쇼핑몰 연동 계정에 Cafe24가 추가된 것을 확인하실 수 있습니다. 주문 처리 옵션에 대한 내용은 하단의 ‘API 연결 설정 옵션’을 확인해주세요.

API 연결 설정 옵션

API 연결 설정 시에 주문 및 상품 연동 동작의 세부 사항을 조절할 수 있는 옵션이 있습니다.
•
자동 주문 확인
•
자동 주문 확인
•
자동 풀필먼트 출하지시

API 설정 정보 확인

API 연결 정보를 추가한 후에는 정상적인 통신이 가능한지 확인합니다.
•
[연결 테스트하기] 버튼을 클릭하여 정상 연결 여부를 확인합니다.

Cafe24 주문 연동 가능 상태값

Cafe24에서 수집한 판매 주문 중, “배송 준비중” 상태의 주문을 가져옵니다.
수동으로 연동하시는 경우 Cafe24의 ‘주문일’ 기준으로 연동해주세요.

Cafe24 주문 연동 송장 번호 업데이트

주의사항 Cafe24 배송업체 관리 페이지에 사용하시는 택배사가 추가되지 않은경우, 주문 발송처리가 실패할 수 있습니다. 해당 페이지에서 사용하실 택배사를 사전에 추가 부탁드립니다.
경로 : Cafe24 > 쇼핑몰 설정 > 배송 설정
•
바코드 라벨이 부착된 화물이 QFC(QX창고)에 입고되는 시점 또는 스마트십에서 송장을 출력하는 시점에 송장 번호가 Cafe24로 업데이트 됩니다.
•
QFC에 입고 되어 송장 번호가 업데이트 되는 경우, 운송 대행사의 택배사 명과 송장 번호로 업데이트 됩니다.
경로 : 스마트십 > 송장 > 송장생성 및 출력
•
바코드 라벨이나 송장을 출력하려는 경우, 위와 같은 경로로 이동하여 출력하실 수 있습니다.

Cafe24 등록 상품에 스마트십 SKU 연결하기

풀필먼트 서비스를 이용하시려는 경우, Cafe24 등록 상품에 스마트십 SKU를 연결해주세요.
옵션 관리코드 설정하는 법 Cafe24 > 상품목록 > 옵션/재고 클릭 > 옵션사용 (사용함) > 자체 품목코드 입력
1.
Cafe24 상품 화면에서 상품별로 코드를 입력합니다.
•
옵션이 없는 단일 상품일 경우는 “자체 상품코드”를 입력하세요.
•
옵션이 있는 선택 상품일 경우에는 옵션 별로 “자체 품목코드”를 입력해주세요.
경로 : 스마트십 > 상품 및 재고 > SKU 관리
a.
스마트십 SKU 관리메뉴로 이동하세요.
b.
스마트십 SKU에 1. 판매사이트에 판매자정의코드 설정하기 에서 입력한 값과 동일한 상품을 입력합니다.
•
옵션이 없는 단일 상품인 경우
◦
단일 상품 유형의 SKU를 등록하고, ‘판매자 정의 코드’를 입력해주세요.
•
옵션이 있는 멀티상품의 경우
◦
‘옵션관리’ 탭에서 ‘판매자 정의 코드’ 를 입력해주세요.
대량의 상품을 등록 및 매핑하려는 경우, 엑셀로 업로드하시면서 함께 ‘SKU 판매자 관리 코드’를 입력해주시면 편리합니다.
3. 위의 작업이 끝났으면 이후 주문이 연동되는 시점부터 풀필먼트 주문으로 생성이 되고, 출고 시점에 재고 수량이 동기화됩니다.

Cafe24 멀티쇼핑몰 생성하기

멀티쇼핑몰이란? Cafe24에서는 멀티쇼핑몰 서비스를 제공하고 있으며, 멀티쇼핑몰은 메인으로 운영하는 쇼핑몰 외 목적에 따라 다양하게 운영할 수 있습니다. 멀티쇼핑몰은 추가로 연동하지 않아도 API 연동 목록에 자동으로 추가됩니다. 멀티쇼핑몰 생성 방법은 아래 가이드를 참고해주세요.
1.
쇼핑몰 설정 > 채널 설정 > 멀티쇼핑몰을 눌러주세요.
2.
[쇼핑몰 추가] 버튼을 눌러주세요.
3.
설정 완료 후 [저장]버튼을 누르면 멀티쇼핑몰이 추가됩니다.
4.
추가된 멀티쇼핑몰은 좌측 상단에서 확인 및 선택하실 수 있습니다.