Pension Schemes Online
Practitioner Management
Response Messages for e-Submission
V2.1
HM Revenue & Customs
Practitioner Management
Pension Schemes Online
1. Document Control
2. About this document
3. ChRIS Response Messages
1.
Correlation ID
2.
Message class
4. IRenvelope Response Messages
1.
Test Message
2.
Key
3.
Period end
4.
Principal
5.
Agent
6.
Default currency
7.
Namespace
8.
Schema version
9.
Top element name
10.
IRmark
11.
Sender
12.
Pension Scheme Tax Reference
13.
PS Body
Body Response Messages
1. Pension Scheme Tax Reference
2. Practitioners ID
3. Practitioner Name
4. Scheme Administrators ID
5.Client Reference
6. Effective Date
7. Action
8. Authorise Declaration
9. Deauthorise Declaration
10. Declaration Date
6. Success Response Messages
1.
Successful Submission Response
7. Failure Response Messages
1.
Failure Submission Response
13/02/16
3
3
4
4
4
5
5
5
5
5
5
6
6
6
6
6
6
7
7
7
7
8
8
8
9
9
9
9
10
10
10
10
10
10
Version 2.1
Page 2 of 10
HM Revenue & Customs
Practitioner Management
Pension Schemes Online
1. Document Control
Document History
Version
Date
1.0
23/05/07
2.0
25/07/07
2.1
18/12/14
Baselined.
Baselined.
April 2015 Release
Addition of submission error message
where the Scheme administrator’s Fit and
Proper status is ‘Info not Provided’.
2. About this document
Section 3 outlines the rules that govern the contents of the GovTalkHeader.
Section 4 outlines the rules that govern the contents of the envelope schema.
Business validation rules are defined in a separate set of rules for each message.
This also contains both the validation and business rules, which will form part of the
validation checks that will need to be undertaken by both the HMRC ‘e’ portal or that
developed by third party software suppliers.
Section 5 covers the body response messages. On submission the message is
tested against the XML schema by the Parser. XML that successfully passes
through the Parser will then be tested against the GovRules, which test the crossfield validation.
This section identifies every element in the business validation rules. In all cases a
Parser error will be generated if the submission fails at Parser level. If there is no
specific cross-field validation for an element it is simply noted ‘Parser error’. Where
there is a cross-field validation the error and error message only is detailed.
A bold black line separates each data item table and the error messages contained
below this line are state validation.
HMRC will use the following default values within the error structure when Parser
errors are located.
Element
Description and Value
RaisedBy
HMRC-ERIC
Number
5012 – all errors caused by schema validation
6010 – all errors from badly-formed XML
Type
business
Text
Default text from Parser
Location
Line and position number from the Parser
Section 6 outlines the Success Response Messages.
13/02/16
Version 2.1
Page 3 of 10
HM Revenue & Customs
Practitioner Management
Pension Schemes Online
3. ChRIS Response Messages
This section outlines the rules that govern the contents of the GovTalkHeader.
1. Correlation ID
Error Number
Error
Error Message
Error Number
Error
Error Message
2. Message class
Error Number
Error
Error Response Message
13/02/16
A duplicate correlation ID has been submitted in TPVS.
You have submitted a duplicate Correlation ID. Please either enter a new unique number or delete the
element from your submission. In a live submission this field must be empty.
Null correlation ID
[ChRIS 1] System error <error number> please contact the helpdesk
The class sent does not match the URL.
You have sent message class <Class> when the URL requires <Class>. Either make your submission to the
correct URL or amend the class’.
Version 2.1
Page 4 of 10
HM Revenue & Customs
Practitioner Management
Pension Schemes Online
4. IRenvelope Response Messages
This section outlines the rules that govern the contents of the envelope schema.
Each submission must contain only 1 occurrence of Pension Scheme Tax Reference, but may contain multiple occurrences of Scheme
Administrators ID.
IRheader
1. Test Message
Error
Parser level
2. Key
Error
Parser level
Error Number
Error
Error Message
Error Number
Error
Error Message
601603
The Scheme Administrator ID in the IRheader does not match the Scheme Administrator ID in the body.
The Scheme Administrator ID entry in the IRheader key does not match the Scheme Administrator ID in the
body.
601604
The Practitioner ID in the IRheader does not match the Practitioner ID in the body.
The Practitioner ID entry in the IRheader key does not match the Practitioner ID in the body.
3. Period end
Error
Parser level
4. Principal
Error
Parser level
5. Agent
Error
Parser level
13/02/16
Version 2.1
Page 5 of 10
HM Revenue & Customs
Practitioner Management
6. Default currency
Error
Pension Schemes Online
Parser level
Manifest
7. Namespace
Error Number
Error
Error Message
1031
The entry in the Namespace does not agree with the entry in the GovTalkHeader.
[The namespace in the IRheader must match the GovTalkHeader] System error please contact the help desk.
8. Schema version
Error
Parser level
9. Top element name
Error
Parser level
10. IRmark
Error
Parser level
11. Sender
Error
Parser level
13/02/16
Version 2.1
Page 6 of 10
HM Revenue & Customs
Practitioner Management
Pension Schemes Online
PS Envelope
12. Pension Scheme Tax Reference
Error Number
601605
Error
Practitioner Management is submitted and the Pension Scheme Tax Reference in the Psheader is not
completed or does not match the tax reference in the body.
Error Message
[BVR Envelope 12] The Pension Scheme Tax Reference does not match the tax reference in the body.
13. PS Body
Error
Parser level
Body Response Messages
Scheme Administrator / Practitioner Details
1. Pension Scheme Tax Reference
Error
Parser level
Error Number
Error
Error Message
13/02/16
701603
The tax reference does not exist in TPSS
The tax reference does not exist in TPSS.
Version 2.1
Page 7 of 10
HM Revenue & Customs
Practitioner Management
2. Practitioners ID
Error
Error Number
Error
Error Message
Pension Schemes Online
Parser level
Error Number
Error
Error Message
701601
The Practitioner has already been authorised for this Pension Scheme by the Scheme Administrator.
The Practitioner <Practitioner ID> has already been authorised for the Pension Scheme <PSTR> by the Scheme
Administrator <Administrator ID>.
707904
The action is deauthorise, and the practitioner authorisation from this administrator for this scheme has already
been ceased.
The authorisation received from <Scheme Administrator ID> for Practitioner <Practitioner ID> for the Pension
Scheme <PSTR> has already been ceased.
701606
The Practitioner does not exist in TPSS.
The Practitioner does not exist in TPSS.
3. Practitioner Name
Error
Parser level
Error Number
Error
Error Message
4. Scheme Administrators ID
Error
Parser level
Error Number
Error
Error Message
701604
The Scheme Administrator is not associated to the Pension Scheme.
The Scheme Administrator <Administrator ID> is not associated to the Pension Scheme <PSTR>.
Error Number
Error
Error Message
701605
The Scheme Administrator does not exist in TPSS.
The Scheme Administrator does not exist in TPSS.
Error Number
Error
Error Message
707905
The Scheme Administrator was not the authoriser of the practitioner, and the action is deauthorise.
The Scheme Administrator must be the authoriser of the practitioner to deauthorise the practitioner
13/02/16
Version 2.1
Page 8 of 10
HM Revenue & Customs
Practitioner Management
Pension Schemes Online
5.Client Reference
Error
Parse level
6. Effective Date
Error
Parse level
7. Action
Error Number
Error
Error Message
601606
The action is authorise and the submitter is a practitioner.
Only a Scheme Administrator can authorise a practitioner.
8. Authorise Declaration
Error Number
Error
Error Message
Error Number
Error
Error Message
Error Number
Error
Error Message
601601
The submission contains authorisations and the authorise declaration is not present.
You must complete the authorisation declaration.
601607
The submission does not contain authorisations and the authorise declaration is present.
You must not complete the authorisation declaration.
601608
The submitter is a practitioner and the authorise declaration is present.
You must not complete the authorisation declaration.
13/02/16
Version 2.1
Page 9 of 10
HM Revenue & Customs
Practitioner Management
Pension Schemes Online
9. Deauthorise Declaration
Error Number
601602
Error
The submission contains deauthorisations and the deauthorise declaration is not present.
Error Message
You must complete the de-authorise declaration.
Error Number
601609
Error
The submission does not contain deauthorisations and the deauthorise declaration is present.
Error Message
You must not complete the deauthorise declaration.
Error Number
601610
Error
The submitter is a practitioner and the deauthorise declaration is present.
Error Message
You must not complete the deauthorise declaration.
10. Declaration Date
6.
Success Response Messages
1. Successful Submission Response
Message Number
7160
Response
Thank you for the Practitioner Management submission.
Response Message
7.
Failure Response Messages
1. Failure Submission Response
Message Number
MSG352
Response
Third Party Submission by a Scheme Administrator who has not provided their Fit and Proper Details
This submission has not been accepted. Before you can proceed, please log on to the TPSS Portal at
www.gov.uk (search for Manage a Registered Pension Scheme) to give us new additional scheme
administrator information.
Response Message
13/02/16
You will log on using the username and password that you were issued when you registered for Pension
Schemes Online at the Government Gateway. Once you have provided the additional information you will
be able to resubmit this submission.
Version 2.1
Page 10 of 10