📖 Hướng dẫn Sử dụng: Quyết toán Bảng lương & Tra cứu Thu nhập (Payroll Settlement)

1. 📌 Định nghĩa & Mục đích Tính năng (Overview)

• Tên tính năng: Quyết toán Bảng lương, Tùy biến Phụ cấp/Giảm trừ & Chi trả VietQR (Payroll Settlement & Income Dashboard).
• Phân hệ áp dụng: 🌐 Web Dashboard (Kế toán & Quản lý Agency) / 📱 Zalo Mini App (Worker tra cứu thu nhập).
• Vấn đề giải quyết: Tự động hóa tính toán tiền lương theo ca làm thực tế, tích hợp công thức tùy biến phụ cấp/giảm trừ (payroll_custom_items), kiểm thực tài khoản ngân hàng thụ hưởng và hỗ trợ chi trả nhanh qua VietQR. Đồng thời giúp Worker theo dõi thu nhập minh bạch trên Zalo Mini App.
• Lợi ích mang lại:
  • Tự động đối soát 100% dữ liệu ca làm đã hoàn tất.
  • Hỗ trợ công thức tính lương tùy biến theo từng dự án hoặc Workspace.
  • Worker chủ động tra cứu lịch sử thu nhập qua biểu đồ trực quan.

2. 👥 Đối tượng Sử dụng & Quyền Hạn (Target Audience & IAM)

3. 📖 Thuật ngữ & Khái niệm Nghiệp vụ (Glossary)

• Payroll Period: Chu kỳ thanh toán lương (theo tuần, tháng hoặc theo đợt chiến dịch).
• Payroll Custom Items: Các mục phụ cấp hoặc giảm trừ mở rộng (phụ cấp xăng xe, tiền ăn, phạt trễ giờ, thưởng chuyên cần).
• Bank Account Validation: Cơ chế kiểm tra tính hợp lệ của số tài khoản và ngân hàng thụ hưởng trước khi tạo lệnh chuyển tiền.
• Net Payable: Số tiền thực nhận của Worker sau khi cộng phụ cấp và trừ các khoản khấu trừ/thuế.

4. 🔄 Luồng Trải nghiệm Người dùng (User Flow)

5. 🛠 Các Bước Thực hiện Chi tiết (Step-by-Step Guide)

🔹 Bước 1: Tạo Chu kỳ & Tính toán Lương trên Web Dashboard

1. Truy cập mục Bảng lương (/payrolls) ➔ Nhấn + Tạo kỳ lương mới.
2. Chọn khoảng thời gian (Từ ngày - Đến ngày) và Folder/Chiến dịch áp dụng.
3. Hệ thống tự động tổng hợp số ca hoàn tất, số giờ làm và tiền lương cơ bản của từng Worker.
4. Tùy chỉnh các khoản mục bổ sung:
   • Thêm phụ cấp (Hỗ trợ di chuyển, thưởng đạt KPI).
   • Thêm khoản giảm trừ (Vi phạm quy định, phạt trễ).

🔹 Bước 2: Kiểm thực Tài khoản & Chi trả VietQR

1. Kiểm tra trạng thái Hợp lệ tài khoản ngân hàng (Hệ thống hiển thị huy hiệu xanh khi số tài khoản đã được xác thực).
2. Nhấn Phê duyệt kỳ lương.
3. Sử dụng tính năng Xuất VietQR hàng loạt để quét thanh toán nhanh từ ứng dụng ngân hàng hoặc xuất file Excel đối soát.
4. Chọn đúng phiếu lương đã duyệt, tải lên ảnh biên lai chuyển khoản rồi nhấn Xác nhận đã thanh toán (Paid). Nếu chuyển sang phiếu khác, cần tải biên lai của phiếu đó trước khi xác nhận.

🔹 Bước 3: Worker Tra cứu Thu nhập trên Zalo Mini App

1. Worker mở ứng dụng Zalo, chọn tab Thu nhập (Payroll).
2. Màn hình hiển thị:
   • Tổng thu nhập tháng: Số tiền đã nhận (Paid) và số tiền đang chờ thanh toán (Pending).
   • Biểu đồ thu nhập (IncomeChart): Thống kê thu nhập theo từng tuần/tháng.
   • Danh sách phiếu lương: Nhấn vào từng phiếu để xem chi tiết tiền lương cơ bản, các khoản thưởng/phạt và số tài khoản nhận tiền.

🚨 6. Xử lý Lỗi Thường gặp (Troubleshooting & FAQs)