Contract.CreateEmployeeRequest

Name / Description Type / Format Example
personalDetails Contract.PersonalDetailsRequest {Contract.PersonalDetailsRequest}
employmentDetails Contract.EmploymentDetailsRequest {Contract.EmploymentDetailsRequest}
autoEnrolment Contract.AutoEnrolmentRequest {Contract.AutoEnrolmentRequest}
leaveSettings Contract.LeaveSettingsRequest {Contract.LeaveSettingsRequest}
rightToWork Contract.RightToWork {Contract.RightToWork}
bankDetails Contract.BankDetails {Contract.BankDetails}
payOptions Contract.PayOptionsRequest {Contract.PayOptionsRequest}
tags string[]
holidaySchemeUniqueId string uuid "string"
aggregatedServiceDate string date "2024-11-03"
evcId
If set then this will be used as the EmployeeIDFromProduct sent to EVC in place of the standard EmployeeId.
string uuid "string"
sourceSystemId
Used by external systems so they can store an immutable reference.
Once this property is set it cannot be changed.
string "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",
    "photoSasUrl": "string",
    "mobile": "string",
    "dateOfBirth": "2024-11-03",
    "gender": "Male",
    "niNumber": "string",
    "passportNumber": "string",
    "partnerDetails": {
      "firstName": "string",
      "initials": "string",
      "lastName": "string",
      "niNumber": "string"
    }
  },
  "employmentDetails": {
    "cis": {
      "verification": {
        "manuallyEntered": true,
        "matchInsteadOfVerify": true,
        "number": "string",
        "date": "2024-11-03",
        "taxStatus": "Gross",
        "verificationResponse": "error too many levels"
      },
      "type": "SoleTrader",
      "utr": "string",
      "tradingName": "string",
      "companyUtr": "string",
      "companyNumber": "string",
      "vatRegistered": true,
      "vatNumber": "string",
      "vatRate": 0.0,
      "reverseChargeVAT": true
    },
    "department": {
      "code": "string",
      "title": "string",
      "color": "string",
      "accountingCode": "string"
    },
    "cisSubContractor": true,
    "payrollCode": "string",
    "jobTitle": "string",
    "onHold": true,
    "onFurlough": true,
    "furloughStart": "2024-11-03",
    "furloughEnd": "2024-11-03",
    "furloughCalculationBasis": "ActualPaidAmount",
    "furloughCalculationBasisAmount": 0.0,
    "partialFurlough": true,
    "furloughHoursNormallyWorked": 0.0,
    "furloughHoursOnFurlough": 0.0,
    "isApprentice": true,
    "apprenticeshipStartDate": "2024-11-03",
    "apprenticeshipEndDate": "2024-11-03",
    "workingPattern": "string",
    "forcePreviousPayrollCode": "string",
    "starterDetails": {
      "startDate": "2024-11-03",
      "starterDeclaration": "A",
      "overseasEmployerDetails": {
        "overseasEmployer": true,
        "overseasSecondmentStatus": "None",
        "eeaCitizen": true,
        "epm6Scheme": true
      },
      "pensionerPayroll": {
        "inReceiptOfPension": true,
        "bereaved": true,
        "amount": 0.0,
        "startDate": "2024-11-03"
      }
    },
    "directorshipDetails": {
      "isDirector": true,
      "startDate": "2024-11-03",
      "leaveDate": "2024-11-03",
      "niAlternativeMethod": true
    },
    "leaverDetails": {
      "hasLeft": true,
      "leaveDate": "2024-11-03",
      "isDeceased": true,
      "paymentAfterLeaving": true,
      "p45Sent": true,
      "payAccruedBalance": true,
      "paymentMethodAfterLeaving": "RegularPayMethod"
    },
    "roles": [
      {
        "id": "string",
        "name": "string",
        "metadata": {},
        "url": "string"
      }
    ],
    "isWorkingInFreePort": true,
    "isWorkingInInvestmentZone": true,
    "veteranDetails": {
      "isVeteran": true,
      "firstCivilianEmploymentDate": "2024-11-03"
    },
    "continuousEmploymentDate": "2024-11-03"
  },
  "autoEnrolment": {
    "lastAssessment": {
      "assessmentDate": "2024-11-03"
    },
    "ukWorker": "No",
    "daysToDeferAssessment": 0,
    "deferByMonthsNotDays": true,
    "exempt": true,
    "aeExclusionCode": "NotKnown",
    "aePostponementLetterSent": true
  },
  "leaveSettings": {
    "useDefaultHolidayType": true,
    "useDefaultAllowanceResetDate": true,
    "useDefaultAllowance": true,
    "useDefaultAccruePaymentInLieu": true,
    "useDefaultAccruePaymentInLieuRate": true,
    "useDefaultAccruePaymentInLieuAllGrossPay": true,
    "useDefaultHolidayAccrualBasis": true,
    "useDefaultAccruePaymentInLieuPayAutomatically": true,
    "useDefaultAccrueHoursPerDay": true,
    "useDefaultMaximumAccruePeriod": true,
    "allowanceResetDate": "2024-11-03",
    "allowance": 0.0,
    "adjustment": 0.0,
    "holidayType": "Days",
    "accrueSetAmount": true,
    "accrueHoursPerDay": 0.0,
    "showAllowanceOnPayslip": true,
    "showAhpOnPayslip": true,
    "accruePaymentInLieuRate": 0.0,
    "accruePaymentInLieuAllGrossPay": true,
    "accruePaymentInLieuPayAutomatically": true,
    "occupationalSicknessUniqueId": "string",
    "accruedPaymentAdjustment": 0.0,
    "accruedHoursAdjustment": 0.0,
    "holidayAccrualBasis": "RegularPayOnly",
    "holidayAccrualDefaultRateType": "HourlyRate",
    "aggregatedServiceDate": "2024-11-03",
    "useAggregatedServiceDate": true,
    "accruePayCodeSetUniqueId": "string",
    "maximumAccruePeriod": 0.0,
    "holidayLeaveAccrualCustomRateType": "HourlyRate",
    "useDefaultHolidayAccrualDefaultRateType": true
  },
  "rightToWork": {
    "checked": true,
    "documentType": "Other",
    "documentRef": "string",
    "documentExpiry": "2024-11-03",
    "note": "string"
  },
  "bankDetails": {
    "bankName": "string",
    "bankBranch": "string",
    "bankReference": "string",
    "accountName": "string",
    "accountNumber": "string",
    "sortCode": "string",
    "note": "string",
    "buildingSocietyRollNumber": "string"
  },
  "payOptions": {
    "regularPayLines": [
      {
        "analysisCategoryCodesJson": "string",
        "value": 0.0,
        "rate": 0.0,
        "multiplier": 0.0,
        "description": "string",
        "code": "string",
        "tags": [
          "string"
        ],
        "childId": "string",
        "isNetToGross": true,
        "targetNetToGrossValue": 0.0,
        "netToGrossDiscrepancy": 0.0,
        "effectiveFrom": "2024-11-03",
        "effectiveTo": "2024-11-03",
        "isAutoGeneratedBasicPayLine": true,
        "percentageOfEffectiveDays": 0.0,
        "totalWorkingDays": 0.0,
        "autoAdjustForLeave": true,
        "isAutomaticBackPay": true,
        "ignoreInitialBackPay": true,
        "contributesToBasicPay": true,
        "calculateAsWhenPaid": true,
        "totalPaidDays": 0.0,
        "roleId": "string",
        "earnedFrom": "2024-11-03",
        "earnedTo": "2024-11-03",
        "annualValue": 0.0,
        "department": "string",
        "costCentre": "string",
        "departmentId": "string",
        "costCentreId": "string",
        "analysisCategoriesCodes": [
          {
            "analysisCategory": "string",
            "analysisCategoryCode": "string",
            "analysisCategoryId": "string",
            "analysisCategoryCodeId": "string"
          }
        ],
        "analysisCategoryCodeIds": [
          "string"
        ],
        "paySpineId": "string",
        "paySpineGradeId": "string",
        "spinalPointId": "string",
        "londonAllowanceId": 0,
        "fullTimeAnnualValue": 0.0
      }
    ],
    "period": "Custom",
    "ordinal": 0,
    "method": "Cash",
    "withholdTaxRefundIfPayIsZero": true,
    "taxAndNi": {
      "niTable": "string",
      "secondaryClass1NotPayable": true,
      "postgradLoan": true,
      "postgraduateLoanStartDate": "2024-11-03",
      "postgraduateLoanEndDate": "2024-11-03",
      "studentLoan": "None",
      "studentLoanStartDate": "2024-11-03",
      "studentLoanEndDate": "2024-11-03",
      "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,
    "autoAdjustForLeave": true,
    "niTable": "string"
  },
  "tags": [
    "string"
  ],
  "holidaySchemeUniqueId": "string",
  "aggregatedServiceDate": "2024-11-03",
  "evcId": "string",
  "sourceSystemId": "string"
}
Contained in Models

- none -

Consumed by Operations
Create a new Employee
Returned by Operations

- none -