SLA Scorecard

Đo lường hiệu suất vận hành theo SLA — DEM/DET compliance, on-time delivery, partner performance. Route: /sla.

Tổng quan

SLA Engine tự động tính toán và theo dõi các chỉ số dịch vụ (Service Level Agreement) của từng lô hàng và đối tác.

KPI tổng quan workspace:

Chỉ số	Giá trị ví dụ	Mục tiêu
On-time delivery rate	87%	≥ 90%
DEM compliance rate	92%	≥ 95%
DET compliance rate	89%	≥ 95%
Avg container dwell time	4.2 ngày	≤ 5 ngày
SLA breach rate tháng	8%	≤ 5%

🔍

SLA Scorecard — KPI tổng workspace và breakdown theo đối tác

DEM/DET Compliance

Theo dõi tỷ lệ lấy hàng và trả container đúng free time.

DEM Compliance — phân tích:

Kết quả	Số container	Tỷ lệ
Lấy hàng trong free time	138	92%
Vượt free time 1–3 ngày	8	5.3%
Vượt free time > 3 ngày	4	2.7%

Nguyên nhân breach thường gặp:

Nguyên nhân	Tần suất
Tờ khai HQ chậm duyệt	45% breach
Hàng thiếu chứng từ KTCN	30% breach
Kho chưa sẵn sàng nhận	15% breach
Hãng tàu trả container chậm	10% breach

Giảm DEM breach

Theo dõi SLA countdown mỗi ngày buổi sáng — ưu tiên xử lý container DISCHARGED đã > 4 ngày. Kết nối ePort để nhận ngày DISCHARGED chính xác ngay khi tàu cập cảng.

On-time Delivery

Tỷ lệ lô hàng giao đúng hoặc trước ETA cam kết với khách.

Phân tích trễ hạn:

Nguyên nhân	Số lô	Tỷ lệ
Tàu trễ lịch (vessel delay)	12	48%
Thông quan chậm	8	32%
Vận chuyển nội địa trễ	5	20%

Luồng xử lý khi phát hiện nguy cơ trễ:

Phát hiện ETA thực > ETA cam kết → SLA Engine cảnh báo → Thông báo tự động cho khách → Ghi nhận nguyên nhân → Tính toán impact → Cập nhật ETA mới

🔍

On-time delivery dashboard — phân tích nguyên nhân và trend theo tháng

Partner Scorecard

Đánh giá hiệu suất từng đối tác (hãng tàu, nhà xe, forwarder) theo SLA.

Scorecard hãng tàu:

Hãng tàu	On-time departure	Vessel delay avg	DEM free time	Điểm
Evergreen	94%	0.8 ngày	7 ngày	A
COSCO	88%	1.5 ngày	5 ngày	B+
Yang Ming	82%	2.1 ngày	7 ngày	B

Scorecard nhà xe (Trucker):

Nhà xe	On-time pickup	On-time delivery	Sự cố	Điểm
Vận tải ABC	96%	94%	0	A
Xe tải XYZ	88%	85%	2	B

Dùng scorecard để đàm phán

Đưa scorecard vào cuộc họp với hãng tàu/nhà xe để yêu cầu cải thiện hoặc đàm phán điều kiện tốt hơn (free time, giá cước).

Cài đặt SLA

Cấu hình SLA mặc định:

1. Vào /settings/sla → cấu hình per loại lô hàng
2. Đặt ngưỡng cảnh báo (trigger alert khi còn N ngày)
3. Chọn kênh nhận alert (Telegram / Zalo / Email)
4. Cấu hình escalation (ai nhận alert cấp độ 2 khi không xử lý trong X giờ)

Override SLA per lô hàng:

Một số lô hàng có điều kiện đặc biệt (hàng tươi sống, hàng nguy hiểm) — override SLA tại chi tiết Shipment → tab SLA → Chỉnh sửa ngưỡng.

SLA Templates — cài sẵn cho từng loại lô hàng

Hệ thống có 3 preset template SLA theo loại lô hàng:

8 milestone SLA cho lô nhập khẩu:

Milestone	Trigger	SLA mặc định
Invoice nhận	DOCUMENT_APPLIED (Invoice)	T+1 ngày sau ETD
Packing List nhận	DOCUMENT_APPLIED (PL)	T+1 ngày sau ETD
Bill of Lading nhận	DOCUMENT_APPLIED (B/L)	T+3 ngày sau ETD
C/O nhận	DOCUMENT_APPLIED (CO)	T+5 ngày sau ETD
Bảo hiểm nhận	DOCUMENT_APPLIED (Insurance)	T+5 ngày sau ETD
Tờ khai nộp	DECLARATION_STATUS = SUBMITTED	T+2 ngày sau DISCHARGED
Hàng về đến	CONTAINER_STATUS = DISCHARGED	ETA thực tế
Giao hàng	CONTAINER_STATUS = DELIVERED	Free time DEM - 1 ngày

Cơ chế phát hiện breach

Cron job chạy mỗi giờ quét toàn bộ SLA milestone chưa hoàn thành:

1. So sánh dueDate với thời gian hiện tại
2. Nếu quá hạn → tạo breach record
3. Gửi thông báo Telegram / in-app

Chống spam alert: Unique constraint (trackingId, userId, UTC-day) đảm bảo mỗi người chỉ nhận 1 alert mỗi ngày cho cùng breach — dù cron chạy 24 lần/ngày.

SLA Milestone tự hoàn thành

Một số milestone tự động mark COMPLETED khi event tương ứng xảy ra:

Event	Milestone tự hoàn thành
document.applied (B/L)	Milestone "Bill of Lading nhận"
container.event.created (DISCHARGED)	Milestone "Hàng về đến"
declaration.status-changed (SUBMITTED)	Milestone "Tờ khai nộp"
container.event.created (DELIVERED)	Milestone "Giao hàng"