RTI Job Instructions



RtiJobInstruction [Schema]

Name Type Required Description
HoldingDate xsd:dateTime no Optional date, used to defer execution of the job until a future point in time.
RtiType xsd:string (enumeration)
  • FPS
  • EPS
  • NVR
  • EAS
  • EYU
yes The type of RTI message to be generated or transmitted.
Generate xsd:boolean yes Flag to indicate if the job should generate the message.
Transmit xsd:boolean yes Flag to indicate if the message should be transmitted to HMRC via the RTI gateway.
TaxYear TaxYear yes The tax year the message relates to.
EarlierTaxYear EarlierTaxYear no Only used for EYU messages, indicates the past tax year that the correction relates to.
Employer Link yes A link to the associated Employer resource.
Timestamp xsd:dateTime yes The timestamp that is transmitted on the RTI message.
PaySchedule Link no Only used for FPS messages, a link to the associated PaySchedule resource.
PaymentDate xsd:date no Only used for FPS messages, the relevant payment date.
SchemeCeased xsd:date no Flag to indicate if the PAYE scheme has ceased.
LateReason xsd:string (enumeration)
  • A
  • B
  • C
  • D
  • F
  • G
  • H
no If applicable, the reason given for a late submission.
TaxMonth TaxMonth no The reporting tax month.
NoPaymentForPeriodFrom xsd:date no Only used for EPS messages, used to report a period where no payments are made.
NoPaymentForPeriodTo xsd:date no Only used for EPS messages, used to report a period where no payments are made.
PeriodOfInactivityFrom xsd:date no Only used for EPS messages, used to report a period of inactivity.
PeriodOfInactivityTo xsd:date no Only used for EPS messages, used to report a period of inactivity.
FinalSubmissionForYear xsd:boolean no Flag to indicate if this is the final submission of the tax year.

Late Reasons

Letter Explanation
A Notional payment: Payment to Expat by third party or overseas employer
B Notional payment: Employment related security
C Notional payment: Other
D Payment subject to Class 1 NICs but P11D/P9D for tax
F No requirement to maintain a Deductions Working Sheet or Impractical to report work done on the day
G Reasonable excuse
H Correction to earlier submission