Capture employee information
Creating an employee in Nmbr requires providing the required information to the employee API endpoint. RequestWork Assignments
A core concept in the Nmbr API is Work Assignments. Work Assignments allow you to attach an Employee and Pay-Rates to a Pay Schedule. Work Assignments offer a flexible data architecture to allow you to represent both simple and complex employment scenarios depending on your requirements. An Employee may have multiple Work Assignments, which can represent different jobs or work held by the employee within a single Business Entity. This may depend on your product needs and data architecture. When creating a Benefit, Deduction, Reimbursement, or Allowance, these entities are attached to a Work Assignment. This allows Nmbr to know which Pay-Schedule to apply these on.How Business Entity influences Work Assignments
- An Employee may have multiple Work Assignments within a single Company.
- An Employee may only have one Work Assignment per Pay-Schedule.
- A single Work Assignment may have multiple Pay-Rates.
- CPP and EI Statutory Withholding limits are calculated across all Work Assignments for an Employee within a single Business Entity - meaning Employee and Employer contributions should not exceed their maximum contribution limits.
- A Work Assignment inherits the Business Entity’s Province of Employment by default. If the Work Assignment should use a different province, create a
ca::province_of_employmentTax Property for the Work Assignment. You can include this intax_propertieswhen creating the Work Assignment or create it later using the Province of Employment guide.
Creating a Work Assignment
Removing a Work Assignment
- Work Assignments may only be deleted when there are no Pay Stubs with a status of
processing,failed, orpaid. - A Work Assignment may be archived to remove it from future Payrolls. Archived Work Assignments are also removed by default from lists of Work Assignments.

