> ## Documentation Index
> Fetch the complete documentation index at: https://make.edicus.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 스마트스토어 연동

> 스마트스토어를 Edicus Link에 연결하고, 주문을 가져오는 조건과 발주확인 시점을 정하는 방법

Edicus Link는 연동한 스마트스토어에서 주문을 가져와 구매자에게 편집링크를 보냅니다. 연동은 스마트스토어센터에서 API 권한을 대행사 **모션원**에 맡기고, 발급된 판매자 ID를 Edicus Link에 붙여넣으면 끝납니다. 이 페이지는 연동 절차와, 연동한 뒤 주문이 언제 어떤 조건으로 들어오는지 정리합니다.

## 배우는 것

* 스마트스토어센터에서 API 권한을 맡기고 연동하는 방법
* 연동만으로는 주문이 들어오지 않는 이유와 주문을 가져오는 조건
* 주문을 가져오는 주기와 수집 상태 표시
* **자동 발주 확인**을 켜면 스마트스토어 발주확인이 언제 되는지
* 취소, 배송, 구매확정이 Edicus Link에 반영되는 방식
* 여러 스마트스토어를 연결하는 방법

## 연동하기

연동은 **설정** > **쇼핑몰 연동** 메뉴에서 합니다. 커머스API센터에서 애플리케이션을 만들 필요는 없습니다. 스마트스토어센터의 **API 관리** 메뉴만 씁니다.

**1. 연동 화면을 엽니다**

**설정** > **쇼핑몰 연동**에서 오른쪽 위의 **연동 추가**를 누릅니다. 연동한 쇼핑몰이 하나도 없으면 가운데의 **쇼핑몰 연동** 버튼을 눌러도 됩니다. **스마트스토어 연동하기** 화면이 열립니다.

**2. 스마트스토어센터의 API 관리 메뉴를 엽니다**

스마트스토어센터의 **\[스토어관리] - \[API 관리]** 메뉴로 접속합니다. 화면의 **API 관리 메뉴 바로가기**를 누르면 새 창으로 열립니다.

**3. 상품 API와 주문 API에 모션원을 지정합니다**

스마트스토어센터의 **API 관리** 화면에서 다음을 합니다.

1. **API 사용 설정**에서 **사용**을 선택합니다.
2. **상품 API**와 **주문 API**에 모두 **모션원**을 지정하고 **저장**을 누릅니다. 다른 대행사를 이미 쓰고 있다면 **대행사추가** 버튼으로 모션원을 추가합니다.
3. 같은 화면의 **API 연동용 판매자 ID**를 복사합니다.

상품 API는 상품을 등록할 때, 주문 API는 주문을 가져오고 발주확인할 때 씁니다. 둘 중 하나라도 빠지면 연동이 제대로 동작하지 않습니다.

**4. 판매자 ID를 붙여넣고 저장합니다**

Edicus Link 화면의 **API 연동용 판매자 ID 입력** 칸에 복사한 값을 붙여넣고 **연동 확인 및 저장**을 누릅니다. 붙여넣을 때 딸려 온 앞뒤 공백은 Edicus Link가 지웁니다.

확인에 성공하면 "쇼핑몰 연동 정보가 저장되었습니다."라는 알림이 뜨고 그 쇼핑몰의 설정 화면으로 이동합니다.

확인 단계에서 나올 수 있는 결과는 셋입니다.

| 화면 | 뜻과 할 일 |
| - | - |
| "쇼핑몰 연동 정보가 저장되었습니다." | 연동이 끝났습니다. 쇼핑몰 이름은 스마트스토어 이름으로 자동으로 채워집니다 |
| "연동에 실패했습니다. API 연동용 판매자 ID를 다시 확인해주세요." | 판매자 ID가 틀렸거나, 스마트스토어센터에서 **API 사용 설정**과 모션원 지정이 저장되지 않았을 수 있습니다. 둘 다 다시 확인하세요 |
| **이미 연동된 쇼핑몰입니다** | 같은 스마트스토어를 이 계정에 이미 연동했습니다. 같은 주문이 두 번 수집되지 않도록 저장하지 않습니다. **기존 연동으로 이동**을 누르세요 |

> [!TIP]
>
> 쇼핑몰 이름은 설정 화면 위쪽 경로 표시에서 이름을 눌러 바꿀 수 있습니다. 이 이름은 메시지 문구의 상점명 자리에 들어갑니다. [메시지 발송 설정](https://make.edicus.io/docs/link/messaging.md)을 보세요.

## 연동만으로는 주문이 들어오지 않습니다

연동을 마쳐도 바로 주문이 들어오지는 않습니다. Edicus Link는 아래 조건을 모두 만족하는 주문 항목만 가져옵니다.

| 조건 | 설명 |
| - | - |
| Edicus Link에 등록한 상품 | 주문한 상품을 이 쇼핑몰에 연결해 등록해 두어야 합니다. [상품 연동](https://make.edicus.io/docs/link/products.md) |
| 상품 상태가 **판매중** | Edicus Link의 **상품 연동** 화면에서 정하는 상태입니다. 스마트스토어의 판매 상태와는 따로입니다. **준비중**인 상품의 주문은 가져오지 않습니다 |
| 옵션 조합이 **무시**나 **미설정**이 아님 | 옵션 설정에서 **무시**나 **미설정**으로 둔 조합으로 들어온 주문 항목은 가져오지 않습니다. 스마트스토어에서 새로 생겨 아직 설정하지 않은 조합(**매핑 없음**)의 주문은 가져오지만, 구매자가 편집을 시작할 수 없습니다. [옵션 설정](https://make.edicus.io/docs/link/options.md) |
| 결제 완료 | 결제가 끝난 주문 항목만 새 주문으로 등록합니다. 무통장입금처럼 결제가 늦게 끝나는 주문은 입금이 확인된 뒤에 들어옵니다 |
| 계정이 이용 중 | **이용 중단**이나 **탈퇴 신청** 상태인 계정은 새 주문을 등록하지 않습니다. [계정 설정](https://make.edicus.io/docs/link/account.md) |

판매중 상품이 하나도 없으면 그 쇼핑몰은 주문 확인 자체를 쉽니다. 그래서 연동 직후에는 수집 상태가 **준비 중**으로 보이고, 첫 상품을 **판매중**으로 바꾼 뒤부터 주문을 가져옵니다.

> [!NOTE]
>
> 상품을 **판매중**으로 바꾸려면 결제수단이 등록되어 있어야 하고, 판매중 상품 수가 플랜 한도 안이어야 합니다. [이용료와 결제](https://make.edicus.io/docs/link/billing.md)를 보세요.

## 주문을 가져오는 주기

Edicus Link는 3분마다 연동한 쇼핑몰의 주문 변경 내역을 확인합니다. 새로 결제된 주문이 조건에 맞으면 그 회차에 주문을 등록하고, 같은 회차에 구매자에게 편집링크를 보냅니다.

```mermaid theme={null}
flowchart TD
    A["구매자가 스마트스토어에서 결제"] --> B["3분마다 주문 변경 내역 확인"]
    B --> C{"이 쇼핑몰에 판매중 상품이 있나"}
    C -->|없음| D["이번 회차는 건너뜀"]
    C -->|있음| E{"상품, 옵션, 결제 조건에 맞나"}
    E -->|아니오| F["가져오지 않음"]
    E -->|예| G["주문 등록"]
    G --> H["구매자에게 편집링크 발송"]
```

수집은 늘 "지금부터" 기준으로 진행합니다.

* 연동하기 전이나 판매중 상품이 없던 동안 결제된 주문을 거슬러 올라가 한꺼번에 가져오지 않습니다.
* 판매자 화면에는 지난 주문을 다시 불러오는 기능이 없습니다.

메시지가 나가는 방식은 [메시지 발송 설정](https://make.edicus.io/docs/link/messaging.md)에 있습니다.

## 수집 상태 확인

**쇼핑몰 연동** 목록의 카드 오른쪽 배지와, 쇼핑몰 설정 화면 맨 위의 상태 표시줄이 지금 주문을 가져오고 있는지 알려 줍니다. 상태 표시줄에는 스마트스토어 주소도 함께 나옵니다.

| 상태 | 화면 설명 | 뜻 |
| - | - | - |
| **수집 중** | 마지막 수집 시각(예: "3분 전") | 정상적으로 주문을 가져오고 있습니다 |
| **준비 중** | "상품을 판매중으로 바꾸면 주문을 가져오기 시작합니다." | 판매중 상품이 아직 한 번도 없었습니다. 연동 직후의 정상 상태입니다 |
| **수집 멈춤** | "판매중인 상품이 없어 새 주문을 가져오지 않습니다. 멈춘 동안 들어온 주문은 나중에도 가져올 수 없습니다." | 판매중 상품이 있다가 모두 사라졌습니다. 주문을 놓치고 있는 상태입니다 |
| **중지됨** | "새 주문을 가져오지 않습니다. 끈 동안 들어온 주문은 나중에도 가져올 수 없습니다." | 운영팀이 이 쇼핑몰의 수집을 꺼 둔 상태입니다 |

```mermaid theme={null}
stateDiagram-v2
    state "준비 중" as preparing
    state "수집 중" as collecting
    state "수집 멈춤" as halted
    [*] --> preparing: 연동 직후
    preparing --> collecting: 상품을 판매중으로 바꿈
    collecting --> halted: 판매중 상품이 모두 없어짐
    halted --> collecting: 다시 판매중으로 바꿈
```

**수집 중**인데 설정 화면의 마지막 수집 시각이 몇 분이 아니라 몇 시간 전으로 보이면, 주문 확인이 실패하고 있을 수 있습니다. 마지막 수집 시각은 확인에 성공했을 때만 바뀝니다. 설정 화면의 **API 연동** 섹션에서 **API 연동 정보 확인**을 눌러 보세요. "API 연동 정보가 유효하지 않습니다."가 뜨면 스마트스토어센터에서 모션원 지정이 풀렸는지 확인합니다. 마지막 수집 시각은 화면을 열 때 읽으므로 새로고침해야 최신 값이 보입니다.

### 수집을 잠시 멈추려면

쇼핑몰 설정 화면에는 판매자가 수집을 끄고 켜는 스위치가 없습니다. **중지됨** 상태를 풀어야 하면 [고객센터](https://make.edicus.io/help)에 요청하세요.

판매자가 직접 수집을 멈추는 방법은 이 쇼핑몰의 상품을 모두 **준비중**으로 바꾸는 것입니다. 상태가 **수집 멈춤**으로 바뀌고, 다시 **판매중**으로 바꾼 뒤부터 새 주문을 가져옵니다.

> [!WARNING]
>
> 멈춘 동안 결제된 주문은 다시 판매중으로 바꿔도 가져오지 않습니다. 이미 등록된 주문의 취소나 구매확정 같은 변화도 멈춘 동안에는 Edicus Link에 반영되지 않습니다. 계정 전체를 쉬려면 [계정 설정](https://make.edicus.io/docs/link/account.md)의 이용 중단을 보세요.

## 발주확인 시점

쇼핑몰 설정 화면의 **자동 처리** 섹션에서 스마트스토어 발주확인을 Edicus Link에 맡길지 정합니다. 쇼핑몰마다 따로 정하며, 새로 연동한 쇼핑몰은 꺼진 상태로 시작합니다.

| **자동 발주 확인** | 스마트스토어 발주확인 |
| - | - |
| 켬 | 구매자가 편집을 마치고 **제작 요청**을 하면 Edicus Link가 그 주문을 발주확인합니다 |
| 끔 (처음 값) | Edicus Link는 발주확인을 하지 않습니다. 스마트스토어센터에서 직접 처리합니다 |

화면 설명대로 발주 처리 뒤에는 구매자가 스마트스토어에서 직접 주문을 취소할 수 없습니다. 켜 두면 제작 요청이 들어온 시점에 맞춰 주문이 잠깁니다.

```mermaid theme={null}
sequenceDiagram
    participant B as 구매자
    participant S as 스마트스토어
    participant L as Edicus Link
    B->>S: 결제
    L->>S: 주문 확인(3분마다)
    L->>B: 편집링크 발송
    B->>L: 편집을 마치고 제작 요청
    L->>S: 발주확인(자동 발주 확인을 켰을 때)
```

* 스마트스토어에서 배송방법이 **배송없음**인 주문은 이 설정과 관계없이 결제되는 즉시 스마트스토어가 발주확인합니다.
* [테스트 주문](https://make.edicus.io/docs/link/test-order.md)은 자동 발주 확인을 켜 두어도 발주확인하지 않습니다.
* 발주확인이 실패해도 제작 요청은 그대로 진행됩니다. 발주확인 여부는 스마트스토어센터에서 확인하세요.

체크박스를 바꾸면 화면 위쪽이 "저장되지 않은 변경사항이 있습니다."로 바뀝니다. **저장**을 눌러야 반영됩니다.

## 취소, 배송, 구매확정 반영

Edicus Link는 주문을 가져오는 같은 3분 주기에, 이미 등록한 주문의 스마트스토어 상태 변화도 함께 반영합니다. 자세한 상태는 [주문 관리](https://make.edicus.io/docs/link/orders.md)에 있습니다.

| 스마트스토어에서 생긴 일 | Edicus Link 주문 상태 |
| - | - |
| 추가상품을 뺀 모든 주문 항목이 취소됨 | **취소됨** |
| 발송처리 또는 배송완료 | **배송 시작** |
| 취소, 반품을 뺀 모든 항목이 구매확정됨 | **구매확정** |

구매확정은 이용료 정산의 기준이 됩니다. [이용료와 결제](https://make.edicus.io/docs/link/billing.md)를 보세요.

## 여러 스마트스토어 연결

* **연동 추가**로 스마트스토어를 여러 개 연결할 수 있습니다. 같은 스마트스토어를 한 계정에 두 번 연동할 수는 없습니다.
* **자동 발주 확인**은 쇼핑몰마다 따로 정합니다.
* 메시지 발송 설정은 계정에 하나입니다. 모든 쇼핑몰의 주문에 같은 발송 수단과 문구를 쓰고, 상점명 자리에만 각 쇼핑몰 이름이 들어갑니다.
* 목록 카드의 ⋮ 메뉴에는 **설정**만 있습니다. 판매자 화면에서 연동을 지울 수는 없습니다.

## 예전 방식으로 연동한 쇼핑몰

예전에는 판매자가 커머스API센터에서 애플리케이션 ID와 시크릿을 발급받아 넣는 방식으로도 연동했습니다. 지금은 이 방식으로 새로 연동할 수 없습니다.

예전 방식 연동이 남아 있으면 Edicus Link 화면에 **쇼핑몰 연동 V2로 전환해 주세요** 창이 뜹니다. 이 창은 닫을 수 없고, **전환하러 가기**를 눌러야 넘어갑니다. 목록 카드에는 **전환 가능** 배지가 붙습니다.

**1. 쇼핑몰 설정 화면을 엽니다**

**전환하러 가기**를 누르거나, **쇼핑몰 연동** 목록에서 **전환 가능** 배지가 붙은 카드를 누릅니다.

**2. 스마트스토어센터에서 모션원을 지정합니다**

위 [연동하기](#연동하기)의 2, 3단계와 같습니다. **API 연동** 섹션의 안내에도 같은 내용이 있습니다.

**3. 판매자 ID를 확인하고 저장합니다**

**API 연동용 판매자ID**란에 붙여넣고 **API 연동 정보 확인**을 누릅니다. "유효한 API 연동 정보입니다."가 뜨면 화면 위쪽의 **저장**을 누릅니다. 저장하면 예전 애플리케이션 정보는 지워집니다.

## 됐는지 확인

> [!TIP]
>
> **쇼핑몰 연동** 목록에서 카드 배지가 **수집 중**이고, 설정 화면의 마지막 수집 시각이 몇 분 안쪽이면 주문을 가져오고 있는 것입니다. 실제 결제 없이 편집링크 발송까지 확인하려면 [테스트 주문](https://make.edicus.io/docs/link/test-order.md)을 넣어 보세요.

## 다음 단계

> **[메시지 발송 설정](https://make.edicus.io/docs/link/messaging.md)**
>
> 수집한 주문의 구매자에게 편집링크를 보낼 방법을 정합니다.

> **[상품 연동](https://make.edicus.io/docs/link/products.md)**
>
> 스마트스토어 상품을 등록하고 판매중으로 바꿉니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.