네이버 스마트스토어를 운영하면서 매일 주문을 확인하고, 수동으로 엑셀에 옮기고, 택배사에 업로드하는 작업에 지치셨나요? 스마트스토어 API를 연동하면 이 모든 과정이 자동화됩니다.
이 가이드는 API 연동 경험이 전혀 없는 분들도 5분 만에 따라할 수 있도록 작성했습니다.
💡 이 가이드를 읽으면
- 스마트스토어 API 키를 발급받는 방법
- 팜프리에 API를 연동하는 방법
- 주문이 자동으로 동기화되는지 확인하는 방법
총 소요 시간: 5분
1단계: 스마트스토어 API 키 발급받기
1 네이버 개발자 센터 접속
네이버 개발자 센터(https://developers.naver.com)에 접속하여 로그인합니다. 스마트스토어 판매자 계정으로 로그인하세요.
2 애플리케이션 등록
상단 메뉴에서 "Application" → "애플리케이션 등록"을 클릭합니다. 애플리케이션 이름은 "팜프리 주문관리"처럼 알아보기 쉽게 입력하세요.
3 사용 API 선택
사용 API 목록에서 다음을 체크합니다:
- ✓ 네이버 스마트스토어 주문 조회 API
- ✓ 네이버 스마트스토어 상품 조회 API
4 Client ID와 Client Secret 복사
등록이 완료되면 Client ID와 Client Secret이 발급됩니다. 이 두 값을 복사해두세요. (나중에 팜프리 설정에서 사용합니다)
💚 팁: API 키는 안전하게 보관하세요
Client Secret은 비밀번호와 같습니다. 절대 타인에게 공유하지 마세요. 만약 유출되었다면 네이버 개발자 센터에서 재발급 받을 수 있습니다.
2단계: 팜프리에 API 연동하기
1 팜프리 관리자 로그인
팜프리 관리자 페이지(https://admin.farmfree.co.kr)에 로그인합니다.
2 설정 메뉴 접속
왼쪽 메뉴에서 "설정" → "마켓 연동"을 클릭합니다.
3 스마트스토어 연동
"스마트스토어 연동" 카드에서 "연동하기" 버튼을 클릭합니다.
4 API 키 입력
1단계에서 복사한 Client ID와 Client Secret을 입력하고 "연동 완료" 버튼을 클릭합니다.
3단계: 연동 확인하기
연동이 완료되면 자동으로 주문이 동기화됩니다. 다음 단계로 확인하세요:
- 왼쪽 메뉴에서 "주문 관리" → "주문 목록"을 클릭합니다.
- 스마트스토어 주문이 자동으로 표시되는지 확인합니다.
- 주문 항목 옆에 "스마트스토어" 라벨이 표시되면 성공입니다!
💚 자동 동기화 주기
팜프리는 5분마다 스마트스토어 주문을 자동으로 가져옵니다. 실시간 동기화가 필요하다면 "주문 목록" 화면에서 "새로고침" 버튼을 클릭하세요.
문제 해결 (트러블슈팅)
Q. "API 연동 실패" 오류가 나옵니다
해결 방법:
- Client ID와 Client Secret을 다시 확인하세요. 공백이나 오타가 없는지 체크합니다.
- 네이버 개발자 센터에서 애플리케이션 상태가 "사용 중"인지 확인하세요.
- 스마트스토어 판매자 계정으로 로그인했는지 확인하세요.
Q. 주문이 동기화되지 않습니다
해결 방법:
- 스마트스토어에 실제 주문이 있는지 확인하세요.
- "주문 목록" 화면에서 "새로고침" 버튼을 클릭하여 수동 동기화를 시도하세요.
- 네이버 개발자 센터에서 API 사용 권한이 활성화되어 있는지 확인하세요.
Q. 과거 주문도 가져올 수 있나요?
답변: 네, 가능합니다. 팜프리는 연동 시점부터 최근 3개월의 주문을 자동으로 가져옵니다. 더 오래된 주문이 필요하다면 고객지원(010-4775-2111)으로 문의해주세요.
다음 단계
스마트스토어 API 연동을 완료하셨다면, 이제 다음 단계로 진행하세요:
- 택배 API 연동: 클릭 한 번으로 송장 자동 생성
- 알림톡 설정: 고객에게 배송 시작 알림 자동 발송
- 쿠팡 연동: 스마트스토어와 쿠팡 주문을 한 곳에서 관리