- Created by kjetill.vassmo.lund, last modified on May 08, 2024
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 7 Current »
Ved bruk av prosessen timeendringkan innbygger be om endring av en time hos en helsekontakt.
API-navn | DIALOG_INNBYGGER_TIMEENDRING |
---|---|
Funksjonelt område | Dialog |
API-versjon og dato publisert | v1.1 |
Status | Utvikling |
API-dokumentasjon sist endret |
|
Teknologi | AMQP |
Kommunikasjonsprosess
Følgende prosess skal aktiveres i adresseregisteret for å støtte funksjonaliteten.
Prosess | Funksjonalitet | Versjon |
Dialog_Innbygger_Timeendring | Første versjon av dialogbasert ønske om endring av timeavtale | 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 | ØnskeEndring | Dialogmelding 1.1 Pasientrelasjon iCal |
Helsepersonell | Avtale | Dialogmelding 1.1 iCal |
Sekvensdiagram for ønske om time er vist i figuren under.
Se ytterligere detaljer i innholdsstandarder for innhold i meldinger
Forespørsel fra innbygger
Innbygger kommer med et ønske om endring av en timeavtale.
Tjeneste | Forespørsel om timeendring, asynkron tjeneste |
Bruksområde | Brukes når innbygger har ønske en endring av en timeavtale |
Hodemelding | Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: <Type V="DIALOG_INNBYGGER_TIMEENDRING" DN="Dialog med innbygger - timeendring"/> Obligatorisk verdi i MsgHead/MsgInfo/Ack er: <Ack DN="Ja" V="J"/> |
Dialogmelding | Obligatoriske elementer (klasse/element):
Lovlige kodeverdier som kan brukes i TypeForesp:
Valgfrie elementer (klasse/element):
XML eksempel: <Foresporsel> <TypeForesp V="OET" DN=" Ønske om endring av time" S="2.16.578.1.12.4.1.1. 7601"/> <Sporsmal>Timen på tirsdag kolliderer med en annen avtale. Kan jeg få en avtale på onsdag?</Sporsmal> </Foresporsel> RollerRelatertNotat Benyttes ikke. Timeønske sendes alltid til tjeneste angitt i hodemeldingen (fastlege eller annen tjeneste) |
iCalender | Inneholder Id til timeavtalen som skal endres
XML eksempel: <icalendar xmlns="urn:ietf:params:xml:ns:icalendar-2.0" xsi:schemaLocation="urn:ietf:params:xml:ns:icalendar-2.0 iCalendar.xsd"> <vcalendar> <properties> <version> <text>2.0</text> </version> <prodid> <text>PAS-EPJ</text> </prodid> </properties> <components> <vevent> <properties> <dtstart> <date-time>2024-05-23T11:45:00</date-time> </dtstart> <dtend> <date-time>2024-05-23T12:00:00</date-time> </dtend> <categories> <text>Konsultasjon</text> </categories> <uid> <text>915c0b2a-fb5c-427e-9620-14a3e6ec9a3e</text> </uid> <contact> <text>91095</text> </contact> </properties> <components/> </vevent> </components> </vcalendar> </icalendar> |
Helsepersonell | Ikke aktuelt å bruke for denne tjenesten. |
Pasientrelasjon | Obligatorisk informasjon når en annen person enn pasient ber om timeendring på vegne av pasient. Se Pasientrelasjon for korrekt bruk. |
Vedlegg | Ikke aktuelt å bruke for denne tjenesten. |
Svar fra helsekontakt
Tjeneste | Svar på forespørsel om timeønske, asynkron tjeneste |
Bruksområde | Svar på endring av time |
Hodemelding | Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: <Type V="DIALOG_INNBYGGER_TIMEENDRING" DN="Dialog med innbygger - timeendring"/> Obligatorisk verdi i MsgHead/MsgInfo/Ack er: <Ack DN="Ja" V="J"/> Meldinger som inngår i en samtaletråd skal refereres til hverandre ved hjelp av MsgHead/MsgInfo/ConversationRef på følgende måte:
<ConversationRef> <RefToParent>ae53cf18-c834-4342-994c-387e5b80078c</RefToParent> <RefToConversation>ae53cf18-c834-4342-994c-387e5b80078c</RefToConversation> </ConversationRef> Dette skal benyttes i tilfeller der det sendes et svar på et timeønske. |
Dialogmelding | Obligatoriske elementer (klasse/element):
Elementet Dialogmelding/Notat/Foresporsel benyttes ikke i svarmelding.
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>:
Valgfrie elementer (klasse/element):
XML eksempel: <Notat> <TemaKodet V="07" S="2.16.578.1.12.4.1.1.7602" DN="Endring av time bekreftet"/> <TekstNotatInnhold>Du har fått time onsdag kl 11:45.</TekstNotatInnhold> </Notat> RollerRelatertNotat Valgfritt, benyttes i henhold til Dialogmelding under RollerRelatertNotat. RollerRelatertNotat angir helsepersonellet som besvarte meldingen og gir mulighet til å angi hvem som besvarer XML-eksempel: <RollerRelatertNotat> <RoleToPatient V="16" DN="Turnuslege" S="2.16.578.1.12.4.1.1.9034" /> <HealthcareProfessional> <FamilyName>Lin</FamilyName> <GivenName>Rita</GivenName> <Ident> <Id>9144900</Id> <TypeId V="HPR" DN="HPR-nummer" S="2.16.578.1.12.4.1.1.8116" /> </Ident> </HealthcareProfessional> </RollerRelatertNotat> |
iCalender | Obligatorisk når timeavtalen er oppdatert. Dersom timen ikke kunne endres eller forespørsel avvises, skal ical element ikke sendes og timeavtalen i Helsenorge er uendret. XML eksempel: <xcal:vcalendar> <xcal:properties> <xcal:version> <xcal:text>2.0</xcal:text> </xcal:version> <xcal:prodid> <xcal:text>System NN</xcal:text> </xcal:prodid> </xcal:properties> <xcal:components> <xcal:vevent> <xcal:properties> <xcal:dtstart> <xcal:date-time>2012-12-12T09:45:00</xcal:date-time> </xcal:dtstart> <xcal:dtend> <xcal:date-time>2012-12-12T10:00:00</xcal:date-time> </xcal:dtend> <xcal:uid> <xcal:text>4088E990AD89CB3DBB484909</xcal:text> </xcal:uid> <xcal:contact> <xcal:text>91095 </xcal:text> </xcal:contact> <xcal:related-to> <xcal:uri>651b1341-26ca-11e4-8c21-0800200c9a66</xcal:uri> </xcal:related-to></xcal:properties> <xcal:components /> </xcal:vevent> </xcal:components> </xcal:vcalendar> |
Helsepersonell | Ikke aktuelt å bruke for denne tjenesten. |
Pasientrelasjon | Ikke aktuelt å bruke for denne tjenesten. |
Vedlegg | Ikke aktuelt å bruke for denne tjenesten. |
Eksempelmeldinger
Eksempelmeldinger er angitt under
<?xml version="1.0" encoding="UTF-8"?> <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 MsgHead-v1_2.xsd"> <MsgInfo> <Type V="DIALOG_INNBYGGER_TIMEENDRING" DN="Dialog med innbygger - timeendring"/> <MIGversion>v1.2 2006-05-24</MIGversion> <GenDate>2024-05-16T07:08:11.0Z</GenDate> <MsgId>9277ad96-a664-42d0-90bf-e6130206b33a</MsgId> <Ack V="J" DN="Ja"/> <Sender> <Organisation> <OrganisationName>Norsk helsenett SF</OrganisationName> <Ident> <Id>112374</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>109989</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>Line</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>Ønske om endring av time</ContentDescription> <RefDoc> <IssueDate V="2024-05-16T07:08:11.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 dialogmelding-v1.1.xsd"> <Foresporsel> <TypeForesp V="OET" S="2.16.578.1.12.4.1.1.7601" DN=" Ønske om endring av time" /> <Sporsmal>Timen på tirsdag kolliderer med en annen avtale. Kan jeg få en avtale på onsdag?</Sporsmal> </Foresporsel> </Dialogmelding> </Content> </RefDoc> </Document> <Document> <RefDoc> <IssueDate V="2024-05-16T10:01:24.0Z"/> <MsgType V="XML" DN="XML-instans"/> <MimeType>application/iCalendar</MimeType> <Description>iCalendarEndreTime</Description> <Content> <icalendar xmlns="urn:ietf:params:xml:ns:icalendar-2.0" xsi:schemaLocation="urn:ietf:params:xml:ns:icalendar-2.0 iCalendar.xsd"> <vcalendar> <properties> <version> <text>2.0</text> </version> <prodid> <text>PAS-EPJ</text> </prodid> </properties> <components> <vevent> <properties> <dtstart> <date-time>2024-05-23T11:45:00</date-time> </dtstart> <dtend> <date-time>2024-05-23T12:00:00</date-time> </dtend> <categories> <text>Konsultasjon</text> </categories> <uid> <text>915c0b2a-fb5c-427e-9620-14a3e6ec9a3e</text> </uid> <contact> <text>91095</text> </contact> </properties> <components/> </vevent> </components> </vcalendar> </icalendar> </Content> </RefDoc> </Document> </MsgHead>
<?xml version="1.0" encoding="UTF-8"?> <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 MsgHead-v1_2.xsd"> <MsgInfo> <Type V="DIALOG_INNBYGGER_TIMEENDRING" DN="Dialog med innbygger - timeendring"/> <MIGversion>v1.2 2006-05-24</MIGversion> <GenDate>2024-05-16T10:01:24.0Z</GenDate> <MsgId>17e47224-9644-4bbb-ab1c-0769358eeb30</MsgId> <Ack V="J" DN="Ja"/> <ConversationRef> <RefToParent>9277ad96-a664-42d0-90bf-e6130206b33a</RefToParent> <RefToConversation>9277ad96-a664-42d0-90bf-e6130206b33a</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>Norsk helsenett SF</OrganisationName> <Ident> <Id>112374</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>109989</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>Line</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>Svar på ønske om endring av time</ContentDescription> <RefDoc> <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 dialogmelding-v1.1.xsd"> <Notat> <TemaKodet V="07" S="2.16.578.1.12.4.1.1.7602" DN="Endring av time bekreftet"/> <TekstNotatInnhold>Du har fått time onsdag kl 11:45.</TekstNotatInnhold> </Notat> </Dialogmelding> </Content> </RefDoc> </Document> <Document> <RefDoc> <MsgType V="XML" DN="XML-instans"/> <MimeType>application/iCalendar</MimeType> <Description>iCalendarEndreTime</Description> <Content> <icalendar xmlns="urn:ietf:params:xml:ns:icalendar-2.0" xsi:schemaLocation="urn:ietf:params:xml:ns:icalendar-2.0 iCalendar.xsd"> <vcalendar> <properties> <version> <text>2.0</text> </version> <prodid> <text>PAS-EPJ</text> </prodid> </properties> <components> <vevent> <properties> <dtstart> <date-time>2024-05-22T11:45:00</date-time> </dtstart> <dtend> <date-time>2019-05-22T12:00:00</date-time> </dtend> <categories> <text>Konsultasjon</text> </categories> <uid> <text>915c0b2a-fb5c-427e-9620-14a3e6ec9a3e</text> </uid> <contact> <text>910952</text> </contact> </properties> <components/> </vevent> </components> </vcalendar> </icalendar> </Content> </RefDoc> </Document> </MsgHead>
<?xml version="1.0" encoding="UTF-8"?> <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 MsgHead-v1_2.xsd"> <MsgInfo> <Type V="DIALOG_INNBYGGER_TIMEENDRING" DN="Dialog med innbygger - timeendring"/> <MIGversion>v1.2 2006-05-24</MIGversion> <GenDate>2024-05-16T10:01:24.0Z</GenDate> <MsgId>17e47224-9644-4bbb-ab1c-0769358eeb30</MsgId> <Ack V="J" DN="Ja"/> <ConversationRef> <RefToParent>9277ad96-a664-42d0-90bf-e6130206b33a</RefToParent> <RefToConversation>9277ad96-a664-42d0-90bf-e6130206b33a</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>Norsk helsenett SF</OrganisationName> <Ident> <Id>112374</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>109989</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>Line</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>Svar på ønske om endring av time</ContentDescription> <RefDoc> <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 dialogmelding-v1.1.xsd"> <Notat> <TemaKodet V="34" S="2.16.578.1.12.4.1.1.7602" DN="Time kunne ikke endres"/> <TekstNotatInnhold>Vi har ingen ledige timer onsdag. Du kan få en time torsdag 13:45, ønsker du denne timen isteden?.</TekstNotatInnhold> </Notat> </Dialogmelding> </Content> </RefDoc> </Document> </MsgHead>
Generell info om meldingsutveksling med Helsenorge
For overordnet informasjon om meldingsutveksling med Helsenorge se her: Meldingsutveksling med Helsenorge
Endringslogg
Dato | Endring |
---|---|
Mai 2024 | Første utkast publisert |
|
|
|
|
- No labels