Employer



Represents an employer revision. See revisible objects for more information on revisions and how they work.

Employer [Schema]

Name Type Required Description
EffectiveDate xsd:date yes The date the revision will come into effect.
Revision Revision yes The revision number of the employer.
Name xsd:string ( min: 1 max: 35)
Pattern: [A-Za-z0-9 ~!"@#$%&'\(\)\*\+,\-\./:;<=>\?\[\\\]^_\{\}£€]*
yes The legal name of the employer.
Region CalculatorRegion yes The employer's region which determines the default calculators to be used.
Territory CalculatorTerritory yes The employer's territory which determines the default calculators to be used in all employee calculations. Currently United Kingdom is the only supported territory.
BacsServiceUserNumber xsd:integer
Pattern: [0-9]{6}
no The employer's unique identifier making payments throught the BACS network.
ClaimEmploymentAllowance xsd:boolean no Indicates if the employer should claim the Employment Allowance See Claiming the Employment Allowance for more details.
ClaimSmallEmployerRelief xsd:boolean no Indicates if the employer should claim the Small Employer Relief See Claiming Small Employer Relief for more details.
ApprenticeshipLevyAllowance Money ( min: 0 max: 15000) no The employer's annual levy allowance; The apprenticeship levy will only apply to employers with annual paybill in excess of £3 million.
RuleExclusions RuleExclusionFlags yes The list of pre-claculation rules to exclude by default for all employees. See Pre-calculation rules for more information on how they work.
Address Address no The employer's registered address.
HmrcSettings HmrcSettings no The employer's specific HMRC reference numbers and RTI credentials.
BankAccount BankAccount no The employer's bank account; will be used as the originator account in any BACS reporting.

HMRC Settings



HmrcSettings [Schema]

Name Type Required Description
TaxOfficeNumber xsd:string
Pattern: [0-9]{3}
yes The Tax Office Number is the first part of your employer's PAYE refernce issued by HMRC; it consists of 3 numbers. Required to make RTI submissions.
TaxOfficeReference xsd:string ( min: 1 max: 10)
Pattern: [A-Za-z0-9]*
yes The Tax Office Reference is the second part of your employer's PAYE refernce issued by HMRC; it consists of up to 10 apha-numeric charaters. Required to make RTI submissions.
AccountingOfficeRef xsd:string
Pattern: [0-9]{3}P[A-Z][0-9]{7}[0-9X]
yes The Accounting Office Reference is issued by HMRC; typically it is found on employer's P30BC Employer Payment Booklet. Required to make RTI submissions.
SAUTR xsd:string
Pattern: [0-9]{10}
no The Self Assessment Unique Tax reference; only applicable to sole proprietors or partnerships.
COTAXRef xsd:string
Pattern: [0-9]{10}
no The Corporation Tax reference; applicable to limited companies.
Sender xsd:string (enumeration)
  • Individual
  • Company
  • Agent
  • Bureau
  • Partnership
  • Trust
  • Employer
  • Government
  • ActingInCapacity
  • Other
no The entity type that is making the RTI submission on behalf of the employer. Required to make RTI submissions.
SenderId xsd:string ( min: 1 max: 35)
Pattern: [A-Za-z0-9 ~!"@#$%&'\(\)\*\+,\-\./:;<=>\?\[\\\]^_\{\}£€]*
no The government gateway username issued to the employer by HMRC. Required to make RTI submissions.
Password xsd:string ( min: 1 max: 35)
Pattern: [A-Za-z0-9 ~!"@#$%&'\(\)\*\+,\-\./:;<=>\?\[\\\]^_\{\}£€]*
no The government gateway password issued to the employer by HMRC. Required to make RTI submissions.
ContactFirstName Name no The designated HMRC contact person's first name.
ContactLastName Name no The designated HMRC contact person's last name.
ContactEmail xsd:string ( min: 3 max: 129)
Pattern: [A-Za-z0-9\.\-_]{1,64}@[A-Za-z0-9\.\-_]{1,64}
no The designated HMRC contact person's email address; RTI submission acknowledgements will be sent to this address.
ContactTelephone Telephone no The designated HMRC contact person's telephone number.
ContactFax Telephone no The designated HMRC contact person's fax number.