> For the complete documentation index, see [llms.txt](https://guide.hypercape.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.hypercape.com/brand-guide/form-events/undefined-11.md).

# 배송사 관리 페이지

## Part 11 · 배송사 관리 페이지

자주 쓰는 배송사를 미리 등록해 두고, 운송장 입력 시 드롭다운에서 빠르게 선택할 수 있도록 하는 페이지입니다.

<figure><img src="/files/p6VgFOPBMIZKwwK61zTA" alt=""><figcaption></figcaption></figure>

### 11-1. 진입 경로

| 방법           | 경로                                |
| ------------ | --------------------------------- |
| 폼 이벤트 목록     | 우상단의 🚚 **배송사 관리** 버튼 클릭          |
| 폼 이벤트 상세 페이지 | 헤더의 🚚 (Truck) 아이콘 클릭             |
| 직접 URL       | `/dashboard/form-events/carriers` |

페이지 제목은 **배송사 관리**, 부제는 **"경품 배송에 사용할 배송사를 관리합니다."** 입니다.

### 11-2. 페이지 헤더

| 위치  | 요소              | 동작                                |
| --- | --------------- | --------------------------------- |
| 좌상단 | **← 돌아가기** 아이콘  | 폼 이벤트 목록으로 복귀                     |
| 중앙  | 제목 + 부제         | "배송사 관리 / 경품 배송에 사용할 배송사를 관리합니다." |
| 우상단 | ➕ **배송사 추가** 버튼 | 추가 다이얼로그 열기                       |

### 11-3. 배송사 표 — 4개 컬럼

<figure><img src="/files/SSYkCJSc1d4bxk9mdbo7" alt=""><figcaption></figcaption></figure>

| 컬럼       | 너비        | 의미                                             |
| -------- | --------- | ---------------------------------------------- |
| **순서**   | 12px      | `sortOrder` 숫자 (작은 값이 위로 정렬)                   |
| **배송사명** | 가변        | 등록된 이름 (예: "CJ대한통운"). 비활성 상태면 옆에 회색 **비활성** 배지 |
| **활성**   | 24px      | **스위치 토글** — 즉시 활성/비활성 전환                      |
| **작업**   | 24px (우측) | **⋯ 드롭다운** — ✏️ 수정 / 🗑 삭제(빨강)                 |

#### 빈 상태

등록된 배송사가 0개면 표 대신 카드가 표시됩니다 — "**등록된 배송사가 없습니다.**" + 카드 안에 \[+ 배송사 추가] 버튼.

### 11-4. 배송사 추가 / 수정 다이얼로그

<figure><img src="/files/ciThLwOEgeBcZpZSfk06" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/7DoSBGKufvIcu9Z77tV0" alt=""><figcaption></figcaption></figure>

페이지 우상단 ➕ **배송사 추가** 버튼 또는 행의 ⋯ > **수정**을 누르면 같은 다이얼로그가 열립니다.

다이얼로그 제목 (🚚 트럭 아이콘과 함께):

* 추가 모드: **배송사 추가**
* 수정 모드: **배송사 수정**

#### 11-4-1. 입력 필드 (3개)

| 필드        | 입력 형식         | 비고                  |
| --------- | ------------- | ------------------- |
| **배송사명**  | 텍스트 (최대 100자) | 플레이스홀더: "예: CJ대한통운" |
| **정렬 순서** | 숫자 (최소 0)     | 작은 숫자가 드롭다운 위쪽에 노출됨 |
| **활성**    | 스위치           | 추가 시 기본 ON          |

#### 11-4-2. 하단 액션

| 버튼                              | 동작                       |
| ------------------------------- | ------------------------ |
| **취소**                          | 변경사항 버리고 닫기              |
| **추가** (추가 모드) / **저장** (수정 모드) | 변경사항 저장. 이름이 비어 있으면 비활성됨 |

### 11-5. 활성/비활성 토글 — 표에서 바로

<figure><img src="/files/OKZD68e74m25w3tPcf1c" alt=""><figcaption></figcaption></figure>

표의 **활성 컬럼 스위치**를 직접 클릭하면 다이얼로그를 열지 않고도 즉시 켜고 끌 수 있습니다. 토스트로 결과 안내가 표시됩니다.

* 활성 → 비활성: "배송사가 비활성화되었습니다."
* 비활성 → 활성: "배송사가 활성화되었습니다."

비활성 상태의 배송사는 **운송장 입력 드롭다운에서 노출되지 않습니다** (등록 데이터는 유지됨).

### 11-6. 배송사 삭제 🔴

행의 ⋯ 드롭다운 > **삭제** 클릭 → 즉시 삭제됩니다. 결과는 토스트로 안내됩니다.

> 🟡 **삭제 시 주의** 이미 그 배송사로 등록된 운송장 정보가 있어도 삭제됩니다. 운송장 데이터에 저장된 배송사명은 그대로 남지만, 향후 새 운송장 입력 시에는 이 배송사가 드롭다운에 더 이상 나타나지 않습니다.

### 11-7. 운송장 입력 시 어떻게 쓰이나요?

배송 정보 입력 시(Part 8-3 참고) **국제 배송사** 또는 **로컬 배송사** 드롭다운에 **활성 상태인 배송사들**이 정렬 순서대로 노출됩니다. 선택 후 운송장번호를 입력하면 됩니다.

> 💡 **자주 쓰는 배송사를 위로** 자주 쓰는 배송사를 작은 sortOrder 값으로 등록하면 운송장 입력 시 드롭다운 맨 위에 노출되어 클릭 횟수가 줄어듭니다 (예: 1=CJ대한통운, 2=DHL, 3=FedEx 등).