Giao diện
Debit Note — Phụ phí, Trip Cost & Đối chiếu Báo giá
Quản lý khoản phải thu / phải trả ngoài hợp đồng. Trip costs tự sinh từ Fleet. Đối chiếu giá bill vs báo giá chốt. Đa đồng tiền, khoá tỷ giá. Route: /finance/debit-notes.
Khái niệm
Debit Note (Báo nợ) là chứng từ tài chính phát hành khi có chi phí phát sinh ngoài hợp đồng vận chuyển — phụ phí, sự cố, sửa chữa container, lưu kho, v.v.
Khi nào phát hành Debit Note:
- Phụ phí DEM/DET (lưu container/lưu bãi quá hạn)
- Sửa chữa container hỏng (theo biên bản gate-out)
- Phí phát sinh tại cảng (THC, sealing, x-ray bổ sung)
- Bồi thường sự cố vận chuyển (đổ hàng, móp container)
- Trip costs: xăng, cầu đường, phụ cấp tài xế
Khác với Invoice
Invoice là chứng từ thanh toán cước chính theo hợp đồng. Debit Note là chứng từ bổ sung cho khoản phụ phí ngoài hợp đồng — luôn liên kết tới Shipment / Container gốc.
Tạo từ Shipment
Vào chi tiết Shipment → tab Công nợ → nút + Tạo Debit Note. Hệ thống auto-fill partner, cost line gợi ý từ phụ phí phát hiện, multi-currency theo partner default.
Luồng tạo:
Mở Shipment → Tab Công nợ → Chọn partner phải thu → Thêm cost line → Review & gửi
Danh sách giấy báo nợ
Màn hình danh sách hiển thị toàn bộ Debit Note của workspace — trạng thái, tổng tiền và hạn thanh toán để kế toán theo dõi nhanh.
Mẹo
Nếu phụ phí đến từ EIR / Gate event đã extract sẵn, hệ thống điền số tiền + ngày phát sinh tự động — kế toán chỉ review và confirm.
Trip costs tự sinh
Chi phí chuyến xe (trip costs) tự động sinh dòng debit note khi Trip hoàn thành — nối Fleet Module sang Finance, không cần nhập tay.
Các loại trip cost tự động:
| Loại cost | Nguồn | Sinh debit note khi |
|---|---|---|
| Xăng dầu | FuelLog.totalCost liên kết Trip | Trip DELIVERED |
| Phí cầu đường | Trip.tollFee (nhập tay hoặc GPS) | Trip DELIVERED |
| Phụ cấp tài xế | Trip.driverAllowance | Trip DELIVERED |
| Cước thuê xe ngoài | Trip.vendorCost (nhà xe TRUCKER) | Invoice AP nhà xe |
Xem tại Shipment
Từ chi tiết Shipment → tab Tài chính → Trip Costs để xem tất cả dòng chi phí chuyến xe đã sinh. Mỗi dòng có nút drill-down về Trip gốc.
Liên kết xăng
FuelLog → Trip → Shipment → Debit Note là chuỗi tự động. Xem chi tiết tại Quản lý nhiên liệu.
Đối chiếu báo giá
Khi nhận bill/invoice từ nhà cung cấp, hệ thống so chiếu từng dòng cost với giá đã chốt trong Quote (acceptedVersionNo) — cảnh báo lệch để kế toán xử lý trước khi thanh toán.
Ví dụ đối chiếu:
| Dòng chi phí | Giá báo (acceptedVersion) | Giá bill | Trạng thái |
|---|---|---|---|
| Ocean Freight | 850 USD | 850 USD | Khớp |
| THC xuất | 120 USD | 135 USD | Lệch +15 USD |
| Phí sửa manifest | — | 30 USD | Ngoài báo giá |
Chống tranh chấp và bill sót
Dòng lệch > 5% hoặc cost ngoài báo giá bị đánh dấu đỏ — kế toán phải ghi nhận lý do trước khi approve thanh toán. Audit trail đầy đủ cho mọi approve/reject.
Liên kết Quote
Để đối chiếu hoạt động, Shipment phải có quoteId liên kết. Khi tạo Shipment từ Quote ACCEPTED, liên kết được tạo tự động. Xem chi tiết tại Báo giá (Quotes).
Multi-currency
Debit Note hỗ trợ 3 đồng tiền: VND, USD, CNY. Tỷ giá được khoá tại thời điểm phát hành (không biến động sau).
| Trường | Mô tả | Ví dụ |
|---|---|---|
| currency | Mã đồng tiền cost line | USD |
| amount | Số tiền gốc | 1,200.00 |
| fx_rate | Tỷ giá tại ngày phát hành | 25,430 |
| amount_vnd | Quy đổi VND (auto-tính) | 30,516,000 ₫ |
| fx_locked_at | Timestamp khoá tỷ giá | 2026-05-30 14:22 |
Tỷ giá khoá vĩnh viễn
Sau khi phát hành (status SENT), tỷ giá KHÔNG cập nhật theo NHNN. Mọi điều chỉnh sau phải tạo Credit Note đối ứng — không sửa Debit Note cũ.
Trạng thái
State machine 4 trạng thái: DRAFT → SENT → PAID → DISPUTED
| Trạng thái | Mô tả | Hành động cho phép |
|---|---|---|
| DRAFT | Đang soạn, chưa gửi | Sửa, xoá, gửi |
| SENT | Đã gửi khách, chờ thanh toán | Đánh dấu paid, mở dispute |
| PAID | Đã thanh toán đủ | Chỉ xem, không sửa |
| DISPUTED | Khách phản đối, đang xử lý | Cập nhật bằng chứng, resolve |
Liên kết chứng từ
Mỗi Debit Note có thể liên kết nhiều chứng từ gốc làm bằng chứng:
- Invoice cước chính (mã, ngày)
- EIR có Số lệnh + container size (chứng minh lưu bãi)
- Gate event log (in/out timestamp)
- Biên bản sự cố / ảnh hiện trường
- Email xác nhận của hãng tàu
Xuất PDF
Xuất Debit Note ra PDF chuẩn để gửi khách qua email. Template có logo workspace, danh sách cost line, tỷ giá, ngân hàng nhận.
Tuỳ chọn xuất:
- Ngôn ngữ: Tiếng Việt / English / Song ngữ
- Đơn vị tiền: gốc / quy đổi VND / cả hai
- Đính kèm chứng từ gốc (zip)
- Watermark "DRAFT" nếu chưa SENT