ExpenseBenefit Complex Type

Description

Individual Expense Benefit details for Enhanced Reporting submission.

Namespace

http://www.ros.ie/schemas/paye-employers/err/v1/enhanced_reporting/

Diagram

Overview

ExpenseBenefit

Individual Expense Benefit details for Enhanced Reporting submission.

Sequence

LineItemID expenseBenefitLineItemID Simple Type

Data Item Ref: 5. Used to uniquely identify individual line items.

PreviousLineItemID optional expenseBenefitLineItemID Simple Type

Data Item Ref: N/A. Used to identify a previous version of this line item when corrections are made. Can only reference line items within the same Enhanced Reporting Run.

EmployeeID optional EmployeeID Complex Type

Data Item Refs: 9 and 15. Unique references to an employment for an employee. Includes PPSN and Employment ID.

Sequence

EmployeePPSN EmployeePPSN Simple Type

Data Item Ref: 9. Employee's PPS Number.

EmploymentID employmentID Simple Type

Data Item Ref: 15. Employment ID. Unique identifier for each distinct employment for an employee. To be set by the employer.

EmployerReference optional employerReference Simple Type

Data Item Ref: 14. Employee's internal staff identifier/reference. This will be mandatory if the PPSN isn’t available and must remain unchanged in all submissions received until the PPSN is available. Optional if PPSN is available.

Name Name Complex Type

Data Item Ref: 10 and 11. Employee Name. Mandatory.

Sequence

FirstName defaultString Simple Type

Data Item Ref: 10. The first name of the employee.

FamilyName defaultString Simple Type

Data Item Ref: 11. The surname/family name of the employee.

Address optional Address Complex Type

Data Item Ref: 12. Elements required when Employee PPSN is not known.

Sequence

AddressLine 1..3 defaultString Simple Type

Data Item Ref: 12. The address will be mandatory if the PPSN isn’t available. Line 1 of the employee's address is required.

County optional county Simple Type

Data Item Ref: 12. County element of the employee's address.

Eircode optional eircode Simple Type

Data Item Ref: 12. Employee's Eircode (if known). Used for Irish addresses only.

CountryCode optional countryCode Simple Type

Data Item Ref: 12. Country code element. Codes used at the International Standard for country codes ISO 3166 Alpha-3.

DateOfBirth optional xs:date

Data Item Ref: 13. Employee's Date of Birth - format YYYY-MM-DD. This will be mandatory if the PPSN isn’t available.

Category category Simple Type

Data Item Ref: 18. Category of Expense Benefit. Possible values are Travel and Subsistence, Remote Working Daily Allowance, Small Benefits Exemption.

SubCategory optional subcategory Simple Type

Data Item Ref: 19. Subcategory of Expense Benefit. Will be mandatory if relevant category is selected. Possible values for Travel and Subsistence category are Travel Vouched, Travel Unvouched, Subsistence Vouched, Subsistence Unvouched, Site Based Employees, Emergency Travel, Eating on Site, Advance Payment.

AdvancePaymentReconciliation optional xs:boolean

Data Item Ref: 21. Advance Payment Reconciliation. This is to identify if a Travel and Subsistence submission relates to a previously submitted Advance Payment.

PaymentDate xs:date

Data Item Ref: 16. Date employee is paid Expense Benefit (YYYY-MM-DD).

NumberOfDays optional xs:integer

Data Item Ref: 20. Number of Days. The total number of days for the Expense Benefit.

Amount defaultDecimal Simple Type

Data Item Ref: 17. Expense Benefit Amount. The total amount of the Expense Benefit.

Used By

ExpensesBenefits Element

Source

<xs:complexType name="ExpenseBenefit" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:annotation>
    <xs:documentation>Individual Expense Benefit details for Enhanced Reporting submission.</xs:documentation>
  </xs:annotation>
  <xs:sequence>
    <xs:element name="LineItemID" type="pc:expenseBenefitLineItemID">
      <xs:annotation>
        <xs:documentation>Data Item Ref: 5. Used to uniquely identify individual line items.</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="PreviousLineItemID" type="pc:expenseBenefitLineItemID" minOccurs="0">
      <xs:annotation>
        <xs:documentation>Data Item Ref: N/A. Used to identify a previous version of this line item when corrections are made. Can only reference line items within the same Enhanced Reporting Run.</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="EmployeeID" type="pp:EmployeeID" minOccurs="0">
      <xs:annotation>
        <xs:documentation>Data Item Refs: 9 and 15. Unique references to an employment for an employee. Includes PPSN and Employment ID.</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="EmployerReference" type="pc:employerReference" minOccurs="0">
      <xs:annotation>
        <xs:documentation>Data Item Ref: 14. Employee's internal staff identifier/reference. This will be mandatory if the PPSN isn’t available and must remain unchanged in all submissions received until the PPSN is available. Optional if PPSN is available.</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="Name" type="pp:Name">
      <xs:annotation>
        <xs:documentation>Data Item Ref: 10 and 11. Employee Name. Mandatory.</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="Address" type="pp:Address" minOccurs="0">
      <xs:annotation>
        <xs:documentation>Data Item Ref: 12. Elements required when Employee PPSN is not known.</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="DateOfBirth" type="xs:date" minOccurs="0">
      <xs:annotation>
        <xs:documentation>Data Item Ref: 13. Employee's Date of Birth - format YYYY-MM-DD. This will be mandatory if the PPSN isn’t available.</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="Category" type="pc:category">
      <xs:annotation>
        <xs:documentation>Data Item Ref: 18. Category of Expense Benefit. Possible values are Travel and Subsistence, Remote Working Daily Allowance, Small Benefits Exemption.</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="SubCategory" type="pc:subcategory" minOccurs="0">
      <xs:annotation>
        <xs:documentation>Data Item Ref: 19. Subcategory of Expense Benefit. Will be mandatory if relevant category is selected. Possible values for Travel and Subsistence category are Travel Vouched, Travel Unvouched, Subsistence Vouched, Subsistence Unvouched, Site Based Employees, Emergency Travel, Eating on Site, Advance Payment.</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="AdvancePaymentReconciliation" type="xs:boolean" minOccurs="0">
      <xs:annotation>
        <xs:documentation>Data Item Ref: 21. Advance Payment Reconciliation. This is to identify if a Travel and Subsistence submission relates to a previously submitted Advance Payment.</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="PaymentDate" type="xs:date">
      <xs:annotation>
        <xs:documentation>Data Item Ref: 16. Date employee is paid Expense Benefit (YYYY-MM-DD).</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="NumberOfDays" type="xs:integer" minOccurs="0">
      <xs:annotation>
        <xs:documentation>Data Item Ref: 20. Number of Days. The total number of days for the Expense Benefit.</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="Amount" type="pc:defaultDecimal">
      <xs:annotation>
        <xs:documentation>Data Item Ref: 17. Expense Benefit Amount. The total amount of the Expense Benefit.</xs:documentation>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>