- Created by Levin Løssfelt, last modified by Alette N. L. Olrik on Oct 08, 2021
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 9 Next »
Prosessen avtaleavbestilling er identisk med funksjonen for innbygger å sende avbestilling i prosessen AMQP Timereservasjon versjon 1.2
Denne prosessen gjør det mulig for en aktør å åpne opp for avbestillinger av avtaler fra innbygger, uten å åpne opp for hele prosessen timeadministrasjon som også innebærer at innbygger får hente ledige timer og bestille nye timer. Et premiss for å kunne benytte denne prosessen er at innbygger ser avtaler og prosessen Avtaleutsending er aktivert.
API-navn | DIALOG_INNBYGGER_AVTALEAVBESTILLING |
---|---|
Funksjonelt område | Dialog |
API-versjon og dato publisert | v1.0 |
Status | I DRIFT |
API-dokumentasjon sist endret |
|
Teknologi | AMQP |
Prosesser og roller
Her er info om prosesser og roller
Dette er en frittstående prosess og har en egen verdi i meldingens funksjon i hodemeldingen. Følgende prosess skal aktiveres i adresseregisteret for å støtte funksjonaliteten.
Prosess | Funksjonalitet | Versjon |
Dialog_Innbygger_Avtaleavbestilling | Første versjon av kommunikasjonsprosess. | 1.0 |
Tabellen under viser hvilke roller som inngår i prosessen, hvilke funksjoner de ulike rollene kan gjøre og hvilke meldinger som benyttes for de ulike versjonene.
Versjon | Rolle | Funksjon | Meldingsinnhold |
1.0 | Innbygger | AvbestillAvtale
| Dialogmelding 1.1 Pasientrelasjon iCal |
Helsepersonell | SvarAvbestilling | Dialogmelding 1.1 iCal |
Se ytterligere detaljer i innholdsstandarder for innhold i meldinger
Forespørsel fra innbygger om avbestilling
Her er strukturen på query
Med forespørsel om avbestilling kan innbygger sende en forespørsel om å avbestille en time.
Denne funksjon dekker avbestilling som beskrevet i AMQP Timereservasjon under Reservasjon av valgt time.
Tjeneste | Forespørsel om timereservasjon, asynkron tjeneste |
Bruksområde | Brukes når innbygger ønsker å avbestille en reservert time. |
Hodemelding | Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding
Obligatorisk verdi i MsgHead/MsgInfo/Type er: <Type V="DIALOG_INNBYGGER_AVTALEAVBESTILLING" DN="Dialog med innbygger - avtaleavbestilling "/>
Obligatorisk verdi i MsgHead/MsgInfo/Ack er: <Ack DN="Ja" V="J"/>
Referanse til samtaletråd settes til meldingen som ble sendt for timenotifikasjon, beskrevet i AMQP Notifikasjon Innbygger Time <ConversationRef> <RefToParent>f5896674-1147-46f0-bc9b-6b6bde5bb844</RefToParent> <RefToConversation>f5896674-1147-46f0-bc9b-6b6bde5bb844</RefToConversation> </ConversationRef> |
Dialogmelding | Obligatoriske elementer (klasse/element):
Lovlige kodeverdier som kan brukes i TypeForesp:
|
iCalender | Obligatorisk når informasjon om tidspunkt sendes til legekontor. Elementene under iCal/vevent skal ha følgende innhold
Ved avbestilling av time skal feltet related-to ha samme verdi som i opprinnelig time. Følgende valgfrie informasjon kan benyttes:
XML eksempel: <vcalendar> <properties> <version> <text>2.0</text> </version> <prodid> <text>PAS EPJ</text> </prodid> </properties> <components> <vevent> <properties> <dtstart> <date-time>2019-07-05T11:45:00</date-time> </dtstart> <dtend> <date-time>2019-07-05T12:00:00</date-time> </dtend> <uid> <text>651b1341-26ca-11e4-8c21-0800200c9a66</text> </uid> <related-to> <uri>651b1341-26ca-11e4-8c21-0800200c9a66</uri> </related-to> <contact> <text>91095</text> </contact> <summary> <text>Reisevaksine</text> </summary> <description> <text>Jeg har allerede tatt dose 2</text> </description> </properties> <components/> </vevent> </components> </vcalendar> |
Svar på forespørsel om avbestilling
Her er strukturen på en respons
Innholdet i Dialogemeldingen for svar på forespørsel er identisk med svar som beskrevet i AMQP Timereservasjon under Reservasjon av valgt time. Dersom avbestilling kommer via prosessen Avtaleavbestilling skal det også svares med avbestilling slik som i eksempelet under.
Tjeneste | Svar på forespørsel om avbestilling, asynkron tjeneste |
Bruksområde | Svar på avbestilling av en reservert time. |
Hodemelding | Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding
Obligatorisk verdi i MsgHead/MsgInfo/Type er <Type V="DIALOG_INNBYGGER_AVTALEAVBESTILLING" DN="Dialog med innbygger - avtaleavbestilling "/>
Obligatorisk verdi i MsgHead/MsgInfo/Ack er: <Ack DN="Ja" V="J"/> |
Dialogmelding | Obligatoriske elementer (klasse/element):
Lovlige kodeverdier som kan brukes i Dialogmelding/Notat/Temakodet:
Avvisning av henvendelse/forespørsel: dersom system/behandler ikke kan svare på mottatt henvendelse/forespørsel kan følgende kodeverdier fra kodeverk 7602 benyttes i elementet <Dialogmelding/Notat/Temakodet>:
|
iCalender | Obligatorisk når informasjon om tidspunkt sendes til Helsenorge.no. Elementene under iCal/vevent skal ha følgende innhold
Ved avbestilling av time skal feltet related-to ha samme verdi som i opprinnelig time.
Følgende valgfrie informasjon kan benyttes:
XML eksempel: <vcalendar> <properties> <version> <text>2.0</text> </version> <prodid> <text>PAS EPJ</text> </prodid> </properties> <components> <vevent> <properties> <dtstart> <date-time>2019-07-05T11:45:00</date-time> </dtstart> <dtend> <date-time>2019-07-05T12:00:00</date-time> </dtend> <uid> <text>651b1341-26ca-11e4-8c21-0800200c9a66</text> </uid> <related-to> <uri>651b1341-26ca-11e4-8c21-0800200c9a66</uri> </related-to> <contact> <text>91095</text> </contact> <status> <text>CANCELLED</text> </status> <x-cancellation-reason> <text>Avlyst av innbygger</text> </x-cancellation-reason> <summary> <text>Reisevaksine</text> </summary> <description> <text>Siden du allerede har tatt dose 2, trenger du ikke denne timen</text> </description> </properties> <components/> </vevent> </components> </vcalendar> |
Generell info om meldingsutveksling med Helsenorge
For overordnet informasjon om meldingsutveksling med Helsenorge se her: Meldingsutveksling med Helsenorge og PVK
Ytterligere informasjon
Under er forskjellige typer supplerende informasjon
Eksempelmeldinger
<?xml version="1.0" encoding="UTF-8"?> <!-- Eksempel på bruk av hodemeldingen sammen med dialogmeldingen --> <MsgHead xmlns="http://www.kith.no/xmlstds/msghead/2006-05-24" xmlns:xsd="http://www.w3.org/2001/XMLSchema.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.kith.no/xmlstds/msghead/2006-05-24 ../../../sarepta/skjema/felleskomponenter/MsgHead-v1_2.xsd"> <MsgInfo> <Type V="DIALOG_INNBYGGER_AVTALEBESTILLING" DN="Dialog med innbygger - avtalebestilling"/> <MIGversion>v1.2 2006-05-24</MIGversion> <GenDate>2019-11-21T09:30:47.0Z</GenDate> <MsgId>ae53cf18-c834-4342-994c-387e5b80078c</MsgId> <Ack V="J" DN="Ja"/> <Sender> <Organisation> <OrganisationName>DIREKTORATET FOR E-HELSE</OrganisationName> <Ident> <Id>115851</Id> <TypeId V="HER" S="2.16.578.1.12.4.1.1.9051" DN="HER-id"/> </Ident> <Organisation> <OrganisationName>Digitale innbyggertjenester</OrganisationName> <Ident> <Id>8093248</Id> <TypeId V="HER" S="2.16.578.1.12.4.1.1.9051" DN="HER-id"/> </Ident> </Organisation> </Organisation> </Sender> <Receiver> <Organisation> <OrganisationName>Nanset legekontor</OrganisationName> <Ident> <Id>971318864</Id> <TypeId V="ENH" S="2.16.578.1.12.4.1.1.9051" DN="Organisasjonsnummeret i Enhetsregister"/> </Ident> <Ident> <Id>1234</Id> <TypeId V="HER" S="2.16.578.1.12.4.1.1.9051" DN="HER-id"/> </Ident> <HealthcareProfessional> <RoleToPatient V="6" S="2.16.578.1.12.4.1.1.9034" DN="Fastlege"/> <FamilyName>September</FamilyName> <GivenName>August</GivenName> <Ident> <Id>91095</Id> <TypeId V="HER" S="2.16.578.1.12.4.1.1.8116" DN="HER-id"/> </Ident> </HealthcareProfessional> </Organisation> </Receiver> <Patient> <FamilyName>Danser</FamilyName> <GivenName>Folke</GivenName> <Ident> <Id>13116900216</Id> <TypeId V="FNR" S="2.16.578.1.12.4.1.1.8116" DN="Fødselsnummer"/> </Ident> </Patient> </MsgInfo> <Document> <ContentDescription>Avbestill reservert time</ContentDescription> <RefDoc> <IssueDate V="2012-11-14T09:30:47.0Z"/> <MsgType V="XML" DN="XML-instans"/> <Content> <Dialogmelding xmlns="http://www.kith.no/xmlstds/dialog/2013-01-23" xmlns:fk1="http://www.kith.no/xmlstds/felleskomponent1" xsi:schemaLocation="http://www.kith.no/xmlstds/dialog/2013-01-23 ../../../sarepta/skjema/dialogmelding/2013-01-23/dialogmelding-v1.1.xsd"> <Foresporsel> <TypeForesp V="ART" S="2.16.578.1.12.4.1.1.7601" DN="Avbestill reservert time"/> <Sporsmal>Har blitt syk og kan ikke møte til timen.</Sporsmal> <KodetOpplysning V="2" S="2.16.578.1.12.4.1.1.1101" DN="Nei"/> </Foresporsel> </Dialogmelding> </Content> </RefDoc> </Document> <Document> <RefDoc> <MsgType V="XML" DN="XML-instans"/> <Description>iCalendarBestillTime</Description> <Content> <icalendar xmlns="urn:ietf:params:xml:ns:icalendar-2.0" xsi:schemaLocation="urn:ietf:params:xml:ns:icalendar-2.0 ../../../sarepta/skjema/felleskomponenter/iCalendar.xsd"> <vcalendar> <properties> <version> <text>2.0</text> </version> <prodid> <text>PAS EPJ</text> </prodid> </properties> <components> <vevent> <properties> <dtstart> <date-time>2019-07-05T11:45:00</date-time> </dtstart> <dtend> <date-time>2019-07-05T12:00:00</date-time> </dtend> <uid> <text>4088E990AD89CB3DBB484909</text> </uid> <related-to> <uri>651b1341-26ca-11e4-8c21-0800200c9a66</uri> </related-to> <contact> <text>91095</text> </contact> </properties> <components/> </vevent> </components> </vcalendar> </icalendar> </Content> </RefDoc> </Document> </MsgHead>
<?xml version="1.0" encoding="UTF-8"?> <!-- Eksempel på bruk av hodemeldingen sammen med dialogmeldingen --> <MsgHead xmlns="http://www.kith.no/xmlstds/msghead/2006-05-24" xmlns:xsd="http://www.w3.org/2001/XMLSchema.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.kith.no/xmlstds/msghead/2006-05-24 ../../../sarepta/skjema/felleskomponenter/MsgHead-v1_2.xsd"> <MsgInfo> <Type V="DIALOG_INNBYGGER_AVTALEBESTILLING" DN="Dialog med innbygger - avtalebestilling"/> <MIGversion>v1.2 2006-05-24</MIGversion> <GenDate>2019-05-21T11:21:00.0Z</GenDate> <MsgId>e6e2c36e-e6d3-4c75-9755-398a29b57e7e</MsgId> <Ack V="J" DN="Ja"/> <ConversationRef> <RefToParent>ae53cf18-c834-4342-994c-387e5b80078c</RefToParent> <RefToConversation>ae53cf18-c834-4342-994c-387e5b80078c</RefToConversation> </ConversationRef> <Sender> <Organisation> <OrganisationName>Nanset legekontor</OrganisationName> <Ident> <Id>971318864</Id> <TypeId V="ENH" S="2.16.578.1.12.4.1.1.9051" DN="Organisasjonsnummeret i Enhetsregister"/> </Ident> <Ident> <Id>1234</Id> <TypeId V="HER" S="2.16.578.1.12.4.1.1.9051" DN="HER-id"/> </Ident> <HealthcareProfessional> <RoleToPatient V="6" S="2.16.578.1.12.4.1.1.9034" DN="Fastlege"/> <FamilyName>September</FamilyName> <GivenName>August</GivenName> <Ident> <Id>91095</Id> <TypeId V="HER" S="2.16.578.1.12.4.1.1.8116" DN="HER-id"/> </Ident> </HealthcareProfessional> </Organisation> </Sender> <Receiver> <Organisation> <OrganisationName>DIREKTORATET FOR E-HELSE</OrganisationName> <Ident> <Id>115851</Id> <TypeId V="HER" S="2.16.578.1.12.4.1.1.9051" DN="HER-id"/> </Ident> <Organisation> <OrganisationName>Digitale innbyggertjenester</OrganisationName> <Ident> <Id>8093248</Id> <TypeId V="HER" S="2.16.578.1.12.4.1.1.9051" DN="HER-id"/> </Ident> </Organisation> </Organisation> </Receiver> <Patient> <FamilyName>Danser</FamilyName> <GivenName>Folke</GivenName> <Ident> <Id>13116900216</Id> <TypeId V="FNR" S="2.16.578.1.12.4.1.1.8116" DN="Fødselsnummer"/> </Ident> </Patient> </MsgInfo> <Document> <ContentDescription>Avbestilling bekreftet</ContentDescription> <RefDoc> <IssueDate V="2019-05-21T11:21:00.0Z"/> <MsgType V="XML" DN="XML-instans"/> <Content> <Dialogmelding xmlns="http://www.kith.no/xmlstds/dialog/2013-01-23" xsi:schemaLocation="http://www.kith.no/xmlstds/dialog/2013-01-23 ../../../sarepta/skjema/dialogmelding/2013-01-23/dialogmelding-v1.1.xsd"> <Notat> <TemaKodet V="08" S="2.16.578.1.12.4.1.1.7602" DN="Avbestilling av time bekreftet"/> </Notat> </Dialogmelding> </Content> </RefDoc> </Document> <Document> <RefDoc> <MsgType V="XML" DN="XML-instans"/> <Description>iCalendarBestillTime</Description> <Content> <icalendar xmlns="urn:ietf:params:xml:ns:icalendar-2.0" xsi:schemaLocation="urn:ietf:params:xml:ns:icalendar-2.0 ../../../sarepta/skjema/felleskomponenter/iCalendar.xsd"> <vcalendar> <properties> <version> <text>2.0</text> </version> <prodid> <text>PAS EPJ</text> </prodid> </properties> <components> <vevent> <properties> <dtstart> <date-time>2019-07-05T11:45:00</date-time> </dtstart> <dtend> <date-time>2019-07-05T12:00:00</date-time> </dtend> <uid> <text>651b1341-26ca-11e4-8c21-0800200c9a66</text> </uid> <related-to> <uri>651b1341-26ca-11e4-8c21-0800200c9a66</uri> </related-to> <contact> <text>91095</text> </contact> </properties> <components/> </vevent> </components> </vcalendar> </icalendar> </Content> </RefDoc> </Document> </MsgHead>
<?xml version="1.0" encoding="UTF-8"?> <!-- Eksempel på bruk av hodemeldingen sammen med dialogmeldingen --> <MsgHead xmlns="http://www.kith.no/xmlstds/msghead/2006-05-24" xmlns:xsd="http://www.w3.org/2001/XMLSchema.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.kith.no/xmlstds/msghead/2006-05-24 ../../../sarepta/skjema/felleskomponenter/MsgHead-v1_2.xsd"> <MsgInfo> <Type V="DIALOG_INNBYGGER_AVTALEBESTILLING" DN="Dialog med innbygger - avtalebestilling"/> <MIGversion>v1.2 2006-05-24</MIGversion> <GenDate>2019-05-21T11:21:00.0Z</GenDate> <MsgId>e6e2c36e-e6d3-4c75-9755-398a29b57e7e</MsgId> <Ack V="J" DN="Ja"/> <ConversationRef> <RefToParent>ae53cf18-c834-4342-994c-387e5b80078c</RefToParent> <RefToConversation>ae53cf18-c834-4342-994c-387e5b80078c</RefToConversation> </ConversationRef> <Sender> <Organisation> <OrganisationName>Nanset legekontor</OrganisationName> <Ident> <Id>971318864</Id> <TypeId V="ENH" S="2.16.578.1.12.4.1.1.9051" DN="Organisasjonsnummeret i Enhetsregister"/> </Ident> <Ident> <Id>1234</Id> <TypeId V="HER" S="2.16.578.1.12.4.1.1.9051" DN="HER-id"/> </Ident> <HealthcareProfessional> <RoleToPatient V="6" S="2.16.578.1.12.4.1.1.9034" DN="Fastlege"/> <FamilyName>September</FamilyName> <GivenName>August</GivenName> <Ident> <Id>91095</Id> <TypeId V="HER" S="2.16.578.1.12.4.1.1.8116" DN="HER-id"/> </Ident> </HealthcareProfessional> </Organisation> </Sender> <Receiver> <Organisation> <OrganisationName>DIREKTORATET FOR E-HELSE</OrganisationName> <Ident> <Id>115851</Id> <TypeId V="HER" S="2.16.578.1.12.4.1.1.9051" DN="HER-id"/> </Ident> <Organisation> <OrganisationName>Digitale innbyggertjenester</OrganisationName> <Ident> <Id>8093248</Id> <TypeId V="HER" S="2.16.578.1.12.4.1.1.9051" DN="HER-id"/> </Ident> </Organisation> </Organisation> </Receiver> <Patient> <FamilyName>Danser</FamilyName> <GivenName>Folke</GivenName> <Ident> <Id>13116900216</Id> <TypeId V="FNR" S="2.16.578.1.12.4.1.1.8116" DN="Fødselsnummer"/> </Ident> </Patient> </MsgInfo> <Document> <ContentDescription>Forespørsel avvist</ContentDescription> <RefDoc> <IssueDate V="2019-05-21T11:21:00.0Z"/> <MsgType V="XML" DN="XML-instans"/> <Content> <Dialogmelding xmlns="http://www.kith.no/xmlstds/dialog/2013-01-23" xsi:schemaLocation="http://www.kith.no/xmlstds/dialog/2013-01-23 ../../../sarepta/skjema/dialogmelding/2013-01-23/dialogmelding-v1.1.xsd"> <Notat> <TemaKodet V="09" S="2.16.578.1.12.4.1.1.7602" DN="Time kunne ikke avbestilles"/> </Notat> </Dialogmelding> </Content> </RefDoc> </Document> <Document> <RefDoc> <MsgType V="XML" DN="XML-instans"/> <Description>iCalendarBestillTime</Description> <Content> <icalendar xmlns="urn:ietf:params:xml:ns:icalendar-2.0" xsi:schemaLocation="urn:ietf:params:xml:ns:icalendar-2.0 ../../../sarepta/skjema/felleskomponenter/iCalendar.xsd"> <vcalendar> <properties> <version> <text>2.0</text> </version> <prodid> <text>PAS EPJ</text> </prodid> </properties> <components> <vevent> <properties> <dtstart> <date-time>2019-07-05T11:45:00</date-time> </dtstart> <dtend> <date-time>2019-07-05T12:00:00</date-time> </dtend> <uid> <text>4088E990AD89CB3DBB484909</text> </uid> <related-to> <uri>651b1341-26ca-11e4-8c21-0800200c9a66</uri> </related-to> <contact> <text>91095</text> </contact> </properties> <components/> </vevent> </components> </vcalendar> </icalendar> </Content> </RefDoc> </Document> </MsgHead>
Om brukeren kan avbestille timen
For å finne ut om "Avbestille time" knappen skal vise så gjøres det et kall mot backend; Timeadministrasjonsstotte.
Timeadministrasjon sjekker:
Om timen venter på svar for avbestilling eller endring, eller om avbestilling er avvist, da vil ikke bruker kunne avbestille timen på nytt.
Om kommunikasjonsprosessen til motpart her DIALOG_INNBYGGER_TIMERESERVASJON eller DIALOG_INNBYGGER_AVTALEAVBESTILLING. Om den har en av disse så vil bruker kunne avbestille timen.
Vi returnerer MessageFunction i kallet som inneholder den kommunikasjonsprossessen motpart har, der timereservasjon blir valgt over avtaleavbestilling. Denne blir sendt til avbestilling av time når man gjør dette kallet når man trykker på knappen og bestemmer hvilket kommunikasjon
Om timen ikke har motpart så sjekker man i databasen om timen har KanAvbestilles og eventuelt om den er innenfor dato når man kan avbestilles (gjerne en gitt tid før timen). Om man kan avbestille timen og datoen er innenfor så vil brukeren kunne avbestille timen.
- No labels