MSO Cloud · Documentation

Tải CSV/Excel

Source: docs/guides/admin/csv-upload-setup.md Updated 2026-09-22
On this page

Nạp dữ liệu bằng file khi chưa có kết nối API — và giữ cách đọc file đó lại thành một mẫu dùng cho lần sau.

Đối tượng: quản trị viên tổ chức và người vận hành dữ liệu. Cần đọc trước: Kết nối dữ liệu.

Hai màn hình#

  • Tải lên dữ liệu (/connectors/uploads) — chọn thương hiệu, chọn loại dữ liệu hoặc mẫu ánh xạ, thả file .csv, .xlsx hoặc .xls, rồi theo dõi trạng thái xử lý của chính lần tải đó.
  • Cấu hình CSV/Excel (/connectors/uploads/templates) — nơi giữ mẫu ánh xạ: file này có những cột nào, mỗi cột vào trường nào, ngày viết theo kiểu gì, tiền tệ bóc ra sao.

Mẫu ánh xạ là dữ liệu chứ không phải mã. Một hình dạng file mới của cùng một luồng là thêm một mẫu, không phải một bản dựng mới.

Lần đầu nạp một hình dạng file mới#

  1. Mở file bằng trình soạn thảo văn bản, không mở bằng Excel: Excel âm thầm ghi lại mã ký tự. Kiểm tra hàng tiêu đề và ba dòng mẫu.
  2. Vào Cấu hình CSV/Excel, tạo mẫu cho luồng dữ liệu đích: khai dấu phân cách, số dòng bỏ qua, mã ký tự, rồi nối từng cột nguồn với trường đích.
  3. Nạp thử một trăm dòng đầu ở Tải lên dữ liệu và đọc danh sách dòng bị từ chối.
  4. Sạch rồi mới nạp cả file.
  5. Đối chiếu kết quả ở Đối soát dữ liệu (/validation).

Các luồng thương mại cơ bản (đơn hàng, creator, tồn kho, chi phí creator, chỉ tiêu, sản phẩm) đã có sẵn bộ tên cột tiếng Việt và tiếng Anh, nên phần lớn file xuất từ sàn nạp được ngay mà không cần tạo mẫu.

Chi tiết cấu trúc một mẫu ánh xạ, danh sách phép biến đổi cột và các lỗi phân tích file thường gặp nằm ở Manual CSV / Excel Upload Runbook.

Khi có gì đó không đúng#

Hiện tượng Nguyên nhân thường gặp Cách xử lý
Dòng bị từ chối vì không đọc được số cột tiền còn ký hiệu tiền tệ Bật bóc ký hiệu tiền tệ trong phép biến đổi của cột.
Dòng bị từ chối vì không đọc được ngày ngày kiểu Việt Nam bị đọc theo kiểu Mỹ Khai đúng định dạng ngày trong mẫu.
Tiếng Việt hiện thành ký tự lạ file mã hoá kiểu cũ Khai đúng mã ký tự trong phần đọc file của mẫu.
File bị từ chối vì quá lớn file lịch sử quá dài Cắt nhỏ file rồi nạp nhiều lần.
Nạp lại cùng file làm số nhân đôi mẫu chưa khai khoá chống trùng Khai khoá chống trùng trong mẫu rồi nạp lại.

Liên quan#