Import chi tiết phiếu nhập kho

Nhập liệu hàng loạt sản phẩm vào phiếu nhập kho từ file Excel, tự động mapping SKU, đơn vị tính và số lượng.

Tính năng Import chi tiết phiếu nhập kho cho phép thêm hàng loạt sản phẩm vào phiếu nhập kho từ file Excel. Hệ thống sẽ tự động tìm sản phẩm dựa trên SKU và mapping đơn vị tính, giúp tiết kiệm thời gian nhập liệu cho những phiếu nhập kho có nhiều sản phẩm.

Giao diện tổng thể

Chức năng import nằm trong trang Thêm/Chỉnh sửa phiếu nhập kho, ở phần Hàng hoá cần nhập.
Nhấn nút Import từ Excel để mở hộp thoại chọn file.
Hệ thống sẽ đọc file, tự động mapping các cột, và thêm sản phẩm vào danh sách chi tiết phiếu nhập kho.

Định dạng file import

File import có thể là Excel (.xls, .xlsx) hoặc CSV (.csv). Mỗi dòng trong file tương ứng với một sản phẩm (biến thể) cần thêm vào phiếu nhập kho.

Các cột trong file Excel

Tên cột	Bắt buộc	Mô tả	Mã code
SKU/Barcode	Có	Mã SKU hoặc barcode của biến thể sản phẩm. Hệ thống sẽ tìm sản phẩm dựa trên mã này	`sku`
Số lượng / Khối lượng (KG)	Có	Số lượng cần nhập kho theo đơn vị tính. Với sản phẩm cân ký, đây là khối lượng (KG). Nếu để trống, mặc định = 1	`uom_quantity`
Đơn vị tính	Có	Tên đơn vị tính (VD: Cái, Hộp, Thùng). Nếu để trống, hệ thống dùng đơn vị tính mặc định của sản phẩm	`uom_name`
Số lượng đếm	Không	Số lượng đếm thực tế (chỉ dùng cho sản phẩm cân ký bán theo số lượng đếm). VD: Số trái, số quả, số miếng	`catch_counting`

Tên cột trong file không cần khớp chính xác. Hệ thống hỗ trợ nhận diện tên cột tương tự (synonyms). Ví dụ: cột "SL", "S.L" sẽ được tự động mapping thành cột Số lượng.

Danh sách tên cột tương đương (synonyms)

Cột	Tên tương đương được nhận diện
SKU/Barcode	`sku`, `code`, `biến thể`, `barcode`
Số lượng	`SL`, `S.L`, `số lượng`
Đơn vị tính	`đơn vị tính`, `đvt`, `dv`, `đv`, `đv tính`
Số lượng đếm	`số lượng đếm`, `sl đếm`, `số trái`, `số quả`, `số miếng`

Khác với import đơn hàng mua (PO), phiếu nhập kho không có cột Đơn giá. Phiếu nhập kho chỉ quản lý số lượng nhập, không quản lý giá mua.

Các bước import

Truy cập menu Kho hàng > Phiếu nhập xuất kho.
Nhấn Thêm phiếu nhập hoặc mở một phiếu nhập kho đã có (ở trạng thái cho phép chỉnh sửa).
Trong phần Hàng hoá cần nhập, nhấn nút Import từ Excel.
Chọn file Excel từ máy tính.
Hệ thống sẽ tự động mapping các cột và hiển thị kết quả.
Kiểm tra danh sách sản phẩm đã được thêm.
Nhấn Tạo phiếu hoặc Lưu để hoàn tất.

File mẫu tải về

Các file Excel mẫu để 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.

File mẫu	Mô tả
productreceipt_import_template.xlsx	File mẫu import chi tiết phiếu nhập kho với các cột SKU, Số lượng, Đơn vị tính.

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

Tìm sản phẩm theo SKU

Hệ thống tìm sản phẩm (biến thể) dựa trên SKU/Barcode trong cơ sở dữ liệu sản phẩm.
Nếu SKU không tìm thấy, hệ thống sẽ hiển thị cảnh báo dòng đó bị bỏ qua (kèm số dòng trong file Excel).
Chỉ các SKU hợp lệ mới được thêm vào phiếu nhập kho.

Mapping đơn vị tính

Nếu cột Đơn vị tính có giá trị, hệ thống sẽ tìm đơn vị tính phù hợp dựa trên tên (so sánh không phân biệt hoa thường).
Nếu cột Đơn vị tính để trống, hệ thống tự dùng đơn vị tính có hệ số quy đổi lớn nhất của sản phẩm làm mặc định.

Xử lý số lượng đếm (catch counting)

Cột Số lượng đếm chỉ áp dụng cho sản phẩm có cách bán cân ký = Bán theo số lượng đếm.
Nếu sản phẩm không phải loại cân ký đếm, giá trị cột này sẽ bị bỏ qua (= 0).

Hành vi khi import

Import sẽ thêm mới sản phẩm vào danh sách chi tiết phiếu nhập kho.
Nếu SKU đã tồn tại trong danh sách chi tiết, hệ thống sẽ ghi đè số lượng theo dữ liệu trong file.
Sau khi import thành công, bạn vẫn có thể chỉnh sửa số lượng trước khi lưu phiếu.

Phiếu nhập kho từ đơn hàng mua (PO)

Nếu phiếu nhập kho được tạo từ đơn hàng mua (PO), danh sách sản phẩm sẽ được tự động điền từ chi tiết PO. Bạn chỉ cần kiểm tra và điều chỉnh số lượng thực tế nhập kho.

Giới hạn

Import chi tiết phiếu nhập kho không giới hạn số dòng (khác với import vị trí sản phẩm/vị trí kho). Tuy nhiên, file quá lớn có thể ảnh hưởng đến hiệu suất xử lý trên trình duyệt.

Danh sách lỗi

Import chi tiết phiếu nhập kho xử lý hoàn toàn trên Frontend (trình duyệt). Hệ thống đọc file Excel, resolve SKU và đơn vị tính ngay trên giao diện, sau đó thêm sản phẩm vào danh sách chi tiết (chưa lưu cho đến khi nhấn Lưu phiếu).

Lỗi Frontend (xử lý trên giao diện)

Mã lỗi	Thông báo	Nguyên nhân	Cách khắc phục
`sku_not_found`	SKU [mã] không tìm thấy (dòng X)	Mã SKU/Barcode trong file không khớp với bất kỳ biến thể sản phẩm nào trong hệ thống. Hệ thống tìm trong bộ nhớ frontend (`useProductCache`)	Kiểm tra lại SKU đã tồn tại trong hệ thống. Đảm bảo sản phẩm đã được tạo và đồng bộ

Lỗi logic (không hiển thị cảnh báo nhưng ảnh hưởng dữ liệu)

Tình huống	Hành vi hệ thống	Lưu ý
Đơn vị tính không khớp	Tên ĐVT trong file không tìm thấy đơn vị tương ứng → hệ thống tự dùng ĐVT có hệ số quy đổi lớn nhất	Không hiển thị cảnh báo. Kiểm tra cột ĐVT sau khi import
Số lượng để trống	Mặc định = 0 đối với sản phẩm cân ký, = `uom_quantity` đối với sản phẩm thường	Điền số lượng rõ ràng vào file
Số lượng đếm không áp dụng	Sản phẩm không phải loại cân ký đếm → giá trị `catch_counting` = 0	Cột này chỉ có tác dụng với sản phẩm cân ký bán theo số lượng đếm
Sản phẩm cân ký (KG)	Số lượng trong file (đơn vị KG) được tự động nhân ×1000 (chuyển thành gram) khi thêm vào phiếu	Nhập số lượng theo KG (VD: 1.5 = 1.5 KG = 1500g)
SKU trùng	Nếu SKU đã có trong danh sách chi tiết, hệ thống ghi đè số lượng thay vì cộng dồn	Đảm bảo mỗi SKU chỉ xuất hiện 1 lần trong file

Lỗi chung (file Excel)

Lỗi	Nguyên nhân	Cách khắc phục
File không đọc được	File bị hỏng, sai định dạng hoặc không có dòng tiêu đề	Kiểm tra file có đuôi `.xls`, `.xlsx` hoặc `.csv`. Đảm bảo dòng đầu tiên là tiêu đề cột
Cột không được nhận diện	Tên cột trong file không nằm trong danh sách synonyms	Đổi tên cột theo danh sách tên cột tương đương
Trạng thái phiếu không cho phép	Phiếu nhập kho đã hoàn thành hoặc đã huỷ → không thể import thêm sản phẩm	Chỉ import khi phiếu ở trạng thái Nháp

Cách đọc lỗi: Khi import thất bại, hệ thống hiển thị số dòng trong file Excel (bắt đầu từ dòng 2, vì dòng 1 là tiêu đề). Ví dụ: "dòng 5" tương ứng với dòng thứ 5 trong file Excel.

Phân quyền

Xem phiếu nhập xuất kho: Cần quyền Xem phiếu kho.
Thêm/Chỉnh sửa phiếu nhập xuất kho: Cần quyền Quản lý phiếu kho.

Import chi tiết phiếu nhập kho

On this page