Giao diện

Quản lý đội xe (Fleet) ​

Quản lý xe, tài xế, chuyến vận chuyển — tích hợp GPS VietMap, tự sinh trip costs vào Finance. Route: /fleet.

Tổng quan ​

Fleet Module quản lý đội xe nội bộ (xe nhà) và theo dõi chuyến thuê xe ngoài (nhà xe TRUCKER):

Đối tượngMô tả
Xe (Vehicle)Xe tải, xe container thuộc sở hữu workspace
Tài xế (Driver)Tài xế nội bộ, liên kết với xe
Chuyến (Trip)Một lần vận chuyển từ A đến B
Nhà xe (TRUCKER partner)Xe thuê ngoài — Trip.vendorCost

KPI đội xe:

Chỉ sốÝ nghĩa
Xe hoạt độngSố xe đang có chuyến trong tuần
Chuyến hoàn thành thángTổng Trip DELIVERED trong tháng
Km trung bình / chuyếnHiệu quả tuyến đường
Chi phí xăng / kmTheo dõi tiêu hao nhiên liệu
Dashboard Fleet
Dashboard đội xe — KPI và lịch chuyến tuần này

Xe & tài xế ​

Thêm xe:

  1. Vào /fleet/vehicles → + Thêm xe
  2. Điền: biển số, loại xe (đầu kéo / xe thùng / xe lạnh...), tải trọng, năm SX
  3. Nhập vietmapDeviceId nếu xe có GPS VietMap
  4. Ngày đăng kiểm, ngày bảo hiểm — hệ thống cảnh báo trước 30 ngày hết hạn

Thêm tài xế:

  1. Vào /fleet/drivers → + Thêm tài xế
  2. Điền: họ tên, CCCD, số bằng lái, hạng bằng lái
  3. Ngày hết hạn bằng lái — cảnh báo trước 30 ngày
  4. Gán xe mặc định (có thể thay đổi per-trip)

Cảnh báo đăng kiểm

Xe sắp hết đăng kiểm trong 30 ngày → Telegram alert đến OPS + ADMIN. Xe hết đăng kiểm không được tạo Trip mới.

Chuyến (Trip) ​

Tạo chuyến vận chuyển:

  1. Từ chi tiết Container (GATE_OUT) → nút Tạo chuyến hoặc vào /fleet/trips → + Tạo Trip
  2. Điền:
    • Container — liên kết container cần vận chuyển
    • Xe / Tài xế — hoặc chọn Nhà xe ngoài (TRUCKER partner)
    • Địa điểm đi — cảng / kho
    • Địa điểm đến — kho khách / cảng
    • Ngày giờ xuất phát
    • Phí cầu đường, phụ cấp tài xế (nếu biết trước)
  3. Lưu → Trip status = PLANNED

Vòng đời Trip:

Trạng tháiTrigger
PLANNEDMới tạo
IN_PROGRESSXe rời điểm đi (GPS auto hoặc tài xế xác nhận)
DELIVEREDXe đến điểm đến (GPS auto hoặc tài xế xác nhận)
COMPLETEDTài xế xác nhận giao hàng + upload bằng chứng

Tự sinh Debit Note khi Trip DELIVERED:

Loại costNguồn
Xăng dầuFuelLog liên kết Trip
Phí cầu đườngTrip.tollFee
Phụ cấp tài xếTrip.driverAllowance
Cước nhà xe ngoàiTrip.vendorCost
Chi tiết chuyến
Chi tiết Trip — timeline trạng thái và chi phí tự sinh

Chi tiết một chuyến xe ​

Nhấn vào dòng Trip trong danh sách để xem toàn bộ thông tin: lộ trình GPS, mốc giờ ra/vào cảng, và bảng breakdown chi phí (xăng, cầu đường, phụ cấp, cước nhà xe).

Chi tiết chuyến xe
Chi tiết chuyến xe — lộ trình, chi phí và mốc giờ ra/vào cảng

GPS & vị trí thực ​

Khi kết nối VietMap GPS:

  • Vị trí xe cập nhật realtime mỗi 30–60 giây
  • Bản đồ hiển thị tất cả xe đang hoạt động
  • Geofence cảng: xe vào/ra tự ghi gate timestamp
  • Trip tự chuyển IN_PROGRESS khi xe bắt đầu di chuyển
  • Đề xuất DELIVERED khi xe dừng > 10 phút tại địa điểm đến

Xem cách kết nối tại Tích hợp VietMap GPS.

Lịch & báo cáo ​

Lịch chuyến tuần:

Timeline view hiển thị tất cả Trip theo xe — dễ phát hiện xe trống hoặc chồng lịch.

Báo cáo Fleet theo kỳ:

Báo cáoNội dung
Hiệu suất xeKm, số chuyến, doanh thu / chi phí per xe
Tiêu hao nhiên liệuLít/100km, so sánh giữa các xe
Hiệu suất tài xếSố chuyến, đúng giờ, sự cố
Chi phí chuyếnTổng trip cost, breakdown theo loại

Cảnh báo hết hạn tự động ​

Hệ thống kiểm tra định kỳ và gửi cảnh báo theo 3 mốc: 30 ngày / 14 ngày / 7 ngày trước hạn:

Đối tượngLoại hết hạnNgười nhận alert
XeĐăng kiểmOPS + ADMIN
XeBảo hiểmOPS + ADMIN
XeĐăng ký xe (phù hiệu)OPS + ADMIN
Tài xếBằng láiOPS + ADMIN

Cảnh báo gửi qua Telegram (nếu đã cấu hình) + in-app notification. Xe hết đăng kiểm sẽ bị khóa không tạo Trip mới cho đến khi cập nhật ngày đăng kiểm.

Trip billing — tự sinh Debit Note ​

Khi Trip chuyển sang DELIVERED, hệ thống tự động:

  1. Tổng hợp toàn bộ cost của Trip (xăng, cầu đường, phụ cấp, cước nhà xe)
  2. Tạo Debit Note ở trạng thái DRAFT với origin = TRIP_AUTO
  3. Liên kết vào Shipment → Container → Trip (chain đầy đủ cho P&L)
  4. Kế toán review và chuyển sang SENT khi sẵn sàng gửi khách

Không cần nhập tay chi phí

Mọi chi phí Trip được tự động đẩy lên Debit Note — kế toán chỉ cần review và approve, không cần nhập tay từng dòng.

Xem chi tiết → Debit Note.

Phân công xe + tài xế ​

Quy tắc phân công:

  • 1 xe chỉ có 1 Trip IN_PROGRESS tại một thời điểm
  • 1 tài xế chỉ có 1 Trip IN_PROGRESS tại một thời điểm
  • Hệ thống cảnh báo nếu cố assign xe/tài xế đang bận vào Trip mới

Nhà xe ngoài (TRUCKER):

Nếu không có xe nhà, tạo Trip với TRUCKER partner thay vì xe nội bộ:

  • Chọn Nhà xe → search partner có role TRUCKER
  • Nhập cước nhà xe (vendorCost)
  • Không cần vehicle/driver record — Trip vẫn tạo được
  • Cost tự sinh vào Debit Note AP nhà xe