> 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-7.md).
# 배송 관리
## Part 8 · 배송 관리 (배송 탭)
이벤트 상세 페이지의 **배송** 탭에서는 선정된 응모자에게 제품을 발송하고, 운송장을 등록하고, 배송이 실패한 응모자를 별도로 관리합니다.
### 8-1. 두 줄 필터 — Shipping / Delivery
배송 탭 상단에는 **두 줄로 분리된 배지 필터**가 있습니다. 같은 응모자에 대해 "운송장이 등록되었는지(Shipping)" 와 "배송 가능한 상태인지(Delivery)" 라는 **두 개의 독립 상태**를 함께 봅니다.
#### 8-1-1. Shipping 필터 — 운송장 등록 여부
| 배지 | 색상 | 의미 |
| ----------- | ------------------- | --------------------- |
| **All** | 회색 | 선정자 전체 |
| **Shipped** | 초록 (📦 Package 아이콘) | 운송장 정보가 1개 이상 등록된 응모자 |
| **Pending** | 노랑 | 운송장이 아직 등록되지 않은 응모자 |
#### 8-1-2. Delivery 필터 — 배송 가능 여부
| 배지 | 색상 | 의미 |
| ----------------- | ----------------------- | ------------------ |
| **All** | 회색 | 전체 |
| **Deliverable** | 파랑 (✅ PackageCheck 아이콘) | 정상 배송 대상 |
| **Undeliverable** | 빨강 (❌ PackageX 아이콘) | 운영자가 배송불가로 마킹한 응모자 |
> 💡 **두 필터를 함께 쓸 수 있습니다** 예) "Shipping = Pending + Delivery = Deliverable" → 아직 발송 안 됐고 배송 가능한 응모자만 = **지금 발송해야 할 명단**
#### 8-1-3. 검색
필터 아래 검색창이 있습니다. 플레이스홀더는 "**Search by name, email, or tracking number...**" 이며 **이름·이메일·운송장번호** 세 가지를 동시에 검색합니다 (신청자 탭과 동일).
### 8-2. 배송 표 — 7개 컬럼
| 컬럼 | 표시되는 정보 |
| ------------------- | ------------------------------------------------------- |
| 체크박스 | 일괄 처리용 (일괄 액션 권한 있을 때만 표시) |
| **Name** | 응모자 이름 + (배송불가 시) 빨간 **Undeliverable** 배지 |
| **Email** | 연락처 이메일 |
| **Address** | 배송 주소 (한 줄로 압축, 마우스 호버 시 전체 표시) |
| **Carrier** | 등록된 배송사 (여러 개면 콤마로 묶어 표시) |
| **Tracking Number** | 운송장번호 + 추적 링크 🔗. 없으면 노랑 **Pending** 배지 (클릭하면 입력 다이얼로그) |
| **Delivery** | Undeliverable일 때 빨간 글씨로 사유 표시, 정상은 `-` |
| **Actions** (우측) | 배송불가 토글(PackageX/Undo2 아이콘) + **Edit / Enter** 버튼 |
> 💡 **행 배경 색** 배송불가로 마킹된 응모자 행은 **연한 빨간색 배경**으로 표시되어 한눈에 구분됩니다.
### 8-3. 단일 응모자 배송 정보 입력
배송 정보를 한 명씩 입력하는 방법입니다.
#### 8-3-1. 진입 경로 (3가지)
| 위치 | 동작 | 결과 |
| ------------ | ---------------------------------------------------------- | -------------- |
| 배송 탭 표 | Tracking Number 컬럼의 노랑 **Pending** 배지 클릭 | 배송 정보 입력 다이얼로그 |
| 배송 탭 표 | 우측 끝 **\[Enter]** 버튼 (운송장 없을 때) 또는 **\[Edit]** 버튼 (이미 등록됨) | 같은 다이얼로그 |
| 신청자 탭 응모자 상세 | 응모자 행 우측 👁 → 다이얼로그 본문의 **배송 정보 수정** 버튼 | 같은 다이얼로그 |
#### 8-3-2. 입력 다이얼로그의 필드 — 다중 운송장 지원
한 응모자에게 **여러 운송장 세트**를 등록할 수 있습니다. 한 세트는 다음 6개 필드로 구성됩니다.
| 필드 | 의미 |
| --------------------------- | ------------------------------------------------ |
| **배송사 (Carrier)** | 등록된 배송사 드롭다운에서 선택 (Part 12에서 미리 등록한 활성 배송사가 노출됨) |
| **운송장번호 (Tracking Number)** | 메인 추적번호 |
| **로컬 배송사** | 도착지 국가의 로컬 배송 파트너 (선택) |
| **로컬 운송장번호** | 국내 추적번호 (선택) |
| **발송일** | 실제 발송 일시 |
| **메모** | 패키지 내용·수량 등 자유 메모 (선택) |
> 💡 **국제·로컬 분리 운송장이 필요한 이유** 해외로 발송한 뒤 도착지 국가에서 로컬 택배사가 이어받는 경우(예: DHL → CJ대한통운), 두 개의 운송장으로 나눠 추적할 수 있게 합니다.
### 8-4. 일괄 배송 정보 업데이트 — 엑셀
여러 명의 운송장을 한 번에 업데이트하는 기능입니다. **신청자 탭의 \[일괄 작업] 버튼**을 통해서만 진입합니다 (배송 탭에는 별도 진입점이 없습니다).
#### 8-4-1. 진입 경로 (1가지)
이벤트 상세 헤더의 \[일괄 작업] 버튼\
↓\
\[정보 갱신] 카테고리 카드 클릭\
↓\
\[배송정보 일괄 업데이트] 카드 클릭\
↓\
일괄 작업 실행 다이얼로그
자세한 일괄 작업 다이얼로그 구조는 **Part 7-7** 참고.
#### 8-4-2. 처리 흐름 (3단계)
1. **템플릿 다운로드** — 이미 선정된 응모자가 한 줄씩 채워진 엑셀이 받아집니다
2. 엑셀에 **배송사·운송장번호·발송일** 등 입력 후 저장
3. 다이얼로그에 **엑셀 업로드** → 미리보기 단계 확인 → 실행 → 결과 리포트
> 🟡 **운송장이 비어 있는 행은 무시됩니다** 엑셀에서 운송장번호 필드를 비워둔 응모자는 업데이트되지 않습니다 (안전 장치).
### 8-5. 배송불가 (Undeliverable) 관리
배송이 실패한 응모자를 별도로 표시해 정상 응모자와 구분하는 기능입니다.
#### 8-5-1. 배송불가 사유 8가지
| 라벨 | 의미 |
| ---------------------------- | ------------- |
| **Customs Duty Unpaid** | 관부가세 미납·납부 거절 |
| **Customs Clearance Failed** | 통관 미협조 |
| **Invalid Address** | 주소 불명 |
| **Recipient Unavailable** | 수취인 부재·미응답 |
| **Delivery Refused** | 수취 거절 |
| **Lost** | 분실 |
| **Damaged** | 파손 |
| **Other** | 기타 (직접 사유 입력) |
> 💡 **라벨이 모두 영문**입니다. 시스템 차원의 표준 코드라 한국어 번역 라벨이 따로 없습니다.
#### 8-5-2. 개별 마킹 — 1명씩 처리
배송 탭 표의 행 **우측 끝 작업 영역**에 마킹 토글이 있습니다.
| 현재 상태 | 노출되는 버튼 | 클릭 시 |
| ----- | ------------------------------------------------------- | ------------------------------- |
| 정상 | 회색 **PackageX 아이콘** (📦) — 호버 시 "Mark as undeliverable" | 8가지 사유 드롭다운이 열림 → 사유 선택 → 즉시 마킹 |
| 배송불가 | 빨간 **Undo2 아이콘** (↩) — "Mark as deliverable" | 즉시 해제 (사유 묻지 않음) |
마킹된 행은 **연한 빨간색 배경**으로 바뀌고, Name 컬럼 옆에 **Undeliverable** 배지가 추가됩니다.
#### 8-5-3. 일괄 마킹 — 여러 명을 한 번에
배송 탭 표에서 **체크박스로 여러 명 선택** 시, 검색창 우측에 일괄 액션이 나타납니다.
| 버튼 | 동작 |
| ----------------------------- | -------------------------------------- |
| ❌ **Mark Undeliverable** (빨강) | 8가지 사유 드롭다운 → 선택 → 모든 대상에 같은 사유로 일괄 마킹 |
| ↩ **Mark Deliverable** | 선택한 응모자의 배송불가 일괄 해제 |
#### 8-5-4. 배송불가 마킹의 효과
* 응모자가 **Undeliverable** 상태로 표시됨 (행 빨간 배경 + Name 옆 배지)
* **Delivery 필터**에서 별도로 분리되어 한눈에 추적
* **콘텐츠 제출 리마인더 이메일 발송에서 자동 제외**
* 마킹 해제 시 다시 정상 응모자로 복귀
> 🟡 **콘텐츠 리마인더 자동 제외가 중요한 이유** 배송이 실패한 응모자에게 "콘텐츠 제출해 주세요" 리마인더가 가면 혼란을 줍니다. 배송불가 마킹은 이런 잘못된 자동 발송을 막아주는 안전 장치입니다.