Snitflader i Digital Post

Ved systemtilslutning til Digital Post-løsningen (herefter løsningen), understøttes forskellige protokoller, som kan bruges alt efter behov og kompatibilitet med egne modtager- og afsendersystemer. Herunder beskrives de eksisterende snitflader og deres funktionalitet, samt snitflade for enkeltmeddelelser sendt som masseforsendelser.

Uddybende teknisk beskrivelse kan findes i Technical Integration, afsnit 12. 

Modtagersystemer

REST PUSH
Snitfladen understøtter, at meddelelser kommer frem til modtagersystem hurtigst muligt, ved at sende disse, så snart de er tilgængelige. Dette kræver at modtagersystemet kan klare den volumen og belastning der kan være forbundet med dette.
Løsningen sender meddelelsen direkte til modtagersystemet så snart denne er tilgængelig. Modtagersystemet svarer først med statuskode for modtagelse og kvitterer herefter via forretningskvittering. Efter modtagelse af gyldig forretningskvittering slettes meddelelsen i løsningen.

REST PULL
Snitfladen muliggør, at man som modtager selv tjekker for og henter meddelelser, når disse gøres tilgængelige. Dette kan være relevant, hvis et system ikke er sat op til at modtage og svare på kald løbende. Det er vigtigt at pointere, at meddelelser anses for modtaget når de er tilgængelige og det derfor er modtagerens ansvar, at hente disse.
Modtagersystem henter liste over tilgængelige meddelelser fra løsningen. Modtagersystem henter herefter tilgængelige meddelelser og løsningen svarer igen med statuskode. Efter modtagelse af gyldig forretningskvittering slettes meddelelsen i løsningen og vil derfor ikke kunne hentes igen.

REST PUBLISH/SUBSCRIBE
Snitfladen minder om ovenstående PULL snitflade, med den forskel, at løsningen giver besked om tilgængelige meddelelser. Dermed skal modtagersystemet ikke selv løbende tjekke om der er nye tilgængelige meddelelser, men skal stadig selv afhente dem.
Løsningen giver besked til modtagersystemet for hver meddelelse, når denne er klar til afhentning. Herefter kan modtagersystemet selv hente tilgængelige meddelelser fra løsningen. Løsningen afventer gyldig forretningskvittering fra modtagersystem og herefter slettes meddelelse i løsningen og vil derfor ikke kunne hentes igen.

Afsendersystemer

REST PUSH
Snitfladen understøtter både enkelt- og masseforsendelser, hvor forsendelse og kvittering foregår asynkront mellem afsendersystem og løsning.
Afsendersystemet sender separat meddelelse eller flere samlede meddelelser til løsningen, som svarer med teknisk kvittering via statuskode. Efter validering af meddelelse, sender løsningen en forretningskvittering. Hvis denne er positiv er meddelelsen overleveret til Digital Post.
Format
Meddelelser kan enten sendes enkeltvis i XML-format eller som masseforsendelse, med en til flere meddelelser pakket i tar.lzma format. Førstnævnte skal bruges til enkelte meddelelser, hvor leveringstiden kan være kritisk, mens masseforsendelse skal bruges ved større forsendelser, som ikke er tidskritiske. Som udgangspunkt leveres enkeltforsendelser til modtageren inden for 20 sekunder, mens masseforsendelser leveres til modtager hurtigst muligt inden for 24 timer. Utilsigtet afsendelse af større forsendelser som enkeltforsendelser belaster løsningen og påvirker svartider og brugeroplevelse for alle anvendere negativt.

REST PULL
Snitfladen understøtter, som ovenstående, asynkron forsendelse og kvittering, med den forskel, at forretningskvitteringer ikke sendes direkte til afsendersystemet, men i stedet gøres tilgængelige for afhentning. Ikke afhentede kvitteringer slettes efter 7 dage.

SFTP
Snitfladen understøtter masseforsendelser, hvor disse pakkes og placeres på en sikker server, hvorefter løsningen samler disse og foretager forsendelse.
Afsendersystem uploader tar.lzma, indeholdende en eller flere meddelelser, til SFTP-serveren. Efter behandling gør løsningen forretningskvittering for hver meddelelse tilgængelig i en dedikeret folder på SFTP-serveren. Herefter skal afsendersystem hente og slette kvitteringer inden for 14 dage. Kvitteringer slettes automatisk efter 14 dage uanset om de er blevet hentet eller ej. Alle forsendelser via SFTP behandles som masseforsendelser og leveres til modtager hurtigst muligt, inden for 24 timer.

REST PUSH masseforsendelse
På baggrund af utilsigtet brug af enkeltforsendelser til udsendelse af høj volumen, hvilket påvirker løsningens performance og brugerens oplevelse, er der introduceret en ny REST snitflade, som altid leverer til modtager hurtigst muligt, inden for 24 timer, uanset om der afleveres en enkelt XML-fil eller et tar.lzma arkiv. Denne snitflade udbydes i forbindelse med, at flere afsendersystemer ikke har kunne understøtte korrekt masseforsendelse, således, at de fortsat teknisk set kan sende en høj volumen af enkeltforsendelser, uden at påvirke løsningen og brugeroplevelse negativt.
På sigt kan der blive indført regler der gør, at et afsendersystem automatisk dirigeres over til denne snitflade, hvis utilsigtet brug eller misbrug fortsat registreres i forbindelse med enkeltforsendelser.