Beskrivning

Möjlighet att skicka mail till en medborgares eller ett företags digitala brevlåda.

För tillfället stödjs enbart Kivra, men detta kommer att utökas till Min myndighetspost samt Eboks.

Digimail kommer inte stödjas pga: “Digimail har sagt upp anslutningsavtalet för Mina meddelanden. Det innebär att det från den 1 juni 2022 inte längre är möjligt att ta emot digital post från offentliga aktörer i Digimail” - digg.se

Användning av tjänsten

Denna tjänst har en del riktliner , samt digitala fakturor till en medborgares Kivra-brevlåda.

Brevlådeoperatörer som stöds för mail: Kivra, Min Myndighetspost, Fortnox och Billo
Borttagna brevlådeoperatörer: e-boks, Digimail

Användning av tjänsten

Det finns vissa riktlinjer för hur meddelanden bör utformas och hur stora bilagor som kan bifogas:

Allmänt

Bilagor

• För tillfället stödjer tjänsten endast PDF-bilagor.

• Bilagorna måste BASE64-encode:

• as. Ingen kontroll görs på deras “korrekthet” så detta är upp till avsändaren att säkerställa.

  • Tänk på att BASE64-encoding lägger på ~33% till storleken av PDF-filen.

Digitala mail

Utformning 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 HTML (text/plain html) eller text /html. (text/plain

  går ej att formatera och lämpar sig bäst för t.ex. en enda mening.

  ):

  • 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/ HTML-validering och om denna inte går igenom kommer vi tjänsten att neka meddelandet. Det går även att Base64BASE64-encoda encode:a 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-encode:ad.

  • Text-meddelanden går ej att formatera och lämpar sig bäst för t.ex. en enda mening. Får inte vara BASE64-encode:at.

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 . Om inte nekar tjänsten utskicket.

  • Max-storleken Maxstorleken beräknas på hela meddelandet som skickas så om det bilagan/bilagorna är exakt 2MB kommer det att nekas pgap.g.a. den overhead som SOAP-meddelandet lägger på.

Digitala fakturor

Utformning av meddelanden

• Tjänsten kommer att verifiera att mottagande kontonummer är ett korrekt Plus- eller Bankgironummer och nekar fakturautskicket om så inte är fallet.

Bilagor

• Minst en bilaga måste skickas med
• Det finns ingen begränsning på bilagors storlek.

Livscykelstatus

Produktion

Lösningsbeskrivning

Hantering av personuppgifter

I fallet där ett digitalt mail eller en faktura skall skickas till en medborgare hämtas personnummer via CitizenMapping Party då personnummer är tvingande för att få reda på vilken bredvlåda brevlåda medborgaren har.

API specifikation (wip)