Features
PlatformLive

Staff & Payroll

Manage employee records, generate payroll calculations, produce payslips, and keep staff-related deductions and declarations visible.

Overview

The staff and payroll module at Staff & Payroll module is where VillaTax manages employee records, salary calculations, payroll-side deductions, and payroll-linked follow-up. It gives the product a structured way to handle recurring staff costs instead of leaving payroll logic outside the system.

The feature matters because salary, BPJS, withholding, payslips, and later declarations all need a stable employee record as their starting point.

Employee Records

A staff record can hold the core fields VillaTax needs to support payroll-related workflows, including:

  • employee identity information
  • role and employment context
  • salary
  • PTKP-related input
  • nationality and tax-residency context
  • BPJS participation fields
  • KITAS-related information where relevant

This is useful because payroll quality depends on setup quality. If the employee record is wrong, the rest of the payroll output becomes harder to trust.

Payroll Calculation Scope

The current product clearly supports payroll calculation around:

  • gross salary
  • BPJS-related deductions and employer-side portions
  • PPh 21 calculation through the TER-based workflow visible in code
  • resulting net salary

That makes the module a real payroll workflow rather than a simple staff directory.

BPJS and Withholding Context

VillaTax should describe this part carefully and concretely. The module handles BPJS and payroll-tax logic as part of the payroll record, but it should avoid over-claiming beyond what the code clearly supports.

The safe public understanding is:

  • BPJS employee and employer portions are reflected in payroll calculations
  • PPh 21 is calculated from the employee setup and payroll data
  • payroll outputs can feed downstream declaration and accounting workflows

That is already meaningful without stretching into unsupported legal detail.

Year-End and Period Logic

The payroll workflow is not just about one month’s number. It also matters because periodic salary processing can affect year-end review, employee declarations, and accounting consistency. The product’s value here is that payroll is part of the same operating system as the rest of the finance and tax stack, not a detached spreadsheet process.

Payslips and Follow-Through

The module connects directly to payslip generation and staff declarations. That is important because a payroll tool is only operationally useful if it does more than compute a number. Teams also need to:

  • produce a readable employee output
  • keep declaration follow-up visible
  • preserve the payroll trail for later review

VillaTax supports that broader workflow by tying staff records, payroll outputs, payslips, and declaration status together.

Foreign Staff Context

The product includes fields that matter for foreign-worker handling, such as nationality, tax-residency state, and KITAS-related information. The safe public claim is that VillaTax helps preserve the relevant context so payroll and follow-up work can be handled more carefully.

What should not be overpromised is automatic treaty-driven payroll intelligence or a claim that every foreign-worker edge case is fully solved in-product. The honest position is that the module supports the relevant staff context and flags, while more complex treatment still requires correct setup and review.

Relationship to Accounting

Payroll is financially important because it does not stop at salary calculation. It also affects the accounting layer. That is why the module belongs in VillaTax’s broader operating stack: payroll becomes part of the same financial story as expenses, liabilities, and reporting.

What It Does Not Try to Be

This should not be framed as a full enterprise HR suite. Its value is focused:

  • maintain the employee record
  • calculate payroll consistently
  • generate payroll outputs
  • support downstream staff-related tax and admin workflows

That is exactly the right scope for VillaTax.

Getting Started

Start in Staff & Payroll module by making the employee records complete and accurate first. Once the staff setup is clean, payroll generation, payslips, and declaration follow-up become much easier to trust period after period.

Open in dashboard

Access this feature in your workspace.