Betalingsoppgave - utføres i system utenfor Helsenorge

Betalingsoppgave - utføres i system utenfor Helsenorge

Hva er en betalingsoppgave

Dette er en oppgave som utføres i et eksternt system. Innbygger får oppgaven på Helsenorge, men selve gjennomføringen av oppgaven skjer i en betalingsløsning utenfor Helsenorge. Når innbygger starter oppgaven på Helsenorge åpnes en ny fane i nettleser, og innbygger kommer til betalingsløsningen. Innbygger får ingen kopi på Helsenorge av det som skjer/gjøres i det eksterne systemet.

Overordnet om integrasjon mellom ekstern betalingsløsning og Helsenorge

Arbeidsflyten for denne type oppgaver er som følger:

  1. Helseaktørens betalingsleverandør sender oppgaven til innbygger via Helsenorge

  2. Innbygger varsles om mottatt oppgave og kan logge seg inn på Helsenorge å finne oppgaven

  3. Innbygger kan se beskrivelse av oppgaven, se frist, samt starte oppgaven i ekstern betalingsløsning (via lenke som avsender sendte med i oppgaven)

    1. Innbygger vil også påminnes om eventuelt ikke utført oppgave når fristen nærmer seg

  4. Ekstern løsning må understøtte single-sign-on via Helsenorge innloggingsløsning: https://helsenorge.atlassian.net/wiki/x/CgCkV

  5. Ekstern løsning må understøtte representasjon: https://helsenorge.atlassian.net/wiki/x/AoA7lg

  6. Når innbygger har fullført betalingen i ekstern betalingsløsning, skal løsningen rapportere tilbake til Helsenorge at oppgaven er utført.

Sende betalingsoppgave til innbygger

For å sende betalingsoppgave til innbygger benyttes OppgaveAPIet, som understøtter både meldingsbasert- og REST-integrasjon: Oppgave API

En betalingsoppgave representeres alltid som en FHIR-ressurs av typen ‘Task’.

Oppgave som FHIR Task

Hvordan FHIR Task skal benyttes er beskrevet i detalj her: FHIR Task - Oppgave Se eksempel under.

Betalingsoppgave kjennetegnes ved at Task.focus.type = “PaymentNotice

<focus> <type value="PaymentNotice"/> </focus>

XML-eksempler på innsending av oppgave

Eksempel på Payload (FHIR Task):

Eksempel på Hodemelding med oppgave (vedlagt dokument er det samme som payload ved rest-kall):

Oppdatere status på Helsenorge når betalingsoppgave er utført

Oppgavens status endres ved å benytte eget API for statusoppdatering: