Import sản phẩm

Tính năng Import sản phẩm cho phép thêm hoặc cập nhật hàng loạt sản phẩm và biến thể 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ã sản phẩm và SKU.

Vị trí trên menu admin

• Sản phẩm > Tất cả sản phẩm — nút Import trên thanh công cụ, chọn tuỳ chọn import sản phẩm và biến thể để vào màn nhập file.

Giao diện tổng thể

• Màn hình import bao gồm 3 bước: Tải lên file, Kiểm tra dữ liệu, Xác nhận import.
• Hiển thị bảng preview dữ liệu với highlight lỗi nếu có.
• Sidebar bên phải hiển thị thống kê: Số dòng hợp lệ, số lỗi, cảnh báo.
• Nút tải file mẫu Excel nằm ở góc trên phải.

Định dạng file import

File import có thể là Excel (.xls, .xlsx) hoặc CSV (.csv). Giới hạn: dung lượng tối đa 10 MB, tối đa 20.000 dòng dữ liệu (trừ dòng tiêu đề). Tên tiêu đề cột phải khớp chính xác với file mẫu. Thiếu cột bắt buộc sẽ bị báo lỗi ngay khi tải file.

Import sản phẩm

1. Truy cập menu Sản phẩm > Tất cả sản phẩm.
2. Nhấn nút Import trên thanh công cụ, chọn tuỳ chọn "Import sản phẩm & biến thể" để tới trang Import sản phẩm.
3. Nhấn Tải file mẫu Excel trên giao diện để tải template (nếu chưa có), hoặc tải file mẫu theo ngành hàng ở mục File mẫu tải về bên dưới.
4. Chuẩn bị file Excel theo đúng định dạng các cột yêu cầu.
5. Nhấn Chọn file từ máy tính để mở cửa sổ chọn file Excel từ máy tính của bạn.
6. Nhấn Bắt đầu Import dữ liệu để upload file và bắt đầu xử lý. Nếu có lỗi thiếu cột hoặc sai cột, hãy kiểm tra ở bước này.
7. Chờ hệ thống xử lý và hiển thị kết quả: Số sản phẩm đã tạo/cập nhật.

File mẫu tải về

Các file Excel mẫu theo ngành hàng để tham khảo định dạng cột và dữ liệu. Tải về, chỉnh sửa theo nhu cầu rồi dùng để import.

Quy tắc xử lý dữ liệu

Tạo mới và cập nhật

• Sản phẩm: Tìm theo Mã sản phẩm. Chưa tồn tại thì tạo mới; đã tồn tại thì cập nhật thông tin từ file.
• Loại sản phẩm & Cách bán cân ký: Import cho phép chuyển sản phẩm thường sang hàng cân ký hoặc ngược lại nếu dữ liệu trong file hợp lệ.
• Tên sản phẩm không được trùng với sản phẩm khác trong cùng công ty; nếu trùng, hệ thống báo lỗi và không lưu dòng đó.
• Mô tả: Khi cập nhật, chỉ ghi đè nếu sản phẩm hiện tại chưa có mô tả; khi tạo mới luôn lấy từ file.
• Tag: Chỉ ghi đè khi cột Tag trong file không để trống; nếu để trống khi cập nhật thì giữ nguyên tag hiện có.
• Hình ảnh: Chỉ tải và gán khi sản phẩm chưa có hình đại diện; nếu đã có ảnh thì cột Hình sản phẩm bị bỏ qua. Hình đầu tiên trong danh sách URL được đặt làm ảnh đại diện.
• Biến thể: Tìm theo cặp (sản phẩm, SKU). SKU trống thì hệ thống dùng Mã sản phẩm làm SKU. Chưa tồn tại thì tạo biến thể mới; đã tồn tại thì cập nhật giá và thông tin biến thể. Các cột Mã vạch, Tên riêng biến thể, Ghi chú biến thể, Giá so sánh, Tồn tối thiểu, Theo dõi serial, Chiều dài (mm) / Chiều rộng (mm) / Chiều cao (mm) và Khối lượng biến thể (gram) được gán trực tiếp cho biến thể nếu có trong file.

Gom nhóm sản phẩm

• Các dòng có cùng Mã sản phẩm sẽ được gom thành 1 sản phẩm.
• Mỗi dòng tương ứng với 1 biến thể hoặc 1 đơn vị tính của sản phẩm đó.
• Sản phẩm có nhiều đơn vị tính: Các dòng có cùng thuộc tính nhưng khác đơn vị tính.
• Sản phẩm có nhiều biến thể: Các dòng có thuộc tính khác nhau.

Xử lý đơn vị tính

• Chỉ áp dụng cho sản phẩm đơn vị tính. Dòng có Hệ số quy đổi = 1 là đơn vị cơ bản; hệ số lớn hơn 1 là đơn vị phụ, ví dụ Thùng = 10 Bịch.
• Giá bán trong file tương ứng với đơn vị tính của dòng đó.

Xử lý thuộc tính

• Định dạng: Tên thuộc tính : Giá trị. Nhiều cặp cách nhau bởi dấu phẩy (,) hoặc dấu sổ dọc (|). VD: Màu: Đen, Size: XL hoặc Màu: Đen|Size: XL.
• Hệ thống tự động tạo thuộc tính và giá trị thuộc tính nếu chưa tồn tại. Các thuộc tính của biến thể được gộp lại hiển thị trên sản phẩm.

Lưu ý đối với sản phẩm cân ký

• Với hàng cân ký, cột Đơn vị tính trong file không dùng; hệ thống dùng đơn vị Gram từ cài đặt.
• Cách bán cân ký phải là bán theo khối lượng hoặc bán theo số lượng; nếu nhập giá trị khác, hệ thống báo lỗi dữ liệu không hợp lệ.
• Catch-weight (Cân & đếm): Khi bán theo số lượng, có thể khai báo thêm Đơn vị catchweight và Hệ số catchweight. Nếu 2 cột này để trống, sản phẩm vẫn tạo được nhưng thiếu thông tin cân và đếm.
• Giá bán trong file là giá cho 1 kg; hệ thống lưu giá cho 1 gram (chia 1000).
• Khối lượng (gram) không dùng cho sản phẩm cân ký; hệ thống tự đặt = 1 (1 gram).
• Sản phẩm cân ký không dùng cột Đơn vị tính, Hệ số quy đổi, Khối lượng (gram) trong file.

Trạng thái & hành vi hệ thống

• Trạng thái sản phẩm mặc định là Đang kinh doanh nếu để trống.
• Loại sản phẩm mặc định là sản phẩm thường nếu để trống; với hàng cân ký, cách bán mặc định là bán theo khối lượng.
• Cách tính giá hỗ trợ Giá chuẩn và Báo giá sau. Nếu để trống thì mặc định là Giá chuẩn.
• Danh mục (3 cấp, phân cách >>) được tự tạo nếu chưa có. Thương hiệu và Nhà cung cấp (nhiều nhà cung cấp cách nhau dấu phẩy) tự tạo nếu chưa tồn tại.
• Hình ảnh chỉ tải và gán khi sản phẩm chưa có hình đại diện. Tag chỉ ghi đè khi cột Tag không trống; tag mới được tạo nếu chưa có trong hệ thống.
• Sau khi tải file, hệ thống xử lý dữ liệu theo từng phần và hiển thị kết quả để người dùng kiểm tra.

Lưu ý - Giới hạn - Lỗi thường gặp

• Giới hạn file: Định dạng .xls, .xlsx, .csv; dung lượng tối đa 10 MB; số dòng dữ liệu tối đa 20.000. Tiêu đề cột phải khớp chính xác với file mẫu.
• Mã sản phẩm và SKU nên dùng chữ, số, dấu gạch ngang hoặc gạch dưới; tránh ký tự đặc biệt. Tên sản phẩm không được trùng với sản phẩm khác trong cùng công ty.
• Giá bán nhập số (số nguyên); với sản phẩm cân ký là giá/1 kg, hệ thống tự chia 1000 khi lưu.
• URL hình ảnh phải hợp lệ và truy cập được; hệ thống tạo/tìm file từ URL. Nếu sản phẩm đã có hình đại diện thì cột Hình sản phẩm bị bỏ qua.
• Import chỉ tạo mới và cập nhật; không xoá sản phẩm. Sản phẩm không nằm trong file không bị thay đổi.
• Lỗi thường gặp: thiếu cột bắt buộc, tên sản phẩm bị trùng, thiếu cấu hình Gram cho hàng cân ký hoặc cách bán cân ký không hợp lệ. Mở kết quả import để xem dòng nào cần sửa.

Ai được import?

• Xem danh sách và vào màn import: cần quyền Xem sản phẩm.
• Chạy import và lưu: cần quyền Quản lý sản phẩm.