> 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 · 배송사 관리 페이지
자주 쓰는 배송사를 미리 등록해 두고, 운송장 입력 시 드롭다운에서 빠르게 선택할 수 있도록 하는 페이지입니다.
### 11-1. 진입 경로
| 방법 | 경로 |
| ------------ | --------------------------------- |
| 폼 이벤트 목록 | 우상단의 🚚 **배송사 관리** 버튼 클릭 |
| 폼 이벤트 상세 페이지 | 헤더의 🚚 (Truck) 아이콘 클릭 |
| 직접 URL | `/dashboard/form-events/carriers` |
페이지 제목은 **배송사 관리**, 부제는 **"경품 배송에 사용할 배송사를 관리합니다."** 입니다.
### 11-2. 페이지 헤더
| 위치 | 요소 | 동작 |
| --- | --------------- | --------------------------------- |
| 좌상단 | **← 돌아가기** 아이콘 | 폼 이벤트 목록으로 복귀 |
| 중앙 | 제목 + 부제 | "배송사 관리 / 경품 배송에 사용할 배송사를 관리합니다." |
| 우상단 | ➕ **배송사 추가** 버튼 | 추가 다이얼로그 열기 |
### 11-3. 배송사 표 — 4개 컬럼
| 컬럼 | 너비 | 의미 |
| -------- | --------- | ---------------------------------------------- |
| **순서** | 12px | `sortOrder` 숫자 (작은 값이 위로 정렬) |
| **배송사명** | 가변 | 등록된 이름 (예: "CJ대한통운"). 비활성 상태면 옆에 회색 **비활성** 배지 |
| **활성** | 24px | **스위치 토글** — 즉시 활성/비활성 전환 |
| **작업** | 24px (우측) | **⋯ 드롭다운** — ✏️ 수정 / 🗑 삭제(빨강) |
#### 빈 상태
등록된 배송사가 0개면 표 대신 카드가 표시됩니다 — "**등록된 배송사가 없습니다.**" + 카드 안에 \[+ 배송사 추가] 버튼.
### 11-4. 배송사 추가 / 수정 다이얼로그
페이지 우상단 ➕ **배송사 추가** 버튼 또는 행의 ⋯ > **수정**을 누르면 같은 다이얼로그가 열립니다.
다이얼로그 제목 (🚚 트럭 아이콘과 함께):
* 추가 모드: **배송사 추가**
* 수정 모드: **배송사 수정**
#### 11-4-1. 입력 필드 (3개)
| 필드 | 입력 형식 | 비고 |
| --------- | ------------- | ------------------- |
| **배송사명** | 텍스트 (최대 100자) | 플레이스홀더: "예: CJ대한통운" |
| **정렬 순서** | 숫자 (최소 0) | 작은 숫자가 드롭다운 위쪽에 노출됨 |
| **활성** | 스위치 | 추가 시 기본 ON |
#### 11-4-2. 하단 액션
| 버튼 | 동작 |
| ------------------------------- | ------------------------ |
| **취소** | 변경사항 버리고 닫기 |
| **추가** (추가 모드) / **저장** (수정 모드) | 변경사항 저장. 이름이 비어 있으면 비활성됨 |
### 11-5. 활성/비활성 토글 — 표에서 바로
표의 **활성 컬럼 스위치**를 직접 클릭하면 다이얼로그를 열지 않고도 즉시 켜고 끌 수 있습니다. 토스트로 결과 안내가 표시됩니다.
* 활성 → 비활성: "배송사가 비활성화되었습니다."
* 비활성 → 활성: "배송사가 활성화되었습니다."
비활성 상태의 배송사는 **운송장 입력 드롭다운에서 노출되지 않습니다** (등록 데이터는 유지됨).
### 11-6. 배송사 삭제 🔴
행의 ⋯ 드롭다운 > **삭제** 클릭 → 즉시 삭제됩니다. 결과는 토스트로 안내됩니다.
> 🟡 **삭제 시 주의** 이미 그 배송사로 등록된 운송장 정보가 있어도 삭제됩니다. 운송장 데이터에 저장된 배송사명은 그대로 남지만, 향후 새 운송장 입력 시에는 이 배송사가 드롭다운에 더 이상 나타나지 않습니다.
### 11-7. 운송장 입력 시 어떻게 쓰이나요?
배송 정보 입력 시(Part 8-3 참고) **국제 배송사** 또는 **로컬 배송사** 드롭다운에 **활성 상태인 배송사들**이 정렬 순서대로 노출됩니다. 선택 후 운송장번호를 입력하면 됩니다.
> 💡 **자주 쓰는 배송사를 위로** 자주 쓰는 배송사를 작은 sortOrder 값으로 등록하면 운송장 입력 시 드롭다운 맨 위에 노출되어 클릭 횟수가 줄어듭니다 (예: 1=CJ대한통운, 2=DHL, 3=FedEx 등).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://guide.hypercape.com/brand-guide/form-events/undefined-11.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.