Overview

We have introduced an enhancement to the payslip file naming format used in the HiBob–Employment Hero integration.

• Security and reliability of payslip syncing
• File uniqueness to prevent naming conflicts
• Easier identification of payslips by employee and pay run period
• Improved traceability for troubleshooting and auditing

This change applies to all newly synced payslips.

New Default Payslip Naming Format

All newly synced payslips will use the following naming convention:

{eh_employee_id}_from_{payrun_start_date}_to_{payrun_end_date}_{unique_timestamp}.pdf

Example

10502121_from_2026-06-27_to_2026-07-03_1781168972.pdf

Format Breakdown

Benefits

• Prevents duplicate file names
• Reduces the risk of sync conflicts
• Makes it easier to identify the employee associated with a payslip
• Clearly indicates the pay period covered by the payslip
• Improves tracking and auditing of synced payslips

Custom Filename Prefix Setting

Customers who have enabled the Filename Prefix Setting will continue to have their configured prefix added to the beginning of the payslip file name.

Example Configuration

Resulting Filename

SyncEzy_10502121_from_2026-06-27_to_2026-07-03_1781168972.pdf

Important Note

The only change when a custom filename prefix is configured is that the prefix is added before the standard payslip naming structure.

How to Check Your Current Filename Prefix Configuration

To verify whether your integration is using a custom filename prefix:

1. Navigate to your HiBob–Employment Hero Integration.
2. Open Settings.
3. Select HiBob Employment Hero Configuration Setting.
4. Locate the Filename Prefix Setting toggle.
5. Check whether the toggle is enabled.
6. If enabled, review the value entered in the filename prefix field.
   

Do I Need to Take Any Action?

No action is required.

The new naming format will automatically apply to all newly synced payslips.

You only need to take action if you wish to:

• Review your current filename prefix configuration
• Update your existing filename prefix

Frequently Asked Questions

Will existing payslips be renamed?

No. Existing payslips will remain unchanged. The new naming convention only applies to newly synced payslips.

Why was this change introduced?

The update improves payslip sync reliability, prevents filename conflicts, and makes payslips easier to identify by employee and pay run period.

Will my custom filename prefix still work?

Yes. Any configured filename prefix will continue to be applied before the standard payslip naming structure.

How can I tell which employee a payslip belongs to?

The filename now includes the Employment Hero Employee ID, making employee identification easier.

What makes each filename unique?

A system-generated timestamp is appended to each filename to ensure uniqueness and avoid conflicts.

Need Help?

If you have any questions about this update or need assistance reviewing your configuration, please contact the SyncEzy Support team.