Mina meddelanden Förmedling av elektronisk post för myndigheter i Sverige

Transkript

1 Mina meddelanden Förmedling av elektronisk post för myndigheter i Sverige Tekniska tjänstekontrakt - API Version 3.40 Revision: 43 Mina meddelanden är en myndighetsgemensam e-posttjänst förvaltad av Skatteverket och utvecklad tillsammans med Bolagsverket och Tillväxtverket.

2 Emma (EC) Version: 3.40 Sida av 4 Innehållsförteckning. INLEDNING...4. MEDDELANDEFÖRMEDLING I MINA MEDDELANDEN TJÄNSTER RECIPIENT isregistered isreachable register deregister...0 getpendingaccountrequest deletependingaccountrequest getallregisteredaccounts getallreachableaccounts... getaccountpreferences storeaccountpreferences AUTHORITY getuseraccessrights testnewsigner verifyauthorizedsignatures getsenders CONSENT registerconsent accept refuse cancel getall SERVICE deliversecure deliverforward notify getunusedmailboxes flagremovedaccounts MESSAGE distributesecure distributeforward...5 checkdistributionstatus NOTIFICATION distribute checkdistributionstatus PUBLIK INFORMATIONSMODELL (SCHEMATYPER) RECIPIENTID () ORGANIZATIONNUMBER () PERSONALNUMBER () USERIDENTITY () ADRESS () SENDER PERSON...30 TEXT NOTIFICATIONMESSAGE...30

3 Emma (EC) Version: 3.40 Sida 3 av SECUREDELIVERY...3 NOTIFICATIONDELIVERY DELIVERYHEADER SIGNEDDELIVERY SIGNATUREDATA...3 SEALEDDELIVERY SEAL SECUREMESSAGE MESSAGEHEADER...33 SUPPORTINFO METADATA MESSAGEBODY AACHMENT...34 FORWARDDELIVERY FORWARDMESSAGE FELHANTERING EXCEPTIONINFORMATION ERRORCODES NAVIGERINGSADRESSER INBOX ACCOUNTREQUEST DOKUMENTINFORMATION REFERENSER REVISIONSHISTORIK DOKUMENTANSVARIG...4

4 Emma (EC) Version: 3.40 Sida 4 av 4. Inledning Syftet med detta dokument är att dokumentera kraven på de tekniska tjänstekontrakt som utarbetats i samarbete mellan de myndigheter som har anslutit sig eller ska ansluta sig till Mina meddelanden. Dokumentet riktar sig till i första hand personal på anslutande myndigheter och privata meddelandeförmedlingsoperatörer, MFSoperatörer, som kravställer systemet på en teknisk nivå.. Meddelandeförmedling i Mina meddelanden Meddelandeförmedlingssystemet, även kallat MFS, består av flera olika delsystem (figur.). Arkitekturen och systemuppdelningen är gjord för att stödja samexistens mellan flera MFS-operatörer likt marknaden för distribution av vanlig papperspost. Systemet är uppdelat i tre funktionella skikt: Självservice Meddelandedistribution Myndighetsutövning Delsystemen exponerar sin funktionalitet genom grafiska användargränssnitt (e-tjänst) och programmeringsgränssnitt (API). Privata MFS-operatörer kan leverera system för Självservice och Meddelandedistribution och behöver implementera aktuella tjänster enligt kontrakten i detta dokument för att samexistera med minameddelanden.se och andra MFS-operatörer. Myndighetsutövningen sköts alltid av förmedlingsadressregistret (FAR) och består av att registerföra anslutna personer och organisationer samt att utföra behörighetskontroller. Figur. Meddelandeförmedlingssystemets olika beståndsdelar

5 Emma (EC) Version: 3.40 Sida 5 av 4 3. Tjänster Tjänsterna är publika och publiceras av MFS-systemet. För att erbjuda och ta del av tjänster i MFS-systemet måste en aktör ansluta sig till Mina meddelanden genom att teckna anslutningsavtal med FAR-ansvarig. Beroende på vilken roll en aktör har kommer den åt olika tjänster. Tjänsterna definieras enligt WSDL [3] och kopplade XSD [4]. Alla tjänster kan anropas som webservices via SOAP och vissa kan även anropas via SHS-protokollet. För anslutning krävs ett avtal med förmedlingsadressregistret (FAR) och en giltig server-legitimation från Steria AB. Du hittar WSDL- och XSD-dokument här: 3. Recipient En tjänst för hantering av konton hos FAR. Tjänsten omfattar operationer för att ansöka om konto, avsluta konto samt utföra kontroller om mottagarkonton finns. 3.. isregistered Operationen kontrollerar om mottagare har ett registrerat konto hos FAR. Om mottagaren har ett konto slås även adressen till mottagarens brevlåda upp och returneras i svaret. Riktning Parameter Datatyp Beskrivning IN mottagare* RecipientId[] Lista med mottagare ID, Personnummer, eller Organisationsnummer. Max 000 mottagare/fråga. UT resultat AccountStatus[] Anger om mottagaren har ett konto hos FAR samt adressen till mottagarens e-tjänst-operatör. Ansluten organisation BRONS Ansluten organisation MFS-operatör AccountStatus Kontokontroll och adresser för en viss mottagare. RecipientId* RecipientId Mottagaridentitet. Type* AccountTypes Anger om konto finns hos FAR och i så fall av vilken typ. Pending* boolean true om en pågående kontoansökan finns. ServiceSupplier ServiceSupplier Info om eventuell brevlådeoperatör. Är null om konto saknas.

6 Emma (EC) Version: 3.40 Sida 6 av ServiceSupplier Information kring brevlådeoperatören. Name* string Brevlådeoperatörens namn. Den statliga brevlådan heter: minameddelanden.se Logo anyuri URL som pekar på en bild av brevlådeoperatörens logo. ServiceAdress* anyuri Service adress. Adressen är en WS-endpoint till tjänsten hos den operatör som mottagaren valt för sin brevlåda och profil. Exempel: UIAdress anyuri Basadress för direktnavigering i e-tjänsten hos den operatör som mottagaren valt för sin brevlåda och profil. Värdet är null om mottagarens e-tjänst-operatör inte stödjer direktnavigering. Exempel: AccountTypes Definerade kontotyper. Namn Beskrivning Etapp Secure Användareidentitet verifierad med e-legitimation. Anonymous Anonymt så kallat lågnivåkonto, användarnamn och lösenord. Not Konto saknas hos FAR.

7 Emma (EC) Version: 3.40 Sida 7 av isreachable Operationen kontrollerar om mottagare har ett registrerat konto hos FAR och om avsändaren har godkänts för utskick av elektroniska meddelanden av mottagaren. Om mottagaren har ett konto slås även adressen till mottagarens brevlådeoperatör upp och returneras i svaret. Riktning Parameter Datatyp Beskrivning IN avsändare* OrganizationNumber Avsändarens organisationsnummer. mottagare* RecipientId[] Lista med mottagare ID, Personnummer, eller Organisationsnummer. Max 000 mottagare/fråga. UT resultat ReachabilityStatus [] Anger om mottagaren har ett konto hos FAR om avsändaren är godkänd samt adressen till mottagarens e-tjänst-operatör. Ansluten organisation BRONS Ansluten organisation MFS-operatör ReachabilityStatus AccountStatus* AccountStatus Anger om mottagaren har ett konto hos FAR samt adressen till mottagarens e-tjänstoperatör. SenderAccepted* boolean Anger om avsändaren godkänts för elektroniska utskick av mottagaren. 3 3

8 Emma (EC) Version: 3.40 Sida 8 av register Anropas när en ny användare ansöker om ett konto och anslutning till FAR. I samband med denna registrering godkänner användaren avtalet kring elektronisk meddelandeförmedling. Vid ansökan kontrolleras om signaturerna som gjorts motsvarar den firmateckning som krävs om ansökan avser ett företag. Om firmateckningen inte är fullständig sparas ansökan som pågående och kan hämtas och kompletteras med nya signaturer vid ett senare tillfälle. Om ansökan avser ett privat konto kontrolleras att signaturen gjorts av samma person som ansökan avser. IN ansökan* AccountRequest Ansökan om konto. En ev. pågående ansökan kan hämtas via getpendingaccountrequest. kontotyp* AccountTypes Kontotyp. Adress* Adress[0...0] E-postadress(er) (används för att skicka bekräftelse och slängs sedan bort). signatur SignatureData[] Signering av ansökan skapad med användarens privata nyckel på e- legitimationen. Om ansökan avser ett konto med flera firmatecknare måste samtliga firmatecknares signaturer anges innan ansökan godkänns. (För lågnivå-konto anges ingen signatur.) UT resultat* SignatureAuthorizationResult Resultat av signering. Slutanvändare MFS-operatör signatur AccountRequest Dokument som motsvarar en ansökan eller en avanmälan om konto hos FAR. Id* RecipientId Mottagaridentitet. Type* AccountRequestType Typ av dokument. AgreementText* string Villkorstext. Timestamp* date Starttidpunkt för ansökan/anmälan. ServiceSupplier* string Namn på leverantören av brevlåda som mottagaren har valt. Brevlådan måste vara registrerad hos FAR. Den statliga brevlådan heter: minameddelanden.se.

9 Emma (EC) Version: 3.40 Sida 9 av AccountRequestType Typ av begäran. Ansökan eller avanmälan. Namn Beskrivning Etapp Create Ansökan om nytt konto. Delete Anmälan om avslut av konto.

10 Emma (EC) Version: 3.40 Sida 0 av deregister Anropas när en mottagare vill avsluta sitt konto hos FAR. Vid avanmälan kontrolleras om signaturerna som gjorts motsvarar den firmateckning som krävs om anmälan avser ett företag. Om firmateckningen inte är fullständig sparas avanmälan som pågående och kan hämtas och kompletteras med nya signaturer vid ett senare tillfälle. Om anmälan avser ett privat konto kontrolleras att signaturen gjorts av samma person som ansökan avser. IN avanmälan* AccountRequest Avanmälan. En ev. pågående avanmälan kan hämtas via getpendingaccountrequest. Adress* Adress[0...0] E-postadress(er) (används för att skicka bekräftelse och slängs sedan bort). signatur SignatureData[] Signering av avanmälan skapad med användarens privata nyckel på e-legitimationen. Om avanmälan avser ett konto med flera firmatecknare måste samtliga firmatecknares signaturer anges innan avanmälan godkänns. (För lågnivå-konto anges ingen signatur.) UT resultat* SignatureAuthorizationResult Resultat av signering. Slutanvändare MFS-operatör signatur 3..5 getpendingaccountrequest Fråga om pågående kontoansökan eller avanmälan. IN id* RecipientId[] Mottagaridentitet. identitet* UserIdentity Inloggad användares identitetsnyckel. UT pågående ansökan PendingAccountRequest[] Påbörjad kontoansökan om påbörjad ansökan finns annars tomt i listan. Slutanvändare Dataägare PendingAccountRequest Dokument som motsvarar en påbörjad ansökan eller avanmälan om konto hos FAR. AccountRequest* AccountRequest Kontoansökan.

11 Emma (EC) Version: 3.40 Sida av 4 SignatureStatus* SignatureAuthorizationResult Aktuell signaturkontroll status deletependingaccountrequest Radera en pågående kontoansökan eller avanmälan. IN id* RecipientId Mottagaridentitet. identitet* UserIdentity Inloggad användares identitetsnyckel. Ansluten organisation Dataägare getallregisteredaccounts Hämta alla personnummer/organisationsnummer som har registrerat ett konto hos förmedlingsadressregistret. Mottagaren kan ha valt bort vissa avsändare för elektroniska utskick och kan därför vara onåbar trots att konto finns. Använd operationen getallreachableaccounts för att ta hänsyn till avsändaren. IN sida* int Sidnummer för den delmängd som skall hämtas. Första sidan har nummer 0. UT resultat* AccountContainer Lista med personnummer/organisationsnummer samt information om fler sidor finns att hämta. Ansluten organisation Ansluten organisation AccountContainer Registrerade konton i förmedlingsregistret. Page* int Sida i svaret. Accounts* RecipientId[] Personnummer eller organisationsnummer. MorePages boolean Finns flera sidor att hämta.

12 Emma (EC) Version: 3.40 Sida av getallreachableaccounts Hämta alla personnummer/organisationsnummer som har registrerat ett konto hos förmedlingsadressregistret och som är nåbara för aktuell avsändare. IN avsändare* OrganizationNumber Avsändarens organisationsnummer. sida* int Sidnummer för den delmängd som skall hämtas. Första sidan har nummer 0. UT resultat* AccountContainer Lista med personnummer/organisationsnummer samt information om fler sidor finns att hämta. Ansluten organisation Ansluten organisation getaccountpreferences Hämta inställningar för en mottagares konto. IN id* RecipientId Mottagaridentitet. identitet* UserIdentity Inloggad användares identitetsnyckel. UT inställningar* AccountPreferences Kontoinställningar. Ansluten organisation Dataägare storeaccountpreferences Spara nya inställningar för en mottagares konto. IN id* RecipientId Mottagaridentitet. identitet* UserIdentity Inloggad användares identitetsnyckel. inställningar* AccountPreferences Kontoinställningar. Ansluten organisation Dataägare AccountPreferences En mottagares kontoinställningar. Id* RecipientId Mottagaridentitet. 3 AcceptedSenders* Sender[] Godkända avsändare. 3

13 Emma (EC) Version: 3.40 Sida 3 av 4 3. Authority En tjänst för att möjliggöra behörighetskontroller som tillhandahålls av FAR för att säkra juridiska krav. 3.. getuseraccessrights Hämtar användarens behörighetsattribut. Användaren är alltid behörig till sitt mottagarkonto men kan även vara behörig till ett eller flera organisationskonton. Rättigheterna sätts enligt gällande regler och i förekommande fall baserat på firmateckningsuppgifter från Bolagsverkets register eller medgivande utdelat av behörig kontoinnehavare. IN identitet* UserIdentity Inloggad användares identitetsnyckel. UT resultat* UserAccessRightsResult Behörighetsresultat Slutanvändare Dataägare anrop UserAccessRightsResult Resultat av behörighetsslagning. Rights* UserAccessRights[] Användarens behörighetsattribut en förekomst per konto. Problems UserAccessRightsProblem[] Ev. fel som uppstod vid behörighetsslagningen. Om listan är tom eller null betyder det att inga fel uppstod UserAccessRights En användares behörighetsattribut för ett visst konto. Id* RecipientId Mottagaridentitet. 3 OrganizationName string Om mottagaridentiteten avser en organisation anges namnet här. UserIdentity* UserIdentity Inloggad användares identitetsnyckel. 3 GrantedAccess* UserActivities[] Rättigheter. 3 GrantType* GrantTypes Anger hur tilldelningen av rättigheter skett. 3 Role string Eventuell roll i angiven organisation enligt Bolagsverkets register. ServiceSupplier string Om användaren har ett konto i FAR anges här hos vilken brevlådeoperatör mottagaren har sin brevlåda

14 Emma (EC) Version: 3.40 Sida 4 av UserActivities Definierade aktiviteter. Namn Beskrivning Etapp View Ta del av information rörande angivet konto inklusive att läsa meddelanden i kontots brevlåda. Användaren kan även avsäga sig ett medgivande som han eller hon fått sig tilldelat. ForwardMessage Vidarebefordra ett meddelande. 3 InitiateAccountAction Starta ansökan om konto eller avanmälan av konto. 3 InitiateConsentAction Starta utdelning eller återkallelse av ett medgivande. 3 EditSettings Ändra inställningar för angivet konto GrantTypes Definierade typer av tilldelning av rättigheter. Namn Beskrivning Etapp AuthorizedSignatory AuthorizedRole Consent Personen har signeringsrättigheter för kontot. Följer firmateckningsrätten enligt Bolagsverkets register om kontot är ett företagskonto. Personen har behörighet tilldelad enligt behöriga roller i Styrelsen för Bolaget enligt Bolagsverkets register. Personen har tilldelats medgivande genom godkännande av bolagets firmatecknare enligt firmateckningen hos Bolagsverket eller som utsedd förmyndare UserAccessRightsProblem Feltyper som kan uppstå vid behörighetsslagning. Source* UserAccessRightsProblemSource Felkälla 3 Type* UserAccessRightsProblemType Feltyp 3 Description* string Beskrivning av felet 3 ObjectId string ObjektID UserAccessRightsProblemSource Definierade felkällor. Namn Beskrivning Etapp Bolagsverket Ett fel från Bolagsverket

15 Emma (EC) Version: 3.40 Sida 5 av UserAccessRightsProblemType Definierade feltyper. Namn Beskrivning Etapp DataMissing Efterfrågat data saknas 3 DataUncertain Efterfrågat data osäkert eller kan inte tolkas. Exempelvis firmateckningsätt som inte kan tolkas maskinellt. DataUnexpected Oväntat fel/data 3 SourceInaccessible Källan är för tillfället inte kontaktbar testnewsigner Testar om angivna personers underskrifter är tillräckliga för en åtgärd för angivet konto genom att lägga till en underskrift till de underskrifter som eventuellt redan är gjorda. Om kontot gäller en organisation sker kontrollen enligt gällande firmateckning baserat på registeruppgifter från Bolagsverket. Operationen kan användas för att testa resultatet av en signering innan den genomförs. IN id* RecipientId Mottagaridentitet. undertecknare* Person[] Personer som redan har signerat. Listan kan vara tom om ingen signerat ännu. ny undertecknare PersonalNumber Identitet för tillkommande undertecknare. åtgärd* AccountActions Åtgärd gällande ett konto. UT resultat* SignatureAuthorizationResult Resultat av underskriftstest. Slutanvändare MFS-operatör anrop 3... AccountActions Definierade kontoåtgärder. Namn Beskrivning Etapp Ownership Skapa och avsluta konto samt dela ut ett medgivande. CancelConsent Återkalla ett medgivande. 3

16 Emma (EC) Version: 3.40 Sida 6 av SignatureAuthorizationResult Resultat av en firmatecknings- och ev. signaturkontroll. Id* RecipientId Mottagaridentitet. SignedBy* Person[] Lista med personer som har signerat. Status* AuthorizationStatus Complete om firmateckning uppfylls, Incomplete om det behövs fler signaturer. Om firmateckningsreglerna inte stöds är status RulesNotSupported. Timestamp date Tidstämpel för senaste signering. Text string Firmateckningskonstruktion i klartext. Uppgifterna tas från Bolagsverkets register över firmatecknare. PossibleSigners Person[] Lista med personer vars underskrift ff. kan krävas för att firmateckning skall uppfyllas enligt Bolagsverkets register AuthorizationStatus Namn Beskrivning Etapp Complete Anger att firmateckning uppfylls. Incomplete Firmateckning uppfylls inte, fler underskrifter krävs. RulesNotSupported Firmateckningskonstruktionen stöds inte verifyauthorizedsignatures Kontrollerar om bifogade signaturer är tillräckliga för en åtgärd för angivet konto. Om kontot gäller ett företag sker kontrollen enligt gällande firmateckning baserat på registeruppgifter från Bolagsverket. Kontrollen omfattar även en verifiering av bifogade signaturer. IN id* RecipientId Mottagaridentitet. signatur* SignatureData[] Lista med digitala signaturer skapade av personer som skall genomföra en åtgärd för aktuellt konto. data* base64binary Base64 kodat data som motsvarar det data som har signerats. åtgärd* AccountActions Åtgärd gällande ett konto. UT resultat* SignatureAuthorizationResult Resultatet anger om ev. firmateckning uppfylls samt ger gällande firmateckningstext. Slutanvändare MFS-operatör signatur

17 Emma (EC) Version: 3.40 Sida 7 av getsenders Hämtar alla avsändare som anslutit sig till FAR. UT avsändare* Sender[] Anslutna användare. Slutanvändare MFS-operatör - 3

18 Emma (EC) Version: 3.40 Sida 8 av Consent En tjänst för hantering av medgivanden. Ett medgivande kan delas ut av behöriga firmatecknare för ett företagskonto i förmedlingsadressregistret. Medgivandet kan delas ut till en privatperson. Personen som blir tilldelad ett medgivande kan ha ett eget konto i förmedlingsadressregistret men det är inget krav. En person som tilldelats ett medgivande får tillgång till den säkra elektroniska brevlådan till det konto som medgivandet gäller. Ett medgivande är inte en offentlig handling och kan därför inte delas ut på begäran enligt lagen om offentlig handling. Medgivanden kan inte läsas av handläggare hos förmedlingsadressregistret utan används endast vid teknisk bearbetning registerconsent Registrerar ett medgivande. Kräver att behöriga personer enligt Bolagsverkets firmateckningsregister signerat medgivandet. Medgivandet blir inte aktivt förrän mottagaren har godkänt medgivandet, vilket sker vid ett anrop till accept. Mottagaren informeras om erbjudande om medgivande genom att ett meddelande skickas till privatpersonens säkra elektroniska brevlåda om han eller hon har ett konto. IN medgivande* ConsentRequest Medgivande. Medgivanden under behandling kan hämtas via getall. signatur* SignatureData[] Signering av medgivande skapad med användarens privata nyckel på e-legitimationen. Om ansökan avser ett konto med flera firmatecknare måste samtliga firmatecknares signaturer anges innan ansökan godkänns. UT resultat* SignatureAuthorizationResult Resultat av signering. Slutanvändare MFS-operatör signatur ConsentRequest Dokument som motsvarar ett medgivande eller återkallelse av medgivande. Account* RecipientId Konto för vilket medgivande avser. Name string Namn på organisationen. Fältet sätts när alla medgivanden hämtas med getall, fältet behöver inte fyllas i vid registrering. ConsentHolder* Person Person till vilken medgivande skall delas ut eller återkallas. Type* ConsentRequestTypes Typ av dokument

19 Emma (EC) Version: 3.40 Sida 9 av 4 AgreementText string Villkorstext. Behöver inte anges vid återkallelse på egen begäran av innehavaren av medgivandet. Timestamp* date Starttidpunkt när utdelande eller återkallelse av medgivande påbörjades ConsentRequestTypes Typ av begäran. Utdelning av medgivande eller återkallelse av medgivande. Namn Beskrivning Etapp Create Utdelning av medgivande. 3 Delete Återkallelse av medgivande. 3 Cancel Återkallelse på egen begäran av innehavaren av medgivandet accept När ett medgivande signerats och registrerats måste mottagaren av medgivandet godkänna att han eller hon vill ha ett medgivande. Genom att anropa denna operation godkänner mottagaren medgivandet och det blir därmed aktivt. När ett medgivande accepterats meddelas det utdelande företaget genom ett meddelande till dess säkra elektroniska brevlåda. Mottagaren kan ta bort medgivandet när denne inte anser sig behöva det längre. Borttag sker genom anrop till cancel. När en mottagare tar bort ett medgivande informeras företaget genom att ett meddelande skickas till företagets säkra elektroniska brevlåda. IN konto* RecipientId Konto för vilket medgivande avser. identitet* UserIdentity Inloggad användares identitetsnyckel. Slutanvändare MFS-operatör signatur refuse Anropas när en mottagare av ett medgivande avböjer erbjudande om medgivande. Om mottagaren avböjer raderas registreringen av medgivandet och företaget som delat ut medgivandet informeras om åtgärden. IN konto* RecipientId Konto för vilket medgivande avser. identitet* UserIdentity Inloggad användares identitetsnyckel. Slutanvändare MFS-operatör signatur 3

20 Emma (EC) Version: 3.40 Sida 0 av cancel Med denna operation kan ett medgivande tas bort av innehavaren av medgivandet utan att signering krävs. Samma operation används när den utdelande parten vill återkalla ett medgivande, då krävs signering enligt gällande regler. IN återkallelse* ConsentRequest Återkallelse av medgivande. signatur SignatureData[] Signering av medgivande skapad med användarens privata nyckel på e-legitimationen. Minst en firmatecknare måste signera en återkallelse. Om återkallelsen är på egen begäran av innehavaren krävs ingen signatur. identitet* UserIdentity Inloggad användares identitetsnyckel. UT resultat* SignatureAuthorizationResult Resultat av signering. Slutanvändare MFS-operatör signatur getall Listar alla medgivanden för ett eller flera konton samt de som rör en viss person. Medgivanden kan vara aktiva, vänta på att samtliga firmatecknare skall signera registreringen eller vänta på att mottagaren skall godkänna erbjudandet. IN konto RecipientId[] Aktuella konton. Konton som en användare har behörighet till kan hämtas med getuseraccessrights. Parametern kan utelämnas och då hämtas bara medgivande som är utdelade till angiven person. identitet* UserIdentity Inloggad användares identitetsnyckel. UT resultat* Consent[] Lista med medgivanden för aktuella konton och inloggad användare. Medgivanden har olika status beroende på hur långt de kommit i processen för utdelning av ett medgivande. Slutanvändare MFS-operatör signatur 3

21 Emma (EC) Version: 3.40 Sida av Consent Dokument som motsvarar ett medgivande eller återkallelse av medgivande. Request* ConsentRequest Dokument som motsvarar utdelning av ett medgivande. SignatureStatus* SignatureAuthorizationResult Aktuell signaturkontroll status. 3 Status* ConsentStatus Status för utdelningsprocessen ConsentStatus Status i processen för utdelning av ett medgivande. Namn Beskrivning Etapp SigningIncomplete Signering är inte komplett, väntar på en eller flera signaturer. 3 WaitingForAccept Signering komplett, väntar på acceptans från mottagaren av medgivandet. Active Aktivt medgivande

22 Emma (EC) Version: 3.40 Sida av Service En tjänst som en MFS-operatör använder för att leverera meddelanden till en mottagare. Tjänsten implementeras av alla e-tjänst-operatörer deliversecure Lämnar in en försändelse med säkra meddelanden till mottagarens brevlåda och skickar ev. en avisering om att meddelandet finns i den säkra elektroniska brevlådan. IN försändelse* SealedDelivery En försändelse med säkra meddelanden. UT resultat* DeliveryResult Resultat av begärd inlämning av försändelse. Ansluten organisation BRONS MFS-operatör meddelande DeliveryResult Resultat av en inlämnad försändelse. TransId* string Id som kan användas för senare uppföljning. Status* DeliveryStatus[] Leveransstatus för varje mottagare i försändelsen DeliveryStatus Status för en begärd leverans av en försändelse. RecipientId* RecipientId Mottagaridentitet. Delivered* boolean Anger true om försändelsen levererats till mottagarens brevlåda och false om brevlådan saknas hos denna leverantör eller om mottagaren valt bort elektroniska utskick från avsändaren deliverforward Lämnar in en vidarebefordrad försändelse med ett säkert meddelanden till mottagarens säkra elektroniska brevlåda och skickar ev. en avisering om att meddelandet finns i brevlådan. IN försändelse* ForwardDelivery En vidarebefordrad försändelse. UT resultat* DeliveryResult Resultat av begärd inlämning av försändelse. Ansluten organisation BRONS MFS-operatör meddelande 3

23 Emma (EC) Version: 3.40 Sida 3 av notify Lämnar in ett enkelt meddelande som skall avisera en mottagare. Meddelandet skickas ut via mottagarens valda aviseringskanaler utan att sparas i mottagarens säkra elektroniska brevlåda. IN avisering* NotificationDelivery En avisering. UT resultat* NotifyResult Resultat av avisering. Ansluten organisation BRONS MFS-operatör avisering NotifyResult Status för en begärd distribution av meddelanden. TransId* string Id som kan användas för senare uppföljning. Status* NotificationStatus[] Resultat av avisering getunusedmailboxes Hämtar mottagaridentiteter för brevlådor som inte använts på specificerad tid. IN days* int Antal dagar. UT resultat* RecipientId[] Mottagaridentiteter för oanvända brevlådor. Ansluten organisation MFS-operatör -

24 Emma (EC) Version: 3.40 Sida 4 av flagremovedaccounts Flaggar för brevlådeoperatören om vilka konton som tagits bort. IN type* Type Anger om listan avser konton eller kontoansökningar. recipientids* RecipientId[] Mottagaridentiteter. Ansluten organisation MFS-operatör Type Typ som avser borttagning. Namn Beskrivning Etapp Account Konto. AccountRequest Kontoansökan.

25 Emma (EC) Version: 3.40 Sida 5 av Message En tjänst för att hantera säkra och enkla meddelanden. Tjänsten implementeras av alla operatörer som distribuerar meddelanden distributesecure Operationen begär distribution av säkra meddelanden till en eller flera mottagare. IN försändelse* SignedDelivery Signerad försändelse. UT distributionsid* string Distributionsid för utskicket. Kan sparas för senare uppföljning. Ansluten organisation BRONS Ansluten organisation meddelande 3.5. distributeforward Operationen begär distribution av en vidarebefordrad säker försändelse från en säker elektronisk brevlåda till en annan. IN försändelse* ForwardDelivery Försändelse som skall vidarebefordras. UT distributionsid* string Distributionsid för utskicket. Kan sparas för senare uppföljning. Ansluten organisation BRONS Ansluten organisation meddelande checkdistributionstatus Operationen hämtar status för en tidigare begärd distribution av meddelanden. Om begärd distribution inte ännu har hunnit packats upp och lagts på kö för bearbetning kommer ett SOAP-fault att skickas som svar från denna operation. När detta fel uppstår måste ett nytt anrop göras vid ett senare tillfälle. IN avsändare* RecipientId Avsändarens mottagaridentitet. distributionsid* string Distributionsid för en begärd förmedling av meddelanden via MFS. UT status DistributionStatus[] Lista med status för aktuell distributionsbegäran. Ansluten organisation BRONS Ansluten organisation -

26 Emma (EC) Version: 3.40 Sida 6 av DistributionStatus Status för en begärd distribution av meddelanden. RecipientId* RecipientId Mottagaridentitet. Type* DistributionTypes Anger hur distributionen kommer att ske. DeliveryStatus DeliveryStatus Leveransstatus för aktuell distribution DistributionTypes Giltiga distributiontyper. MFS hanterar endast elektroniska, om papper önskas av mottagaren måste avsändaren ombesörja detta. Namn Beskrivning Digital Meddelanden till mottagaren skall distribueras elektroniskt via MFS. Paper Meddelanden till mottagaren skall distribueras via papper. Mottagaren har valt bort elektroniska utskick från avsändaren. Not Mottagaren är inte ansluten till FAR DeliveryStatus Giltiga leveransstatus. Namn Beskrivning Delivered Försändelsen är levererad och till mottagarens brevlådeoperatör. Pending Försändelsen är under behandling (kommer att levereras). DeliveryFailed Försändelsen kunde inte levereras (misslyckades). 3

27 Emma (EC) Version: 3.40 Sida 7 av Notification En tjänst som skickar enkla meddelanden. Enkla meddelanden skickas via SMS eller e-post beroende på hur mottagaren angivit sina kontaktuppgifter. Tjänsten implementeras av alla operatörer som distribuerar meddelanden distribute Skickar ett enkelt meddelande till en eller flera mottagare. Enkla meddelanden sparas inte i mottagarens säkra elektroniska brevlåda. Antalet mottagare är begränsat i ett anrop till denna metod. Om antalet mottagare du vill skicka till överskrider maxgränsen i tjänsten måste du dela upp begäran i flera anrop till denna operation. IN avsändare* OrganizationNumber Avsändarens organisationsnummer. märkning string Specifikation för avsändarens interna kostnadsfördelning efter fakturering. Max 50 tecken längd. mottagare* RecipientId[] Lista med mottagare som skall aviseras. Max antal är 000 st. avisering* NotificationMessage[] Lista med enkla meddelanden. Här kan det finnas ett meddelande per aviseringstyp. Max förekomster i listan, en för SMS och en för e-post. korrelationsid string Distributionsid (från distribuerat meddelande), kan vara tom om anropet gäller en direktavisering. Max 50 tecken längd. UT distributionsid* string Distributionsid för aviseringen. Kan sparas för senare uppföljning. Ansluten organisation BRONS Ansluten organisation avisering

28 Emma (EC) Version: 3.40 Sida 8 av checkdistributionstatus Operationen kontrollerar status för en tidigare begärd distribution av enkla meddelanden. Resultatet som lämnas är en lista innehållande om och hur det enkla meddelandet kommer att skickas till mottagaren. Om status visar utskick av en viss typ betyder det inte att mottagaren mottagit meddelandet ännu, det betyder att meddelandet är på väg. Om begärd distribution inte ännu har bearbetats klart kommer ett SOAP-fault att skickas som svar från denna operation. IN avsändare* OrganizationNumber Avsändarens organisationsnummer. distributionsid* string Distributionsid för en begärd förmedling av meddelanden via Emma. Max 50 tecken längd. UT status* NotificationStatus[] Lista med status för aktuell distributionsbegäran. Ansluten organisation BRONS Ansluten organisation Per avisering NotificationStatus Status för en begärd distribution av enkla meddelanden. RecipientId* RecipientId Mottagaridentitet. Status* NotificationTypes Anger hur aviseringen kommer att ske NotificationTypes Giltiga aviseringskanaler. Namn Beskrivning Etapp SMS Avisering via SMS. Avisering via traditionell e-post. Not Mottagaren har ingen eller en felaktig aviseringsadress och det går därför inte att avisera mottagaren. Mottagaren kan även ha valt att stänga av aviseringsfunktionen eller valt elektroniska utskick från avsändaren.

29 Emma (EC) Version: 3.40 Sida 9 av 4 4. Publik informationsmodell (Schematyper) Typer som definieras som XML-Schema [4] (XSD) och används i det publika gränssnittet mellan MFS och omgivande system (anslutna myndigheters system, anslutna webbplatser och privata MFS-operatörer). SealedDelivery ForwardDelivery Seal SignedDelivery RecipientId Sender SignatureType SecureDelivery..n DeliveryHeader NotificationDelivery SimpleDelivery..n SecureMessage MessageHeader..n SimpleMessage SignatureData..n AccountRequest Body ContentTypes Attachment 0..n SupportInfo 0..n Metadata.. NotificationMessage NotificationTypes.. Agreement Adress ServiceSupplier Avsändaren äger Mottagaren äger FO eller delat ägarskap Figur 6. Publik informationsmodell 4. RecipientId () Ett giltigt personnummer, organisationsnummer eller ett registrerat användarnamn (sk. lågnivåkonto). Exempel: , eller kalle@home.se 4. OrganizationNumber () Typen motsvarar ett giltigt organisationsnummer. Exempel: PersonalNumber () Typen motsvarar ett giltigt personummer. Exempel: UserIdentity () Identitetsnyckel motsvarande inloggad användare. Om användaren loggat på systemet med e-legitimation är nyckeln användarens personnummer och om användaren loggat in med användarnamn och lösenord är nyckeln samma som användarnamnet Adress () En giltig e-post-adress enligt RFC 8 avsnitt Exempel: kalle@gmail.com.

30 Emma (EC) Version: 3.40 Sida 30 av Sender En avsändare. Attribut Datatyp Beskrivning Id* RecipientId Avsändarens mottagningsidentitet. Name* string Avsändarens namn. 4.7 Person En person. Attribut Datatyp Beskrivning Id* PersonalNumber Personnummer. Name* string Namn. 4.8 Text Typen motsvarar en text som är översatt till ett visst språk för en slutanvändare. Attibut Datatyp Beskrivning Etapp Language* language Språk.? Text* string Själva texten som skall presenteras för slutanvändaren. 4.9 NotificationMessage Ett meddelande som används för att avisera en mottagare om någon händelse. Detta meddelande skickas över en osäker kanal som mobilnätet eller e-post så det är viktigt att informationen inte är av känslig karaktär. E-post meddelanden skickas alltid i två format till mottagaren, enligt MIME-typerna: text/html och text/plain. Endast en text kan anges från avsändaren och avsändaren måste välja format. Om texten anges enligt HTML-format kommer den att skickas som text/html, samma text kommer också att tvättas från alla HTML-taggar och skickas som text/plain. Om texten anges som vanlig text skickas den som text/plain och samma text kompletteras med start- och sluttaggar för HTML och skickas som text/html. Namn Datatyp Beskrivning Etapp From* string Avsändare, skall vara en e-postadress för e-post och en fri text (max tecken) för SMS. Subject* string En titel för meddelandet. Max 54 tecken för e-post och alltid tom sträng för SMS. Text* string Aviseringstext. Max 60 tecken för SMS och obegränsat för e-post. Notificationtype* NotificationTypes Aviseringstyp som detta aviseringsmeddelande gäller för.?

31 Emma (EC) Version: 3.40 Sida 3 av SecureDelivery En säker försändelse. Innehåller meddelanden med känsligt innehåll som garanterat levereras till mottagarens säkra elektroniska brevlåda och där avsändaren kan garanteras. Header* DeliveryHeader Försändelsehuvud. Message* SecureMessage[] En eller flera säkra meddelanden som skall till samma mottagare. 4. NotificationDelivery En aviseringsförsändelse. Header* DeliveryHeader Försändelsehuvud. Message* NotificationMessage[] Aviseringsmeddelande. Listan kan innehålla max förekomster ett för e- post och ett för SMS. 4. DeliveryHeader Ett försändelsehuvud. Sender* Sender Avsändare. Recipient* RecipientId[] Mottagare. Reference string Specifikation för avsändarens interna kostnadsfördelning efter fakturering. Max 50 tecken längd. CorrelationId string Frivillig referens till t.ex. ett ärende hos avsändaren. Kan användas vid framtida korrespondens. 4.3 SignedDelivery En signerad försändelse. Försändelsen signeras av avsändaren. Delivery* SecureDelivery Försändelse. Signature* SignatureType Signatur gjord av avsändaren med avsändarens privata nyckel.

32 Emma (EC) Version: 3.40 Sida 3 av SignatureData En signatur som skapats med ett certifikat som bifogas till det data som signerats. Signature* base64binary En Base64 kodad signatur enligt formaten PKCS#7 eller XMLsignature. CA* string Namn på organisationen som givit ut certifikatet som användes vid skapandet av signaturen. Nonce string Slumpat ord som användes vid skapandet av en XML-signatur. Endast BankID:s PKI-klient. EncodingOfSignedText string Encoding av texten/datat som signerats. Default: UTF SealedDelivery En av distributören mottagen och stämplad signerad försändelse. SignedDelivery* SignedDelivery En försändelse signerad av avsändaren. Seal* Seal Stämpel med mottagningsinformation och utförd signaturkontroll signerad av förmedlande system. Signature* SignatureType XML-signatur gjord av MFS när en försändelse tagits emot för distribution. 4.6 Seal En stämpel som skapas av mottagande distributör efter utförda signaturkontroller genomförts. ReceivedTime* date Mottagningstidpunkt. SignaturesOK* boolean Resultat av kontroll av signaturer i försändelsen. 4.7 SecureMessage Ett säkert meddelande. Ett meddelande får vara max MB (bilagor inkluderat). Header* MessageHeader Meddelandehuvud. Body* MessageBody Meddelandekroppen. Attachment Attachment[] Lista med bilagor.

33 Emma (EC) Version: 3.40 Sida 33 av MessageHeader Ett meddelandehuvud. Id* string Meddelandeidentitet. Subject* string Rubrik. Supportinfo* SupportInfo Information kring var användaren skall vända sig vid behov av support kring meddelandet. Metadata MetaData[] Extra attribut som avsändaren bifogar till meddelandet. Kan användas av avsändaren vid korrespondens eller av mottagaren för sortering/filtrering. Language* language Språk som avsändaren valt. 4.9 SupportInfo Information kring var en mottagare av ett meddelande kan vända sig vid behov av support kring ett mottaget meddelande. Text* string Beskrivande text om var man kan vända sig vid behov av support. Logo anyuri URL som pekar på avsändarens logo. URL anyuri URL som pekar på en webbplats/e-tjänst eller liknande som kan användas vid mer information för ett meddelande. PhoneNumber string Mobiltelefonnummer. Adress Adress E-post adress dit frågor kan skickas avseende ett meddelande. 4.0 MetaData Extra fria attribut som kan användas av avsändare och mottagare av meddelanden. Tag* string Nyckel. Value* string Värde.

34 Emma (EC) Version: 3.40 Sida 34 av 4 4. MessageBody Meddelandekropp. ContentType* string Enligt IANA MIME media types [7]. Body* base64binary Base64 kodat binärdata som motsvarar själva meddelandet. Text skall alltid vara UTF-8 kodad. 4. Attachment En bilaga tillhörande ett meddelande. ContentType* string Enligt IANA MIME media types [7]. Body* base64binary Base64 kodat binärt rådata för en bilaga. Checksum* string Checksumma HEX (MD5-hash) beräknad på bilagans datainnehåll. Filename string Ursprungligt namn på fil. 4.3 ForwardDelivery En originalförsändelse som skall vidarebefordras till en annan mottagare. Header* DeliveryHeader Försändelsehuvud. 3 Message* ForwardMessage Meddelande. 3 OriginalDelivery* SealedDelevery Originalförsändelsen som skall vidarebefordras till en ny mottagare. Försändelsen är signerad av den avsändare som först skickade det säkra elektroniska meddelandet och stämplad av den som distribuerat originalförsändelsen. 4.4 ForwardMessage Ett vidarebefordrat meddelande. Subject* string Rubrik. 3 Body* MessageBody Meddelandekroppen. 3 3

35 Emma (EC) Version: 3.40 Sida 35 av 4 5. Felhantering Fel signaleras alltid som SOAP-fault med ett meddelande som alltid innehåller information om felet, en felkod och ett transaktionsid. Felkoderna är uppdelade på tekniska fel samt applikationsfel. Applikationsfel utlöses av någon typ av användningsfel hos anroparen, felaktigt format på indata, ej behörig eller liknande och indata måste rättas innan anropet görs om. Tekniska fel är kopplade till att något gått fel med tekniken vilket betyder att anropet måste göras om vid ett senare tillfälle. 5. ExceptionInformation Information kring ett fel som uppstod vid ett anrop av en tjänsteoperation. ErrorCode* int Felkod. Description* Text[] Text som ev. kan presenteras för en slutanvändare. CallId* string Kod som kan användas för att spåra ett fel. 5. ErrorCodes Definerade felkoder. Felkoderna är reserverade för Tekniska fel och felkoderna är reserverade för Applikationsfel. Kod Beskrivning Etapp 0 Generellt tekniskt fel Sista felkod för tekniska fel (används ej) Generellt applikationsfel (används för odefinerade fel). 500 Felaktigt indata. 500 Ej behörig Efterfrågat data finns ej Bearbetning ej klar Maximalt antal överskridet Signatur felaktig Företagsformen stöds ej Firmateckningsformen stöds ej Sista felkod för applikationsfel (används ej). ErrorCodes används inte som datatyp eftersom gränssnittet då skulle vara tvunget att uppdateras för varje ny felkod.

36 Emma (EC) Version: 3.40 Sida 36 av 4 6. Navigeringsadresser Navigeringsadresser är URL:ar som kan användas av anslutande webbplatser för att direktnavigera till olika sidor/funktioner i en MFS-operatörs implementation av e- tjänst. Basadressen i URL:en hämtas i ett anrop till Recipient.isRegistered och den fullständiga navigeringsadressen till sidan skapas genom att lägga till önskat navigeringsresurs och eventuella parametrar enligt URI-standard [6]. 6. Inbox Navigera till en mottagares brevlåda. Parameter Beskrivning Etapp RecipientId* Mottagaridentitet- Exempel: 6. AccountRequest Navigera till sidan för att ansöka om ett konto. Parameter Beskrivning Etapp RecipientId* Mottagaridentitet.

37 Emma (EC) Version: 3.40 Sida 37 av 4 7. Dokumentinformation I detta avsnitt hittar du information som rör själva dokumentet. Här finns förteckningar över använd litteratur och referenser samt en ordlista som beskriver ord och förkortningar som används i dokumentet. Sist finns en tabell som redovisar revisionshistoriken för dokumentet. 7. Referenser Här beskrivs alla referenser som används i dokumentet. Ref. Dokumenttitel Utgivare Adress Strategi för myndigheternas arbete med e-förvaltning e-delegationen SOU 009:86 Så enkelt som möjligt för så många som möjligt - från strategi till handling för e-förvaltning e-delegationen SOU 00:0 3 Web Services Description Language (WSDL). 4 W3C XML Schema Definition Language (XSD). W3C W3C MIME Media Types IANA 6 Uniform Resource Identifiers (URI): Generic Syntax IETF Tabell 9. Referenser som används i dokumentet

38 Emma (EC) Version: 3.40 Sida 38 av 4 7. Revisionshistorik Här redovisas dokumentets revisionshistorik. Datum Version Beskrivning Signatur Skapat dokumentets grundstruktur Dokumentation enl. första workshop Deltagare: Erik Andersson, TVV Dag Ekenståhl, TVV Henrik Bengtsson, BOL Jan Eriksson, SKV Rutger Langland, SKV Toni Thomsson, SKV Dokumentation under workshop Deltagare: Erik Andersson, TVV Dag Ekenståhl, TVV Henrik Bengtsson, BOL Per Granstrand, BOL Jan Eriksson, SKV Rutger Langland, SKV Toni Thomsson, SKV Förändringar enl. workshop Förändringar enl. workshop Förslag på kostnadsindelning. Deltagare: Erik Andersson, TVV Dag Ekenståhl, TVV Henrik Bengtsson, BOL Jan Eriksson, SKV Rutger Langland, SKV Toni Thomsson, SKV Fler ändring efter remissrunda. Ändring av felkoder, tillägg av kontotyp och byte av namn på parametern kostnadsställe Ändrat namn på DistributionReceipt till MessageStatus. Ny operation checkdistributionstatus på Notification tjänsten och ny typ NotificationStatus Ändrat märkning till att vara icke obligatorisk. Förtydligat beskrivning av parametrar till checkavailability. Versionen föreslås som RC för konstruktionsstart av etapp Ändrat parametrarna kontotyp, avsändare och meddelandetyp på Recipient.checkAvailability tillbaka till att vara obligatoriska och lagt till en ny operation isregistered. Flyttat Sender-tjänstens operationer som

39 Emma (EC) Version: 3.40 Sida 39 av 4 Datum Version Beskrivning Signatur opererar på MessageType till etapp. Flyttat Recipient.checkAvailability till etapp Ändrat parametern kontotyp i Recipient.checkAvailability till ickeobligatorisk. Ändrat AccountStatus till att innehålla nytt attribut Type av typen AccountTypes och tagit bort attributet Exists Lagt till möjlighet till att lagra olika aviseringsadresser/meddelandetyp för att stödja senaste GUI-prototyp. Skapat länkar för att enklare kunna navigera i dokumentet Ny etappindelning, nu även per attribut. Maxlängder och andra begränsningar på vissa attribut och parametrar Kompletterat operationer som tar en signatur med certifikat Ändringar enl. Visbymöte Jonatan Wentzel, TVV Johan Bergsten, TVV Per Granstrand, BOL Agneta Virsberg, SKV/VE Rutger Langland, SKV/VE Toni Thomsson, SKV/VE Notification.distribute får endast anropas internt hos FAR. Message.checkDistributionStatus omfattar även aviseringsstatus. Borttag av specialkontaktuppgifter för avsändare/meddelandetyper. Endast en e-post adress och ett SMS nummer i kontaktuppgifterna. Uppdatering av kontaktuppgifter kräver ej signering. Recipient.register (ansökan) tar id och en e-postadress istf. kompletta kontaktuppgifter Rättade småfel från föregående version Ändrat så att avsändarparametern alltid kommer först i argumentlistan. Lagt till avsändarparameter för checkdistributionstatus Ändrat NotificationMessage.NotificationType till icke obligatorisk för aviseringsmeddelanden som gäller alla aviseringstyper. SignatureData fält obligatoriska Komplettering av SignatureData med attribut för BankID-nonce. Rättning av beskrivningen av resultatet för operationen Notification.checkDistributionStatus. Flytt av Message-tjänsten till etapp Förtydligande avseende Subject för SMS och lagt till avsändare för aviseringsmeddelanden. Borttag av signatur vid avslutande av konto Rättat texten avseende typ på NotificationMessage samt förtydligat beskrivningen av From-attributet på NotificationMessage.

40 Emma (EC) Version: 3.40 Sida 40 av 4 Datum Version Beskrivning Signatur Rättat felaktiga längder för flera parametrar och fält. Kompletterat med beskrivning av format på e-post meddelanden Rättat behörighetsroller på etapp tjänsterna Lagt till fler felkoder Ändrat returtypen för Recipient.update till boolean. Anger om profilen uppdaterades och om ett kvittensmeddelande skickades Lagt till beskrivning av maxgränsen för antal mottagare i ett anrop till Notification.distribute. Samt lagt till ny felkod Första förslag till ändringar inför etapp : Beskrivningar av systemindelning mm. för stöd av flera MPS-operatörer. Tagit bort interna operationer för GUI från Recipienttjänsten. Tagit bort interna operationer för GUI från Messagetjänsten och uppdaterat distributions-operationer. Flyttat register- och deregister-operationer till Recipienttjänsten och updaterat dem med stöd för multipla signaturer. Nya tjänster: Authority, Service Kompletterat svaret från Recipient.isRegistered med adress till e-tjänst-operatörens Service-tjänst Lagt till operationer för informations- och navigerings behov hos anslutande webbplats enligt möte med verksamt.se s portalprojekt hos Bolagsverket Ny operation för test av ny signerare vid multipel signering Lagt till länk till WSDL/XSD. Ändrat kvittens vid inlämning av försändelser till brevlåda. Ändrat gränssnittet för register/deregister så att en påbörjad ansökan/anmälan sparas hos myndigheten. Flyttat getpendingaccountrequest från Service till Recipient. Ändrat namn och funktion för behörighetsoperation isuserauthorized till getuseraccessrights. Hämta pågående ansökan getpendingaccountrequest kan göras mot flera konton i samma anrop. Lagt till operation för att ta bort en pågående ansökan eller avanmälan deletependingaccountrequest.

41 Emma (EC) Version: 3.40 Sida 4 av 4 Datum Version Beskrivning Signatur Förtydliganden i översiktsbilden.. Mappning till tjänsterna och relationernas kardinalitet Lagt till beskrivningstext och logo i SupportInfo Lagt till organisationsnamn i svaret från getuseraccessrights. Lagt till brevlådeoperatörens namn och logo i svaret från isregistered Nytt fält CorrelationId ipå DeliveryHeader Byt ut boolean OK mot AuthorizationStatus i SignatureAuthorizationResult ML Lagt till AuthorizationStatus med beskrivning Rättningar av status för Message.distribute och checkstatus. Authority.testNewSigner: ändrat parameter för ny undertecknare till att ej vara obligatorisk. SignatureAuthorizationResult.Timestamp: ändrad till att vara ej obligatorisk Kompletterat AccountRequest med attribut med dokumenttyp (ansökan eller avanmälan) samt att dokumentet kan ha upp till tio e-post-adresser. Uppdaterat Service.getMessageCount så att frågan kan omfatta flera brevlådor i samma fråga. Rättat NotificationMessage.Notificationtype till att vara obligatorisk Ändrat Message.distributeSecure/distributeSimple till att endast ta en försändelse per anrop. Kompletterat SignatureData med nytt attribut EncodingOfSignedText Ändrat signaturtypen för säkra meddelanden. Markerat deliversimple och distributesimple för senare etapp Ny operation getallregisteredaccounts för att hämta alla personnummer/orgnummer som har registrerat sig i förmedlingsregistret e-post-adressen flyttar ut från ansökan (igen) Förtydligande avseende kodning av text i säkra meddelanden (alltid UTF-8) Rättning av felaktig dok. av Recipient.getAllRegisteredAccounts() Första ändringar för etapp-3: Ny operation: Recipient.isReachable Ny operation: Recipient.getAllReachableAccounts Ny operation: Authority.getSendes Uppdatering av: Authority.getUserAccessRights