4.

Meddelandesekvensens komponenter och funktioner visas i tabellerna VIII–3–8. Öppna funktioner skall användas på föreskrivet sätt. Privata funktioner får bara användas för att ge information. Alla funktioners inkoder har strukturerats för att passa krav i fråga om format och innehåll som är formulerade på ett språk avsett för att beskriva webbtjänsters funktioner (WSDL, Web Service Desciption Language) som fastställs i de funktionella och tekniska specifikationerna för datautbytesnormer för registersystem inom ramen för Kyotoprotokollet, utarbetade i enlighet med klimatkonventionens partskonferens beslut 24/CP.8. En asterisk ”(*)” visar att en beståndsdel kan förekomma flera gånger som inkod. Tabell VIII–3: Komponenter och funktioner i processer rörande konton och kontrollerade utsläpp



Komponent Funktion Användning MgmtOfAccountWS CreateAccount() Offentlig UpdateAccount() Offentlig CloseAccount() Offentlig UpdateVerifiedEmissions() Offentlig ReceiveAccountOperationOutcome() Offentlig AccountManagement ValidateAccountCreation() Privat CreateAccount() Privat ValidateAccountUpdate() Privat UpdateAccount() Privat ValidateAccountClosure() Privat CloseAccount() Privat ValidateVerifiedEmissionsUpdate() Privat UpdateVerifiedEmissions() Privat DataValidation AuthenticateMessage() Privat CheckVersion() Privat DataFormatsChecks() Privat Tabell VIII–4: Komponenten MgmtOfAccountWS



Syfte Komponenten hanterar begäran från webbtjänster om förfaranden som gäller konton och kontrollerade utsläpp. Funktioner tillgängliga via webbtjänster CreateAccount() Hanterar begäran om öppnande av konto UpdateAccount() Hanterar begäran om uppdatering av konto CloseAccount() Hanterar begäran om avslutande av konto UpdateVerifiedEmissions() Hanterar begäran om uppdatering av kontrollerade utsläpp ReceiveAccountOperationOutcome() Tar emot ett kontoförfarande (öppnande, uppdatering…) resultat (accepteras eller avvisas) Övriga funktioner Ej tillämplig Berörd aktör Gemenskapens oberoende transaktionsförteckning (alla funktioner) och registret (bara för funktionen ReceiveAccountOperationOutcome). Tabell VIII–5: Funktionen MgmtOfAccountWS.CreateAccount()



Syfte Funktionen tar emot begäran om öppnande av ett konto. Gemenskapens oberoende transaktionsförteckning autentiserar det inledande registret (Originating registry) genom att aktivera funktionen AuthenticateMessage() och kontrollerar det inledande registrets version genom att aktivera funktionen CheckVersion(). Om autentiseringen och kontrollen av versionen går igenom returneras resultatidentifieringen ”1” utan svarskoder. Innehållet i begäran skrivs till en fil genom att funktionen WriteToFile() aktiveras och begäran ställs i kö. Om autentiseringen eller kontrollen av versionen inte går igenom returneras resultatidentifieringen ”0” med en ensam svarskod som visar felorsaken. För andra personer (People) än fysiska skall namnet anges i parametern LastName. ”PersonIdentifier” är kontoinnehavarkoden, uppbyggd av de beståndsdelar som anges i bilaga VI. ”IdentifierInRegistry” är den alfanumeriska identifiering som kontoinnehavaren har bestämt i enlighet med bilagorna III och IV. Inparametrar From Obligatorisk To Obligatorisk CorrelationId Obligatorisk MajorVersion Obligatorisk MinorVersion Obligatorisk Account (*) Obligatorisk AccountType Obligatorisk AccountIdentifier Obligatorisk IdentifierInReg Obligatorisk CommitmentPeriod Frivillig Installation Frivillig InstallationIdentifier Obligatorisk PermitIdentifier Obligatorisk Name Obligatorisk MainActivityType Obligatorisk Country Obligatorisk PostalCode Obligatorisk City Obligatorisk Address1 Obligatorisk Address2 Frivillig ParentCompany Frivillig SubsidiaryCompany Frivillig EPERIdentification Frivillig Latitude Frivillig Longitude Frivillig ContactPeople (see People) Obligatorisk People (*) Obligatorisk RelationshipCode Obligatorisk PersonIdentifier Obligatorisk FirstName Frivillig LastName Obligatorisk Country Obligatorisk PostalCode Obligatorisk City Obligatorisk Address1 Obligatorisk Address2 Frivillig PhoneNumber1 Obligatorisk PhoneNumber2 Obligatorisk FaxNumber Obligatorisk Email Obligatorisk Utparametrar Result Identifier Obligatorisk Response Code Frivillig Användning — AuthenticateMessage — WriteToFile — CheckVersion Användare Ej tillämplig (aktiveras som webbtjänst). Tabell VIII–6: Funktionen MgmtOfAccountWS.UpdateAccount()



Syfte Funktionen tar emot begäran om uppdatering av ett konto. Gemenskapens oberoende transaktionsförteckning autentiserar det inledande registret (Originating registry) genom att aktivera funktionen AuthenticateMessage() och kontrollerar det inledande registrets version genom att aktivera funktionen CheckVersion(). Om autentiseringen och kontrollen av versionen går igenom returneras resultatidentifieringen ”1” utan svarskoder. Innehållet i begäran skrivs till en fil genom att funktionen WriteToFile() aktiveras och begäran ställs i kö. Om autentiseringen eller kontrollen av versionen inte går igenom returneras resultatindetifieringen ”0” med en ensam svarskod som visar felorsaken. För andra personer (People) än fysiska skall namnet anges i parametern LastName. ”PersonIdentifier” är kontoinnehavarkoden, uppbyggd av de beståndsdelar som anges i bilaga VI. ”IdentifierInRegistry” är den alfanumeriska identifiering som kontoinnehavaren har bestämt i enlighet med bilagorna III och IV. Inparametrar From Obligatorisk To Obligatorisk CorrelationId Obligatorisk MajorVersion Obligatorisk MinorVersion Obligatorisk Account (*) Obligatorisk AccountIdentifier Obligatorisk IdentifierInReg Frivillig Installation Frivillig PermitIdentifier Frivillig Name Frivillig MainActivityType Frivillig Country Frivillig PostalCode Frivillig City Frivillig Address1 Frivillig Address2 Frivillig ParentCompany Frivillig SubsidiaryCompany Frivillig EPERIdentification Frivillig Latitude Frivillig Longitude Frivillig ContactPeople (see People) Frivillig People (*) Frivillig Action Obligatorisk RelationshipCode Obligatorisk PersonIdentifier Obligatorisk FirstName Frivillig LastName Frivillig Country Frivillig PostalCode Frivillig City Frivillig Address1 Frivillig Address2 Frivillig PhoneNumber1 Frivillig PhoneNumber2 Frivillig FaxNumber Frivillig Email Frivillig Utparametrar Result Identifier Obligatorisk Response Code Frivillig Användning — AuthenticateMessage — WriteToFile — CheckVersion Användare Ej tillämplig (aktiveras som webbtjänst). Tabell VIII–7: Funktionen MgmtOfAccountWS.CloseAccount()



Syfte Funktionen tar emot begäran om avslutande av ett konto. Gemenskapens oberoende transaktionsförteckning autentiserar det inledande registret (Originating registry) genom att aktivera funktionen AuthenticateMessage() och kontrollerar det inledande registrets version genom att aktivera funktionen CheckVersion(). Om autentiseringen och kontrollen av versionen går igenom returneras resultatidentifieringen ”1” utan svarskoder. Innehållet i begäran skrivs till en fil genom att funktionen WriteToFile() aktiveras och begäran ställs i kö. Om autentiseringen eller kontrollen av versionen inte går igenom returneras resultatindetifieringen ”0” med en ensam svarskod som visar felorsaken. Inparametrar From Obligatorisk To Obligatorisk CorrelationId Obligatorisk MajorVersion Obligatorisk MinorVersion Obligatorisk Account (*) Obligatorisk AccountIdentifier Obligatorisk Utparametrar Result Identifier Obligatorisk Response Code Frivillig Användning — AuthenticateMessage — WriteToFile — CheckVersion Användare Ej tillämplig (aktiveras som webbtjänst). Tabell VIII–8: Funktionen MgmtOfAccountWS.UpdateVerifiedEmissions()



Syfte Funktionen tar emot begäran om uppdatering av kontrollerade utsläpp. Gemenskapens oberoende transaktionsförteckning autentiserar det inledande registret (Originating registry) genom att aktivera funktionen AuthenticateMessage() och kontrollerar det inledande registrets version genom att aktivera funktionen CheckVersion(). Om autentiseringen och kontrollen av versionen går igenom returneras resultatidentifieringen ”1” utan svarskoder. Innehållet i begäran skrivs till en fil genom att funktionen WriteToFile() aktiveras och begäran ställs i kö. Om autentiseringen eller kontrollen av versionen inte går igenom returneras resultatindetifieringen ”0” med en ensam svarskod som visar felorsaken. Inparametrar From Obligatorisk To Obligatorisk CorrelationId Obligatorisk MajorVersion Obligatorisk MinorVersion Obligatorisk VerifiedEmissions (*) Obligatorisk Year Obligatorisk Installations (*) Obligatorisk InstallationIdentifier Obligatorisk VerifiedEmission Obligatorisk Utparametrar Result Identifier Obligatorisk Response Code Frivillig Användning — AuthenticateMessage — WriteToFile — CheckVersion Användare Ej tillämplig (aktiveras som webbtjänst). Tabell VIII–9: Funktionen MgmtOfAccountWS.ReceiveAccountOperationOutcome()



Syfte Funktionen tar emot resultatet av ett kontoförfarande. ►M1 Det inledande registret (Originating registry) autentiserar klimatkonventionens oberoende transaktionsförteckning (eller gemenskapens oberoende transaktionsförteckning om alla processer som anges i bilaga VIII sker genom datautbyte via gemenskapens oberoende transaktionsförteckning) genom att aktivera funktionen AuthenticateMessage(), och kontrollerar transaktionsförteckningens version genom att aktivera funktionen CheckVersion(). ◄ Om autentiseringen och kontrollen av versionen går igenom returneras resultatidentifieringen ”1” utan svarskoder. Innehållet i begäran skrivs till en fil genom att funktionen WriteToFile() aktiveras och begäran ställs i kö. Om autentiseringen eller kontrollen av versionen inte går igenom returneras resultatindetifieringen ”0” med en ensam svarskod som visar felorsaken. Om resultatet är ”0” av någon annan felorsak består svarskodslistan av par (kontots eller anläggningens identifiering och tillämplig svarskod). Inparametrar From Obligatorisk To Obligatorisk CorrelationId Obligatorisk MajorVersion Obligatorisk MinorVersion Obligatorisk Outcome Obligatorisk Response List Frivillig Utparametrar Result Identifier Obligatorisk Response Code Frivillig Användning — AuthenticateMessage — WriteToFile — CheckVersion Användare Ej tillämplig (aktiveras som webbtjänst). Tabell VIII–10: Komponenten AccountManagement



Syfte Komponenten tillhandahåller funktionerna validering och uppdatering av förfaranden för konton och kontrollerade utsläpp. Funktioner tillgängliga via webbtjänster Ej tillämplig. Övriga funktioner ValidateAccountCreation() Validerar öppnande av ett konto ValidateAccountUpdate() Validerar uppdatering av ett konto ValidateAccountClosure() Validerar avslutande av ett konto ValidateVerifiedEmissionsUpdate() Validerar uppdatering av kontrollerade utsläpp CreateAccount() Öppnar konto UpdateAccount() Uppdaterar konto CloseAccount() Avslutar konto UpdateVerifiedEmissions() Uppdaterar en anläggnings kontrollerade utsläpp Berörd aktör Transaktionsförteckning (alla funktioner), register (bara i informationssyfte). Tabell VIII–11: Funktionen ManagementOfAccount.ValidateAccountCreation()



Syfte Funktionen validerar begäran om öppnande av ett konto. Om valideringsprovet misslyckas läggs kontoidentifieringen och svarskoden till svarskodslistan. Inparametrar From Obligatorisk To Obligatorisk CorrelationId Obligatorisk MajorVersion Obligatorisk MinorVersion Obligatorisk Account (*) Obligatorisk AccountType Obligatorisk AccountIdentifier Obligatorisk IdentifierInReg Obligatorisk CommitmentPeriod Frivillig Installation Frivillig InstallationIdentifier Obligatorisk PermitIdentifier Obligatorisk Name Obligatorisk MainActivityType Obligatorisk Country Obligatorisk PostalCode Obligatorisk City Obligatorisk Address1 Obligatorisk Address2 Frivillig ParentCompany Frivillig SubsidiaryCompany Frivillig EPERIdentification Frivillig Latitude Frivillig Longitude Frivillig ContactPeople (see People) Obligatorisk People (*) Obligatorisk RelationshipCode Obligatorisk PersonIdentifier Obligatorisk FirstName Frivillig LastName Obligatorisk Country Obligatorisk PostalCode Obligatorisk City Obligatorisk Address1 Obligatorisk Address2 Frivillig PhoneNumber1 Obligatorisk PhoneNumber2 Frivillig FaxNumber Obligatorisk Email Frivillig Utparametrar Result Identifier Obligatorisk Response List Frivillig Meddelanden Kodintervall 7101–7110 och 7122–7160. Tabell VIII–12: Funktionen ManagementOfAccount.CreateAccount()



Syfte Funktionen öppnar konton. För varje konto görs följande: Kontot med alla kontouppgifter skapas. Alla personer (People) och personuppgifter skapas (om de inte redan är skapade) och kopplas till kontot. Informationen om redan skapade, till kontot kopplade personer (People) uppdateras. Om en anläggning är kopplad till kontot skapas anläggningen och med alla uppgifter om anläggningen. Alla personer (People) kopplade till anläggningen (kontaktpersonen) skapas (om de inte redan är skapade). All information knuten till redan skapade, till anläggningen kopplade personer (People) uppdateras. Inparametrar From Obligatorisk To Obligatorisk CorrelationId Obligatorisk MajorVersion Obligatorisk MinorVersion Obligatorisk Account (*) Obligatorisk AccountType Obligatorisk AccountIdentifier Obligatorisk IdentifierInReg Obligatorisk CommitmentPeriod Frivillig Installation Frivillig InstallationIdentifier Obligatorisk PermitIdentifier Obligatorisk Name Obligatorisk MainActivityType Obligatorisk Country Obligatorisk PostalCode Obligatorisk City Obligatorisk Address1 Obligatorisk Address2 Frivillig ParentCompany Frivillig SubsidiaryCompany Frivillig EPERIdentification Frivillig Latitude Frivillig Longitude Frivillig ContactPeople (see People) Obligatorisk People (*) Obligatorisk RelationshipCode Obligatorisk PersonIdentifier Obligatorisk FirstName Frivillig LastName Obligatorisk Country Obligatorisk PostalCode Obligatorisk City Obligatorisk Address1 Obligatorisk Address2 Frivillig PhoneNumber1 Obligatorisk PhoneNumber2 Frivillig FaxNumber Obligatorisk Email Frivillig Utparametrar Result Identifier Obligatorisk Användning Ej tillämplig. Användare Ej tillämplig (aktiveras som webbtjänst). Tabell VIII–13: Funktionen AccountManagement.ValidateAccountUpdate()



Syfte Funktionen validerar en begäran om uppdatering av ett konto. Om valideringsprovet misslyckas läggs kontoidentifieringen och svarskoden till svarskodslistan. Inparametrar From Obligatorisk To Obligatorisk CorrelationId Obligatorisk MajorVersion Obligatorisk MinorVersion Obligatorisk Account (*) Obligatorisk AccountIdentifier Obligatorisk IdentifierInReg Frivillig Installation Frivillig PermitIdentifier Frivillig Name Frivillig MainActivityType Frivillig Country Frivillig PostalCode Frivillig City Frivillig Address1 Frivillig Address2 Frivillig ParentCompany Frivillig SubsidiaryCompany Frivillig EPERIdentification Frivillig Latitude Frivillig Longitude Frivillig ContactPeople (see People) Frivillig People (*) Frivillig Action Obligatorisk RelationshipCode Obligatorisk PersonIdentifier Obligatorisk FirstName Frivillig LastName Frivillig Country Frivillig PostalCode Frivillig City Frivillig Address1 Frivillig Address2 Frivillig PhoneNumber1 Frivillig PhoneNumber2 Frivillig FaxNumber Frivillig Email Frivillig Utparametrar Result Identifier Obligatorisk Response List Frivillig Messages Kodintervall 7102–7107; 7111–7113; 7120; 7122; 7124; och 7126–7158. Tabell VIII–14: Funktionen ManagementOfAccount.UpdateAccount()



Syfte Funktionen uppdaterar uppgifterna om kontot. Om åtgärd = ”Add”: För varje koppling som skall läggas till: Om personen (People) redan är skapad, uppdatera personuppgifter. Om personen (People) inte är skapad, skapa personen (People) och koppla till kontot. Om åtgärd = ”Update”: Uppdatera uppgifter om alla personer (People) som är kopplade till kontot. Om åtgärd = ”Delete”: Ta bort kopplingen mellan personen (People) och kontot (om t.ex. ett extra behörigt ombud skall tas bort). Uppgifter om anläggningar kopplade till kontot uppdateras. Uppdatera uppgifterna om personer (People) kopplade till anläggningen om sådana uppgifter har lämnats (genom ”Add”, ”Update” och ”Delete” enligt ovan). Inparametrar From Obligatorisk To Obligatorisk CorrelationId Obligatorisk MajorVersion Obligatorisk MinorVersion Obligatorisk Account (*) Obligatorisk AccountType Obligatorisk AccountIdentifier Obligatorisk IdentifierInReg Obligatorisk Installation Frivillig InstallationIdentifier Obligatorisk PermitIdentifier Obligatorisk Name Obligatorisk MainActivityType Obligatorisk Country Obligatorisk PostalCode Obligatorisk City Obligatorisk Address1 Obligatorisk Address2 Frivillig ParentCompany Frivillig SubsidiaryCompany Frivillig EPERIdentification Frivillig Latitude Frivillig Longitude Frivillig ContactPeople (see People) Obligatorisk People (*) Obligatorisk RelationshipCode Obligatorisk PersonIdentifier Obligatorisk FirstName Frivillig LastName Obligatorisk Country Obligatorisk PostalCode Obligatorisk City Obligatorisk Address1 Obligatorisk Address2 Frivillig PhoneNumber1 Frivillig PhoneNumber2 Frivillig FaxNumber Frivillig Email Frivillig Utparametrar Result Identifier Obligatorisk Användning Ej tillämplig. Användare Ej tillämplig (aktiveras som webbtjänst). Tabell VIII–15: Funktionen ManagementOfAccount.ValidateAccountClosure()



Syfte Funktionen validerar ett kontoavslutningsförfarande. Om valideringsprovet misslyckas läggs kontoidentifieringen och svarskoden till svarskodslistan. Inparametrar From Obligatorisk To Obligatorisk CorrelationId Obligatorisk MajorVersion Obligatorisk MinorVersion Obligatorisk Account (*) Obligatorisk Syfte AccountIdentifier Obligatorisk Utparametrar Result Identifier Obligatorisk Response List Frivillig Meddelanden 7111; Kodintervall 7114–7115; 7117; 7153–7156; och 7158; ►M1 7161. ◄ Tabell VIII–16: Funktionen ManagementOfAccount.CloseAccount()



Syfte Funktionen avslutar ett konto genom att fastställa kontots sista giltighetsdag till dagens datum. Inparametrar Registry Obligatorisk CorrelationId Obligatorisk MajorVersion Obligatorisk MinorVersion Obligatorisk Account (*) Obligatorisk AccountIdentifier Obligatorisk Utparametrar Result Identifier Obligatorisk Tabell VIII–17: Funktionen ManagementOfAccount.ValidateVerifiedEmissionsUpdate()



Syfte Funktionen validerar en uppdatering av kontrollerade utsläpp. Om valideringsprovet misslyckas läggs anläggningsidentifieringen och svarskoden till svarskodslistan. Inparametrar From Obligatorisk To Obligatorisk CorrelationId Obligatorisk MajorVersion Obligatorisk MinorVersion Obligatorisk VerifiedEmissions (*) Obligatorisk Year Obligatorisk Installations (*) Obligatorisk InstallationIdentifier Obligatorisk VerifiedEmission Obligatorisk Utparametrar Result Identifier Obligatorisk Response List Frivillig Meddelanden Kodintervall 7118–7119; 7152–7156; och 7159; ►M1 7525. ◄ Tabell VIII–18: Funktionen ManagementOfAccount.UpdateVerifiedEmissions



Syfte Uppdaterar kontrollerade årsutsläpp för en anläggning. Inparametrar From Obligatorisk To Obligatorisk CorrelationId Obligatorisk MajorVersion Obligatorisk VerifiedEmissions (*) Obligatorisk Year Obligatorisk Installations (*) Obligatorisk InstallationIdentifier Obligatorisk VerifiedEmission Obligatorisk Utparametrar Result Identifier Obligatorisk