# 🚀 HƯỚNG DẪN IMPORT KOC TỪNG BƯỚC

## 📍 Link Import: https://vananglobal.com.vn/koc/bulk-import

---

## BƯỚC 1: TẢI FILE MẪU

### Cách 1: Tải từ trang web
1. Truy cập: https://vananglobal.com.vn/koc/bulk-import
2. Tìm phần "📥 Tải Template Mẫu"
3. Click vào link **"Template CSV"** để tải file mẫu

### Cách 2: Tải trực tiếp
- File CSV: https://vananglobal.com.vn/KOC_IMPORT_TEMPLATE_SUA_CONG_THUC.csv
- File hướng dẫn: https://vananglobal.com.vn/HUONG_DAN_IMPORT_KOC_SUA_CONG_THUC.md

---

## BƯỚC 2: MỞ FILE VÀ CHUẨN BỊ

### Mở file bằng Excel:
1. Mở Microsoft Excel
2. File > Open > chọn file CSV vừa tải
3. Chọn encoding: **UTF-8**
4. Click OK

### Xóa dữ liệu mẫu:
- Xóa 3 dòng mẫu (dòng 2, 3, 4)
- Giữ lại dòng tiêu đề (dòng 1)

---

## BƯỚC 3: HIỂU CẤU TRÚC FILE (29 CỘT)

### Dòng tiêu đề (Header) - KHÔNG XÓA:
```
STT | Họ Tên KOC (*) | Số Điện Thoại | Email | CCCD | Zalo | Địa Chỉ | Tỉnh/Thành | 
Tên Con 1 | Ngày Sinh Con 1 | Giới Tính Con 1 | Ghi Chú Con 1 |
Tên Con 2 | Ngày Sinh Con 2 | Giới Tính Con 2 | Ghi Chú Con 2 |
TikTok Link (*) | Facebook Link | Instagram Link | Threads Link | YouTube Link |
Danh Mục (*) | Người Phụ Trách | Tình Trạng Hợp Tác |
Cấp Độ KOC | Loại Hợp Tác | Tham Gia Incentive | KOC Tổng Hợp | Ghi Chú Chung
```

### Ký hiệu (*) = BẮT BUỘC phải điền

---

## BƯỚC 4: ĐIỀN DỮ LIỆU TỪNG CỘT

### CỘT 1: STT
- **Loại:** Số thứ tự
- **Bắt buộc:** Không
- **Cách điền:** 1, 2, 3, 4...
- **Ví dụ:** `1`

### CỘT 2: Họ Tên KOC (*) - BẮT BUỘC
- **Loại:** Text
- **Bắt buộc:** CÓ
- **Cách điền:** Họ và tên đầy đủ
- **Ví dụ:** `Nguyễn Thị Lan`
- **Lưu ý:** Viết hoa chữ cái đầu

### CỘT 3: Số Điện Thoại
- **Loại:** Text/Number
- **Bắt buộc:** Nên có
- **Cách điền:** 10 số, bắt đầu bằng 0
- **Ví dụ:** `0912345678`
- **Lưu ý:** Không có khoảng trắng, không có dấu gạch ngang

### CỘT 4: Email
- **Loại:** Email
- **Bắt buộc:** Không
- **Cách điền:** Email hợp lệ
- **Ví dụ:** `lan@gmail.com`

### CỘT 5: CCCD
- **Loại:** Text/Number
- **Bắt buộc:** Nên có
- **Cách điền:** 12 số
- **Ví dụ:** `001234567890`
- **Lưu ý:** Dùng để kiểm tra trùng lặp

### CỘT 6: Zalo
- **Loại:** Text/Number
- **Bắt buộc:** Không
- **Cách điền:** Số điện thoại Zalo
- **Ví dụ:** `0912345678`

### CỘT 7: Địa Chỉ
- **Loại:** Text
- **Bắt buộc:** Không
- **Cách điền:** Địa chỉ đầy đủ
- **Ví dụ:** `123 Nguyễn Huệ, Quận 1`

### CỘT 8: Tỉnh/Thành
- **Loại:** Text
- **Bắt buộc:** Nên có
- **Cách điền:** Tên tỉnh/thành phố
- **Ví dụ:** `TP.HCM`, `Hà Nội`, `Đà Nẵng`
- **Lưu ý:** Dùng để phân vùng tập trung

---

### CỘT 9-12: THÔNG TIN CON 1 (Quan trọng cho Sữa Công Thức)

#### CỘT 9: Tên Con 1
- **Loại:** Text
- **Bắt buộc:** Nên có
- **Cách điền:** Tên gọi của con
- **Ví dụ:** `Bé Minh`, `Bé An`, `Con Lan`

#### CỘT 10: Ngày Sinh Con 1
- **Loại:** Date
- **Bắt buộc:** Nên có
- **Cách điền:** DD/MM/YYYY
- **Ví dụ:** `15/03/2023` (15 tháng 3 năm 2023)
- **Lưu ý đặc biệt:**
  - Nếu ngày TƯƠNG LAI → KOC đang bầu (dự sinh)
  - Ví dụ: `20/05/2026` → Mẹ bầu, dự sinh tháng 5/2026
  - Hệ thống sẽ tự động tính tuổi con

#### CỘT 11: Giới Tính Con 1
- **Loại:** Text
- **Bắt buộc:** Không
- **Cách điền:** `Nam` hoặc `Nữ`
- **Ví dụ:** `Nam`

#### CỘT 12: Ghi Chú Con 1
- **Loại:** Text
- **Bắt buộc:** Không
- **Cách điền:** Thông tin đặc biệt về con
- **Ví dụ:** `Sinh thường`, `Dị ứng lactose`, `Sinh non`, `Cân nặng thấp`

---

### CỘT 13-16: THÔNG TIN CON 2 (Nếu có)
- Tương tự như Con 1
- Chỉ điền nếu KOC có 2 con trở lên

---

### CỘT 17-21: KÊNH MẠNG XÃ HỘI

#### CỘT 17: TikTok Link (*) - BẮT BUỘC (nếu không có Facebook)
- **Loại:** URL
- **Bắt buộc:** CÓ (nếu không có Facebook)
- **Cách điền:** Link profile đầy đủ
- **Ví dụ đúng:** `https://www.tiktok.com/@mebimsuaofficial`
- **Ví dụ sai:** `@mebimsuaofficial` (thiếu https://)
- **Lưu ý:** Phải là link PROFILE, không phải link video

#### CỘT 18: Facebook Link - BẮT BUỘC (nếu không có TikTok)
- **Loại:** URL
- **Bắt buộc:** CÓ (nếu không có TikTok)
- **Cách điền:** Link profile/page đầy đủ
- **Ví dụ đúng:** `https://www.facebook.com/mebimsuaofficial`
- **Ví dụ sai:** `facebook.com/mebimsuaofficial` (thiếu https://)

#### CỘT 19: Instagram Link
- **Loại:** URL
- **Bắt buộc:** Không
- **Ví dụ:** `https://www.instagram.com/reviewsuachobe`

#### CỘT 20: Threads Link
- **Loại:** URL
- **Bắt buộc:** Không
- **Ví dụ:** `https://www.threads.net/@username`

#### CỘT 21: YouTube Link
- **Loại:** URL
- **Bắt buộc:** Không
- **Ví dụ:** `https://www.youtube.com/@username`

**⚠️ QUY TẮC:** Phải có ít nhất 1 trong 2: TikTok HOẶC Facebook

---

### CỘT 22: Danh Mục (*) - BẮT BUỘC
- **Loại:** Text
- **Bắt buộc:** CÓ
- **Cách điền:** Viết CHÍNH XÁC 1 trong 2 giá trị:
  - `Sữa công thức bò`
  - `Sữa công thức dê`
- **Ví dụ đúng:** `Sữa công thức bò`
- **Ví dụ sai:** `sua cong thuc bo` (không dấu)
- **Ví dụ sai:** `Sữa bò` (viết tắt)
- **Lưu ý:** Copy chính xác từ đây, có dấu, có khoảng trắng

### CỘT 23: Người Phụ Trách (ME)
- **Loại:** Text
- **Bắt buộc:** Nên có
- **Cách điền:** Họ tên đầy đủ của ME
- **Ví dụ:** `Nguyễn Thanh Ngân`, `Phạm Ngọc Quyền`
- **Lưu ý:** Phải là tên ME có trong hệ thống (Role = ME)

### CỘT 24: Tình Trạng Hợp Tác
- **Loại:** Text
- **Bắt buộc:** Không
- **Cách điền:** Mô tả trạng thái hiện tại
- **Ví dụ:**
  - `Đã lên bài sau khi nhận quà`
  - `Đã nhận quà chưa rep`
  - `Đã liên hệ đang chờ rep`
  - `Chưa liên hệ`

---

### CỘT 25: Cấp Độ KOC (1=Cơ Bản/2=Mở Rộng)
- **Loại:** Number
- **Bắt buộc:** Không
- **Cách điền:** Nhập số `1` hoặc `2`
  - `1` = KOC Cơ Bản (KOC nhỏ, ảnh hưởng hạn chế)
  - `2` = KOC Mở Rộng (KOC lớn, ảnh hưởng rộng)
- **Ví dụ:** `1`
- **Để trống:** Nếu chưa đánh giá

### CỘT 26: Loại Hợp Tác (Cast/Non-Cast)
- **Loại:** Text
- **Bắt buộc:** Không
- **Cách điền:** `Cast` hoặc `Non-Cast`
  - `Cast` = KOC được trả phí
  - `Non-Cast` = KOC chỉ nhận quà
- **Ví dụ:** `Cast`

### CỘT 27: Tham Gia Incentive (Có/Không)
- **Loại:** Text
- **Bắt buộc:** Không
- **Cách điền:** `Có` hoặc `Không`
- **Ví dụ:** `Có`
- **Mặc định:** `Không`

### CỘT 28: KOC Tổng Hợp (Có/Không)
- **Loại:** Text
- **Bắt buộc:** Không
- **Cách điền:** `Có` hoặc `Không`
- **Ví dụ:** `Không`
- **Mặc định:** `Không`

### CỘT 29: Ghi Chú Chung
- **Loại:** Text
- **Bắt buộc:** Không
- **Cách điền:** Ghi chú bổ sung
- **Ví dụ:** `KOC tiềm năng`, `Mẹ 2 con`, `Nhiệt tình`

---

## BƯỚC 5: VÍ DỤ 1 DÒNG ĐẦY ĐỦ

```
1,Nguyễn Thị Lan,0912345678,lan@gmail.com,001234567890,0912345678,"123 Nguyễn Huệ, Q1",TP.HCM,Bé Minh,15/03/2023,Nam,Sinh thường,Bé An,20/08/2021,Nữ,Dị ứng lactose,https://www.tiktok.com/@mebimsuaofficial,https://www.facebook.com/mebimsuaofficial,,,,"Sữa công thức bò",Nguyễn Thanh Ngân,Đã lên bài sau khi nhận quà,1,Cast,Có,Không,KOC tiềm năng
```

### Giải thích dòng trên:
- STT: 1
- Tên: Nguyễn Thị Lan
- SĐT: 0912345678
- Email: lan@gmail.com
- CCCD: 001234567890
- Zalo: 0912345678
- Địa chỉ: 123 Nguyễn Huệ, Q1
- Tỉnh: TP.HCM
- Con 1: Bé Minh, sinh 15/03/2023, Nam, Sinh thường
- Con 2: Bé An, sinh 20/08/2021, Nữ, Dị ứng lactose
- TikTok: https://www.tiktok.com/@mebimsuaofficial
- Facebook: https://www.facebook.com/mebimsuaofficial
- Instagram, Threads, YouTube: để trống
- Danh mục: Sữa công thức bò
- ME: Nguyễn Thanh Ngân
- Tình trạng: Đã lên bài sau khi nhận quà
- Cấp độ: 1 (Cơ bản)
- Loại: Cast
- Incentive: Có
- Tổng hợp: Không
- Ghi chú: KOC tiềm năng

---

## BƯỚC 6: LƯU FILE

### Lưu dạng Excel (.xlsx) - KHUYẾN NGHỊ:
1. File > Save As
2. Chọn định dạng: **Excel Workbook (.xlsx)**
3. Đặt tên: `KOC_Import_[Ngay].xlsx`
4. Click Save

### Lưu dạng CSV (nếu cần):
1. File > Save As
2. Chọn định dạng: **CSV UTF-8 (Comma delimited) (.csv)**
3. Đặt tên: `KOC_Import_[Ngay].csv`
4. Click Save
5. **Quan trọng:** Chọn encoding **UTF-8 with BOM**

---

## BƯỚC 7: UPLOAD LÊN HỆ THỐNG

### 7.1. Truy cập trang import:
- Link: https://vananglobal.com.vn/koc/bulk-import
- Hoặc: Sidebar > Danh sách KOC > Upload hàng loạt

### 7.2. Chọn file:
1. Click nút **"Chọn file Excel (.xlsx)"**
2. Chọn file vừa lưu
3. Click **Open**

### 7.3. Kiểm tra trước khi upload:
- Tên file hiển thị đúng
- Kích thước file hợp lý (< 5MB)

### 7.4. Bắt đầu import:
1. Click nút **"Bắt đầu import"**
2. Đợi hệ thống xử lý (có thể mất 1-5 phút)
3. **KHÔNG TẮT TRANG** trong lúc xử lý

---

## BƯỚC 8: KIỂM TRA KẾT QUẢ

### Sau khi import xong, hệ thống hiển thị:

#### Thống kê tổng quan:
- ✅ **Tổng số dòng:** Tổng dòng trong file
- ✅ **Thành công:** Số KOC đã tạo thành công
- ❌ **Lỗi:** Số dòng bị lỗi
- ⚠️ **Bỏ qua:** Số dòng bị bỏ qua (trùng lặp)

#### Bảng chi tiết:
Mỗi dòng hiển thị:
- **Dòng:** Số dòng trong file Excel
- **STT:** Số thứ tự
- **Tên Kênh:** Tên KOC
- **Trạng thái:** Thành công / Lỗi
- **Thông báo:** Lý do lỗi (nếu có)

### Các lỗi thường gặp:

| Thông báo lỗi | Nguyên nhân | Cách sửa |
|---------------|-------------|----------|
| "Thiếu tên kênh" | Cột 2 để trống | Điền tên KOC |
| "Thiếu link social" | Không có TikTok và Facebook | Điền ít nhất 1 link |
| "Danh mục không hợp lệ" | Viết sai danh mục | Copy chính xác: "Sữa công thức bò" |
| "KOC đã tồn tại" | Trùng SĐT hoặc CCCD | Kiểm tra lại hoặc cập nhật KOC cũ |
| "Người phụ trách không tồn tại" | Tên ME không có trong hệ thống | Để trống hoặc sửa tên ME |
| "Ngày sinh không hợp lệ" | Sai format ngày | Dùng DD/MM/YYYY |

---

## BƯỚC 9: XỬ LÝ LỖI (Nếu có)

### Nếu có dòng lỗi:
1. **Tải lại file Excel gốc**
2. **Sửa các dòng bị lỗi** theo thông báo
3. **Xóa các dòng đã thành công** (để tránh trùng)
4. **Upload lại** chỉ các dòng đã sửa

### Ví dụ:
- File có 100 dòng
- Import lần 1: 80 thành công, 20 lỗi
- Sửa 20 dòng lỗi
- Upload lại file chỉ có 20 dòng đã sửa

---

## BƯỚC 10: KIỂM TRA KOC ĐÃ TẠO

### 10.1. Vào danh sách KOC:
- Sidebar > Danh sách KOC
- Hoặc: https://vananglobal.com.vn/koc

### 10.2. Lọc theo tab:
- Click tab **"Sữa công thức"** để xem KOC sữa công thức
- Click tab **"Ăn dặm"** để xem KOC ăn dặm

### 10.3. Kiểm tra thông tin:
- Tên KOC hiển thị đúng
- Thông tin con hiển thị đúng
- Link social hiển thị đúng
- Người phụ trách được assign đúng

---

## 📌 CHECKLIST TRƯỚC KHI IMPORT

### ✅ Kiểm tra dữ liệu:
- [ ] Tất cả dòng có **Họ Tên KOC**
- [ ] Tất cả dòng có **TikTok HOẶC Facebook Link**
- [ ] Tất cả dòng có **Danh Mục** viết đúng
- [ ] Ngày sinh con đúng format: **DD/MM/YYYY**
- [ ] Link social đầy đủ (có https://)
- [ ] Số điện thoại không có khoảng trắng
- [ ] Tên ME có trong hệ thống

### ✅ Kiểm tra file:
- [ ] File lưu dạng **.xlsx** (khuyến nghị)
- [ ] Dòng tiêu đề không bị xóa
- [ ] Không có dòng trống giữa dữ liệu
- [ ] Kích thước file < 5MB

---

## 💡 MẸO IMPORT HIỆU QUẢ

### 1. Import từng đợt nhỏ:
- Đợt 1: 10-20 dòng test
- Kiểm tra kết quả
- Đợt 2: Import toàn bộ

### 2. Chuẩn bị dữ liệu trước:
- Làm sạch số điện thoại
- Chuẩn hóa link social
- Kiểm tra tên ME

### 3. Sao lưu file gốc:
- Giữ 1 bản backup
- Để import lại nếu cần

### 4. Phân loại KOC:
- **KOC Bầu:** Ngày sinh con là tương lai
- **Vùng tập trung:** TP.HCM, Đà Nẵng, Khánh Hòa, Đắk Lắk
- **KOC Incentive:** Đánh dấu "Có"

---

## ❓ CÂU HỎI THƯỜNG GẶP

### Q1: File CSV hay Excel tốt hơn?
**A:** Khuyến nghị dùng **Excel (.xlsx)** vì:
- Không lo lỗi encoding
- Dễ chỉnh sửa
- Hỗ trợ format tốt hơn

### Q2: Import được tối đa bao nhiêu dòng?
**A:** Không giới hạn, nhưng khuyến nghị:
- < 500 dòng/lần để xử lý nhanh
- Nếu > 500 dòng, chia thành nhiều file

### Q3: Làm sao biết KOC đã tồn tại?
**A:** Hệ thống check trùng theo:
- Số điện thoại
- CCCD
- Link social (TikTok/Facebook)

### Q4: Import lỗi có mất dữ liệu không?
**A:** KHÔNG. Chỉ các dòng thành công mới được lưu.

### Q5: Có thể import KOC Ăn Dặm không?
**A:** CÓ. Chỉ cần đổi cột "Danh Mục" thành danh mục Ăn Dặm.

---

## 📞 HỖ TRỢ

### Nếu gặp vấn đề:
- **Email:** info@hoai.name.vn
- **Hotline:** 0798869696
- **Hoặc:** Liên hệ Hoài đẹp trai

---

## 🎉 HOÀN THÀNH!

Chúc bạn import thành công! Nếu có thắc mắc, đừng ngại liên hệ hỗ trợ.

**Cập nhật:** 31/01/2026