Employee

Name / Description Type / Format Example
holidaySchemeUniqueId string uuid "string"
aggregatedServiceDate string date "2024-03-19"
leaveHolidayAccrualDefaultRateType string "HourlyRate" "AverageHolidayRate" "FixedPeriodAmount"
id
The unique id of the object
string uuid "string"
personalDetails PersonalDetails {PersonalDetails}
employmentDetails EmploymentDetails {EmploymentDetails}
autoEnrolment AutoEnrolment {AutoEnrolment}
leaveSettings LeaveSettings {LeaveSettings}
rightToWork RightToWork {RightToWork}
bankDetails BankDetails {BankDetails}
tags string[]
payOptions
This object forms the basis of the Employees payment.
PayOptions {PayOptions}
status string "Current" "Former" "Upcoming"
aeNotEnroledWarning
If true then the employee should be enrolled in an Auto Enrolment Qualifying pension but isn't
boolean true
sourceSystemId
Can only be given a value when the employee is created. It can then never be changed.
Used by external systems so they can store an immutable reference
string "string"
evcId
If set then this will be used as the EmployeeIDFromProduct sent to EVC in place of the standard EmployeeId.
string uuid "string"
{
  "holidaySchemeUniqueId": "string",
  "aggregatedServiceDate": "2024-03-19",
  "leaveHolidayAccrualDefaultRateType": "HourlyRate",
  "id": "string",
  "personalDetails": {
    "address": {
      "line1": "string",
      "line2": "string",
      "line3": "string",
      "line4": "string",
      "line5": "string",
      "postCode": "string",
      "country": "England",
      "foreignCountry": "string"
    },
    "maritalStatus": "Single",
    "title": "string",
    "firstName": "string",
    "middleName": "string",
    "lastName": "string",
    "alternativeEmail": "string",
    "previousSurName": "string",
    "email": "string",
    "emailPayslip": true,
    "pdfPassword": "string",
    "pdfPasswordType": "InitialsAndDob",
    "emailStatement": true,
    "photoUrl": "string",
    "telephone": "string",
    "mobile": "string",
    "dateOfBirth": "2024-03-19",
    "statePensionAge": 0,
    "gender": "Male",
    "niNumber": "string",
    "passportNumber": "string",
    "partnerDetails": {
      "firstName": "string",
      "initials": "string",
      "lastName": "string",
      "niNumber": "string"
    }
  },
  "employmentDetails": {
    "cisSubContractor": true,
    "payrollCode": "string",
    "jobTitle": "string",
    "onHold": true,
    "onFurlough": true,
    "furloughStart": "2024-03-19",
    "furloughEnd": "2024-03-19",
    "furloughCalculationBasis": "ActualPaidAmount",
    "furloughCalculationBasisAmount": 0.0,
    "partialFurlough": true,
    "furloughHoursNormallyWorked": 0.0,
    "furloughHoursOnFurlough": 0.0,
    "isApprentice": true,
    "apprenticeshipStartDate": "2024-03-19",
    "apprenticeshipEndDate": "2024-03-19",
    "workingPattern": "string",
    "forcePreviousPayrollCode": "string",
    "starterDetails": {
      "startDate": "2024-03-19",
      "starterDeclaration": "A",
      "overseasEmployerDetails": {
        "overseasEmployer": true,
        "overseasSecondmentStatus": "None",
        "eeaCitizen": true,
        "epm6Scheme": true
      },
      "pensionerPayroll": {
        "inReceiptOfPension": true,
        "bereaved": true,
        "amount": 0.0,
        "startDate": "2024-03-19"
      }
    },
    "directorshipDetails": {
      "isDirector": true,
      "startDate": "2024-03-19",
      "leaveDate": "2024-03-19",
      "niAlternativeMethod": true
    },
    "leaverDetails": {
      "hasLeft": true,
      "leaveDate": "2024-03-19",
      "isDeceased": true,
      "paymentAfterLeaving": true,
      "p45Sent": true,
      "payAccruedBalance": true
    },
    "cis": {
      "type": "SoleTrader",
      "utr": "string",
      "tradingName": "string",
      "companyUtr": "string",
      "companyNumber": "string",
      "vatRegistered": true,
      "vatNumber": "string",
      "vatRate": 0.0,
      "reverseChargeVAT": true,
      "verification": {
        "manuallyEntered": true,
        "matchInsteadOfVerify": true,
        "number": "string",
        "date": "2024-03-19",
        "taxStatus": "Gross",
        "verificationRequest": "string",
        "verificationResponse": "error too many levels"
      }
    },
    "department": {
      "code": "string",
      "title": "string",
      "color": "string",
      "employeeCount": 0,
      "accountingCode": "string"
    },
    "roles": [
      {
        "id": "string",
        "name": "string",
        "metadata": {},
        "url": "string"
      }
    ],
    "isWorkingInFreePort": true,
    "veteranDetails": {
      "isVeteran": true,
      "firstCivilianEmploymentDate": "2024-03-19"
    },
    "continuousEmploymentDate": "2024-03-19",
    "includeSecondedInfoOnStarter": true,
    "isWorkingInInvestmentZone": true
  },
  "autoEnrolment": {
    "state": "Automatic",
    "stateDate": "2024-03-19",
    "ukWorker": "No",
    "daysToDeferAssessment": 0,
    "postponementDate": "2024-03-19",
    "deferByMonthsNotDays": true,
    "exempt": true,
    "aeExclusionCode": "NotKnown",
    "aePostponementLetterSent": true,
    "lastAssessment": {
      "assessmentDate": "2024-03-19T04:46:11",
      "employeeState": "Automatic",
      "age": 0,
      "ukWorker": "No",
      "payPeriod": "Custom",
      "ordinal": 0,
      "earningsInPeriod": 0.0,
      "qualifyingEarningsInPeriod": 0.0,
      "aeExclusionCode": "NotKnown",
      "status": "Eligible",
      "reason": "string",
      "action": {
        "action": "NoChange",
        "employeeState": "Automatic",
        "actionCompleted": true,
        "actionCompletedMessage": "string",
        "requiredLetter": "B1",
        "pensionSchemeId": "string",
        "workerGroupId": "string",
        "letterNotYetSent": true
      },
      "startReportingType": "UsePayRun",
      "endReportingType": "UsePayRun",
      "startPayRunEntryId": 0,
      "endPayRunEntryId": 0,
      "employee": {
        "id": "string",
        "name": "string",
        "metadata": {},
        "url": "string"
      },
      "id": "string"
    }
  },
  "leaveSettings": {
    "useDefaultHolidayType": true,
    "useDefaultAllowanceResetDate": true,
    "useDefaultAllowance": true,
    "useDefaultAccruePaymentInLieu": true,
    "useDefaultAccruePaymentInLieuRate": true,
    "useDefaultHolidayAccrualBasis": true,
    "useDefaultAccruePaymentInLieuPayAutomatically": true,
    "useDefaultAccrueHoursPerDay": true,
    "useDefaultMaximumAccruePeriod": true,
    "allowanceResetDate": "2024-03-19",
    "allowance": 0.0,
    "adjustment": 0.0,
    "allowanceUsed": 0.0,
    "allowanceUsedPreviousPeriod": 0.0,
    "allowanceRemaining": 0.0,
    "holidayType": "Days",
    "accrueSetAmount": true,
    "accrueHoursPerDay": 0.0,
    "showAllowanceOnPayslip": true,
    "showAhpOnPayslip": true,
    "accruePaymentInLieuRate": 0.0,
    "accruePaymentInLieuAllGrossPay": true,
    "accruePaymentInLieuPayAutomatically": true,
    "accruePayCodeSetUniqueId": "string",
    "maximumAccruePeriod": 0.0,
    "holidayAccrualBasis": "RegularPayOnly",
    "holidayAccrualDefaultRateType": "HourlyRate",
    "occupationalSicknessUniqueId": "string",
    "accruedPaymentLiability": 0.0,
    "accruedPaymentAdjustment": 0.0,
    "accruedPaymentPaid": 0.0,
    "accruedPaymentBalance": 0.0,
    "accruedHoursAmount": 0.0,
    "accruedHoursAdjustment": 0.0,
    "accruedHoursPaid": 0.0,
    "accruedHoursAmountLastPeriod": 0.0,
    "paidHoursAmountLastPeriod": 0.0,
    "accruedHoursBalance": 0.0,
    "aggregatedServiceDate": "2024-03-19",
    "useAggregatedServiceDate": true,
    "useDefaultHolidayAccrualDefaultRateType": true
  },
  "rightToWork": {
    "checked": true,
    "documentType": "Other",
    "documentRef": "string",
    "documentExpiry": "2024-03-19",
    "note": "string"
  },
  "bankDetails": {
    "bankName": "string",
    "bankBranch": "string",
    "bankReference": "string",
    "accountName": "string",
    "accountNumber": "string",
    "sortCode": "string",
    "note": "string",
    "buildingSocietyRollNumber": "string"
  },
  "tags": [
    "string"
  ],
  "payOptions": {
    "period": "Custom",
    "ordinal": 0,
    "method": "Cash",
    "withholdTaxRefundIfPayIsZero": true,
    "taxAndNi": {
      "niTable": "string",
      "secondaryClass1NotPayable": true,
      "postgradLoan": true,
      "postgraduateLoanStartDate": "2024-03-19",
      "postgraduateLoanEndDate": "2024-03-19",
      "studentLoan": "None",
      "studentLoanStartDate": "2024-03-19",
      "studentLoanEndDate": "2024-03-19",
      "taxCode": "string",
      "week1Month1": true,
      "foreignTaxCredit": true
    },
    "fpsFields": {
      "offPayrollWorker": true,
      "irregularPaymentPattern": true,
      "nonIndividual": true,
      "hoursNormallyWorked": "LessThan16"
    },
    "tags": [
      "string"
    ],
    "basis": "Hourly",
    "nationalMinimumWage": true,
    "payCode": "string",
    "mileageVehicleType": "Car",
    "mapsMiles": 0,
    "payAmount": 0.0,
    "payAmountMultiplier": 0.0,
    "baseHourlyRate": 0.0,
    "baseDailyRate": 0.0,
    "basicPay": 0.0,
    "autoAdjustForLeave": true,
    "niTable": "string",
    "regularPayLines": [
      {
        "value": 0.0,
        "rate": 0.0,
        "multiplier": 0.0,
        "description": "string",
        "attachmentOrderId": "string",
        "pensionId": "string",
        "leaveId": "string",
        "loanId": "string",
        "leaveStatutoryDaysPaid": 0.0,
        "leaveStatutoryWeeksPaid": 0.0,
        "code": "string",
        "tags": [
          "string"
        ],
        "childId": "string",
        "isNetToGross": true,
        "targetNetToGrossValue": 0.0,
        "netToGrossDiscrepancy": 0.0,
        "effectiveFrom": "2024-03-19",
        "effectiveTo": "2024-03-19",
        "department": "string",
        "costCentre": "string",
        "departmentId": "string",
        "costCentreId": "string",
        "isAutoGeneratedBasicPayLine": true,
        "percentageOfEffectiveDays": 0.0,
        "totalWorkingDays": 0.0,
        "isAutomaticBackPay": true,
        "ignoreInitialBackPay": true,
        "initialBackPayPayRunId": 0,
        "autoAdjustForLeave": true,
        "contributesToBasicPay": true,
        "calculateAsWhenPaid": true,
        "totalPaidDays": 0.0,
        "roleId": "string",
        "employeeRoleReference": "string",
        "earnedFrom": "2024-03-19",
        "earnedTo": "2024-03-19",
        "periodFrom": "2024-03-19",
        "periodTo": "2024-03-19",
        "annualValue": 0.0,
        "parentId": "string",
        "isAutoCalculatedBackPayLine": true,
        "isZeroHoursTeachersBackPayLine": true,
        "analysisCategoriesCodes": [
          {
            "analysisCategory": "string",
            "analysisCategoryCode": "string",
            "analysisCategoryId": "string",
            "analysisCategoryCodeId": "string"
          }
        ],
        "analysisCategoryCodeIds": [
          "string"
        ],
        "paySpineId": "string",
        "paySpineGradeId": "string",
        "spinalPointId": "string",
        "londonAllowanceId": 0,
        "fullTimeAnnualValue": 0.0
      }
    ]
  },
  "status": "Current",
  "aeNotEnroledWarning": true,
  "sourceSystemId": "string",
  "evcId": "string"
}
Contained in Models
ExternalEmployeeMapping
Consumed by Operations

- none -

Returned by Operations

- none -

Getting Started Create an Employee
Getting Started Understanding PayOptions