RPN Web Service
MethodNewRPNOperation
RPN Web Service > All Operations Resource Group : NewRPNOperation (Method)
Request (NewRPNRequest)

The request body is of type NewRPNRequest.

EmploymentStartDate Element FamilyName Element FirstName Element Sequence Name Element EmploymentID Element EmployeePPSN Element Sequence EmployeeID Element Sequence EmployeeDetail Element TaxYear Element Version Element Name Element Sequence SoftwareUsed Element AgentTain Element EmployerRegistrationNumber Element RequestID Element Sequence NewRPNRequest Element

Overview

NewRPNRequest
Request for RPN details for new employee(s).
Sequence
RequestID requestID Simple Type
Data Item Ref: N/A. Unique identifier for the New RPN Request. Will be used in conjunctions with the EmployerRegistrationNumber to check for duplicate requests.
EmployerRegistrationNumber employerReg Simple Type
Data Item Ref: N/A. Employer's PAYE Registration Number.
AgentTain optional agentTAIN Simple Type
Data Item Ref: N/A. Tax Advisor Identification Number. Required if payroll submission filed by agent on behalf of employer.
SoftwareUsed SoftwareUsed Complex Type
References to third party software used for payroll submission.
Sequence
Name NonEmptyString Simple Type
Name of the software used.
Version NonEmptyString Simple Type
Version of the software used.
TaxYear dateYear Simple Type
Data Item Ref: N/A. The tax year to which the submission relates (YYYY).
EmployeeDetail 1..∞ NewEmployeeDetail Complex Type
Details of employees who require a new RPN.
Sequence
EmployeeID EmployeeID Complex Type
Uniquely identifies each employment for the employee.
Sequence
EmployeePPSN EmployeePPSN Simple Type
Data Item Ref: 108. Employee's PPS Number. Used to identify the employee to which the RPN relates.
EmploymentID optional employmentID Simple Type
Data Item Ref: 110. Employee's Employment ID. Unique identifier for each distinct employment for an employee. If the RPN is being triggered as a result of the employee setting up the employment via Jobs and Pension or contacting Revenue, this field will not be populated.
Name Name Complex Type
The employee name.
Sequence
FirstName defaultString Simple Type
Data Item Ref: 106.The first name of the employee.
FamilyName defaultString Simple Type
Data Item Ref: 107 The surname/family name of the employee.
EmploymentStartDate optional xs:date
Data Item Ref: N/A. The date which the employee commences (YYYY-MM-DD).
200 Response (NewRPNResponse)

The response body is of type NewRPNResponse.

Description Element Path Element Code Element Sequence ValidationError Element EmploymentID Element EmployeePPSN Element Sequence NoRPN Element PRSIClass Element PRSIExempt Element LPTToDeduct Element USCDeductedToDate Element PayForUSCToDate Element YearlyUSCRateCutOff Element USCRatePercent Element Index Element Sequence USCRate Element USCStatus Element IncomeTaxDeductedToDate Element PayForIncomeTaxToDate Element YearlyRateCutOff Element TaxRatePercent Element Index Element Sequence TaxRate Element YearlyTaxCredits Element StatePensionCont Element ExclusionOrder Element IncomeTaxCalculationBasis Element EmploymentCessationDate Element EndDate Element EffectiveDate Element PreviousEmployeePPSN Element FamilyName Element FirstName Element Sequence Name Element EmployerReference Element RPNIssueDate Element EmploymentID Element EmployeePPSN Element Sequence EmployeeID Element RPNNumber Element Sequence RPN Element DateTimeEffective Element AgentTain Element EmployerRegistrationNumber Element EmployerName Element Sequence NewRPNResponse Element

Overview

NewRPNResponse
Employer's New RPN Response. Will either return RPN detail or details of validation errors.
Sequence
EmployerName defaultString Simple Type
Data Item Ref: N/A. Employer's PAYE Registration Number.
EmployerRegistrationNumber employerReg Simple Type
Data Item Ref: N/A. Employer's PAYE Registration Number.
AgentTain optional agentTAIN Simple Type
Data Item Ref: N/A. Tax Advisor Identification Number. Required if RPN queried by agent on behalf of employer.
DateTimeEffective xs:dateTime
Data Item Ref: 105. The date and time at which the RPN's returned are correct/were issued (YYYY-MM-DDThh:mm:ss.sss±hh:mm).
RPN 0..∞ RPN Complex Type
Details of new RPN for an employment for an employee.
Sequence
RPNNumber rpnNumber Simple Type
Data Item Ref: 104. Reference number of the RPN for this employment for the employee.
EmployeeID EmployeeID Complex Type
Employee's PPS Number and Employment ID (if available).
Sequence
EmployeePPSN EmployeePPSN Simple Type
Data Item Ref: 108. Employee's PPS Number. Used to identify the employee to which the RPN relates.
EmploymentID optional employmentID Simple Type
Data Item Ref: 110. Employee's Employment ID. Unique identifier for each distinct employment for an employee. If the RPN is being triggered as a result of the employee setting up the employment via Jobs and Pension or contacting Revenue, this field will not be populated.
RPNIssueDate xs:date
Data Item Ref: 105. The date the RPN was issued (YYYY-MM-DD).
EmployerReference optional employerReference Simple Type
Data Item Ref: 111. Employee's internal staff identifier/reference.
Name Name Complex Type
The employee name.
Sequence
FirstName defaultString Simple Type
Data Item Ref: 106.The first name of the employee.
FamilyName defaultString Simple Type
Data Item Ref: 107 The surname/family name of the employee.
PreviousEmployeePPSN optional EmployeePPSN Simple Type
Data Item Ref: 109. Conditionally Returned. Used to identify employee's previous PPS number if available e.g. PPS number with 'W' suffix.
EffectiveDate xs:date
Data Item Ref: 114. January 1st if cumulative basis applies. Date the RPN issued if Week 1 basis applies. The date can be in the future (YYYY-MM-DD).
EndDate xs:date
Data Item Ref: 115. Last date on which the RPN specified will apply. After this date a new RPN should be requested.
EmploymentCessationDate optional xs:date
Data Item Ref: 136. Conditionally returned if present for the employment. Employment Cessation Date
IncomeTaxCalculationBasis IncomeTaxCalculationBasis Simple Type
Data Item Ref: 112. PAYE calculation basis used in the submission. Options allowed are "CUMULATIVE", "WEEK_1" and "EMERGENCY".
ExclusionOrder optional xs:boolean
Data Item Ref: 113. Indicates if there is an exclusion order on file for the employee. Set to “true” if an exclusion order is on file for the employee.
StatePensionCont optional xs:boolean
Data Item Ref: 137. True for an employee drawing down their state pension contributory. Default from 2025 onwards is false.
YearlyTaxCredits defaultDecimal Simple Type
Data Item Ref: 118. Net Tax Credits. Amount of tax credits available to the employee for the year the RPN relates to. Amount of tax credits available for use in the PAYE calculation.
TaxRate 1..∞ TaxRate Complex Type
Details of Tax Rates and Rate Cut Offs
Sequence
Index xs:unsignedShort
Data Item Ref: N/A. Index of the tax rate. For example, Index of 1 would refer to tax rate 1.
TaxRatePercent defaultDecimal Simple Type
Data Item Ref: 119, 121. Tax rate percentage to be applied.
YearlyRateCutOff optional defaultDecimal Simple Type
Data Item Ref: 120. Total allocated to the specified Rate Cut Off. No cut off for highest band.
PayForIncomeTaxToDate defaultDecimal Simple Type
Data Item Ref: 116. Total Pay for Income Tax to Date. This will include total income liable to Income Tax to date – including previous employment income. In the case of recommencements, this includes previous pay from that employer in the same tax year.
IncomeTaxDeductedToDate defaultDecimal Simple Type
Data Item Ref: 117. Total Income Tax Deducted to Date. Total amount of employee’s Income Tax deducted to date. In the case of recommencements, this includes previous tax from that employer in the same tax year.
USCStatus uscStatus Simple Type
Data Item Ref: 124. USC Status. Allowed values are Ordinary and Exempt.
USCRate 0..∞ USCRate Complex Type
Details of USC Rates.
Sequence
Index xs:unsignedShort
Data Item Ref: N/A. Index of the rate. For example, Index of 1 would refer to USC Tax Rate 1.
USCRatePercent defaultDecimal Simple Type
Data Item Ref: 125, 127, 129, 131. USC Rate percentage to be applied.
YearlyUSCRateCutOff optional defaultDecimal Simple Type
Data Item Ref: 126, 128, 130, 132. Total allocated to the specified USC Cut Off.
PayForUSCToDate defaultDecimal Simple Type
Data Item Ref: 133. Total Previous Pay subject to USC to Date. This will include total income liable to USC to date – including previous employment income and any additional declared income liable to USC e.g. Rental Income.
USCDeductedToDate defaultDecimal Simple Type
Data Item Ref: 134. Total Previous USC Paid to Date. Taking into account any USC refunded through any unemployment repayment claim(s).
LPTToDeduct optional defaultDecimal Simple Type
Data Item Ref: 135. LPT to be Deducted. Amount of LPT to be deducted through payroll.
PRSIExempt optional xs:boolean
Data Item Ref: 122. True if employee is exempt from paying PRSI in Ireland. This field is only included if the employee is exempt from paying PRSI.
PRSIClass optional prsiClass Simple Type
Data Item Ref: 123. PRSI Class and Subclass that the employee should be updated to. This will appear only where DSP updates the class or where DSP knows the individual is on the wrong class. i.e. where a review has been carried out by DSP.
NoRPN 0..∞ EmployeeID Complex Type
Data Item Ref: N/A. Employees where no RPN details could be returned. These employees should be calculated under an Emergency basis.
Sequence
EmployeePPSN EmployeePPSN Simple Type
Data Item Ref: 108. Employee's PPS Number. Used to identify the employee to which the RPN relates.
EmploymentID optional employmentID Simple Type
Data Item Ref: 110. Employee's Employment ID. Unique identifier for each distinct employment for an employee. If the RPN is being triggered as a result of the employee setting up the employment via Jobs and Pension or contacting Revenue, this field will not be populated.
ValidationError 0..∞ Error Complex Type
List of Validation errors (if any) on the NewRPNRequest.
Sequence
Code errorCode Simple Type
Technical Error Code - to be used for mapping to error messages.
Path optional errorPath Simple Type
Path to error in schema, if available.
Description errorDescription Simple Type
Description of error - to be used for support.
See Also
All Operations Resource Group | RPN Web Service

Please register for our PIT Support Help Desk for the following: