> For the complete documentation index, see [llms.txt](https://www.analytics-docs.laplacetec.com/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.analytics-docs.laplacetec.com/guide/startguide/connect/mall/wisa.md).

# 위사 연결

라플라스에 위사(스마트윙) 쇼핑몰을 연결하는 방법입니다. 위사 몰 관리자에서 ERP API 연동키를 발급하고 라플라스에서 몰 주소와 연동키를 입력해 위사 연결을 마치는 순서를 안내합니다.

이 가이드는 위사(WISA, 스마트윙) 쇼핑몰의 주문 데이터를 라플라스에 연동하기 위한 절차를 안내합니다.

{% hint style="info" %}
**위사 연결은 베타입니다.**

연결 카드와 화면에 **베타** 표시가 붙어 있어요. 수집 범위와 화면은 사용해 보시는 분들의 의견을 받아 계속 다듬고 있습니다. 이상한 점이 보이면 아래 **전담 매니저에게 요청하기**로 알려 주세요.
{% endhint %}

### 사전 준비 <a href="#ready" id="ready"></a>

위사 데이터를 라플라스에 연동하려면 아래 항목이 필요합니다.

* 위사(스마트윙) 쇼핑몰 관리자 계정
* 쇼핑몰 주소 (예: <[www.myshop.co.kr](http://www.myshop.co.kr)>)
* 위사 몰 관리자에서 발급한 ERP API 연동키
* 라플라스 계정

***

### Step 1. 위사 몰 관리자에서 ERP API 연동키 발급 <a href="#step1" id="step1"></a>

위사 몰 관리자에서 라플라스용 ERP API 연동키를 발급받습니다. 위사 공식 매뉴얼([ERP API연동키 설정](https://help.wisa.co.kr/document/article/2965))의 메뉴 경로를 따릅니다.

1. 위사 쇼핑몰 관리자에 로그인합니다.
2. **관리자 > 설정 > 판매설정 > ERP API연동키 설정**으로 이동합니다.
3. **ERP API연동키 등록**에서 연결 서비스명에 **라플라스**를 입력하고 등록합니다. 위사 매뉴얼의 설명대로 "연결 서비스명 입력 후 등록 시 해당 업체 API키가 발급됩니다."
4. 발급된 API Key를 복사해 둡니다.

> ERP API 연동키는 비밀번호와 같은 역할입니다. 외부에 노출되지 않도록 주의하세요.

{% hint style="warning" %}
이미 발급한 키를 **재발급**하면 그 키로 연동된 서비스가 멈출 수 있어요(위사 매뉴얼: "API Key 발급 후 재발급을 사용하실 경우 연동된 서비스가 중단될 수 있습니다."). 라플라스에 연결한 키를 재발급했다면 아래 Step 2의 **인증 갱신**으로 새 키를 다시 입력해 주세요.
{% endhint %}

***

### Step 2. 라플라스에서 위사 연결 <a href="#step2" id="step2"></a>

1. 왼쪽 레일의 **데이터 연결**을 누른 뒤, 탐색 패널의 **커넥터 검색**에 위사를 입력하거나 **쇼핑몰 연결** 카테고리에서 **위사 연결**을 눌러 주세요.

![위사 연결 화면](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-088fcb4d0c90103a0aaf316bd7a6bb16c519dc69%2Fstartguide__connect__mall__wisa__01.png?alt=media)

{% hint style="info" %}
아직 연결한 쇼핑몰이 없으면 커넥터 화면에 **연결하면 이런 분석을 할 수 있습니다**가 보여요. 화면 아래 **연결 순서**와 **시작 전 준비물**에서 연결 단계와 미리 준비할 것도 확인해 주세요.
{% endhint %}

2. **위사 연결** 화면 머리글 오른쪽의 **데이터 연결**을 눌러 연결 창을 열어 주세요. **쇼핑몰 정보**에 **몰 주소**와 Step 1에서 복사한 **ERP API 연동키**를 입력한 후 **연결하기**를 클릭합니다.
   * 몰 주소는 `www.myshop.co.kr` 처럼 쇼핑몰 주소만 입력하면 돼요. `http://`, `https://` 는 붙여도 되고 빼도 되지만, 라플라스는 연동키를 보호하려고 늘 `https://`(보안 접속)로 쇼핑몰에 접속합니다. 그래서 `https://` 로 열리지 않는 쇼핑몰은 연결할 수 없어요.

![위사 연결 창 몰 주소·ERP API 연동키 입력](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-ecaca579a01b4c454824a5bf85644660bccbc80a%2Fstartguide__connect__mall__wisa__02.png?alt=media)

3. 키가 확인되면 **위사 연결이 완료되었습니다.** 안내가 보여요. 위사는 쇼핑몰 하나가 데이터 소스 하나라서, 연결한 쇼핑몰이 바로 수집 대상으로 추가돼요. 이어서 **데이터 소스 선택** 창이 열리면 **연결 가능한 신규 데이터 소스가 없습니다.** 가 보이는데, 이미 추가됐다는 뜻이니 **취소**를 눌러 닫아 주세요(1).

   ![데이터 소스 선택 창은 취소로 닫기](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-28d29c7c80943ce9717344494dead18168aac620%2Fstartguide__connect__mall__wisa__03.png?alt=media)

* 연결한 쇼핑몰은 커넥터 화면의 연결 표에 보여요. 행 오른쪽 ⋯(**작업 더 보기**)에서 **최신화**와 **인증 갱신**을 할 수 있습니다.
* 쇼핑몰이 여러 개라면 몰마다 연동키를 발급해 같은 순서로 하나씩 연결해 주세요.

{% hint style="warning" %}
**"몰 주소 또는 ERP API 연동키가 올바르지 않습니다"가 보이면**

1. 몰 주소가 위사 관리자에 등록된 쇼핑몰 주소와 같은지, 브라우저에서 `https://` 로 열리는지 확인해 주세요.
2. ERP API 연동키를 앞뒤 공백 없이 그대로 붙여 넣었는지, 그 뒤에 재발급하지 않았는지 확인해 주세요.
   {% endhint %}

{% hint style="info" %}
**데이터 연동이 왜 오래 걸리나요?**

👉 라플라스에서는 위사의 데이터를 가져오기만 하는 것이 아니라 가져온 데이터를 정제하고 차트를 그려주는 작업을 해주기 때문이에요. 소요되는 시간 또한 데이터의 양이 많을수록 오래 걸릴 수도 있어요.

💬 진행 상황은 상단 바 오른쪽 **작업 · 데이터 상태**에서 확인할 수 있고, 연동이 완료되면 이메일로도 알려 드려요. 라플라스를 종료해도 수집은 계속되니 안심하시고 종료하셔도 됩니다.
{% endhint %}

***

### 위사 연결로 볼 수 있는 지표 <a href="#metrics" id="metrics"></a>

위사 ERP API의 주문 데이터에는 **회원 ID가 없습니다**. 그래서 라플라스는 구매자를 수령자 연락처·주소로 묶어요. 선물 주문처럼 주문한 사람과 받는 사람이 다르면 받는 사람 기준으로 집계되어 **재구매**, **신규/재방문 고객** 같은 구매자 지표가 실제와 다를 수 있어요.

***

## 전담 매니저에게 요청하기

위사 연결에 어려움이 있으신가요?

하단의 문의하기 혹은 홈페이지의 채팅 상담을 통해 문의하세요. 담당 매니저가 도움을 드리도록 하겠습니다.

> 💬 [채팅으로 문의하기](https://laplacetec.channel.io/lounge)
>
> 💬 [홈페이지에서 문의하기](https://www.analytics.laplacetec.com/contact)

**이메일 문의:** [**product@laplacetec.com**](mailto:product@laplacetec.com)
