Theo dõi đơn hàng (P4)

Đơn hàng sinh từ báo giá khách chấp nhận, công đoạn động (mặc định 5 bước), mốc tracking, phân công, bill nháp / thật; cấu hình công đoạn.

1.Tóm tắt

Đơn hàng là bước tiếp theo của báo giá Khách chấp nhận: đơn dùng lại đúng RFF.No của báo giá và theo dõi lô hàng đi qua các công đoạn (mặc định 5 bước: Báo giá → Kho nguồn → Cảng đi → Cảng đến → Kho đến), mỗi công đoạn có người phụ trách, người quản lý, dữ liệu riêng và các mốc tracking (vd “Tàu cập cảng (ATA)”, “Nộp MNF cho hải quan”). Đơn quốc tế đi đủ 5 công đoạn; đơn trong nước thường Bỏ qua hai công đoạn cảng và có thêm Agent. Khi tạo đơn, hệ thống lập sẵn bill nháp; xong công đoạn Kho nguồn thì tự lập bill thật; xong công đoạn Kho đến thì cho lập hóa đơn (xem Bill, hóa đơn, công nợ). Chứng từ của đơn nằm ở Chứng từ đơn hàng.

Trang này gồm 2 nhóm màn: Theo dõi đơn hàng (danh sách + màn theo dõi) và Cấu hình công đoạn (quản trị loại công đoạn mặc định dùng khi tạo đơn mới).

Phạm vi (màn có trên menu)

Menu	Nội dung
Vận chuyển › Theo dõi đơn hàng	Danh sách đơn (lọc theo giai đoạn, tìm theo RFF.No / khách / kho / người thực hiện); màn theo dõi một đơn theo RFF.No; sidebar công đoạn / mốc / phân công; popup tạo, sửa, hủy đơn
Dữ liệu nền › Cấu hình công đoạn	Loại công đoạn mặc định: mốc mẫu, trường thông tin, người mặc định, cờ bill thật / lập hóa đơn

Liên quan

Đầu vào là báo giá Khách chấp nhận ở Báo giá (nút Tạo đơn hàng / Mở theo dõi); khách hàng, cảng, kho, tuyến lấy từ Dữ liệu nền; người phụ trách chọn từ Hồ sơ nhân viên đang làm.
Chứng từ gắn công đoạn: Chứng từ đơn hàng. Bill, hóa đơn, công nợ: Bill, hóa đơn, công nợ.
Sidebar phải, popup, tệp đính kèm dùng chung: Khung & quản trị.

2.Actor & quyền

Actor	Vai trò trên module
Nhân viên kinh doanh	Tạo đơn từ báo giá khách chấp nhận; sửa thông tin đơn; theo dõi tiến độ; chọn Agent cho đơn trong nước.
Nhân viên kho / chứng từ / hải quan	Cập nhật công đoạn mình phụ trách: bắt đầu, hoàn thành, bỏ qua, mở lại; nhập dữ liệu công đoạn; thêm / đánh dấu xong mốc; thêm chứng từ.
Quản lý công đoạn	Người quản lý của công đoạn: theo dõi, đổi người phụ trách / quản lý, thêm / sửa / xóa / sắp xếp công đoạn.
Agent (đối tác trong nước)	Không đăng nhập hệ thống. Đơn trong nước ghi tên Agent ở thông tin đơn; nhân viên ANLE cập nhật công đoạn thay Agent.
Quản trị viên hệ thống	Toàn quyền, duy nhất được Hủy đơn và quản lý Cấu hình công đoạn theo cài sẵn.
Super Admin (chỉ xem)	Xem danh sách, theo dõi, lịch sử; không ghi.
Hệ thống	Tự bắt đầu công đoạn kế tiếp, tự đưa đơn sang Hoàn tất, tự lập bill nháp (khi tạo đơn) và bill thật (khi xong công đoạn có cờ), ghi Audit trail.

Các vai trò nghiệp vụ ở trên (kinh doanh, kho, chứng từ, hải quan, quản lý) đều là vai trò hệ thống Người dùng; việc ai phụ trách công đoạn nào do phân công trên từng đơn, không phải do quyền.

Bảng quyền mặc định

Màn hình	Chức năng (mã)	Quản trị viên hệ thống	Super Admin (chỉ xem)	Người dùng	Trưởng phòng
Theo dõi đơn hàng	Xem danh sách, theo dõi đơn, lịch sử `xem`	Có	Có	Có	Có
	Tạo đơn từ báo giá `them`	Có	—	Có	—
	Sửa thông tin đơn `sua`	Có	—	Có	—
	Hủy đơn hàng `huy`	Có	—	—	—
	Thêm / sửa / xóa / sắp xếp công đoạn, chuyển trạng thái `cong-doan`	Có	—	Có	—
	Thêm / sửa / xóa mốc tracking `moc`	Có	—	Có	—
	Gán người phụ trách / quản lý công đoạn `phan-cong`	Có	—	Có	—
Cấu hình công đoạn	Xem cấu hình công đoạn `xem`	Có	Có	Không vào màn	Không vào màn
	Thêm loại công đoạn `them`	Có	—	Không vào màn	Không vào màn
	Sửa loại công đoạn `sua`	Có	—	Không vào màn	Không vào màn
	Xóa loại công đoạn `xoa`	Có	—	Không vào màn	Không vào màn

Giá trị khi cài mới. “Không vào màn”: menu Cấu hình công đoạn mặc định chỉ mở cho Quản trị viên; cấp thêm cho vai trò khác trên Ma trận phân quyền. Người chỉ có quyền xem thấy đủ thông tin nhưng không có nút ghi; hệ thống luôn kiểm quyền ở máy chủ, ẩn nút chỉ để gọn màn. Danh sách người phụ trách (nhân viên đang làm) mở cho người có quyền xem đơn hoặc xem cấu hình công đoạn.

3.Use case

UC-OT-01Tạo đơn từ báo giá khách chấp nhận
Actor	Nhân viên kinh doanh, Quản trị viên
Tiền điều kiện	Quyền `don-hang.them`; báo giá ở trạng thái Khách chấp nhận và chưa có đơn.
Các bước	Từ báo giá: mở báo giá Khách chấp nhận, bấm Tạo đơn hàng (sau khi cập nhật kết quả “Khách chấp nhận” hệ thống cũng tự mời tạo đơn). Từ danh sách đơn: bấm Tạo đơn từ báo giá, gõ số RFF / khách hàng / hàng hóa để tìm, chọn một báo giá trong danh sách (tối đa 50 báo giá gợi ý). Bấm Tạo đơn, xác nhận `C4001` “Tạo đơn hàng từ báo giá SCMDPC29102608?”.
Kết quả	Đơn mới mang cùng RFF.No với báo giá, mở thẳng màn theo dõi; báo `I4001` “Đã tạo đơn hàng SCMDPC29102608.”
Quy tắc / validation	Loại (trong nước / nước ngoài), khách hàng, hàng hóa, kho gửi / kho nhận được chép từ báo giá; cảng đi / cảng đến chép từ tuyến của báo giá. Tạo các công đoạn theo cấu hình mặc định (mục 6); công đoạn đầu “Báo giá” tự Hoàn thành ngay khi tạo đơn (xem dưới); mốc mẫu và trường thông tin chép theo loại công đoạn. Người phụ trách công đoạn “Báo giá” là nhân viên đã lập báo giá (nếu hồ sơ nhân viên đó còn Đang làm); các công đoạn khác lấy người mặc định của loại công đoạn. Công đoạn Báo giá tự điền từ báo giá: hoàn thành ngay với ngày bắt đầu = ngày tạo RFF và ngày hoàn thành = ngày khách chấp nhận (không quá hôm nay); các mốc tự có ngày thực tế, khớp theo tên mốc: mốc “tạo báo giá / cấp RFF.No” = ngày tạo RFF, mốc “Duyệt nội bộ” = ngày báo giá được duyệt, mốc “Khách xác nhận / chấp nhận / đồng ý / duyệt báo giá” = ngày khách chấp nhận; mốc có tên khác thì để trống cho người dùng nhập; ba trường thông tin Số báo giá, Hiệu lực đến, Điều khoản TT chép từ báo giá. Công đoạn kế tiếp (Kho nguồn) bắt đầu ngay. Chỉ áp dụng khi “Báo giá” đứng đầu và đơn có công đoạn sau; nếu không, công đoạn đầu vẫn ở Đang xử lý. Việc tự hoàn thành được ghi vào Audit trail. Đơn tạo trước đây xem UC-OT-12. Lập luôn một bill nháp chép tổng tiền (trước thuế, thuế, cộng) từ báo giá. Tình trạng đơn ban đầu: Đúng tiến độ. Mỗi báo giá chỉ có một đơn; hai người bấm cùng lúc thì chỉ một người tạo được.
Thông báo lỗi chính	`E4001` “Báo giá SCMDPC29102614 chưa ở trạng thái "Khách chấp nhận", không tạo được đơn hàng.” `E4002` “Báo giá SCMDPC29102605 đã có đơn hàng.” — popup hiện nút Mở theo dõi.

UC-OT-02Xem danh sách & lọc theo giai đoạn
Actor	Mọi người có quyền xem đơn
Tiền điều kiện	Quyền `don-hang.xem`.
Các bước	Mở Vận chuyển › Theo dõi đơn hàng. Bấm một chip giai đoạn để lọc: Tất cả, 5 công đoạn mặc định, Khác (đơn đang ở công đoạn thêm tay), Hoàn tất; số trên chip là số đơn. Gõ ô tìm (RFF.No, khách hàng, kho, người thực hiện), tối đa 100 ký tự; danh sách tự tải sau khi ngừng gõ. Bấm một dòng (hoặc Enter) để mở màn theo dõi đơn đó.
Kết quả	Danh sách đơn mới nhất ở trên, phân trang ở máy chủ (20 / 50 / 100 dòng).
Quy tắc / validation	Cột Giai đoạn: dải vạch tiến độ (xanh = xong / bỏ qua, đỏ = đang làm) + tên công đoạn đang làm; đơn xong hiện “Đã giao kho đến”. Cột Đang thực hiện: người phụ trách công đoạn hiện tại kèm vai trò; “Chưa phân công” nếu chưa gán; đơn xong hiện “— Đã hoàn tất”. Cột Tình trạng: đơn đang chạy hiện tình trạng do người dùng chọn (Đúng tiến độ / Cần chú ý / Chậm tiến độ); đơn xong hiện “Hoàn tất”, đơn hủy hiện “Đã hủy”. Lọc / sắp xếp sai giá trị thì bị bỏ qua hoặc báo lỗi giá trị không hợp lệ, không gây lỗi hệ thống.
Thông báo lỗi chính	`E0004` “Loại không hợp lệ: ….” — khi gửi thẳng tham số lọc sai lên API.

UC-OT-03Theo dõi đơn theo RFF.No
Actor	Mọi người có quyền xem đơn
Tiền điều kiện	Quyền `don-hang.xem`.
Các bước	Bấm một dòng ở danh sách, hoặc mở trực tiếp địa chỉ `/orders/<RFF.No>`, hoặc bấm Mở theo dõi ở báo giá. Đọc khối đầu (RFF.No, loại, tình trạng, khách hàng, hàng hóa, ETA kho đến), thanh tiến trình các công đoạn, chi tiết công đoạn đang chọn (người phụ trách, dòng thời gian mốc, dữ liệu công đoạn, chứng từ của công đoạn), khối bill & hóa đơn và dòng “Cùng tham chiếu”. Bấm một công đoạn trên thanh tiến trình để xem công đoạn đó (mặc định là công đoạn đang làm).
Kết quả	Toàn bộ tiến độ một lô hàng trên một màn; mobile xếp dọc.
Quy tắc / validation	Đơn đã hủy hiện dải “Đơn đã hủy: <lý do>” và chỉ xem. Mốc trên dòng thời gian: đã có ngày thực tế = xong; ngày dự kiến nhỏ hơn hôm nay mà chưa xong = trễ (đỏ); mốc chờ đầu tiên của công đoạn đang xử lý = đang làm; còn lại = chưa tới. Dòng “Cùng tham chiếu” cho đi nhanh tới báo giá, chứng từ theo RFF.No; hiện số B/L, bill, hóa đơn của đơn.
Thông báo lỗi chính	`E0002` “Đơn hàng không tồn tại hoặc đã bị xóa.” — màn hiện “Không tìm thấy đơn <RFF.No>”.

UC-OT-04Sửa thông tin đơn
Actor	Nhân viên kinh doanh, Quản trị viên
Tiền điều kiện	Quyền `don-hang.sua`; đơn chưa hủy.
Các bước	Ở màn theo dõi bấm Sửa thông tin ⇒ popup. Sửa hàng hóa, số lượng, trọng lượng, kho nguồn / kho đến, cảng đi / cảng đến, Agent, tàu / chuyến, số B/L, ETA kho đến, tình trạng, ghi chú. Bấm Lưu.
Kết quả	Thông tin đơn cập nhật; thay đổi ghi vào Audit trail (từng trường: giá trị cũ → mới).
Quy tắc / validation	RFF.No, khách hàng, loại đơn, báo giá gốc không sửa được. Tình trạng do người dùng chọn tay (không tự tính theo mốc trễ). Kho, cảng, Agent phải có trong danh mục; giới hạn độ dài / khoảng ở bảng trường (mục 5). Sửa đồng thời ⇒ báo dữ liệu đã bị người khác sửa, bấm Tải lại.
Thông báo lỗi chính	`E4003` “Đơn hàng SCMDPC29102608 đang ở trạng thái "Đã hủy", không thể sửa.” `E0001` “Tình trạng không được để trống.” `E2008` “Trọng lượng phải trong khoảng 0 đến 99999999999.999.” `E0003` “Dữ liệu đã bị người khác thay đổi. Vui lòng tải lại rồi thử lại.”

UC-OT-05Hủy đơn
Actor	Quản trị viên (quyền `huy`)
Tiền điều kiện	Quyền `don-hang.huy`; đơn đang Đang thực hiện và không còn hóa đơn chưa hủy.
Các bước	Bấm Hủy đơn ở màn theo dõi. Nhập lý do (bắt buộc, ≤ 500 ký tự) trong hộp thoại xác nhận `C4005` “Hủy đơn hàng SCMDPC29102605? Đơn đã hủy chỉ còn xem.” Bấm xác nhận.
Kết quả	Đơn sang Đã hủy; mọi bill của đơn bị hủy theo; lý do hiện ở dải đầu trang.
Quy tắc / validation	Đơn đã hủy chỉ còn xem: không sửa đơn, không đổi công đoạn / mốc / phân công, không thêm / sửa / xóa chứng từ, không sửa bill / hóa đơn. Muốn hủy đơn đã có hóa đơn: hủy hóa đơn trước (hóa đơn ghi nhận đã thu tiền thì không hủy được). Lưu ý: khung tệp đính kèm dùng chung không tự chặn tải tệp lên / xóa tệp của chứng từ khi đơn đã hủy (hành vi của khung); chứng từ vẫn bị chặn sửa / xóa.
Thông báo lỗi chính	`E0001` “Lý do hủy không được để trống.” `E4003` “Đơn hàng SCMDPC29102611 đang ở trạng thái "Hoàn tất", không thể hủy.” `E4003` “Đơn hàng SCMDPC29102611 đang ở trạng thái "Đang thực hiện", không thể hủy khi còn hóa đơn chưa hủy.”

UC-OT-06Thêm / sửa / xóa / sắp xếp công đoạn
Actor	Quản lý công đoạn, Nhân viên kho / chứng từ / hải quan, Quản trị viên
Tiền điều kiện	Quyền `don-hang.cong-doan`; đơn chưa hủy.
Các bước	Thêm: bấm Thêm công đoạn dưới thanh tiến trình ⇒ sidebar; nhập tên, biểu tượng, mô tả, vai trò phụ trách, ngày dự kiến, địa điểm và các cặp thông tin (khóa – giá trị); Lưu. Công đoạn mới nằm cuối, trạng thái Chưa bắt đầu. Sửa: chọn công đoạn, bấm Sửa công đoạn (hoặc Sửa ở khối “Dữ liệu …”). Xóa: bấm Xóa (chỉ hiện khi công đoạn Chưa bắt đầu), xác nhận `C4003`. Sắp xếp: bấm Sắp xếp ⇒ sidebar; kéo thả (hoặc nút lên / xuống) các công đoạn chưa bắt đầu; Lưu.
Kết quả	Danh sách công đoạn của đơn cập nhật; mọi thay đổi ghi Audit trail.
Quy tắc / validation	Tối đa 20 công đoạn / đơn; tối đa 30 dòng thông tin / công đoạn; khóa thông tin ≤ 100 ký tự, không trùng trong một công đoạn. Chỉ xóa được công đoạn Chưa bắt đầu; đơn phải còn ít nhất một công đoạn; mốc và lịch sử phân công đi theo công đoạn bị xóa, còn chứng từ được giữ và chuyển thành “chứng từ chung của đơn”; thứ tự các công đoạn còn lại được đánh số lại. Chỉ sắp xếp lại được các công đoạn chưa bắt đầu — công đoạn đang xử lý / hoàn thành / bỏ qua giữ nguyên vị trí. Công đoạn thêm tay không mang cờ bill thật / lập hóa đơn; thêm công đoạn vào đơn đã Hoàn tất ⇒ đơn quay về Đang thực hiện. Thứ tự và trạng thái do máy chủ quyết định, không nhận từ client.
Thông báo lỗi chính	`E4013` “Công đoạn tối đa 20 mục.” `E4014` “Khóa thông tin "Số seal" bị trùng.” `E4004` “Công đoạn "Cảng đi" đang ở trạng thái "Đang xử lý", không thể xóa.” `E4006` “Đơn hàng phải còn ít nhất một công đoạn.” `E4007` “Chỉ sắp xếp lại được các công đoạn chưa bắt đầu.” `E0004` “Biểu tượng không hợp lệ: ….” — chỉ chữ thường không dấu, số, gạch dưới (≤ 40).

UC-OT-07Chuyển trạng thái công đoạn
Actor	Nhân viên kho / chứng từ / hải quan, Quản lý công đoạn
Tiền điều kiện	Quyền `don-hang.cong-doan`; đơn chưa hủy.
Các bước	Chọn công đoạn rồi bấm một trong các nút theo trạng thái: Bắt đầu / Bỏ qua (Chưa bắt đầu); Hoàn thành / Bỏ qua (Đang xử lý); Mở lại (Hoàn thành hoặc Bỏ qua). Xác nhận `C4002` “Chuyển công đoạn "Cảng đến" sang "Hoàn thành"?”.
Kết quả	Công đoạn đổi trạng thái, báo `I4002` “Công đoạn "Cảng đến" đã chuyển sang "Hoàn thành".”; ngày bắt đầu / hoàn thành tự ghi.
Quy tắc / validation	Luật công đoạn: chỉ Hoàn thành / Bỏ qua được khi mọi công đoạn đứng trước đã Hoàn thành hoặc Bỏ qua. Mở lại bị chặn khi có công đoạn đứng sau đã xong (`E4016` — phải mở lại công đoạn sau trước) và, với công đoạn bật cờ lập hóa đơn, khi đơn còn hóa đơn chưa hủy (`E4017`). Nút Mở lại bị khóa kèm gợi ý (tooltip) khi biết chắc sẽ bị chặn. Mỗi đơn chỉ có một công đoạn Đang xử lý. Bấm Bắt đầu khi đơn đã có công đoạn khác đang xử lý bị chặn (`E4018`; nút Bắt đầu bị khóa kèm gợi ý) — phải hoàn thành hoặc bỏ qua công đoạn đang xử lý trước. Khi Mở lại một công đoạn mà công đoạn đứng sau đang xử lý, công đoạn sau tự quay về Chưa bắt đầu (giữ ngày bắt đầu, ghi Audit trail); hộp xác nhận nêu rõ điều này. Sau khi một công đoạn xong / bỏ qua, công đoạn kế tiếp đang Chưa bắt đầu tự chuyển Đang xử lý (chỉ khi không còn công đoạn nào khác đang xử lý). Hoàn thành công đoạn có cờ “kích hoạt bill thật” ⇒ tự lập bill thật (Bỏ qua không kích hoạt). Mọi công đoạn xong / bỏ qua ⇒ đơn tự Hoàn tất; mở lại một công đoạn ⇒ đơn về Đang thực hiện. Chuyển trạng thái ghi vào Audit trail.
Thông báo lỗi chính	`E4004` “Công đoạn "Cảng đi" đang ở trạng thái "Hoàn thành", không thể chuyển sang Hoàn thành.” `E4005` “Phải hoàn thành hoặc bỏ qua các công đoạn trước "Cảng đến".” `E4016` “Không mở lại được công đoạn "Kho nguồn": công đoạn sau "Cảng đi" đã xong, hãy mở lại công đoạn sau trước.” `E4017` “Công đoạn "Kho đến" đã có hóa đơn 1 chưa hủy, không mở lại được.” `E4018` “Công đoạn "Cảng đi" đang xử lý, hãy hoàn thành hoặc bỏ qua trước khi bắt đầu "Cảng đến".”

UC-OT-08Thêm / sửa / xóa / đánh dấu xong mốc
Actor	Nhân viên kho / chứng từ / hải quan
Tiền điều kiện	Quyền `don-hang.moc`; đơn chưa hủy.
Các bước	Thêm: bấm Thêm mốc dưới dòng thời gian ⇒ sidebar; nhập tên mốc, ngày dự kiến, ngày thực tế (bỏ trống = chưa xong), địa điểm, ghi chú; Lưu. Sửa / xóa: bấm vào mốc trên dòng thời gian ⇒ sidebar; Lưu hoặc Xóa (xác nhận `C4006` “Xóa mốc "Nộp MNF cho hải quan"?”). Đánh dấu xong nhanh: bấm dấu ✓ cạnh mốc chưa xong ⇒ ngày thực tế = hôm nay.
Kết quả	Dòng thời gian cập nhật: mốc xong hiện ngày + địa điểm, mốc trễ hiện đỏ kèm ngày dự kiến.
Quy tắc / validation	Tên mốc bắt buộc ≤ 255; địa điểm ≤ 255; ghi chú ≤ 1000; ngày thực tế không được sau hôm nay; tối đa 50 mốc / công đoạn. Mốc chỉ thuộc công đoạn của chính đơn đó (không thao tác chéo đơn). Mốc không làm đổi trạng thái công đoạn — hoàn thành công đoạn vẫn là thao tác riêng.
Thông báo lỗi chính	`E0001` “Tên mốc không được để trống.” `E0004` “Ngày thực tế không hợp lệ: không được sau hôm nay.” `E4013` “Mốc tối đa 50 mục.” `E4008` “Mốc không thuộc đơn hàng SCMDPC29102608.”

UC-OT-09Gán phụ trách / quản lý, xem lịch sử
Actor	Quản lý công đoạn, Quản trị viên
Tiền điều kiện	Quyền `don-hang.phan-cong`; đơn chưa hủy.
Các bước	Ở khối công đoạn bấm Đổi người ⇒ sidebar “Đổi người phụ trách”. Với mỗi vai trò (Phụ trách / Quản lý) chọn nhân viên (hoặc “— Bỏ gán”), nhập lý do (tùy chọn ≤ 500), bấm Lưu phụ trách / Lưu quản lý. Xem mục Lịch sử bên dưới: ai → ai, lý do, người đổi, lúc nào.
Kết quả	Người phụ trách hiện ở thanh tiến trình, dòng chi tiết và cột “Đang thực hiện” của danh sách; lịch sử có thêm một dòng.
Quy tắc / validation	Chỉ chọn được nhân viên có trạng thái Đang làm; chọn lại đúng người hiện tại thì không ghi gì. Một người quản lý nhiều công đoạn ⇒ màn hiện “· cũng quản lý …”. Mỗi lần đổi ghi cả lịch sử phân công riêng và Audit trail.
Thông báo lỗi chính	`E0002` “Nhân viên không tồn tại hoặc đã bị xóa.” `E0004` “Nhân viên không hợp lệ: NGHI_VIEC.” `E0006` “Bạn không có quyền thực hiện thao tác này.”

UC-OT-10Cấu hình loại công đoạn
Actor	Quản trị viên
Tiền điều kiện	Quyền màn Cấu hình công đoạn (`dl-congdoan`).
Các bước	Mở Dữ liệu nền › Cấu hình công đoạn: xem bảng loại công đoạn và dải “Xem trước đơn mới”. Thêm (nút Thêm loại công đoạn) hoặc sửa (bấm dòng) ⇒ sidebar rộng. Nhập mã, tên, biểu tượng, thứ tự, “Mặc định cho đơn mới”, mô tả, vai trò và người phụ trách / quản lý mặc định, danh sách mốc mẫu, danh sách trường thông tin, hai cờ bill / hóa đơn; kéo thả hoặc dùng mũi tên để đổi thứ tự dòng; Lưu. Xóa bằng biểu tượng thùng rác trên dòng.
Kết quả	Cấu hình mới chỉ áp cho đơn tạo sau đó; đơn đã có giữ nguyên công đoạn đã chép.
Quy tắc / validation	Mã bắt buộc ≤ 20 (chữ không dấu, số, `. _ -`; tự viết HOA), không đổi sau khi tạo, không trùng; tên ≤ 100; biểu tượng chữ thường / số / gạch dưới ≤ 40; mô tả ≤ 500; vai trò ≤ 50; thứ tự 0 … 9999. Mốc mẫu và trường thông tin: tối đa 30 dòng; mốc ≤ 255, khóa ≤ 100 ký tự; khóa thông tin không trùng. Cờ kích hoạt bill thật và cờ bắt đầu lập hóa đơn mỗi cờ chỉ bật ở một loại công đoạn. Chỉ chọn người mặc định là nhân viên Đang làm. Không xóa được loại đã dùng trong đơn.
Thông báo lỗi chính	`E0005` “Mã loại công đoạn đã tồn tại.” `E4009` “Chỉ một loại công đoạn được bật "Kích hoạt bill thật" (đang bật ở Kho nguồn).” `E4013` “Mốc mẫu tối đa 30 mục.” `E4014` “Khóa thông tin "Số seal" bị trùng.” `E2001` “Loại công đoạn KHO_NGUON đang được dùng ở 7 bản ghi, không xóa được.”

UC-OT-11Tự bắt đầu công đoạn, hoàn tất đơn, tạo bill
Actor	Hệ thống
Tiền điều kiện	Tạo đơn hoặc chuyển trạng thái công đoạn.
Các bước	Tạo đơn ⇒ lập công đoạn, mốc mẫu, bill nháp; công đoạn Báo giá tự Hoàn thành (ngày mốc, thông tin lấy từ báo giá) và công đoạn kế bắt đầu. Xong / bỏ qua một công đoạn ⇒ bắt đầu công đoạn kế. Hoàn thành công đoạn có cờ bill thật ⇒ lập bill thật chép tiền từ bill nháp mới nhất (chỉ lập một lần) ⇒ hiện thông báo “Đã tạo bill thật cho đơn hàng <RFF.No>.” cùng thông báo đổi trạng thái. Mọi công đoạn xong / bỏ qua ⇒ đơn Hoàn tất.
Kết quả	Tiến độ đơn luôn nhất quán với trạng thái các công đoạn; thao tác trên cùng một đơn được xử lý tuần tự (khóa đơn).
Quy tắc / validation	Công đoạn Báo giá hoàn thành ngay khi tạo đơn, công đoạn kế tiếp bắt đầu ngay. Việc lập bill thật tự động được ghi vào Audit trail của đơn (lý do “Hoàn thành <công đoạn>”).
Thông báo lỗi chính	—

UC-OT-12Lấy tiến độ từ báo giá (đơn tạo trước đây)
Actor	Nhân viên kinh doanh, Quản lý công đoạn, Quản trị viên
Tiền điều kiện	Quyền `don-hang.cong-doan`; đơn chưa hủy; đang chọn công đoạn “Báo giá” ở trạng thái Chưa bắt đầu, Đang xử lý hoặc Hoàn thành mà còn ô trống (mốc chưa có ngày, thông tin chưa điền). Dùng cho đơn tạo trước khi hệ thống tự điền công đoạn Báo giá.
Các bước	Chọn công đoạn “Báo giá”, bấm Lấy tiến độ từ báo giá. Xác nhận `C4007`.
Kết quả	Hệ thống điền ngày các mốc và thông tin còn trống theo báo giá gốc (quy tắc như UC-OT-01); nếu công đoạn chưa Hoàn thành thì hoàn thành luôn và công đoạn kế bắt đầu. Báo `I4005` “Đã lấy tiến độ công đoạn "Báo giá" từ báo giá SCMDPC29102652: điền ngày cho 2 mốc.”
Quy tắc / validation	Không ghi đè dữ liệu đã nhập: ô nào đã có ngày / giá trị thì giữ nguyên, chỉ điền ô còn trống. Hoàn thành công đoạn theo luật công đoạn: các công đoạn đứng trước phải xong hoặc bỏ qua. Ghi vào Audit trail của đơn; thao tác trên đơn được xử lý tuần tự.
Thông báo lỗi chính	`E4019` “Công đoạn "Cảng đi" không phải công đoạn Báo giá, không lấy được tiến độ từ báo giá.” `E4004` công đoạn đang Bỏ qua, không lấy được tiến độ. `E4005` còn công đoạn đứng trước chưa xong. `E4003` đơn đã hủy.

4.Luồng màn hình

Màn hìnhPopup (hộp thoại)Sidebar phảiThao tác chuyển mànHệ thống tự chuyển / quay về

Màn theo dõi là một trang riêng (địa chỉ theo RFF.No). Form ngắn thao tác trên một công đoạn / mốc / người (công đoạn, sắp xếp, mốc, phân công, chứng từ, loại công đoạn, thu tiền) mở dạng sidebar phải rộng 400 / 480 / 640px, trên mobile (≤ 600px) chiếm toàn chiều ngang; form nhiều trường của cả đơn (tạo đơn, sửa đơn, bill, hóa đơn) mở dạng popup giữa màn. Sidebar và popup đóng bằng nút Hủy, dấu × hoặc phím Esc mà không lưu; lưu thành công thì đóng và màn theo dõi tải lại (xem Popup và sidebar ở Khung). Trên màn theo dõi, nút Lấy tiến độ từ báo giá (công đoạn Báo giá của đơn cũ) mở popup xác nhận rồi tải lại màn. Chứng từ mở sang Chứng từ đơn hàng, bill / hóa đơn sang Bill, hóa đơn, công nợ.

5.Màn hình

Danh sách đơn

**Mobile 375px: mỗi đơn là một thẻ** (RFF.No, khách hàng, tuyến, giai đoạn, ETA, tình trạng); bấm thẻ mở theo dõi

**Lọc chip “Cảng đi”: chỉ các đơn đang ở công đoạn Cảng đi**

Theo dõi đơn

**Đơn nước ngoài đang ở Cảng đi — có mốc trễ, tình trạng “Chậm tiến độ”**
Khối đầu: RFF.No (nút Sao chép), loại, tình trạng, khách hàng, hàng hóa, ETA kho đến; nút Sửa thông tin / Hủy đơn
Thanh tiến trình các công đoạn: tròn xanh = xong, đỏ có viền vàng = đang làm, trắng = chưa bắt đầu; dưới mỗi công đoạn là người phụ trách
Thêm công đoạn / Sắp xếp
Chi tiết công đoạn: người phụ trách / quản lý (Đổi người), nút Hoàn thành / Bỏ qua / Sửa công đoạn
Dòng thời gian mốc: chấm xám = xong, chấm đỏ = trễ (“Dự kiến 27/10”), dấu ✓ đánh dấu xong hôm nay
Khối “Dữ liệu cảng đi” (cặp khóa – giá trị của công đoạn) và chứng từ của công đoạn

**Đơn trong nước: hai công đoạn cảng ở trạng thái Bỏ qua, đang ở Kho đến**

**Đơn đã hoàn tất: mọi công đoạn xong, công đoạn cuối có nút Mở lại, bill / hóa đơn phía dưới**

**Mobile 375px: thanh tiến trình xếp dọc**

**Mobile 375px: chi tiết công đoạn và dòng thời gian**

**Sidebar Mốc: sửa mốc “Thông quan xuất khẩu” đã trễ**
Tên mốc (bắt buộc ≤ 255)
Ngày dự kiến / Ngày thực tế (bỏ trống = chưa xong; không sau hôm nay)
Địa điểm ≤ 255, ghi chú ≤ 1000
Xóa (chỉ khi sửa mốc) · Hủy · Lưu

**Sidebar Phân công: đổi người phụ trách và xem lịch sử**
Người phụ trách hiện tại và ô chọn nhân viên (hoặc “— Bỏ gán”)
Lý do ≤ 500 và nút Lưu phụ trách
Khối Quản lý tương tự
Lịch sử: ai → ai, lý do, người đổi, lúc nào

**Sidebar Sửa công đoạn: thông tin chung và các cặp khóa – giá trị**

**Sidebar Sắp xếp: chỉ kéo được công đoạn chưa bắt đầu**

Công đoạn (thêm / sửa)

Tên trường	Bắt buộc	Độ dài / khoảng	Giá trị hợp lệ	Ghi chú
Tên công đoạn	Có	≤ 100
Biểu tượng	—	≤ 40	Chữ thường không dấu, số, `_`	Bỏ trống = `flag`; gợi ý biểu tượng Material
Mô tả	—	≤ 500
Vai trò phụ trách	—	≤ 50		vd “Hải quan”
Ngày dự kiến	—	—	Ngày
Địa điểm	—	≤ 255
Thông tin — Khóa	Có (mỗi dòng)	≤ 100	Không trùng trong công đoạn	Tối đa 30 dòng
Thông tin — Giá trị	—	≤ 500

Mốc

Tên trường	Bắt buộc	Độ dài / khoảng	Giá trị hợp lệ	Ghi chú
Tên mốc	Có	≤ 255
Ngày dự kiến	—	—	Ngày
Ngày thực tế	—	—	Ngày ≤ hôm nay	Có ngày = mốc xong
Địa điểm	—	≤ 255
Ghi chú	—	≤ 1000
Số mốc	—	≤ 50 / công đoạn

Phân công

Tên trường	Bắt buộc	Độ dài / khoảng	Giá trị hợp lệ	Ghi chú
Vai trò	Có	—	KBN `ORDER_ASSIGN_ROLE` (Phụ trách / Quản lý)	Mỗi vai trò lưu riêng
Nhân viên	—	—	Nhân viên Đang làm	Bỏ trống = bỏ gán
Lý do	—	≤ 500		Ghi vào lịch sử

**Hủy đơn: hộp thoại yêu cầu nhập lý do**

Sửa thông tin đơn

Tên trường	Bắt buộc	Độ dài / khoảng	Giá trị hợp lệ	Ghi chú
Hàng hóa	—	≤ 500
Số lượng (mô tả)	—	≤ 255		vd “24 pallet”
Trọng lượng (kg)	—	0 … 99.999.999.999,999	≤ 3 chữ số lẻ
Kho nguồn / Kho đến	—	—	Danh mục kho bãi
Cảng đi / Cảng đến	—	—	Danh mục cảng
Agent	—	—	Danh mục đối tác	Dùng cho đơn trong nước
Tàu / chuyến	—	≤ 100
Số B/L	—	≤ 50
ETA kho đến	—	—	Ngày
Tình trạng	Có	—	KBN `ORDER_HEALTH`	Chọn tay
Ghi chú	—	≤ 2000
Lý do hủy	Có (khi hủy)	≤ 500

Cấu hình công đoạn

**Sidebar Sửa loại công đoạn (640px): thông tin, người mặc định, mốc mẫu, trường thông tin, cờ**
Mã khóa sau khi tạo
Biểu tượng xem trước, thứ tự, “Mặc định cho đơn mới”
Vai trò và người phụ trách / quản lý mặc định
Mốc mẫu: kéo thả hoặc nút lên / xuống / xóa
Hai cờ Bill / hóa đơn (cuối sidebar)

**Mobile 375px: bảng cuộn ngang, sidebar chiếm toàn màn hình khi mở**

Tên trường	Bắt buộc	Độ dài / khoảng	Giá trị hợp lệ	Ghi chú
Mã	Có	≤ 20	Chữ không dấu, số, `. _ -`; tự HOA	Không đổi sau khi tạo; không trùng
Tên	Có	≤ 100
Biểu tượng	Có	≤ 40	Chữ thường, số, `_`
Thứ tự	—	0 … 9999	Số nguyên	Xếp công đoạn khi tạo đơn
Mặc định cho đơn mới	—	—	Chọn / bỏ chọn	Bỏ chọn: không tự thêm, vẫn thêm tay được
Mô tả / gợi ý	—	≤ 500
Vai trò phụ trách	—	≤ 50
Phụ trách / Quản lý mặc định	—	—	Nhân viên Đang làm
Mốc mẫu	—	≤ 30 dòng; mỗi dòng ≤ 255		Chép vào đơn mới
Trường thông tin	—	≤ 30 dòng; khóa ≤ 100	Không trùng	Chép vào đơn mới (giá trị trống)
Kích hoạt bill thật	—	—	Chỉ một loại được bật	Mặc định: Kho nguồn
Bắt đầu lập hóa đơn	—	—	Chỉ một loại được bật	Mặc định: Kho đến

Công đoạn Báo giá tự điền

Đơn mới: công đoạn Báo giá đã Hoàn thành, ba mốc có ngày, thông tin lấy từ báo giá; Kho nguồn đang xử lý — **Đơn mới tạo từ báo giá: công đoạn Báo giá tự Hoàn thành, các mốc có ngày, Số báo giá / Hiệu lực đến / Điều khoản TT đã điền, Kho nguồn bắt đầu ngay**

Đơn tạo trước đây: công đoạn Báo giá Đang xử lý, mốc và thông tin trống, nút Lấy tiến độ từ báo giá — **Đơn tạo trước đây: Báo giá còn trống, có nút Lấy tiến độ từ báo giá**

Từ báo giá sang đơn

**Báo giá khách chấp nhận chưa có đơn: nút Tạo đơn hàng**

**Báo giá đã có đơn: nút Mở theo dõi (không còn Tạo đơn hàng)**

6.Trạng thái & quy tắc

Trạng thái công đoạn

Đường đứt nét đỏ: Mở lại đưa công đoạn Hoàn thành / Bỏ qua về Đang xử lý (bị chặn bởi E4016 / E4017). Mỗi đơn chỉ có một công đoạn Đang xử lý: Bắt đầu bị chặn (E4018) khi đã có công đoạn khác đang xử lý, và Mở lại đưa công đoạn sau đang xử lý về Chưa bắt đầu. Công đoạn kế tiếp tự chuyển Chưa bắt đầu → Đang xử lý khi công đoạn trước xong hoặc bỏ qua (và không còn công đoạn nào khác đang xử lý). Chuyển “Hoàn thành / Bỏ qua” chỉ hợp lệ khi mọi công đoạn trước đã Hoàn thành / Bỏ qua.

Trạng thái công đoạn — ORDER_STAGE_STATUS

Mã	Nhãn hiển thị	Thao tác tiếp theo
`CHUA_BAT_DAU`	Chưa bắt đầu	Bắt đầu, Bỏ qua, Sửa, Xóa, sắp xếp
`DANG_XU_LY`	Đang xử lý	Hoàn thành, Bỏ qua, Sửa, cập nhật mốc / phân công
`HOAN_THANH`	Hoàn thành	Mở lại (nếu không bị chặn)
`BO_QUA`	Bỏ qua	Mở lại (nếu không bị chặn)

Trạng thái đơn hàng

Trạng thái đơn — ORDER_STATUS

Mã	Nhãn hiển thị	Ý nghĩa
`DANG_THUC_HIEN`	Đang thực hiện	Còn ít nhất một công đoạn chưa xong; cho mọi thao tác theo quyền
`HOAN_TAT`	Hoàn tất	Mọi công đoạn Hoàn thành / Bỏ qua; cho lập hóa đơn; mở lại hoặc thêm công đoạn ⇒ về Đang thực hiện
`HUY`	Đã hủy	Chỉ xem; hủy bill; không còn thao tác ghi

Tình trạng đơn — ORDER_HEALTH (người dùng chọn tay ở popup Sửa thông tin đơn)

Mã	Nhãn hiển thị	Màu
`DUNG_TIEN_DO`	Đúng tiến độ	xanh
`CAN_CHU_Y`	Cần chú ý	vàng
`CHAM_TIEN_DO`	Chậm tiến độ	đỏ

Hệ thống không tự tính tình trạng từ mốc trễ: mốc trễ chỉ hiện đỏ trên dòng thời gian; người phụ trách tự chuyển tình trạng của đơn. Đơn Hoàn tất / Đã hủy hiển thị “Hoàn tất” / “Đã hủy” thay cho tình trạng.

Vai trò phân công — ORDER_ASSIGN_ROLE

Mã	Nhãn hiển thị
`PHU_TRACH`	Phụ trách
`QUAN_LY`	Quản lý

5 công đoạn mặc định khi tạo đơn

#	Loại (mã)	Vai trò mặc định	Mốc mẫu	Trường thông tin	Cờ
1	Báo giá `BAO_GIA`	Kinh doanh	Tạo báo giá & cấp RFF.No · Duyệt nội bộ · Khách xác nhận báo giá	Số báo giá · Hiệu lực đến · Điều khoản TT	—
2	Kho nguồn `KHO_NGUON`	Kho	Nhận hàng tại kho gửi · Kiểm đếm & đóng container · Xe rời kho đi cảng	Số lượng · Trọng lượng · Số seal	Kích hoạt bill thật
3	Cảng đi `CANG_DI`	Chứng từ	Hạ bãi · Thông quan xuất khẩu · Tàu chạy (ATD)	Tàu / chuyến · ETD · Số B/L · Container	—
4	Cảng đến `CANG_DEN`	Hải quan	Tàu cập cảng (ATA) · Nộp MNF cho hải quan · Thông quan & lấy hàng khỏi cảng	ETA · Số MNF / Bill nháp · Tờ khai nhập · Trạng thái HQ	—
5	Kho đến `KHO_DEN`	Kho	Xe đến kho nhận · Khách ký nhận (POD) · Xuất hóa đơn cho khách	Ngày giao · Người nhận	Bắt đầu lập hóa đơn

Quản trị viên sửa danh sách này ở Cấu hình công đoạn; thay đổi chỉ áp cho đơn tạo sau. Thứ tự do cột “Thứ tự” (10, 20, … 50) quyết định.

Công đoạn Báo giá tự điền ngày mốc theo tên mốc: tên chứa “tạo” / “RFF” ⇒ ngày tạo RFF; chứa “duyệt” ⇒ ngày duyệt nội bộ; chứa “khách” kèm “xác nhận” / “chấp nhận” / “đồng ý” / “duyệt” ⇒ ngày khách chấp nhận. Đổi tên mốc vẫn tự điền nếu tên còn các từ khóa này; tên khác thì người dùng nhập tay.

Mốc trên dòng thời gian

Hiển thị	Điều kiện
Xong (chấm đặc, có ngày + địa điểm)	Có ngày thực tế
Trễ (chấm đỏ, “Dự kiến dd/MM”)	Chưa có ngày thực tế và ngày dự kiến nhỏ hơn hôm nay
Đang làm	Mốc chưa xong đầu tiên của công đoạn Đang xử lý
Chưa tới (chấm rỗng)	Các mốc còn lại

Giới hạn

Mục	Giới hạn
Công đoạn / đơn	20
Mốc / công đoạn	50
Dòng thông tin / công đoạn	30
Mốc mẫu, trường thông tin / loại công đoạn	30 dòng mỗi danh sách
Lý do hủy, lý do phân công	≤ 500 ký tự
Ô tìm kiếm danh sách đơn	≤ 100 ký tự
Kích thước trang danh sách	20 / 50 / 100 (tối đa 200)

Thông báo lỗi và xác nhận của module

Mã	Nội dung	Khi nào
`E4001`	Báo giá {0} chưa ở trạng thái “Khách chấp nhận”, không tạo được đơn hàng.	Tạo đơn từ báo giá chưa thắng
`E4002`	Báo giá {0} đã có đơn hàng.	Tạo đơn lần hai
`E4003`	Đơn hàng {0} đang ở trạng thái “{1}”, không thể {2}.	Sửa / hủy / thao tác khi đơn đã hủy hoặc không đúng trạng thái
`E4004`	Công đoạn “{0}” đang ở trạng thái “{1}”, không thể {2}.	Chuyển trạng thái / xóa sai trạng thái
`E4005`	Phải hoàn thành hoặc bỏ qua các công đoạn trước “{0}”.	Hoàn thành / bỏ qua khi công đoạn trước chưa xong
`E4006`	Đơn hàng phải còn ít nhất một công đoạn.	Xóa công đoạn cuối cùng
`E4007`	Chỉ sắp xếp lại được các công đoạn chưa bắt đầu.	Sắp xếp làm đổi vị trí công đoạn đã bắt đầu
`E4008`	{0} không thuộc đơn hàng {1}.	Công đoạn / mốc / bill / hóa đơn của đơn khác
`E4009`	Chỉ một loại công đoạn được bật “{0}” (đang bật ở {1}).	Bật cờ thứ hai ở Cấu hình công đoạn
`E4013`	{0} tối đa {1} mục.	Vượt 20 công đoạn / 50 mốc / 30 dòng
`E4014`	Khóa thông tin “{0}” bị trùng.	Khóa thông tin trùng
`E4016`	Không mở lại được công đoạn “{0}”: công đoạn sau “{1}” đã xong, hãy mở lại công đoạn sau trước.	Mở lại sai thứ tự
`E4017`	Công đoạn “{0}” đã có hóa đơn {1} chưa hủy, không mở lại được.	Mở lại công đoạn lập hóa đơn khi còn hóa đơn
`E4018`	Công đoạn “{0}” đang xử lý, hãy hoàn thành hoặc bỏ qua trước khi bắt đầu “{1}”.	Bắt đầu công đoạn khi đơn đã có công đoạn khác đang xử lý
`E4019`	Công đoạn “{0}” không phải công đoạn Báo giá, không lấy được tiến độ từ báo giá.	Lấy tiến độ từ báo giá trên công đoạn khác Báo giá
`I4005`	Đã lấy tiến độ công đoạn “{0}” từ báo giá {1}: điền ngày cho {2} mốc.	Sau khi lấy tiến độ từ báo giá
`C4007`	Lấy tiến độ công đoạn “{0}” từ báo giá {1}? Hệ thống điền ngày các mốc và trường thông tin còn trống, hoàn thành công đoạn nếu chưa hoàn thành; dữ liệu đã nhập được giữ nguyên.	Hộp xác nhận trước khi lấy tiến độ
`I4001` · `I4002`	Đã tạo đơn hàng {0}. · Công đoạn “{0}” đã chuyển sang “{1}”.	Thông báo thành công
`C4001` … `C4006`	Xác nhận: tạo đơn, chuyển công đoạn, xóa công đoạn, ghi nhận công nợ, hủy đơn, xóa mốc.	Hộp thoại xác nhận

Một đơn – nhiều người cùng làm. Mọi thao tác ghi trên cùng một đơn (công đoạn, mốc, phân công, bill, hóa đơn) được máy chủ xử lý lần lượt; người đến sau gặp dữ liệu đã đổi sẽ nhận thông báo “đã bị người khác thay đổi” và tải lại.