Commission Regulation (EC) No 2216/2004 (repealed)Dangos y teitl llawn

ANNEX VIII Processes concerning accounts and verified emissions with response codes

Requirements for each process

1.

The following message sequence for processes concerning an account or verified emissions shall apply:

(a)

the authorised representative of an account shall submit a request to the registry administrator of that registry;

(b)

the registry administrator shall assign a unique correlation identification code comprising the elements set out in Annex VI to the request;

(c)

prior to the communication link between the Community independent transaction log and the UNFCCC independent transaction log being established, the registry administrator shall call the appropriate operation on the Community independent transaction log account management Web service, thereafter, the registry administrator shall call the appropriate operation on the UNFCCC independent transaction log account management Web service;

(d)

the Community independent transaction log shall validate the request by calling the appropriate validation function within the Community independent transaction log;

(e)

if the request is successfully validated and thereby accepted, the Community independent transaction log shall amend the information it holds in accordance with that request;

(f)

the Community independent transaction log shall call the ‘receiveAccountOperationOutcome’ operation on the account management Web service of the registry which sent the request, notifying the registry as to whether the request was successfully validated and thereby accepted, or whether the request was found to contain a discrepancy and was thereby rejected;

(g)

if the request was successfully validated and thereby accepted, the registry administrator which sent the request shall amend the information held in the registry in accordance with that validated request; otherwise, if the request was found to contain a discrepancy and was thereby rejected, the registry administrator which sent the request shall not amend the information held in the registry in accordance with that rejected request.

Table VIII-1: Message Sequence Diagram for Processes concerning an Account or Verified Emissions

2. Prior to the communication link between the Community independent transaction log and the UNFCCC independent transaction log being established, a registry administrator sending a request should receive an acknowledgement of receipt from the Community independent transaction log within 60 seconds. Thereafter, a registry administrator sending a request should receive an acknowledgement of receipt from the UNFCCC independent transaction log within 60 seconds. A registry administrator sending a request should receive a notification of validation from the Community independent transaction log within 24 hours.

3.

The status of the process during the message sequence shall be as follows:

Table VIII-2: Status Diagram for Processes concerning an Account or Verified Emissions

4. The components and functions which are utilised during the message sequence are shown in table VIII-3 to VIII-18. Functions which are public shall be implemented as specified. Functions which are Privatee are for informational purposes only. The inputs of all functions have been structured to match the format and informational requirements described using web services description language, set out in the functional and technical specifications for data exchange standards for registry systems under the Kyoto Protocol, elaborated pursuant to Decision 24/CP.8 of the Conference of the Parties to the UNFCCC. An asterisk ‘(*)’ has been used to denote the fact that an element can appear multiple times as an input.

Table VIII-3: Components and Functions for Processes concerning an Account or Verified Emissions

Component	Function	Scope
MgmtOfAccountWS	CreateAccount()	Public
	UpdateAccount()	Public
	CloseAccount()	Public
	UpdateVerifiedEmissions()	Public
	ReceiveAccountOperationOutcome()	Public
AccountManagement	ValidateAccountCreation()	Private
	CreateAccount()	Private
	ValidateAccountUpdate()	Private
	UpdateAccount()	Private
	ValidateAccountClosure()	Private
	CloseAccount()	Private
	ValidateVerifiedEmissionsUpdate()	Private
	UpdateVerifiedEmissions()	Private
DataValidation	AuthenticateMessage()	Private
	CheckVersion()	Private
	DataFormatChecks()	Private

Table VIII-4: MgmtOfAccountWS Component

Purpose
The purpose of this component is to handle web service requests for the management of accounts and verified emissions.
Functions exposed through Web Services
CreateAccount()	Handles the account creation requests
UpdateAccount()	Handles the account update requests
CloseAccount()	Handles account closure requests
UpdateVerifiedEmissions()	Handles verified emissions update requests
ReceiveAccountOperationOutcome()	Receives an account operation (creation, update, …) outcome (‘accepted’ or ‘rejected’)
Other functions
Not applicable.
Roles
Community independent transaction log (for all functions) and registry (for the ReceiveAccountOperationOutcome function only)

Table VIII-5: MgmtOfAccountWS.CreateAccount() function

Purpose
This function receives an account creation request. The Community independent transaction log authenticates the initiating registry (Originating Registry) by calling the AuthenticateMessage() function and checks the version of the initiating registry by calling CheckVersion() function. If authentication and version checks pass, a ‘1’ result identifier is returned without any response codes, the contents of the request are written to a file by calling the WriteToFile() function and the request is put in a queue. If authentication or version checks fail, a ‘0’ result identifier is returned together with a single response code indicating the error cause. If the person (People) is not a natural person its name must be put in the LastName parameter. The ‘PersonIdentifier’ means the account holder identification code comprising the elements set out in Annex VI. The ‘IdentifierInRegistry’ means the alphanumeric identifier for the account as specified by the account holder pursuant to Annexes III and IV.
Input parameters
From	Mandatory
To	Mandatory
CorrelationId	Mandatory
MajorVersion	Mandatory
MinorVersion	Mandatory
Account (*)	Mandatory
AccountType	Mandatory
AccountIdentifier	Mandatory
IdentifierInReg	Mandatory
CommitmentPeriod	Optional
Installation	Optional
InstallationIdentifier	Mandatory
PermitIdentifier	Mandatory
Name	Mandatory
MainActivityType	Mandatory
Country	Mandatory
PostalCode	Mandatory
City	Mandatory
Address1	Mandatory
Address2	Optional
ParentCompany	Optional
SubsidiaryCompany	Optional
EPERIdentification	Optional
Latitude	Optional
Longitude	Optional
ContactPeople (see People)	Mandatory
People (*)	Mandatory
RelationshipCode	Mandatory
PersonIdentifier	Mandatory
FirstName	Optional
LastName	Mandatory
Country	Mandatory
PostalCode	Mandatory
City	Mandatory
Address1	Mandatory
Address2	Optional
PhoneNumber1	Mandatory
PhoneNumber2	Mandatory
FaxNumber	Mandatory
Email	Mandatory
Output parameters
Result Identifier	Mandatory
Response Code	Optional
Uses
AuthenticateMessage WriteToFile CheckVersion
Used By
Not applicable (called as a web service).

Table VIII-6: MgmtOfAccountWS.UpdateAccount() function

Purpose
This function receives an account update request. The Community independent transaction log authenticates the initiating registry (Originating Registry) by calling the AuthenticateMessage() function and checks the version of the initiating registry by calling CheckVersion() function. If authentication and version checks pass, a ‘1’ result identifier is returned without any response codes, the contents of the request are written to a file by calling the WriteToFile() function and the request is put in a queue. If authentication or version checks fail, a ‘0’ result identifier is returned together with a single response code indicating the error cause. If the person (People) is not a natural person its name must be put in the LastName parameter. The ‘PersonIdentifier’ means the account holder identification code comprising the elements set out in Annex VI. The ‘IdentifierInRegistry’ means the alphanumeric identifier for the account as specified by the account holder pursuant to Annexes III and IV.
Input parameters
From	Mandatory
To	Mandatory
CorrelationId	Mandatory
MajorVersion	Mandatory
MinorVersion	Mandatory
Account (*)	Mandatory
AccountIdentifier	Mandatory
IdentifierInReg	Optional
Installation	Optional
PermitIdentifier	Optional
Name	Optional
MainActivityType	Optional
Country	Optional
PostalCode	Optional
City	Optional
Address1	Optional
Address2	Optional
ParentCompany	Optional
SubsidiaryCompany	Optional
EPERIdentification	Optional
Latitude	Optional
Longitude	Optional
ContactPeople (see People)	Optional
People (*)	Optional
Action	Mandatory
RelationshipCode	Mandatory
PersonIdentifier	Mandatory
FirstName	Optional
LastName	Optional
Country	Optional
PostalCode	Optional
City	Optional
Address1	Optional
Address2	Optional
PhoneNumber1	Optional
PhoneNumber2	Optional
FaxNumber	Optional
Email	Optional
Output parameters
Result Identifier	Mandatory
Response Code	Optional
Uses
AuthenticateMessage WriteToFile CheckVersion
Used By
Not applicable (called as a web service).

Table VIII-7: MgmtOfAccountWS.CloseAccount() function

Purpose
This function receives an account closure request. The Community independent transaction log authenticates the initiating registry (Originating Registry) by calling the AuthenticateMessage() function and checks the version of the initiating registry by calling CheckVersion() function. If authentication and version checks pass, a ‘1’ result identifier is returned without any response codes, the contents of the request are written to a file by calling the WriteToFile() function and the request is put in a queue. If authentication or version checks fail, a ‘0’ result identifier is returned together with a single response code indicating the error cause.
Input parameters
From	Mandatory
To	Mandatory
CorrelationId	Mandatory
MajorVersion	Mandatory
MinorVersion	Mandatory
Account (*)	Mandatory
AccountIdentifier	Mandatory
Output parameters
Result Identifier	Mandatory
Response Code	Optional
Uses
AuthenticateMessage WriteToFile CheckVersion
Used By
Not applicable (called as a web service).

Table VIII-8: MgmtOfAccountWS.UpdateVerifiedEmissions() function

Purpose
This function receives a verified emissions update request. The Community independent transaction log authenticates the initiating registry (Originating Registry) by calling the AuthenticateMessage() function and checks the version of the initiating registry by calling CheckVersion() function. If authentication and version checks pass, a ‘1’ result identifier is returned without any response codes, the contents of the request are written to a file by calling the WriteToFile() function and the request is put in a queue. If authentication or version checks fail, a ‘0’ result identifier is returned together with a single response code indicating the error cause.
Input parameters
From	Mandatory
To	Mandatory
CorrelationId	Mandatory
MajorVersion	Mandatory
MinorVersion	Mandatory
VerifiedEmissions (*)	Mandatory
Year	Mandatory
Installations (*)	Mandatory
InstallationIdentifier	Mandatory
VerifiedEmission	Mandatory
Output parameters
Result Identifier	Mandatory
Response Code	Optional
Uses
AuthenticateMessage WriteToFile CheckVersion
Used By
Not applicable (called as a web service).

Table VIII-9: MgmtOfAccountWS.ReceiveAccountOperationOutcome() function

Purpose
This function receives an account management operation outcome. The initiating registry (Originating Registry) authenticates the UNFCCC independent transaction log (or Community independent transaction log prior to the link between the Community independent transaction log and UNFCCC independent transaction log being established) by calling the AuthenticateMessage() function and checks the version of the transaction log by calling CheckVersion() function. If authentication and version checks pass, a ‘1’ result identifier is returned without any response codes, the contents of the request are written to a file by calling the WriteToFile() function and the request is put in a queue. If authentication or version checks fail, a ‘0’ result identifier is returned together with a single response code indicating the error cause. The response code list is populated with couples (the account or installation identifier with an adjoining response code) if the outcome is ‘0’ for any other cause of error.
Input parameters
From	Mandatory
To	Mandatory
CorrelationId	Mandatory
MajorVersion	Mandatory
MinorVersion	Mandatory
Outcome	Mandatory
Response List	Optional
Output parameters
Result Identifier	Mandatory
Response Code	Optional
Uses
AuthenticateMessage WriteToFile CheckVersion
Used By
Not applicable (called as a web service).

Table VIII-10: AccountManagement Component

Purpose
The purpose of this component is to provide the validating and update functions for the management of accounts and verified emissions.
Functions exposed through Web Services
Not applicable.
Other functions
ValidateAccountCreation()	Validates an account creation
ValidateAccountUpdate()	Validates an account update
ValidateAccountClosure()	Validates an account closure
ValidateVerifiedEmissionsUpdate()	Validates a verified emissions update
CreateAccount()	Creates accounts
UpdateAccount()	Updates accounts
CloseAccount()	Closes accounts
UpdateVerifiedEmissions()	Updates verified emissions for installations
Roles
Transaction log (all functions), registry (for information only).

Table VIII-11: ManagementOfAccount.ValidateAccountCreation() function

Purpose
This function validates an account creation request. If a validation test fails, the account identifier and response code are added to the response code list.
Input parameters
From	Mandatory
To	Mandatory
CorrelationId	Mandatory
MajorVersion	Mandatory
MinorVersion	Mandatory
Account (*)	Mandatory
AccountType	Mandatory
AccountIdentifier	Mandatory
IdentifierInReg	Mandatory
CommitmentPeriod	Optional
Installation	Optional
InstallationIdentifier	Mandatory
PermitIdentifier	Mandatory
Name	Mandatory
MainActivityType	Mandatory
Country	Mandatory
PostalCode	Mandatory
City	Mandatory
Address1	Mandatory
Address2	Optional
ParentCompany	Optional
SubsidiaryCompany	Optional
EPERIdentification	Optional
Latitude	Optional
Longitude	Optional
ContactPeople (see People)	Mandatory
People (*)	Mandatory
RelationshipCode	Mandatory
PersonIdentifier	Mandatory
FirstName	Optional
LastName	Mandatory
Country	Mandatory
PostalCode	Mandatory
City	Mandatory
Address1	Mandatory
Address2	Optional
PhoneNumber1	Mandatory
PhoneNumber2	Optional
FaxNumber	Mandatory
Email	Optional
Output parameters
Result Identifier	Mandatory
Response List	Optional
Messages
Range 7101 to 7110; range 7122 to 7160.

Table VIII-12: ManagementOfAccount.CreateAccount() function

Purpose
This function creates accounts. For each account: Create the account and its details. Create all persons (People) and their details if they did not already exist and link these to the account. Update all information linked to persons (People) that already existed and that are linked to the account. Create the installation and installation details if an installation is linked to the account. Create all persons (People) linked to the installation (the contact person) if they did not already exist. Update all information linked to persons (People) that already existed and that are linked to the installation.
Input parameters
From	Mandatory
To	Mandatory
CorrelationId	Mandatory
MajorVersion	Mandatory
MinorVersion	Mandatory
Account (*)	Mandatory
AccountType	Mandatory
AccountIdentifier	Mandatory
IdentifierInReg	Mandatory
CommitmentPeriod	Optional
Installation	Optional
InstallationIdentifier	Mandatory
PermitIdentifier	Mandatory
Name	Mandatory
MainActivityType	Mandatory
Country	Mandatory
PostalCode	Mandatory
City	Mandatory
Address1	Mandatory
Address2	Optional
ParentCompany	Optional
SubsidiaryCompany	Optional
EPERIdentification	Optional
Latitude	Optional
Longitude	Optional
ContactPeople (see People)	Mandatory
People (*)	Mandatory
RelationshipCode	Mandatory
PersonIdentifier	Mandatory
FirstName	Optional
LastName	Mandatory
Country	Mandatory
PostalCode	Mandatory
City	Mandatory
Address1	Mandatory
Address2	Optional
PhoneNumber1	Mandatory
PhoneNumber2	Optional
FaxNumber	Mandatory
Email	Optional
Output parameters
Result Identifier	Mandatory
Uses
Not applicable.
Used By
Not applicable (called as a web service).

Table VIII-13: AccountManagement.ValidateAccountUpdate() function

Purpose
This function validates an account update request. If a validation test fails, the account identifier and response code are added to the response code list.
Input parameters
From	Mandatory
To	Mandatory
CorrelationId	Mandatory
MajorVersion	Mandatory
MinorVersion	Mandatory
Account (*)	Mandatory
AccountIdentifier	Mandatory
IdentifierInReg	Optional
Installation	Optional
PermitIdentifier	Optional
Name	Optional
MainActivityType	Optional
Country	Optional
PostalCode	Optional
City	Optional
Address1	Optional
Address2	Optional
ParentCompany	Optional
SubsidiaryCompany	Optional
EPERIdentification	Optional
Latitude	Optional
Longitude	Optional
ContactPeople (see People)	Optional
People (*)	Optional
Action	Mandatory
RelationshipCode	Mandatory
PersonIdentifier	Mandatory
FirstName	Optional
LastName	Optional
Country	Optional
PostalCode	Optional
City	Optional
Address1	Optional
Address2	Optional
PhoneNumber1	Optional
PhoneNumber2	Optional
FaxNumber	Optional
Email	Optional
Output parameters
Result Identifier	Mandatory
Response List	Optional
Messages
Range 7102 to 7107; range 7111 to 7113; 7120; 7122; 7124; range 7126 to 7158.

Table VIII-14: ManagementOfAccount.UpdateAccount() function

Purpose
This function updates the details of an account. If action = ‘Add’: For each link to be added: If the person (People) existed, update its details if required. If the person (People) did not exist, create the person (People) and link it to the account. If action = ‘Update’: For all persons (People) to update and that are linked to the account, update their details. If action = ‘Delete’: Remove the link between the person (People) and the account (for example, an additional authorised representative is removed). If an installation is linked to the account, update the installation details if required. Update the details of the persons (People) linked to the installation if details have been submitted (by using the same ‘Add’, ‘Update’ and ‘Delete’ actions).
Input parameters
From	Mandatory
To	Mandatory
CorrelationId	Mandatory
MajorVersion	Mandatory
MinorVersion	Mandatory
Account (*)	Mandatory
AccountType	Mandatory
AccountIdentifier	Mandatory
IdentifierInReg	Mandatory
Installation	Optional
InstallationIdentifier	Mandatory
PermitIdentifier	Mandatory
Name	Mandatory
MainActivityType	Mandatory
Country	Mandatory
PostalCode	Mandatory
City	Mandatory
Address1	Mandatory
Address2	Optional
ParentCompany	Optional
SubsidiaryCompany	Optional
EPERIdentification	Optional
Latitude	Optional
Longitude	Optional
ContactPeople (see People)	Mandatory
People (*)	Mandatory
RelationshipCode	Mandatory
PersonIdentifier	Mandatory
FirstName	Optional
LastName	Mandatory
Country	Mandatory
PostalCode	Mandatory
City	Mandatory
Address1	Mandatory
Address2	Optional
PhoneNumber1	Optional
PhoneNumber2	Optional
FaxNumber	Optional
Email	Optional
Output parameters
Result Identifier	Mandatory
Uses
Not applicable.
Used By
Not applicable (called as a web service).

Table VIII-15: ManagementOfAccount.ValidateAccountClosure() function

Purpose
This function validates an account closure operation. If a validation test fails, the account identifier and response code are added to the response code list.
Input parameters
From	Mandatory
To	Mandatory
CorrelationId	Mandatory
MajorVersion	Mandatory
MinorVersion	Mandatory
Account (*)	Mandatory
Purpose
AccountIdentifier	Mandatory
Output parameters
Result Identifier	Mandatory
Response List	Optional
Messages
7111; range 7114 to 7115; 7117; range 7153 to 7156; 7158.

Table VIII-16: ManagementOfAccount.CloseAccount() function

Purpose
This function closes an account or accounts by setting the end validity date of the account(s) to be closed to the current date.
Input parameters
Registry	Mandatory
CorrelationId	Mandatory
MajorVersion	Mandatory
MinorVersion	Mandatory
Account (*)	Mandatory
AccountIdentifier	Mandatory
Output parameters
Result Identifier	Mandatory

Table VIII-17: ManagementOfAccount.ValidateVerifiedEmissionsUpdate() function

Purpose
This function validates a verified emissions update. If a validation test fails, the installation identifier and response code are added to the response code list.
Input parameters
From	Mandatory
To	Mandatory
CorrelationId	Mandatory
MajorVersion	Mandatory
MinorVersion	Mandatory
VerifiedEmissions (*)	Mandatory
Year	Mandatory
Installations (*)	Mandatory
InstallationIdentifier	Mandatory
VerifiedEmission	Mandatory
Output parameters
Result Identifier	Mandatory
Response List	Optional
Messages
Range 7118 to 7119; range 7152 to 7156; 7159.

Table VIII-18: ManagementOfAccount.UpdateVerifiedEmissions function

Purpose
Updates the verified emissions for the year and installation specified.
Input parameters
From	Mandatory
To	Mandatory
CorrelationId	Mandatory
MajorVersion	Mandatory
VerifiedEmissions (*)	Mandatory
Year	Mandatory
Installations (*)	Mandatory
InstallationIdentifier	Mandatory
VerifiedEmission	Mandatory
Output parameters
Result Identifier	Mandatory

Preliminary checks for each process

5. The Community independent transaction log shall check the status of a registry for each process concerning an account or verified emissions. If the communication link between the registry and the Community independent transaction log has not been established or is temporarily suspended pursuant to Article 6(3) in respect of the requested process concerning an account or verified emissions, it shall be rejected and the response code 7005 shall be returned.

6. Prior to the communication link between the Community independent transaction log and the UNFCCC independent transaction log being established, the Community independent transaction log shall perform registry version and registry authentication checks, and message viability checks, on each process concerning an account or verified emissions and return the appropriate response codes if a discrepancy is detected, set out in the functional and technical specifications for data exchange standards for registry systems under the Kyoto Protocol, elaborated pursuant to Decision 24/CP.8 of the Conference of the Parties to the UNFCCC. Thereafter, each registry shall receive such response codes from the UNFCCC independent transaction log.

7. The Community independent transaction log shall perform data integrity checks on each process concerning an account or verified emissions and return response codes in the range 7122 to 7159 if a discrepancy is detected.

Secondary checks for each process

8. The Community independent transaction log shall perform secondary checks on each process concerning an account or verified emissions which has passed all of the preliminary checks. The secondary checks, and the adjoining response codes which are returned when a discrepancy is detected, are set out in table VIII-19.

Table VIII-19: Secondary Checks

Process description	Community independent transaction log response codes
Account creation	Range 7101 to 7110 7160
Account update	Range 7102 to 7105 Range 7107 to 7108 7111 7113 7120 7160
Account closure	7111 Range 7114 to 7115 7117
Verified emissions update	Range 7118 to 7119