RTI EPS Job Instructions



RtiEpsJobInstruction [Schema]

Name Type Required Description
HoldingDate xsd:dateTime no Optional date, used to defer execution of the job until a future point in time.
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.
Employer Link yes A link to the associated Employer resource.
Timestamp xsd:dateTime no The timestamp that is transmitted on the RTI message.
SchemeCeased xsd:date no Flag to indicate if the PAYE scheme has ceased.
TaxMonth TaxMonth yes 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.

Example

<?xml version="1.0"?>
<RtiEpsJobInstruction xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <HoldingDate>2019-09-30T00:00:00+00:00</HoldingDate>
  <Generate>true</Generate>
  <Transmit>true</Transmit>
  <TaxYear>123</TaxYear>
  <Employer title="string" href="string" rel="string" />
  <Timestamp>2019-09-30T00:00:00+00:00</Timestamp>
  <SchemeCeased>2019-09-30</SchemeCeased>
  <FinalSubmissionForYear>true</FinalSubmissionForYear>
  <TaxMonth>123</TaxMonth>
  <NoPaymentForPeriodFrom>2019-09-30</NoPaymentForPeriodFrom>
  <NoPaymentForPeriodTo>2019-09-30</NoPaymentForPeriodTo>
  <PeriodOfInactivityFrom>2019-09-30</PeriodOfInactivityFrom>
  <PeriodOfInactivityTo>2019-09-30</PeriodOfInactivityTo>
</RtiEpsJobInstruction>
{
  "RtiEpsJobInstruction": {
    "HoldingDate": "2019-09-30T00:00:00+00:00",
    "Generate": "true",
    "Transmit": "true",
    "TaxYear": "123",
    "Employer": {
      "@title": "string",
      "@href": "string",
      "@rel": "string"
    },
    "Timestamp": "2019-09-30T00:00:00+00:00",
    "SchemeCeased": "2019-09-30",
    "FinalSubmissionForYear": "true",
    "TaxMonth": "123",
    "NoPaymentForPeriodFrom": "2019-09-30",
    "NoPaymentForPeriodTo": "2019-09-30",
    "PeriodOfInactivityFrom": "2019-09-30",
    "PeriodOfInactivityTo": "2019-09-30"
  }
}