Contract.PensionSchemeRequest

Schema

Name / Description Type / Format Example
id string uuid "string"
name string "string"
provider Contract.PensionProviderRequest {Contract.PensionProviderRequest}
administrator Contract.PensionAdministratorRequest {Contract.PensionAdministratorRequest}
pensionRule string "ReliefAtSource" "SalarySacrifice" "NetPayArrangement"
qualifyingScheme
Set to true if this is a Qualifying Scheme for Auto Enrolment
 boolean true
disableAeLetters
Set to true if the provider deals with AutoEnrolment Letters and therefore the system should not generate them
 boolean true
subtractBasicRateTax boolean true
payMethod string "Cash" "Cheque" "Credit" "DirectDebit"
bankDetails Contract.BankDetails {Contract.BankDetails}
useCustomPayCodes
If set to true then rather than using the setting on the PayCode to determine if the pay is pensionable
we'll instead treat it as pensionable if the Code is included in CustomPayCodes
 boolean true
useCustomPayCodesForTierablePay
If set to true then rather than using the setting on the PayCode to determine if the pay is tierable
we'll instead treat it as tierable if the Code is included in TierablePayCustomPayCodes
 boolean true
customPayCodes
If UseCustomPayCodes is set to true then this contains a list of PayCodes.Code
that we'll treat as being pensionable.
 string[]
tierablePayCustomPayCodes
If UseCustomPayCodesForTierablePay is set to true then this contains a list of PayCodes.Code
that we'll treat as being tierable.
 string[]
workerGroups
A list of WorkerGroups for this Pension. There must always be at least one WorkerGroup
 Contract.WorkerGroupRequest[] {Contract.WorkerGroupRequest}
externalDataProviderId string "SmartPension_Employer" "SmartPension_Adviser" "PeoplesPension" "Xero" "Qbo" "Sage" "Nest" "Cashplus" "BreatheHr" "KashFlow" "FreeAgent" "FreeAgentPm" "Modulr" "Square" "Cezanne" "Ciphr" "Telleroo" "WeWorked" "RotaCloud" "Quinyx" "Csod" "Planday" "Starling" "Deputy" "Bottomline" "Twinfield" "MyePayWindow" "IFinance" "AccountsIQ" "EPaySlips" "NetSuite"
externalDataCompany Contract.ExternalDataCompanyRequest {Contract.ExternalDataCompanyRequest}
displayName string "string"
payCodeType string "Default" "CustomPayCodes" "PayCodeSets"
tierablePayPayCodeType string "Default" "CustomPayCodes" "PayCodeSets"
payCodeSetUniqueId string uuid "string"
tierablePayPayCodeSetUniqueId string uuid "string"
paymentDateRule string "OnPayDate" "OnDayOfWeekAfterPayDate" "OnDayOfMonth"
paymentDateDayOfWeek string "Sunday" "Monday" "Tuesday" "Wednesday" "Thursday" "Friday" "Saturday"
paymentDateDayOfMonth integer int32 0
reportOptionsLgpsIConnect Contract.PensionSchemeReportOptionsLgpsIConnectRequest {Contract.PensionSchemeReportOptionsLgpsIConnectRequest}
reportOptionsLgpsCivicaUpm Contract.PensionSchemeReportOptionsLgpsCivicaUpmRequest {Contract.PensionSchemeReportOptionsLgpsCivicaUpmRequest}
deficitValueOrdinal
The Ordinal used to identify the PaySchedule which the Deficit will be against
 integer int32 0
deficitValue
The Defict value that will be deducted in a PaySchedule
 number double 0.0
includeDeficitValue
Set to true if this a Deficit Payment needs to be assigned to a PaySchedule
 boolean true
deficitValuePayPeriod string "Custom" "Monthly" "FourWeekly" "Fortnightly" "Weekly" "Daily"
nominalCodeMappings
The PensionSchemeNominalCodeMappings used to map the PayCodes to a PensionScheme for the journal configuration
 Contract.PensionSchemeNominalCodeMappingRequest[] {Contract.PensionSchemeNominalCodeMappingRequest}

JSON Example 

{
  "id": "string",
  "name": "string",
  "provider": {
    "id": "string",
    "name": "string",
    "accountNo": "string",
    "portal": "string",
    "website": "string",
    "address": {
      "line1": "string",
      "line2": "string",
      "line3": "string",
      "line4": "string",
      "line5": "string",
      "postCode": "string",
      "country": "England",
      "foreignCountry": "string"
    },
    "telephone": "string",
    "papdisVersion": "PAP10",
    "papdisProviderId": "string",
    "papdisEmployerId": "string",
    "csvFormat": "Papdis",
    "excludeNilPaidFromContributions": true,
    "payPeriodDateAdjustment": 0,
    "miscBoolean1": true,
    "miscBoolean2": true,
    "miscString1": "string",
    "miscString2": "string",
    "optOutWindow": 0,
    "optOutWindowIsMonths": true
  },
  "administrator": {
    "id": "string",
    "name": "string",
    "email": "string",
    "address": {
      "line1": "string",
      "line2": "string",
      "line3": "string",
      "line4": "string",
      "line5": "string",
      "postCode": "string",
      "country": "England",
      "foreignCountry": "string"
    },
    "telephone": "string"
  },
  "pensionRule": "ReliefAtSource",
  "qualifyingScheme": true,
  "disableAeLetters": true,
  "subtractBasicRateTax": true,
  "payMethod": "Cash",
  "bankDetails": {
    "bankName": "string",
    "bankBranch": "string",
    "bankReference": "string",
    "accountName": "string",
    "accountNumber": "string",
    "sortCode": "string",
    "note": "string",
    "buildingSocietyRollNumber": "string"
  },
  "useCustomPayCodes": true,
  "useCustomPayCodesForTierablePay": true,
  "customPayCodes": [
    "string"
  ],
  "tierablePayCustomPayCodes": [
    "string"
  ],
  "workerGroups": [
    {
      "id": "string",
      "name": "string",
      "contributionLevelType": "UserDefined",
      "employeeContribution": 0.0,
      "employeeContributionIsPercentage": true,
      "employerContribution": 0.0,
      "employerContributionIsPercentage": true,
      "employerContributionTopUpPercentage": 0.0,
      "employerContributionIncludesNiSaving": true,
      "employerContributionNiSavingPercentage": 0.0,
      "isAvc": true,
      "additionalVoluntaryContribution": 0.0,
      "avcIsPercentage": true,
      "employerContributionNiSaving": 0.0,
      "customThreshold": true,
      "lowerLimit": 0.0,
      "upperLimit": 0.0,
      "papdisGroup": "string",
      "papdisSubGroup": "string",
      "localAuthorityNumber": "string",
      "schoolEmployerType": "string",
      "matIdentifier": "string",
      "matUniqueNumber": "string",
      "employerReference": "string",
      "lgpsFund": "Avon",
      "workerGroupId": "string",
      "assumedPensionablePay": "AssumedPensionablePay",
      "pensionablePayDefinition": "NotApplicable",
      "payslipDescription": "string"
    }
  ],
  "externalDataProviderId": "SmartPension_Employer",
  "externalDataCompany": {
    "id": "string",
    "name": "string",
    "schemeName": "string"
  },
  "displayName": "string",
  "payCodeType": "Default",
  "tierablePayPayCodeType": "Default",
  "payCodeSetUniqueId": "string",
  "tierablePayPayCodeSetUniqueId": "string",
  "paymentDateRule": "OnPayDate",
  "paymentDateDayOfWeek": "Sunday",
  "paymentDateDayOfMonth": 0,
  "reportOptionsLgpsIConnect": {
    "fileType": "SingleFile",
    "payrollReference1": "Empty",
    "payrollReference2": "Empty",
    "payrollReference3": "Empty",
    "populateEmailAddress": true,
    "populateTelephoneNumber": true,
    "populateMobileNumber": true,
    "populateWorksPlaceName": true,
    "populateWorksAddress": true,
    "populateWorksEmailAddress": true,
    "includeEmploymentBreaks": true,
    "breakReasonSmpIndicatorOnly": true,
    "populateMaritalStatus": true,
    "includeAeQualifyingEarnings": true,
    "proRatePtHoursByTermTimeWeeks": true,
    "ignoreTermTimeWeeksForFteFinalPay": true,
    "showFteAnnualSalaryForFteFinalPay": true,
    "casualStaffHoursAsOne": true,
    "casualStaffIndicatorAsY": true,
    "ignoreHours": true,
    "forceUpperCase": true,
    "salaryType": "PayOnJoining",
    "customText": "string"
  },
  "reportOptionsLgpsCivicaUpm": {
    "payrollNumber": "PayrollCode",
    "casualHours": "ReportAsZero",
    "omitHeaderLine": true,
    "includeFolderNo": true,
    "excludeSchoolEmployerName": true,
    "addressesForNewJoinersOnly": true,
    "proRatePtHoursWeeksWorked": true,
    "fullTimeHoursAsOneHundred": true,
    "includeWeeksWorkedColumns": true
  },
  "deficitValueOrdinal": 0,
  "deficitValue": 0.0,
  "includeDeficitValue": true,
  "deficitValuePayPeriod": "Custom",
  "nominalCodeMappings": [
    {
      "nominalCode": "string",
      "nominalName": "string",
      "journalNarrative": "string",
      "payCode": "string"
    }
  ]
}

References

Contained in Models
Contract.PensionSelectionRequest
Consumed by Operations

- none -

Returned by Operations

- none -