목차 · 2장 쿠팡 연결하기
2장 · 시작 가이드
쿠팡 연결하기
입력정보 복사 · 윙 키 발급 · 키 등록 · 첫 가져오기
쿠팡 윙에서 오픈API 키를 받아 그린시스에 넣으면 쿠팡 주문·반품·정산이 자동으로 들어옵니다. 10분쯤 걸립니다. 쿠팡 윙 아이디와 비밀번호를 준비하세요.
1. 그린시스 입력정보 복사하기
- 앱 대시보드의 「첫 설정 시작하기」를 누르고 2단계에서 「업체명」「URL」「IP 주소」를 복사합니다. 쿠팡 키 발급 화면이 이 세 값을 묻습니다.
- IP 주소는 그린시스 서버 주소입니다. 내 컴퓨터 주소가 아니니 그대로 넣습니다.
2. 쿠팡 윙에서 키 발급받기
- 1추가판매정보
- 1윙 비밀번호
- 2확인
- 1발급
- 2수정
- 1자체개발 선택
- 2업체명
- 3URL
- 4IP 붙여넣기
- 5추가 누르기
- 6확인
- 윙 오른쪽 위 내 이름을 누르고 「추가판매정보」로 갑니다. 윙 비밀번호를 한 번 더 묻습니다. 그린시스 비밀번호가 아닙니다.
- 맨 아래 OPEN API 키 영역에서 「발급」을 누릅니다. 이미 발급했다면 「수정」으로 들어갑니다.
- 복사해 둔 업체명·URL·IP를 넣습니다. IP는 칸에 적은 뒤 「추가」를 꼭 누르고 「확인」을 누릅니다.
3. 그린시스에 키 등록하기
- 1쿠팡 타일
- 2액세스 키
- 3판매자 ID
- 4키 만료일
- 5키 등록
- 앱의 「플랫폼 연동」 › 「쿠팡」에서 「액세스 키」「시크릿 키」「판매자 ID」「키 만료일」을 넣습니다. 판매자 ID는 윙 화면의 업체코드입니다.
- 키 만료일은 윙 화면에 보이는 유효 기간의 끝 날짜입니다. 쿠팡 키는 최대 180일 동안 쓸 수 있습니다.
- 「키 등록 (검증 후 저장)」을 누르면 쿠팡에 실제로 한 번 물어보고 맞을 때만 저장합니다.
4. 처음 한 번 가져오기
- 키를 등록하면 바로 아래 「지금 가져오기」가 열립니다. 기간은 이번 달 1일부터 오늘까지로 잡혀 있으니 그대로 누르세요. 여러 번 눌러도 같은 주문이 겹치지 않습니다.
- 끝나면 가져온 주문 라인·상품 매칭·반품·정산 행 수가 나오고, 대시보드에 매출과 순익이 채워집니다.
- 그다음부터는 자동입니다. 새 주문은 1분마다, 반품·정산까지 전체는 한 시간마다 가져옵니다.
문제가 생겼을 때
- 「키 검증에 실패했습니다」
- 방금 발급했다면 5~30분 뒤 다시 누르세요. 그래도 안 되면 윙 화면에서 액세스 키·시크릿 키·판매자 ID를 다시 복사해 붙여 넣습니다.
- 「쿠팡이 그린시스 서버 IP(…)의 호출을 막았습니다」
- 윙의 OPEN API 「수정」에서 그린시스 IP가 「추가」돼 있는지 확인합니다. 첫 설정 2단계의 IP와 같아야 합니다.
- 화면 위에 「쿠팡 오픈API 키 D-n」이 뜹니다
- 키 만료가 다가왔습니다. 윙에서 새 키를 받은 뒤 「플랫폼 연동」 › 「쿠팡」 › 「키 교체」에 새 키와 만료일을 넣으세요. 만료되면 동기화가 멈춥니다.
- 「만료일이 올바르지 않습니다」
- 쿠팡 키는 최대 180일입니다. 윙 화면의 만료일을 다시 확인하세요.
