Corrections (điều chỉnh lịch sử lương)

Đường dẫn: /companies/{company_id}/corrections

Nó là gì?

Correction là một gói điều chỉnh để sửa các kỳ lương đã trả. Thay vì sửa trực tiếp kỳ lương cũ (không thể), bạn gom các thao tác vào một correction:

void_payroll: hủy một kỳ lương (toàn bộ hoặc một phần)
add_payroll: thêm kỳ lương thay thế hoặc bổ sung
balance_quarter: Check tự cân đối cuối quý

Cả gói được xem trước, duyệt và thực hiện cùng lúc. Thuế được bù trừ trong gói, giúp tránh trích thừa rồi hoàn lại.

Trên màn hình

Hình: Danh sách correction (đều draft, chờ Check Support)

Nút New correction. Bảng cột: #, ID, Status, Year, Created at, Updated at, Created by.

Ví dụ Zodinet: 2 correction cor_... ở trạng thái draft, năm 2026.

Vòng đời

Trạng thái	Ý nghĩa
`draft`	Đang soạn: thêm payroll cần void hoặc thêm mới
`pending`	Đã duyệt, chờ `settlement_date`; còn reopen được trước `reopen_deadline`
`processing`	Đang chuyển tiền; không reopen được
`settled`	Hoàn tất, đã phản ánh vào lịch sử lương
`failed`	Thực hiện lỗi, cần thử lại

Ví dụ: trả nhầm lương một nhân viên tuần trước

New correction, chọn năm thuế (mọi kỳ lương trong gói phải cùng năm).
Void payroll item của nhân viên đó trong kỳ cũ, gắn vào correction.
Thêm payroll mới với số liệu đúng, gắn vào cùng correction.
Preview: xem tổng chênh lệch (totals) và cảnh báo.
Approve.

Quy tắc

Chỉ sửa được khi ở draft. Thêm hoặc bớt payroll làm preview cũ mất hiệu lực.
Reopen một correction pending sẽ xóa kế hoạch chuyển tiền của nó.
Nếu không có tiền cần chuyển, correction chuyển thẳng sang settled khi duyệt.

API: POST /corrections, POST /corrections/{id}/preview, POST /corrections/{id}/approve, POST /payrolls/{id}/void (kèm correction). Webhook correction.