All Collections
People
How do we use contractor/employee IDs?
How do we use contractor/employee IDs?
Aditya Morarka avatar
Written by Aditya Morarka
Updated over a week ago

Employee and contractor IDs (henceforth referred to simply as employee IDs) play an important role in XPayroll. All reports have an employee ID column to help you differentiate between people, and our APIs also use the ID as an identifier to refer to any single person.

There are 2 options for using employee IDs in RazorpayX Payroll. You can choose the setup that best suits you from Settings > Employee Data.

  1. Completely custom IDs

    In this setup, you are free to enter any ID you wish for your employees and contractors, and it can be a mix of letters and numbers (maximum length of 20 characters). If you choose this option, XPayroll will not auto-generate an ID for any new employee/contractor that you add to the platform.

  2. Non-custom IDs

    In this setup, XPayroll will maintain an internal counter and automatically assign a new numeric employee id to any new employee or contractor that you add to the platform. You also have the following additional options -

    1. You can put a default prefix in front of your employee ID.

    2. You can opt for a separate series for your contractors, and assign them a different prefix.

    3. You can specify the default length of an employee ID. For example, if you choose "ABC" as a prefix, and a default length of 6 characters, then employee ID 1 will get the ID "ABC001".

Please note that switching between these two types of IDs after employee setup has been completed can lead to unpredictable behaviour. For example, if you use custom IDs and assign the ID "ABC" to someone and then switch to non-custom IDs, then editing the employee's profile will lead to removal of "ABC" since it is non-numeric.

Did this answer your question?