.png&blockId=78c9ff9a-717f-4cfb-9b99-87bbb83a5b89)
API 연동이란?
스마트십 시스템이 쇼핑몰의 주문을 가져오고, 주문 확인 및 발송 처리를 원격으로 하기 위해서는 API 연결이 필요합니다. 본 문서는 네이버 서비스에 대한 API 연결 설정 방법을 설명합니다.
스마트십이 쇼핑몰의 API를 사용할 때에는 판매자의 접근 권한을 필요로 합니다. 접속 시에 판매자의 로그인 인증 정보를 스마트십이 직접 저장할 수는 없기에, ‘API 키’라는 별도로 인증된 정보를 입력해야 합니다. API 키는 쇼핑몰별로 ‘파트너 키’, ‘비밀 키’ 등의 이름으로 불리기도 합니다.
준비사항
네이버 서비스에 대한 API 연결 설정을 위해서는 다음의 정보가 필요합니다.
•
샵 ID : 스마트스토어 판매자 ID
•
어플리케이션ID : 네이버에서 발급(아래 가이드 참고)
•
어플리케이션 시크릿 : 네이버에서 발급(아래 가이드 참고)
스마트십에 네이버 API 설정하기
1. 네이버에서 API KEY 발급 받기
네이버 서비스에서는 다음과 같은 단계에 따라 API 키를 조회/발급할 수 있습니다.
1.
네이버 커머스 API 센터에 접속 후, 애플리케이션 등록을 진행합니다.
애플리케이션 ID와 애플리케이션 시크릿을 발급받는 커머스 API 센터 계정은 “통합매니저”로 등록된 ID에서 진행해주셔야 주문 연동이 가능합니다. 부매니저 등의 아이디로는 연동이 불가능합니다.
2.
애플리케이션 이름과 설명은 간단하게 입력해주세요.
API 호출 IP (24.11.07 update)
아래 IP를 한번에 하나씩 입력 후 [추가] 버튼을 눌러 3가지 모두 등록하셔야 합니다.
*미등록 시 2025년부터 순차적으로 앱 사용이 제한됩니다.
•
211.115.121.4
•
211.115.121.6
•
211.115.102.134
3.
API 그룹 내 “상품” “주문 판매자” “판매자 정보”를 추가해주세요.
4.
[등록]버튼을 누르시면, 애플리케이션 등록이 완료됩니다.
5.
내스토어 애플리케이션 메뉴로 진입하시면 애플리케이션 ID과 애플리케이션 시크릿을 확인하실 수 있습니다.
2. 스마트십에 네이버 API KEY 등록하기
경로 : 주문 > 쇼핑몰 연동 > 쇼핑몰 API 설정
다음과 같은 단계에 따라 API 연동 설정을 할 수 있습니다.
1.
쇼핑몰 API 설정 페이지에 진입하신 후, 우측 상단의 [+신규등록]을 선택해주세요.
2.
“NAVER”를 선택한 , 하단의 "쇼핑몰 연동 등록"으로 스크롤을 이동해주세요.
3.
API 연동 설정에 필요한 정보들을 입력하고 등록해주세요.
•
쇼핑몰 샵 ID: Naver Shop ID를 기재합니다.
•
API 버전: 국내 사업자 계정을 선택합니다.
•
Application ID: 1. 네이버에서 API KEY 발급받기 에서 발급받은 애플리케이션 ID를 입력합니다.
•
Application Secret: 1. 네이버에서 API KEY 발급받기 에서 발급받은 애플리케이션 시크릿을 입력합니다.
•
API 연결 설정 옵션도 선택해주세요. 자세한 내용은 아래에서 확인하실 수 있습니다.
API 연결 설정 옵션
API 연결 설정 시에 주문 및 상품 연동 동작의 세부 사항을 조절할 수 있는 옵션이 있습니다.
•
자동 주문 연동
•
자동 주문 확인
•
자동 풀필먼트 출하지시
•
자동 재고 동기화 설정
•
API 설정 정보 확인
API 연결 정보를 추가한 후에는 정상적인 통신이 가능한지 확인합니다.
•
[연결 테스트하기] 버튼을 클릭하여 정상 연결 여부를 확인합니다.
네이버 주문 연동 가능 상태값
네이버에서 발생한 판매주문 중, “신규 주문” & “배송 준비” 상태의 주문을 가져옵니다.
네이버 주문 연동 송장 번호 업데이트
경로 : 네이버 스마트스토어센터 > 판매관리 > 배송현황 관리
•
바코드 라벨이 부착된 화물이 QFC(QX창고)에 입고되는 시점 또는 스마트십에서 송장을 출력하는 시점에 QSP로 시작되는 스마트십 송장 번호가 네이버 스마트스토어센터로 업데이트 됩니다.
경로 : 스마트십 > 송장 > 송장생성 및 출력
•
바코드 라벨이나 송장을 출력하려는 경우, 위와 같은 경로로 이동하여 출력하실 수 있습니다.
네이버 판매 상품에 스마트십 SKU 연결하기
재고 동기화 및 풀필먼트 서비스를 이용하시려는 경우, 네이버 판매 상품에 스마트십 SKU를 연결해주세요.
경로 : 네이버 스마트스토어센터 > 상품관리
1.
네이버 스마트 스토어 센터 상품 등록 화면에서 상품별로 코드를 입력합니다.
•
옵션이 없는 단일 상품의 경우 “판매자상품코드”를 입력하세요.
•
옵션이 있는 선택 상품의 경우 옵션별로 “관리코드” 를 입력하세요.
경로 : 스마트십 > 상품 및 재고 > SKU 관리
1.
스마트십 SKU 관리메뉴로 이동하세요.
2.
스마트십 SKU에 1. 판매사이트에 판매자정의코드 설정하기 에서 입력한 값과 동일한 상품을 입력합니다.
•
옵션이 없는 단일 상품인 경우
◦
단일 상품 유형의 SKU를 등록하고, ‘판매자 정의 코드’를 입력해주세요.
•
옵션이 있는 멀티상품의 경우
◦
‘옵션관리’ 탭에서 ‘판매자 정의 코드’ 를 입력해주세요.
대량의 상품을 등록 및 매핑하려는 경우, 엑셀로 업로드하시면서 함께 ‘SKU 판매자 관리 코드’를 입력해주시면 편리합니다.
3.
위의 작업이 끝났으면 이후 주문이 연동되는 시점부터 풀필먼트 주문으로 생성이 되고, 출고 시점에 재고 수량이 동기화됩니다.