Import Giảm khi mua nhiều
Nhập liệu hàng loạt chương trình giảm giá theo số lượng mua từ file Excel, hỗ trợ tạo mới và cập nhật dựa trên Mã chương trình.
Tính năng Import cho phép thêm hoặc cập nhật hàng loạt chương trình "Giảm khi mua nhiều" và các sản phẩm áp dụng từ file Excel. Hệ thống sẽ tự động tạo hoặc cập nhật thông tin dựa trên Mã chương trình.
Giao diện tổng thể
- Nút Import từ file Excel nằm ở cuối trang danh sách Khuyến mãi > Giảm khi mua nhiều.
- Sau khi chọn file, hệ thống xử lý và hiển thị modal Kết quả Import với:
- Số chương trình tạo mới / cập nhật thành công (dạng tag).
- Số lỗi (dạng tag đỏ), click để xem chi tiết.
- Bảng lỗi gom nhóm theo chương trình, click expand để xem chi tiết lỗi từng sản phẩm.
Định dạng file import
File import có thể là Excel (.xls, .xlsx) hoặc CSV (.csv). Tên tiêu đề cột phải khớp chính xác với file mẫu.
| Tên cột (đúng như file mẫu) | Bắt buộc nhập giá trị | Mô tả | Mã code |
|---|---|---|---|
| Tên chương trình | Có | Tên hiển thị của chương trình khuyến mãi | name |
| Mã chương trình | Có | Mã duy nhất, dùng để gom nhóm và upsert. Nhiều dòng cùng mã = 1 chương trình | code |
| Trạng thái | Không | Đang chạy / Chờ kích hoạt / Tạm ngưng. Mặc định: Đang chạy | status |
| Ngày bắt đầu | Không | Định dạng DD/MM/YYYY. Để trống = không thiết lập | date_started |
| Ngày kết thúc | Không | Định dạng DD/MM/YYYY. Để trống = không giới hạn | date_ended |
| Độ ưu tiên | Không | Số nguyên, ưu tiên cao hơn khi có nhiều chương trình trùng sản phẩm | priority |
| Chế độ áp dụng | Không | Cho phép cộng dồn / Không cộng dồn. Mặc định: Cho phép cộng dồn | stacking_mode |
| Cách áp dụng | Không | Tự động áp dụng / Nhập mã. Mặc định: Tự động áp dụng | redeem_type |
| Các mốc ưu đãi | Có | Danh sách mốc giảm giá. Định dạng: Mua từ X: Giảm Y%, phân cách bằng dấu | | discount_options_text |
| Mã SP áp dụng | Không | Mã sản phẩm trong module Sản phẩm. Để trống = chương trình không gắn SP | product_code |
| SKU | Không | Mã SKU variant. Nhiều SKU phân cách bằng dấu phẩy. Để trống = tất cả variant | product_sku |
| Giới hạn tổng | Không | Số lần sử dụng tối đa. Nhập 0 hoặc Không giới hạn = không giới hạn | limit_global_count |
| Giới hạn/ngày | Không | Số lần sử dụng tối đa mỗi ngày. Nhập 0 hoặc Không giới hạn = không giới hạn | limit_per_day_count |
File mẫu tải về
| Loại | File mẫu |
|---|---|
| Giảm khi mua nhiều | promotion_volume_discount_import_sample.xlsx |
Import chương trình
- Truy cập menu Khuyến mãi > Giảm khi mua nhiều.
- Nhấn nút Import từ file Excel (.xlsx, .xls) ở cuối trang danh sách.
- Nhấn Tải file mẫu trên giao diện để tải template (nếu chưa có), hoặc tải file mẫu ở bảng trên.
- Chuẩn bị file Excel theo đúng định dạng các cột yêu cầu.
- Chọn file từ máy tính để bắt đầu xử lý.
- Chờ hệ thống xử lý và hiển thị kết quả: Số chương trình đã tạo/cập nhật, số lỗi.
Quy tắc xử lý dữ liệu
Tạo mới và cập nhật (Upsert)
- Chương trình: Tìm theo Mã chương trình (code). Chưa tồn tại → tạo mới; đã tồn tại → cập nhật (tên, trạng thái, mốc ưu đãi, giới hạn, v.v.).
- Thông tin chương trình (tên, trạng thái, ngày, mốc ưu đãi...) lấy từ dòng đầu tiên của nhóm cùng mã.
- Import chỉ tạo mới và cập nhật; không xóa chương trình. Chương trình không nằm trong file không bị thay đổi.
Gom nhóm chương trình
- Các dòng có cùng Mã chương trình sẽ được gom thành 1 chương trình.
- Mỗi dòng tương ứng với 1 sản phẩm áp dụng của chương trình đó.
- Chương trình không có sản phẩm: 1 dòng duy nhất với cột Mã SP để trống.
Xử lý cột Mã SP và SKU
| Trường hợp | Mã SP | SKU | Kết quả |
|---|---|---|---|
| Áp dụng tất cả variant | SP001 | (để trống) | Sản phẩm SP001 với tất cả variant |
| Áp dụng 1 SKU cụ thể | SP002 | SP002-DEN-L | Chỉ variant "Đen, size L" |
| Áp dụng nhiều SKU | SP002 | SP002-DEN-L, SP002-TRANG-M | 2 variant cụ thể, phân cách bằng dấu phẩy |
| Không có sản phẩm | (để trống) | (để trống) | Chương trình không gắn sản phẩm |
- Mã SP phải khớp chính xác với Mã sản phẩm trong module Sản phẩm. Không tìm thấy → báo lỗi
error_product_not_found. - SKU phải khớp chính xác với mã SKU của biến thể thuộc sản phẩm. Không tìm thấy → báo lỗi
error_sku_not_found. - Khi sản phẩm đã được liên kết với chương trình trước đó, hệ thống sẽ gộp (merge) danh sách variant thay vì tạo trùng.
Xử lý cột Các mốc ưu đãi
Định dạng: Mua từ [số lượng]: Giảm [giá trị], nhiều mốc phân cách bằng dấu |.
Hỗ trợ 3 kiểu giảm giá:
| Kiểu giảm giá | Cú pháp | Ví dụ |
|---|---|---|
| Giảm theo phần trăm | Giảm X% | Mua từ 2: Giảm 5% |
| Giảm số tiền cố định | Giảm Xđ | Mua từ 3: Giảm 20.000đ |
| Giá cố định | Giá cố định Xđ | Mua từ 5: Giá cố định 50.000đ |
Trạng thái & hành vi hệ thống
- Trạng thái mặc định = Đang chạy nếu để trống. Các giá trị hợp lệ: Đang chạy, Chờ kích hoạt, Tạm ngưng.
- Chế độ áp dụng mặc định = Cho phép cộng dồn. Cách áp dụng mặc định = Tự động áp dụng.
- Giới hạn mặc định = 0 (không giới hạn). Chấp nhận số nguyên hoặc chuỗi "Không giới hạn".
- Chương trình chỉ được đếm là tạo mới/cập nhật thành công khi tất cả sản phẩm trong chương trình đó đều được xử lý không lỗi.
Khi cập nhật chương trình đã tồn tại, hệ thống ghi đè toàn bộ thông tin chương trình (tên, trạng thái, mốc ưu đãi, giới hạn...) từ file import. Đảm bảo dữ liệu trong file là chính xác và đầy đủ.
Lưu ý – Giới hạn – Lỗi thường gặp
- Mã chương trình phải duy nhất trong hệ thống và không để trống.
- Mã SP và SKU phải khớp chính xác với dữ liệu trong module Sản phẩm; hệ thống phân biệt chữ hoa/thường.
- Ngày bắt đầu/kết thúc theo định dạng DD/MM/YYYY. Sai định dạng → bỏ qua (không báo lỗi, giữ giá trị mặc định).
- Lỗi thường gặp: Khi xử lý từng dòng:
error_product_not_found(mã SP không tồn tại),error_sku_not_found(mã SKU không thuộc sản phẩm),error_update_promotion(lỗi cập nhật chương trình),error_create_promotion(lỗi tạo mới chương trình),error_add_product(lỗi liên kết sản phẩm). Lỗi validate trên frontend:Thiếu mã chương trình,Thiếu tên chương trình,Thiếu các mốc ưu đãi,Không thể parse mốc ưu đãi.
Phân quyền
- Xem danh sách: Cần quyền Xem khuyến mãi.
- Import: Cần quyền Quản lý khuyến mãi (
promotion.manage).