Returns Reconciliation Schema
LookupPayrollDetailsByReturnPeriodResponse Complex Type
Returns Reconciliation Schema : LookupPayrollDetailsByReturnPeriodResponse Complex Type
Description
Data Items sent to an employer/agent in response to a Payroll Return by Period request to view a Return for a specific period.
Namespace http://www.ros.ie/schemas/paye-employers/v1/returns_reconciliation/
Diagram
Description Element Path Element Code Element Sequence ValidationError Element LPT Element USC Element PRSI Element TaxOnIncome Element multiPeriod Element RunDate Element PayrollRunReference Element Sequence PayrollRunDetails Element LPT Element USC Element PRSI Element TaxOnIncome Element Sequence PeriodSummary Element Version Element DateLastUpdated Element PeriodEndDate Element PeriodStartDate Element Sequence ReturnPeriod Element AgentTain Element EmployerRegistrationNumber Element Sequence LookupPayrollDetailsByReturnPeriodResponse Complex Type
Overview
LookupPayrollDetailsByReturnPeriodResponse
Data Items sent to an employer/agent in response to a Payroll Return by Period request to view a Return for a specific period.
Sequence
EmployerRegistrationNumber employerReg Simple Type
Data Item Ref: 201. Employer's PAYE-EMP Registration Number.
AgentTain optional agentTAIN Simple Type
Data Item Ref: 202. Tax Advisor Identification Number. Returned if the Payroll Return by Period request was filed by an agent on behalf of an employer.
ReturnPeriod ReturnPeriod Complex Type
Data Item Ref: N/A. The period the return relates to.
Sequence
PeriodStartDate xs:date
Data Item Ref: 203. Period start date e.g. 01/01/2019. Used to identify the period the request relates to.
PeriodEndDate xs:date
Data Item Ref: 204. Period end date e.g.31/01/2019. Used to identify the period the request relates to.
DateLastUpdated optional xs:date
Data Item Ref: 208. This date indicates when the return was last updated.
Version optional version Simple Type
Data Item Ref: 207. Indicates the version of the return that is being requested.
PeriodSummary optional PeriodSummary Complex Type
Data Item Ref: N/A. The overall totals for PAYE, PRSI (employer and employee), USC and LPT in the selected period.
Sequence
TaxOnIncome xs:decimal
Data Item Ref: 209. The overall total income tax for the period. (Only payroll figures with pay dates in the selected period are included in this period's totals).
PRSI xs:decimal
Data Item Ref: 210. The overall total PRSI (employer and employee) for the period. (Only payroll figures with pay dates in the selected period are included in this period's totals).
USC xs:decimal
Data Item Ref: 211. The overall total USC for the period. (Only payroll figures with pay dates in the selected period are included in this period's totals).
LPT xs:decimal
Data Item Ref: 212. The overall total LPT for the period. (Only payroll figures with pay dates in the selected period are included in this period's totals).
PayrollRunDetails 0..∞ PayrollRunDetails Complex Type
Data Item Ref: N/A. List of individual payroll runs with pay dates in the selected period.
Sequence
PayrollRunReference PayrollRunReference Simple Type
Data Item Ref: 213. The reference number identifies a specific payroll run.
RunDate xs:date
Data Item Ref: 214. The date the payroll run was submitted or last updated.
multiPeriod xs:boolean
Data Item Ref: 215. Indicates if the Payroll Run includes pay dates in other periods. (Only payroll figures with pay dates in the selected period are included in this period's totals).
TaxOnIncome xs:decimal
Data Item Ref: 216. The total amount of Income Tax in the payroll run for this period. (Only payroll figures with pay dates in the selected period are included in this period's totals).
PRSI xs:decimal
Data Item Ref: 217. The total amount of PRSI (employer and employee) in the payroll run for this period. (Only payroll figures with pay dates in the selected period are included in this period's totals).
USC xs:decimal
Data Item Ref: 218. The total amount of USC in the payroll run for this period. (Only payroll figures with pay dates in the selected period are included in this period's totals).
LPT xs:decimal
Data Item Ref: 219. The total amount of LPT in the payroll run for this period. (Only payroll figures with pay dates in the selected period are included in this period's totals).
ValidationError 0..∞ Error Complex Type
List of Submission Validation Errors (if any).
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
Technical description of error.
Used By
LookupPayrollDetailsByReturnPeriodResponse Element
Source
<xs:complexType name="LookupPayrollDetailsByReturnPeriodResponse" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:annotation>
    <xs:documentation>Data Items sent to an employer/agent in response to a Payroll Return by Period request to view a Return for a specific period.</xs:documentation>
  </xs:annotation>
  <xs:sequence>
    <xs:element name="EmployerRegistrationNumber" type="pc:employerReg">
      <xs:annotation>
        <xs:documentation>Data Item Ref: 201. Employer's PAYE-EMP Registration Number.</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="AgentTain" type="pc:agentTAIN" minOccurs="0">
      <xs:annotation>
        <xs:documentation>Data Item Ref: 202. Tax Advisor Identification Number. Returned if the Payroll Return by Period request was filed by an agent on behalf of an employer.</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="ReturnPeriod" type="rr:ReturnPeriod">
      <xs:annotation>
        <xs:documentation>Data Item Ref: N/A. The period the return relates to.</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="DateLastUpdated" minOccurs="0" type="xs:date">
      <xs:annotation>
        <xs:documentation>Data Item Ref: 208. This date indicates when the return was last updated.</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="Version" minOccurs="0" type="rr:version">
      <xs:annotation>
        <xs:documentation>Data Item Ref: 207. Indicates the version of the return that is being requested.  </xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="PeriodSummary" minOccurs="0" type="rr:PeriodSummary">
      <xs:annotation>
        <xs:documentation>Data Item Ref: N/A. The overall totals for PAYE, PRSI (employer and employee), USC and LPT in the selected period.</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="PayrollRunDetails" type="rr:PayrollRunDetails" minOccurs="0" maxOccurs="unbounded">
      <xs:annotation>
        <xs:documentation>Data Item Ref: N/A. List of individual payroll runs with pay dates in the selected period.</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="ValidationError" type="rr:Error" minOccurs="0" maxOccurs="unbounded">
      <xs:annotation>
        <xs:documentation>List of Submission Validation Errors (if any).</xs:documentation>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>
See Also
Returns Reconciliation Schema

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