Skip to main content

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:

ChứcModule năng Xuất kho Packing List giúphỗ trợ 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— khitừ quét mã đến xác nhận,n hệphiếu thốngxuất.

sẽ:

URL: Lịch sử xuất kho theo Packing List

🗂️ Mục lục

I. Danh sách lịch sử xuất kho

Trang danh sách chia làm 2 khu vực chính: cột trái hiển thị danh sách các Packing List đã xuất, cột phải hiển thị chi tiết phiếu xuất tương ứng.

1. Yêu cầu quyền truy cập

QuyềnPhạm vi
ViewVào được trang danh sách lịch sử xuất kho
EditHiển thị và sử dụng được nút "Xuất kho mới"

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

2. Tìm kiếm lịch sử xuất kho

Ô tìm kiếm nằm ở đầu cột trái, cho phép tìm theo:

  • 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

3. Xem chi tiết phiếu xuất

Nhấp chọn một Packing List trong danh sách bên trái. Cột phải sẽ hiển thị chi tiết phiếu xuất theo từng dòng:

TrườngÝ nghĩa
Mã đơn hàngMã định danh đơn hàng
SKUMã sản phẩm
SL CầnSố lượng cần xuất theo tồn kho
SL XuấtSố lượng thực tế đã xuất
Ghi chúGhi chú của từng dòng đơn hàng

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

II. Chức năng tạo phiếu vềxuất sau.kho mới

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

  • Đăng nhập hệ thống, vào trang "Lịch sử xuất kho theo Packing List".
  • Tại sidebar trái, nhấn nút "Xuất kho mới" để mở cửa sổ quét PKL (modal "Xuất kho Packing List").

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”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úQué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

  1. Đăng nhập hệ thống.
  2. Vào trang “Lịch sử xuất kho theo Packing List”.
  3. Ở 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 theomã Packing List

Tìm2.1 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

  1. NhấNhập chọn một Packing List trong danh sách bên trái.

  2. 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étmã 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

  • ỞTại ô nhập có nhãn: “"Quét QR Code hoặc nhập mã Packing List / Mã tracking”tracking".

    ,

  • Thựthực hiện:n một trong hai cách:

    • Quét QR bằng máy quét, hoặct.
    • Gõ mã PKL rồi nhấn Enter.

Bước 3 —2.2 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.PKL trong cùng một lần xuất kho.
  • Danh sách PKL đã quét hiển thị bên trái modal.
  • Bạn cóCó thể xóa PKL khỏi danh sách đã quét trước khi xác nhận.

Bư

⚠️ Lưu ý: Nếu bạn xóa một thùng (carton) hoặc một dòng đơn hàng ngay trong modal, hệ thống sẽ loại phần đó khỏi dữ liệu xuất và tự tính lại tổng. Việc này có thể kích hoạt cảnh báo "Vui lòng kiểm tra trước 4khi —xuất kho" nếu tổng bị lệch so với dữ liệu Packing List gốc.

3. Kiểm tra thông tin trước khi xuất

  • Với mỗi PKL,PKL đã quét, hệ thống hiển thị:

    • Danh sách thùng (carton) .
    • Danh sách đơn hàng / SKU trong từng thùngng.
    • SL Cần (SL— đưsố lượcng hệ thống tính theo tồn kho sẵn sàng để xuất)t.

    • Các
  • thông

    Trong màn hình hiện tại, bạn khôngtin cần nhậplưu sốý:

    • lượ xuất
  • Trường Mô tả
    SL Cần. Hệ thống tự lấy làm số lượng xuất theo— bạn SLkhông Cầcần nhập thủ công.
    Ghi chú(Không bắt buộc) — Nhập nếu cần cho từng dòng đơn hàng

    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 khiphiếu bạxuất.

    🔴 Cảnh báo phân lưu.

  • Bạn chỉ cần nhập Ghi chúloại: (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óathấy mộtcảnh báo màu đỏ dạng thù"Vui lòng (carton)phân hoặloại lại Packing List! ... khác mộtsố dòlượng đơn hàng được nhập kho", ngaybạn trongcần modalvào trang /phan-loai-thanh-pham để xử lý trước, sau đó mới xuất kho,kho hệ thống sẽ:được.

    • 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 —

4. Xác nhận xuất kho

  • Nhấn nút “"Xuất kho”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”kho" với tổng quan trước khi lưu.
  • Xem lại thông tin và nhấn Xác nhận để hoàn tất.

⚠️ Lưu ý về modal: Modal không thể đóng bằng cách nhấp ra ngoài hoặc nhấn phím Esc. Bạn phải hoàn tất hoặc hủy rõ ràng bên trong modal.

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

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

  1. Tạo phiếu xuất kho thành công.
  2. Lưu chi tiết xuất theo từng Packing List và từng thùng.
  3. Trừ số lượng đã xuất khỏi tồn kho.
  4. Ghi lịch sử xuất để tra cứu về sau.
  5. Đóng modal và làm mới danh sách lịch sử.

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

Trạng tháiĐiều kiện
completed_outboundXuất đủ số lượng
partial_outboundXuất chưa đủ số lượng

III. Quy tắc & Điều kiện hệ thống

1. Đ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ệdữ thống.liệu.
  • PKL chưa xuất kho (chưa có outbound quantity > 0).
  • Packing ListPKL có đủ thông tin đơn hàng để xuất (carton_details có order_id và order_code/order_name).
  • Packing ListPKL còn có tồn kho để xuất.

Lưu ý về cáCách hệ thống tìmtính “tồn để xuất”: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àodùng 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:theo công thức: (tổng đã nhập 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:

  • Tình huốngThông báo lỗi
    Ô nhập trống:ng “"Vui lòng không để trống”ng"
    PKL đã xuất kho hoàn tất:t “"Packing List đã được xuất kho!”"
    PKL thiếu thông tin để xuất:t “"Packing List chưa đủ thông tin xuất kho.”"
    Không tìm thấy/khôngy cònhoặc hết tồn để xuất:t “"Không tìm thấy Packing List”List"
    Quét trùng trong cùng phiếu:u “"Packing List đã được quét”t"

    7.2. 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 (theodựa dữ liệutrên SL Cần và tồn kho)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 ListPKL không khớp với số lượng đơn hàng đã nhập kho, (thểhệ hiện trên UI dưới dạthống cảnh báo)sẽ:

      • Hệ thống sẽ chặChặn lưu,u phiếu xuất.
      • 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àVào trang phân loại/phan-loai-thanh-pham để phân loại lại đúng số lượng cho PKL đó,ng, sau đó quay lại xuất kho. URL tham khảo: /phan-loai-thanh-pham.

    Trong modal xuất kho, nếu bạn thấy cảnh báo màu đỏ kiểu: “Vui lòng phân loại lại Packing List! ... khác số lượng đơn hàng được nhập kho” thì có nghĩa là PKL đang chưa khớp. Bạn cần bấm quay lại màn phân loại để xử lý, rồi mới xuất kho được.

    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,ch (do xóa carton/đơn trong modal), hệ thống sẽ 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”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ượngnào bị khác nhau do bạn đã xóa bớt carton/đơn trong modal.

    c.

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

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

    1. Hệ thống tạo phiếu xuất kho thành công.
    2. Lưu chi tiết xuất theo từng Packing List và từng thùng.
    3. Modal đóng lại.
    4. 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.3. 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ã / quét QR rồi nhấn 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
    Packing List đã được quétTrùng PKL trong cùng phiếuKhông cần quét lại
    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/phan-loai-thanh-pham để làm lại
    Vui lòng kiểm tra trước khi xuất kho Tổng thùng/ng / tổng số lượng trong modal bị lệch Kiểm tra lại các carton/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.

    Giới hạn trong modal

    • Modal không cho đóng bằng cách nhấp ngoài nền (backdrop static) và không cho đóng bằng Esc (theo thuộc tính modal).
    • Packing List/đơn hàng có số lượng không còn để xuất sẽ bị ẩn trong danh sách.
Back to top