Hướng dẫn phân loại Packing List

Hướng dẫn sử dụng — Chức năng Phân loại Thành phẩm

Mục lục

Mục đích
URL truy cập
Mục lục chức năng trên trang
Truy cập chức năng
Tìm kiếm và xem lịch sử phân loại
Tạo phiếu phân loại mới
Điều kiện quét hợp lệ và không hợp lệ
Quy tắc nhập số lượng và xác nhận lưu
Kết quả sau khi lưu
Các thông báo lỗi thường gặp
Các trường và hành vi bị khóa hoặc giới hạn thao tác

1. Mục đích

Chức năng Phân loại thành phẩm dùng để ghi nhận việc phân bổ số lượng hàng hóa từ kho vào từng Packing List theo đơn hàng thực tế. Có 3 loại phân loại:

Loại	Ý nghĩa	Tồn kho thay đổi
Nhập kho	Hàng từ PKL chuyển vào kho chung (phân loại để giảm bớt dư thừa)	↓ Giảm
Nhập PKL	Hàng từ kho phân bổ vào PKL (bổ sung đủ số lượng còn thiếu)	↑ Tăng
Nhập PKL Customer	Chuyển hàng từ một PKL gốc sang PKL khách hàng	Cập nhật chéo

Lưu ý quan trọng: Phân loại phải hoàn thành trước khi xuất kho. Nếu bỏ qua bước này, chức năng Xuất kho sẽ báo lỗi "Phân loại chưa khớp" và không cho lưu phiếu xuất.

2. URL truy cập

Ngôn ngữ	Đường dẫn
Tiếng Việt	`/vi/finished-product-classification`
Tiếng Anh	`/en/finished-product-classification`

3. Mục lục chức năng trên trang

Trang được chia làm hai cột:

Cột trái: Lịch sử các phiếu phân loại đã tạo — tìm kiếm, lọc, chọn để xem chi tiết.
Cột phải: Chi tiết từng phiếu được chọn — hiển thị danh sách đơn hàng, số lượng phân loại, số lượng tồn.

Phía trên cột trái có 3 nút tạo phiếu mới:

Nút	Loại phân loại
Nhập kho	Phân loại nhập kho (giảm tồn)
Nhập PKL	Phân loại nhập PKL (tăng tồn)
Nhập PKL Customer	Phân loại chuyển sang PKL khách hàng

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

Yêu cầu quyền

Quyền	Cho phép làm gì
`View`	Vào trang, xem lịch sử, xem chi tiết
`Edit`	Tạo phiếu phân loại mới (3 nút phân loại mới được kích hoạt)

Nếu không có quyền View, hệ thống hiển thị trang "Từ chối truy cập".
Nếu chỉ có quyền View (không có Edit), các nút Nhập kho / Nhập PKL / Nhập PKL Customer bị vô hiệu hóa.

Yêu cầu tài khoản

Tài khoản đăng nhập phải được gán Chi nhánh. Nếu chưa được gán, khi cố quét mã hệ thống sẽ báo lỗi:
"Tài khoản chưa được gán Chi nhánh. Vui lòng liên hệ Admin."

5. Tìm kiếm và xem lịch sử phân loại

Tìm kiếm theo mã

Nhập mã phiếu hoặc mã Packing List vào ô tìm kiếm ở đầu cột trái.

Lọc nâng cao

Nhấn biểu tượng Bộ lọc (góc trên cột trái) để mở bảng lọc:

Trường lọc	Mô tả
Loại phân loại	Tất cả / Nhập PKL / Nhập kho
Từ ngày	Ngày tạo phiếu (định dạng `dd-mm-yyyy`)
Đến ngày	Ngày tạo phiếu (định dạng `dd-mm-yyyy`)
Người tạo	Tên người tạo phiếu
Chi nhánh	Mặc định theo chi nhánh của tài khoản đăng nhập

Nhấn "Áp dụng" để lọc, "Xóa lọc" để đặt lại.

Khi có bộ lọc đang hoạt động, biểu tượng Bộ lọc hiển thị dấu chấm màu để nhắc nhở.

Xem chi tiết phiếu

Nhấp vào một phiếu trong danh sách bên trái.
Cột phải hiển thị chi tiết phiếu đó:

Thông tin	Mô tả
Mã phiếu	Mã định danh phiếu phân loại
Loại	Badge hiển thị: Nhập kho / Nhập PKL / Nhập PKL Customer
Người tạo	Họ tên người thực hiện
Thời gian tạo	Ngày giờ tạo phiếu
Mã đơn hàng / SKU	Tên và mã định danh sản phẩm
SL phân loại	Số lượng đã phân loại trong lần này
SL tồn	Số lượng tồn kho sau phân loại
SL cần	Số lượng cần phân loại theo kế hoạch

Nhấn "Chi tiết" trên từng dòng đơn hàng để xem danh sách chi tiết theo từng thùng và Packing List.

6. Tạo phiếu phân loại mới

6.1. Phân loại Nhập kho (`Nhập kho`)

Dùng khi hàng đã được nhập vào kho nhiều hơn đơn hàng yêu cầu, cần phân loại để điều chỉnh về đúng số lượng.

Bước 1 — Mở cửa sổ phân loại

Nhấn nút "Nhập kho" → cửa sổ "Phân loại nhập kho" (viền xanh lá) mở ra.

Bước 2 — Quét mã Packing List

Ô nhập ở trên cùng: "Quét mã PKL".
Dùng máy quét QR hoặc nhập tay mã PKL → nhấn Enter.
Thông tin PKL và danh sách thùng hàng / đơn hàng hiện ra bên dưới.
Có thể quét thêm nhiều PKL khác vào cùng một phiếu.

Bước 3 — Nhập số lượng phân loại

Mỗi dòng đơn hàng hiển thị:

Cột	Ý nghĩa
Mã / Tên đơn hàng	Định danh sản phẩm
SL cần	Số lượng hệ thống tính cần phân loại (`nhập kho − đơn hàng`)
SL thực phân loại	Nhập tay — số lượng thực tế phân loại

Cột trái: Nhấp vào một PKL trong danh sách để xem chi tiết thùng hàng của PKL đó ở cột phải.

Bước 4 — Xác nhận

Kiểm tra tổng X / Y PCS ở thanh tiêu đề cửa sổ.
Nhấn "Xác nhận" → hộp thoại xác nhận hiện ra → nhấn "Xác nhận" lần nữa để lưu.

6.2. Phân loại Nhập PKL (`Nhập PKL`)

Dùng khi đơn hàng còn thiếu số lượng nhập kho, cần phân bổ thêm hàng từ kho vào PKL.

Bước 1 — Mở cửa sổ phân loại

Nhấn nút "Nhập PKL" → cửa sổ "Phân loại nhập PKL" (viền xanh dương) mở ra.

Bước 2 — Quét mã Packing List

Thao tác tương tự mục 6.1. Hệ thống tự động tính:

SL cần = đơn hàng − nhập kho (số lượng còn thiếu).
SL gợi ý = số lượng tồn kho còn có thể phân bổ cho đơn hàng này (đã trừ các PKL khác đang quét).

Bước 3 — Nhập / điều chỉnh số lượng

Hệ thống tự điền SL gợi ý vào ô. Có thể sửa lại nếu cần.
Validation nếu cùng một đơn hàng xuất hiện trên nhiều PKL, hệ thống kiểm tra tổng cộng không vượt quá tồn kho.

Bước 4 — Xác nhận — tương tự mục 6.1.

6.3. Phân loại Nhập PKL cho khách hàng (`Nhập PKL Customer`)

Dùng để chuyển hàng từ PKL nguồn (inbound) sang PKL cho khách hàng (customer).

Bước 1 — Mở cửa sổ

Nhấn nút "Nhập PKL Customer" → cửa sổ có 2 ô quét riêng biệt.

Bước 2 — Quét PKL nguồn (bên trái)

Ô "Quét mã PKL": quét QR hoặc nhập mã PKL gốc (PKL chứa hàng trong kho).
PKL được thêm vào danh sách bên trái.

Bước 3 — Quét PKL khách hàng (bên phải)

Ô "Quét mã Packing List Customer": quét QR hoặc nhập mã PKL khách hàng.
Chỉ chấp nhận PKL loại Customer — nếu quét PKL thường sẽ báo lỗi: "Vui lòng quét Packing List Customer."

Bước 4 — Nhập số lượng và xác nhận — tương tự các bước trên.

7. Đ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 khi

Điều kiện	Chi tiết
Mã tồn tại	QR code / mã PKL được tìm thấy trong hệ thống
Chưa xuất kho	Trạng thái PKL không phải `completed_outbound` hoặc `partial_outbound`
Chưa có trong danh sách	PKL chưa được quét trong phiếu đang làm
Tài khoản có chi nhánh	Người dùng đã được gán chi nhánh

❌ Quét không hợp lệ — Hệ thống báo lỗi khi

Trường hợp	Thông báo
Ô nhập trống	"Vui lòng không để trống"
Mã không tồn tại	"Không tìm thấy Packing List"
PKL đã được xuất kho	"Packing List đã xuất kho"
PKL đã có trong danh sách	"Packing List đã tồn tại trong danh sách"
PKL không khả dụng (mọi thùng đều trống)	"Packing List không khả dụng"
Quét PKL thường vào ô PKL Customer	"Vui lòng quét Packing List Customer."
Tài khoản chưa có chi nhánh	"Tài khoản chưa được gán Chi nhánh. Vui lòng liên hệ Admin."

8. Quy tắc nhập số lượng và xác nhận lưu

Quy tắc chung cho mọi loại phân loại

Quy tắc	Chi tiết
Phải lớn hơn 0	Không được để trống hoặc nhập 0
Chỉ nhập số nguyên dương	Không nhập số thập phân, chữ cái, ký tự đặc biệt
Tối đa 12 chữ số	Hệ thống tự chặn khi vượt giới hạn

Quy tắc riêng theo loại

Nhập kho (giảm tồn):

SL thực phân loại ≤ SL nhập kho của đơn hàng đó.
Lỗi nếu vượt: "Không nhập vượt quá số lượng đang có của đơn hàng (X)"

Nhập PKL (tăng tồn):

Tổng SL phân loại của cùng một đơn hàng trên nhiều PKL ≤ tổng tồn kho khả dụng.
Lỗi nếu vượt: "Không nhập vượt quá số tồn (X)"
Validation chạy theo thời gian thực khi nhập — thông báo lỗi hiện ngay dưới ô nhập.

Điều kiện để lưu phiếu thành công

Tất cả điều kiện sau phải đồng thời thỏa mãn:

Đã quét ít nhất 1 Packing List.
Tất cả dòng đơn hàng (không bị xóa, không trống) có SL > 0.
Không có dòng nào còn cảnh báo lỗi (ô noti không rỗng).
Tài khoản có chi nhánh hợp lệ.
Phiên đăng nhập còn hiệu lực.

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

Sau khi xác nhận thành công:

Phiếu phân loại được tạo — mã phiếu duy nhất được sinh tự động.
Tồn kho cập nhật:
- Nhập kho: tồn kho giảm theo SL phân loại.
- Nhập PKL: tồn kho tăng theo SL phân loại.
Lịch sử cập nhật — phiếu mới xuất hiện đầu danh sách bên trái với badge loại tương ứng.
Cửa sổ tự đóng — màn hình chính tự làm mới.

Trạng thái Packing List sau phân loại

Trường hợp	Trạng thái
Tổng SL thực phân loại = SL cần (tất cả dòng)	Phân loại hoàn tất (`completed_classification`)
Tổng SL thực phân loại < SL cần (có dòng còn thiếu)	Phân loại một phần (`partial_classification`)

PKL ở trạng thái phân loại một phần vẫn có thể xuất kho nhưng hệ thống sẽ báo không khớp nếu tổng số lượng đơn hàng chưa đủ.

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

Lỗi khi quét mã

Thông báo	Nguyên nhân	Cách xử lý
"Vui lòng không để trống"	Nhấn Enter khi ô trống	Nhập mã trước khi Enter
"Không tìm thấy Packing List"	Mã không tồn tại	Kiểm tra lại mã PKL
"Packing List đã xuất kho"	PKL đã được xuất hoàn tất	PKL này không phân loại được nữa
"Packing List đã tồn tại trong danh sách"	Quét trùng	Không cần quét lại
"Packing List không khả dụng"	PKL không còn dữ liệu hợp lệ	Kiểm tra lại trạng thái PKL
"Tài khoản chưa được gán Chi nhánh..."	Tài khoản thiếu cấu hình	Liên hệ Admin để gán chi nhánh

Lỗi khi nhập số lượng

Thông báo	Nguyên nhân	Cách xử lý
"Vui lòng nhập số lượng lớn hơn 0"	Ô để trống hoặc nhập 0	Nhập số ≥ 1
"Không nhập vượt quá số lượng đang có của đơn hàng (X)"	SL > SL nhập kho (mode Nhập kho)	Giảm SL về ≤ X
"Không nhập vượt quá số tồn (X)"	Tổng SL vượt tồn kho (mode Nhập PKL)	Giảm SL về ≤ X

Lỗi khi xác nhận lưu

Thông báo	Nguyên nhân	Cách xử lý
"Vui lòng kiểm tra lại số lượng phân loại"	Còn dòng có SL = 0 hoặc có lỗi validation	Kiểm tra và sửa các ô đang báo lỗi
"Không có dữ liệu hợp lệ để lưu"	Tất cả thùng/đơn hàng đã bị xóa hoặc trống	Quét lại PKL và nhập số lượng
"Phiên đăng nhập không hợp lệ..."	Session hết hạn	Tải lại trang và đăng nhập lại
"Không thể tạo phiếu phân loại"	Lỗi từ phía hệ thống	Thử lại, hoặc liên hệ bộ phận kỹ thuật

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

Nút bị vô hiệu hóa theo quyền

Nút / Thao tác	Điều kiện bị khóa
Nút Nhập kho	Tài khoản không có quyền `Edit`
Nút Nhập PKL	Tài khoản không có quyền `Edit`
Nút Nhập PKL Customer	Tài khoản không có quyền `Edit`

Hành vi bị giới hạn trong cửa sổ phân loại

Hành vi	Giải thích
Không thể đóng bằng phím Esc	Hệ thống chặn để tránh mất dữ liệu đang nhập
Không thể đóng bằng cách nhấp ra ngoài	Tương tự — phải bấm Hủy hoặc Xác nhận
Dòng đơn hàng có SL nhập kho = 0 tự động bị ẩn / đánh dấu xóa	Không hiển thị những dòng không liên quan
Thùng hàng tự động bị xóa khi tất cả đơn hàng bên trong bị xóa	Dọn dẹp giao diện tự động
PKL tự động bị xóa khỏi danh sách khi tất cả thùng bị xóa	Tương tự
Ô SL thực phân loại chỉ nhận số nguyên	Không nhập được số thập phân hoặc chữ
Giới hạn 12 chữ số cho ô số lượng	Hệ thống tự chặn khi nhập quá
Validation lỗi hiển thị khi nhập	Không cần nhấn Xác nhận mới thấy lỗi

Lưu ý về xóa thùng hàng / đơn hàng

Trong cửa sổ phân loại, có nút xóa (thùng rác) ở cạnh mỗi thùng hàng và đơn hàng:

Xóa thùng hàng → tất cả đơn hàng trong thùng đó bị bỏ qua khi lưu.
Xóa đơn hàng → đơn hàng đó bị bỏ qua khi lưu.
Khi tất cả thùng của một PKL bị xóa → PKL đó tự động biến mất khỏi danh sách.
Thao tác này không thể hoàn tác trong phiếu hiện tại — nếu xóa nhầm, cần đóng cửa sổ và tạo lại.