Hướng Dẫn Xuất Kho Packing List

Hướng dẫn sử dụng — Chức năng Xuất Kho Packing List (TTD)

1. Mục đích

Chức năng Xuất kho Packing List giúp nhân viên kho ghi nhận việc xuất thành phẩm ra khỏi kho theo từng Packing List (PKL).

Sau khi xác nhận, hệ thống sẽ:

Tạo phiếu xuất kho (Outbound) tương ứng.
Trừ số lượng đã xuất khỏi tồn kho.
Ghi lịch sử xuất để tra cứu về sau.

Lưu ý: Trước khi xuất kho, PKL phải được phân loại thành phẩm đúng số lượng. Nếu phân loại chưa khớp, hệ thống sẽ chặn lưu và nhắc bạn “phân loại lại Packing List”.

2. URL truy cập

Ngôn ngữ	Đường dẫn
Tiếng Việt	`/lich-su-xuat-kho-thanh-pham`

3. Truy cập chức năng

Yêu cầu quyền

Tài khoản cần có quyền View để vào trang.
Nút “Xuất kho mới” chỉ hiển thị/cho phép thao tác khi tài khoản có quyền Edit.

Cách vào trang

Đăng nhập hệ thống.
Vào trang “Lịch sử xuất kho theo Packing List”.
Ở sidebar trái:
- Danh sách.
- Nhấn “Xuất kho mới” để mở cửa sổ quét PKL và tạo phiếu xuất mới.

4. Tìm kiếm và xem lịch sử xuất kho theo Packing List

Tìm kiếm

Ô tìm kiếm nằm ở đầu cột trái.
Có thể tìm theo (theo tooltip trong UI):
- Mã Packing List / Invoice No
- Mã xuất kho
- Tên người nhận
- Tên người xuất kho
- Mã / tên đơn hàng

Xem lịch sử chi tiết

Nhấp chọn một Packing List trong danh sách bên trái.
Cột phải hiển thị chi tiết phiếu xuất theo các dòng:
- Mã đơn hàng
- SKU
- SL Cần
- SL Xuất
- Ghi chú

Nếu phiếu có nhiều thùng (carton), bảng sẽ hỗ trợ phân trang theo thùng để bạn xem đầy đủ.

5. Tạo phiếu xuất kho mới

Bước 1 — Mở cửa sổ quét PKL

Nhấn nút “Xuất kho mới” (cửa sổ sẽ mở dạng modal “Xuất kho Packing List”).

Bước 2 — Quét QR Code hoặc nhập mã Packing List

Ở ô nhập có nhãn: “Quét QR Code hoặc nhập mã Packing List / Mã tracking”.
Thực hiện:
- Quét QR bằng máy quét, hoặc
- Gõ mã PKL rồi nhấn Enter.

Bước 3 — Thêm nhiều Packing List vào cùng một phiếu

Có thể quét lần lượt nhiều PKL.
Danh sách PKL đã quét hiển thị bên trái modal.
Bạn có thể xóa PKL khỏi danh sách đã quét trước khi xác nhận.

Bước 4 — Kiểm tra thông tin trước khi xuất

Với mỗi PKL, hệ thống hiển thị:
- Danh sách thùng (carton)
- Danh sách đơn hàng / SKU trong thùng
- SL Cần (SL được hệ thống tính theo tồn kho sẵn sàng để xuất)
Trong màn hình hiện tại, bạn không cần nhập số lượng xuất. Hệ thống tự lấy số lượng xuất theo SL Cần.
Nếu một dòng không còn số lượng để xuất, dòng đó sẽ bị ẩn và không được tính vào khi bạn lưu.
Bạn chỉ cần nhập Ghi chú (nếu cần) cho từng dòng đơn hàng.

Bước 4.1 — Xóa thùng/đơn trong modal (nếu cần)

Nếu bạn xóa một thùng (carton) hoặc một dòng đơn hàng ngay trong modal xuất kho, hệ thống sẽ:
- Loại phần đó khỏi dữ liệu sẽ xuất,
- Tự tính lại tổng số thùng/tổng số lượng trong phiếu để kiểm tra trước khi lưu.
Vì vậy, việc xóa một phần có thể làm phát sinh cảnh báo “Vui lòng kiểm tra trước khi xuất kho” (nếu tổng bị lệch so với dữ liệu hiện có của Packing List).

Bước 5 — Xác nhận xuất kho

Nhấn nút “Xuất kho” ở cuối modal.
Hệ thống sẽ hiện hộp thoại xác nhận “Xác nhận xuất kho” với tổng quan trước khi lưu.

6. Điều kiện quét hợp lệ và không hợp lệ

Quét hợp lệ — PKL được thêm vào danh sách quét khi:

Ô nhập không trống.
Hệ thống tìm thấy Packing List trong hệ thống.
PKL chưa xuất kho (chưa có outbound quantity > 0).
Packing List có đủ thông tin đơn hàng để xuất (carton_details có order_id và order_code/order_name).
Packing List còn có tồn kho để xuất.

Lưu ý về cách hệ thống tìm “tồn để xuất”:

Nếu hệ thống có sẵn dữ liệu tồn (inventory_quantity hoặc inventory_quantity_format) thì hệ thống sẽ dựa vào giá trị này.
Nếu chưa có dữ liệu tồn theo trường đó, hệ thống sẽ dùng phép tính theo: (tổng đã vào - tổng đã xuất) để suy ra mức có thể xuất.

Quét không hợp lệ — hệ thống báo lỗi và bỏ qua khi:

Ô nhập trống: “Vui lòng không để trống”
PKL đã xuất kho hoàn tất: “Packing List đã được xuất kho!”
PKL thiếu thông tin để xuất: “Packing List chưa đủ thông tin xuất kho.”
Không tìm thấy/không còn tồn để xuất: “Không tìm thấy Packing List”
Quét trùng trong cùng phiếu: “Packing List đã được quét”

7. Quy tắc xác nhận lưu (validation)

Quy tắc về số lượng

Hệ thống dùng SL Cần làm cơ sở số lượng xuất.
Trước khi lưu, hệ thống sẽ kiểm tra các điều kiện xuất (theo dữ liệu SL Cần và tồn kho) để đảm bảo phiếu có thể lưu hợp lệ.

Quy tắc bắt buộc về phân loại thành phẩm

Nếu số lượng đơn hàng trong Packing List không khớp với số lượng đơn hàng đã nhập kho (thể hiện trên UI dưới dạng cảnh báo):
- Hệ thống sẽ chặn lưu,
- Hiển thị cảnh báo: “Số lượng đơn hàng trong Packing List không bằng với số lượng đơn hàng được nhập kho. Vui lòng phân loại lại Packing List!”

Cách xử lý: vào trang phân loại để phân loại lại đúng số lượng cho PKL đó, sau đó quay lại xuất kho. URL tham khảo: /phan-loai-thanh-pham.

Quy tắc về tổng thùng / tổng PCS

Nếu tổng số thùng hoặc tổng số lượng xuất ở mức packing list bị lệch, hệ thống hiển thị cảnh báo trước khi cho xác nhận lưu: “Vui lòng kiểm tra trước khi xuất kho”.
Nội dung cảnh báo sẽ chỉ ra Packing List nào bị lệch và phần tổng thùng/tổng số lượng bị khác nhau do bạn đã xóa bớt carton/đơn trong modal.

8. Kết quả sau khi lưu

Sau khi nhấn Xác nhận:

Hệ thống tạo phiếu xuất kho thành công.
Lưu chi tiết xuất theo từng Packing List và từng thùng.
Modal đóng lại.
Danh sách lịch sử (cột trái) được làm mới để hiển thị trạng thái xuất mới.

Trạng thái Packing List sau xuất sẽ chuyển theo logic:

completed_outbound nếu đủ số lượng
partial_outbound nếu chưa đủ số lượng

9. Các thông báo lỗi thường gặp

Thông báo	Ý nghĩa	Cách xử lý
Vui lòng không để trống	Chưa nhập mã PKL	Nhập mã/QR rồi Enter
Packing List đã được xuất kho!	PKL đã hoàn tất xuất	Chọn PKL khác
Packing List chưa đủ thông tin xuất kho.	PKL không có đủ dữ liệu đơn hàng	Kiểm tra lại dữ liệu PKL
Không tìm thấy Packing List	PKL không tồn tại hoặc không còn tồn để xuất	Kiểm tra lại mã PKL / tồn kho
Số lượng đơn hàng trong Packing List không bằng với số lượng đơn hàng được nhập kho. Vui lòng phân loại lại Packing List!	Phân loại thành phẩm chưa khớp	Vào trang phân loại để làm lại
Vui lòng kiểm tra trước khi xuất kho	Tổng thùng/tổng số lượng trong modal bị lệch	Kiểm tra lại các carton/đơn đã xóa và cân chỉnh cho khớp

10. Các trường và hành vi bị khóa hoặc giới hạn thao tác

Quyền

Nếu thiếu quyền View thì trang sẽ hiển thị Từ chối truy cập.
Nếu thiếu quyền Edit thì nút “Xuất kho mới” không cho phép tạo phiếu.