Batch cycles

Batch cycles

A batch cycle is the template every payroll run is created from: how often you pay, which days the pay period and attendance period end on, which employees are included, what gets calculated, and who can verify, approve and pay. Set up a batch cycle before your first payroll, and add another when a group of people is paid on a different schedule — for example a monthly cycle for staff and a separate yearly cycle for bonuses.

Where: Settings › Payroll › Batch Cycles

You need: write access to the Settings › Payroll right

Before You Start

New companies start with four cycles: Regular (Monthly), Regular (Semi-Monthly), Bonus (Yearly) and Commissions (Monthly). Edit these rather than adding duplicates. They have no currency, so the first time you edit one you must choose a Currency before it will save.

Each cycle has three tabs: Setup, Employees and Access.

How to set up a batch cycle

  1. Open Settings › Payroll › Batch Cycles and click Add New, or select an existing cycle and click Edit.
  2. On Setup, enter a Name and choose the Batch Type and Currency.
  3. Under Cut-offs, enter the Payroll cutoff and Attendance cutoff days (see below).
  4. Under Calculations, switch on what this cycle pays: Wages, Contributions, Taxes.
  5. Under Other Payments, leave on the payment types this cycle should pick up and switch off the ones you pay in a separate cycle.
  6. Click Save.
  7. Open the Employees tab and choose who is included.
  8. Open the Access tab and add the people who will work on this cycle's payrolls. See Batch cycle access and payslip approvals.
⚠️ A new cycle starts with Wages, Contributions and Taxes all switched off. A regular payroll cycle needs all three on, or its payslips will carry no salary, no contributions and no tax.

How to set the cut-offs

You enter days of the month, not offsets. Monthly takes one day; semi-monthly and bi-weekly take two (one for each period). Weekly takes a weekday name instead of a number.

FieldWhat it means
Payroll cutoffThe last day of the period wages are paid for
Attendance cutoffThe last day of attendance counted — lateness, absence, overtime, leave and holidays

How the dates are worked out when a payroll is created:

  • Monthly: the pay period runs from the day after last month's cut-off to this month's cut-off. Enter 31 for calendar months; in shorter months it becomes the last day of the month.
  • Semi-monthly: period 1 ends on the lower day and period 2 on the higher, for example 15 and 31.
  • Bi-weekly: uses exactly the same two days of the month as semi-monthly. It is not a rolling 14-day cycle.
  • Weekly: period 1 ends on the first occurrence of that weekday in the month, period 2 on the second, and so on, up to five periods.
  • Yearly, Quarterly, One-time: no dates are worked out; you enter them when you create the payroll.

Attendance earlier than payroll. If the attendance cut-off day is higher than the payroll cut-off day, the attendance window moves back a month. Payroll 25 with attendance 20 counts attendance to the 20th of the same month. Payroll 12 with attendance 15 counts attendance to the 15th of the previous month.

Semi-monthly and bi-weekly: the order of the attendance days matters. Each attendance box is paired with the payroll box beside it. If the attendance day next to the first period's payroll day is later in the month than that payroll day, every period's attendance moves back one period. For example, payroll 15 and 31 with attendance 31 and 15: the payroll ending on the 15th pays for attendance from the 16th to the end of the previous month, and the payroll ending on the 31st pays for the 1st to the 15th. Enter the attendance days in the same order as the payroll days if you do not want this.

You can still change any date in the create-payroll dialog for a one-off run.

Setup tab: every field

FieldWhat it doesSensible default
NameUnique name; payroll runs are named after itWho is on it, e.g. "Head office monthly"
Batch TypeHow often it runs, and the divisor that splits a monthly amount per payslip (table below)Your pay frequency
CurrencyCurrency shown on payslips. An employee's own currency takes priority. Nothing is convertedYour payroll currency
Payroll cutoff / Attendance cutoffSee aboveAttendance a few days before payroll
Advance payment dayOnly if you pay before the payroll cut-off. Day 1–28 of the month before the payroll ends. Anyone hired after that day and before the period starts gets an extra prorated payslip for the earlier period in the same runBlank
Automatic actions run atThe hour, in company local time, at which automated checklist actions run. It does not affect calculation09:00
Tax CodeTax table for this batch (Indonesian PPh 21 codes). None means each employee's own tax code on their profile is usedNone
Company stampPrints the stamp uploaded under Payment Configuration › Payslip Stamp. You cannot switch it on until a stamp is uploadedOff
WagesCalculates basic pay, attendance and the wage basisOn for regular payroll
ContributionsCalculates statutory contributionsOn for regular payroll
TaxesCalculates income tax. Tax Gross Up and Contribution Gross Up are always included with itOn for regular payroll
Accumulated 13th monthShows the 13th month earned so far on the batchYour choice
Accumulated 13th month to employeeAlso shows it on the employee's payslipOff unless you want employees to see it
YTD on payslipsYear-to-date totals on payslips in the appYour choice
Other PaymentsWhich payment types this cycle picks up: Fixed Allowances, Commissions, Bonus, Non-Taxable, Loans, Attendance Policy, Wage Adjustment, Tax Gross Up, Contribution Gross Up, Expenses, Termination, Encashment, Others, De Minimis, Union Dues, Allowances, Others (taxable), Bonus (Non-Billable), Basic Salary, Holiday PayAll on

Switching on Termination also brings in employees who were deactivated during the period and have not had a final payslip yet. Switch Attendance Policy off and your custom payroll policies will not run in this cycle.

How the batch type splits a monthly wage

Batch TypeMonthly amount per payslip
Monthly, One-timeAll of it
Semi-monthlyHalf
Bi-weekly÷ 2.1667 (364 ÷ 14 ÷ 12)
Weekly÷ 4.3452 (365 ÷ 7 ÷ 12)
Quarterly× 3
Yearly× 12

The same divisor splits recurring allowances, contributions and tax. See How wages are calculated.

Employees tab

Choose one:

  • Employees whose profile is set to this batch cycle — everyone whose Batch Cycle field on their profile's Payroll tab names this cycle. Use this for regular payroll.
  • Employees matching these filters — anyone matching Employment Type, Department, Position, Branch, Profile Groups, Subsidiary, Cost Centre or Religion. Within one filter, any selected value matches; across filters, every filter you set must match. The profile's Batch Cycle field is ignored.

Active employees only leaves out people whose app account is still Invited or Uninvited. It is about the account, not employment.

Payslips are never created for people with no wage or wage period, unapproved profiles, people hired after the period ends, or people terminated before it starts.

What Happens Next

  • The filters, calculation switches, other payment types, dates and divisor are copied into each payroll when it is created. Editing the cycle later does not change payrolls that already exist.
  • Batch Type and Tax Code are re-copied to a payroll whenever that payroll is saved, but its divisor is not recalculated. Do not change a cycle's type while it has open payrolls.
  • Company stamp, Currency, YTD on payslips and access changes take effect straight away.
  • The 13th month switches are stored on a payroll the first time it is used; they reliably apply to new payrolls.

Tips

  • Leave a few days between the attendance cut-off and the payroll cut-off so attendance can be checked before you calculate.
  • Use profile assignment for regular payroll and filters for special runs. Filter-based cycles ignore the profile field, so an employee can match several filter cycles and be paid in each of them.
  • Do not delete a cycle that has payrolls. Past payrolls lose their link to it and its access list is deleted, despite what the confirmation says. Rename it or stop assigning people to it instead.
  • The PDF payslip has its own year-to-date switch, under the Custom Payslip Template settings. Set both to match.

Troubleshooting / FAQ

Q: An employee is missing from the payroll. Check the Employees tab. On profile assignment, check the Batch Cycle field on their profile. Check Active employees only, their wage and wage period, and their hire and termination dates.

Q: Payslips show no salary or no tax. Wages or Taxes is switched off under Calculations — on the cycle, and on the payroll created from it.

Q: I changed the cycle but this month's payroll did not change. Payrolls copy the cycle's settings when they are created. Change the payroll itself, or create a new one.

Q: It says invalid cut-offs when I save. Fill only as many boxes as the type needs: one for monthly, weekly, yearly, quarterly and one-time; two for semi-monthly and bi-weekly.

Q: A semi-monthly payroll counts the previous half-month's attendance. The attendance days are entered in the opposite order to the payroll days. See the cut-offs section above.

Related articles