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:
Helseaktørens betalingsleverandør sender oppgaven til innbygger via Helsenorge
Innbygger varsles om mottatt oppgave og kan logge seg inn på Helsenorge å finne oppgaven
Innbygger kan se beskrivelse av oppgaven, se frist, samt starte oppgaven i ekstern betalingsløsning (via lenke som avsender sendte med i oppgaven)
Innbygger vil også påminnes om eventuelt ikke utført oppgave når fristen nærmer seg
Ekstern løsning må understøtte single-sign-on via Helsenorge innloggingsløsning: https://helsenorge.atlassian.net/wiki/x/CgCkV
Ekstern løsning må understøtte representasjon: https://helsenorge.atlassian.net/wiki/x/AoA7lg
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:
Task.status skal settes til utført. Se her: Oppdatere innsendt oppgave