> 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 필터**에서 별도로 분리되어 한눈에 추적
* **콘텐츠 제출 리마인더 이메일 발송에서 자동 제외**
* 마킹 해제 시 다시 정상 응모자로 복귀
> 🟡 **콘텐츠 리마인더 자동 제외가 중요한 이유** 배송이 실패한 응모자에게 "콘텐츠 제출해 주세요" 리마인더가 가면 혼란을 줍니다. 배송불가 마킹은 이런 잘못된 자동 발송을 막아주는 안전 장치입니다.
---
# 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-7.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.