Payrolls (chạy lương)

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

Nó là gì?

Payroll là một lần trả lương cho một nhóm nhân viên và nhà thầu, với một kỳ tính công và một ngày trả lương. Trong payroll:

• Payroll item: dòng lương của từng nhân viên (thu nhập, giờ làm, tips, hoàn ứng…)
• Contractor payment: khoản trả cho từng nhà thầu

Trên màn hình

Hình: Danh sách payroll sau 16 kịch bản

• Banner Payroll Isn’t Set Up Yet kèm nút Begin Setup (nếu chưa hoàn tất Payroll setup)
• Nút Run payroll: tạo kỳ lương mới
• Menu More: thao tác khác (off-cycle…)

Các cột: Status, Pay period, Processing period, Pay date, Gross pay, Funding account, Type, Managed, Void.

Ví dụ Zodinet (sandbox): Paid · 10/10/2026 – 10/16/2026 · Three day · 10/23/2026 · $1,000.00 · Checking ··1234 · Regular · Managed: Yes · Void: No

Vòng đời trạng thái

Trạng thái	Khi nào	Có sửa được không
draft	Mới tạo	Sửa, xóa, preview được
pending	Đã Approve	Khóa; còn Reopen về draft được trước reopen_deadline
processing	Qua reopen_deadline, tiền bắt đầu chuyển	Không; muốn đổi phải liên hệ Check
paid	Đã trả xong cho mọi người	Chỉ void được
partially_paid	Có ít nhất một khoản trả nhân viên bị trả về	Xử lý ở Payments
failed	Trích tiền công ty thất bại	Công ty phải nạp lại, thường bằng wire

draft ──approve──► pending ──(reopen_deadline)──► processing ──► paid
  ▲                  │                               │            │
  └────reopen────────┘                               ▼            ▼
                                                   failed   partially_paid

Quy trình chạy một kỳ lương

Hình: Hộp Setup your next payroll — ① chọn Pay schedule · ② bấm Create payroll

Hình: Trình soạn payroll — ① nhập các dòng earning · ② Save Draft · ③ Preview payroll

Hình: Preview: tab Taxes — ① cash requirement · ② Submit payroll để duyệt

1. Run payroll: chọn pay schedule (hoặc nhập period và payday), loại regular.
2. Nhập dữ liệu: số giờ của từng nhân viên (theo earning rate), thưởng, tips, hoàn ứng; số tiền cho contractor. Mỗi khoản thu nhập phải có workplace.
3. Preview: Check tính thuế, phúc lợi, khấu trừ và net pay. Đọc kỹ warnings.
4. Approve trước approval deadline.
5. Theo dõi tiền đi ở Payments.

Công thức net pay

net_pay = gross − thuế nhân viên − đóng góp phúc lợi của nhân viên − thu nhập quy đổi − khấu trừ sau thuế + hoàn ứng

Quy tắc đã kiểm chứng trên sandbox

• Mỗi kỳ của pay schedule chỉ có một payroll regular; Console chỉ đề xuất kỳ có payday kế tiếp sau hôm nay.
• Nhân viên có $0 bị loại khỏi payroll khi lưu nháp.
• Overtime không tự nhân 1.5: Check lấy rate × giờ.
• Payroll toàn bộ Manual thì approval deadline = payday.
• Payday phải ≥ company start date.
• Chi tiết từng bước: Thực hành từng bước.

Hạn chót (production)

• ACH Three Day: duyệt trước 3pm ET, 3 ngày làm việc ngân hàng trước payday.
• Two Day / One Day: tương tự nhưng ngắn hơn, và bị giới hạn bởi weekly credit limit.
• Wire: hạn duyệt dời tới chiều ngày trả lương, nhưng công ty phải chuyển wire đúng số tiền trước giờ cắt.
• Reopen deadline: muộn hơn trong hai mốc “11am ET ngày approval deadline” và “1 giờ sau khi approve”, nhưng không quá approval deadline.
• Payroll ACH Three Day tối đa $1 triệu cash requirement mỗi kỳ.

Các loại payroll

Type	Dùng khi
regular	Kỳ lương bình thường theo lịch
off_cycle	Ngoài lịch: thưởng, hoa hồng, sửa sai, lương cuối khi nghỉ việc. Không dùng pay schedule. Tùy chọn: thuế supplemental cố định, có áp dụng phúc lợi và khấu trừ hay không
amendment, balancing	Do Check tạo khi điều chỉnh hoặc cân đối cuối quý

Managed = Yes: Check tính thuế. Managed = No: external payroll (nhập lịch sử).

Void (hủy kỳ lương đã trả)

• Chỉ void được payroll paid hoặc partially_paid.
• Void phải đi qua một Correction: tạo correction nháp, rồi void toàn bộ hoặc một phần payroll vào correction đó.
• Void tạo bút toán âm (lương, thuế, phúc lợi). Tiền đã vào tài khoản nhân viên không tự quay về; phải xử lý riêng.

Thử trong sandbox

Payroll đã duyệt tự đi pending → processing → paid khoảng mỗi 5 phút. Đặt tên công ty NSF Co. để thử lỗi thiếu tiền. Xem Sandbox và Production.

API: POST /payrolls → POST /payroll_items + POST /contractor_payments → GET /payrolls/{id}/preview → POST /payrolls/{id}/approve · POST /payrolls/{id}/reopen · POST /payrolls/{id}/void. Webhook payroll.