Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Beskrivning
Möjlighet att skicka mail till en medborgares eller ett företags digitala brevlåda.
Brevlådeoperatörer som stödjs: Kivra, Min Myndighetspost, Fortnox och Billo
Borttagna brevlådeoperatörer: e-boks, Digimail Digimail
Användning av tjänsten
Denna tjänst har en del riktliner för hur meddelanden bör utformas och hur stora bilagor som kan bifogas:
Utforming av meddelanden
Ett komplett meddelande får vara max 2 MB, inklusive bilagor och meddelande. Tjänsten gör en kontroll på detta och kommer att ge ett felmeddelande om det är för stort. Anledningen är helt enkelt att inte alla brevlådeoperatörer stödjer större meddelanden och att en leverans därför inte kan garanteras.
Varje meddelande måste ha ett icke-tomt meddelande (body), utöver eventuell bilaga, som kan vara antingen av typen text/plain eller text/html.
HTML-meddelanden går att styla och https://www.digg.se/digital-post/offentlig-aktor/teknisk-beskrivning-av-digital-post/utforma-meddelanden beskriver bäst hur dessa meddelanden bör utformas.
I princip går det att skicka vad man vill men tjänsten gör alltid en validering mot https://validator.w3.org/ och om denna inte går igenom kommer vi att neka meddelandet. Det går även att Base64-encoda bilder och infoga dessa, däremot är det inte tillåtet att länka till bilder på internet.
Hela meddelandet/bodyn måste vara Base64-encodad.text/plain går ej att formatera och lämpar sig bäst för t.ex. en enda mening. Får inte vara Base64-encodad.
Bilagor
Det går att skicka med 0 → n bilagor till ett meddelande. För tillfället stödjer vi enbart pdf-bilagor.
Bilagorna måste Base64-encodas, ingen kontroll görs på deras “korrekthet” så detta är upp till avsändaren att säkerställa.
Tänk på att Base64-encodning lägger på ~33% till storleken av pdf:en.
Samtliga bilagor inklusive meddelandet måste vara under 2MB i storlek annars nekar tjänsten utskicket.
Max-storleken beräknas på hela meddelandet som skickas så om bilagan/bilagorna är exakt 2MB kommer det att nekas pga. den overhead som SOAP-meddelandet lägger på.
Livscykelstatus
Produktion
Lösningsbeskrivning
Gliffy | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Hantering av personuppgifter
I fallet där ett digitalt mail skall skickas till en medborgare hämtas personnummer via CitizenMapping då personnummer är tvingande för att få reda på vilken bredvlåda medborgaren har.
API specifikation (wip)
Open api | ||
---|---|---|
| ||
Säkerhetsklassning
Säkerhetsklass 1
Autentiseringsmetod: Oauth2
Teknisk ägare
För tekniska frågor:
teamdynasty@sundsvall.se
Källkod
Githubhttps://github.com/OpenSundsvall/api-service-digital-mail-sender