AMQP Timeendring

Ved bruk av prosessen timeendring kan 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 May 6, 2024
Status	Utvikling
API-dokumentasjon sist endret	May 6, 2024
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): Dialogmelding/Foresporsel/TypeForesp Lovlige kodeverdier som kan brukes i TypeForesp: OET Ønske om endring av time Valgfrie elementer (klasse/element): Dialogmelding/Foresporsel/EmneSporsmal Dialogmelding/Foresporsel/Sporsmal 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 dtstart: starttidspunkt for gjeldende time dtend: slutttidspunkt for gjeldende time uid: id for avtale contact: HER-id som administrerer avtalen 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: Elementet «RefToParent» skal referere til forrige melding i dialog Elementet «RefToConversation» skal referere til første melding i dialogen `<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): Dialogmelding/Notat/Temakodet Elementet Dialogmelding/Notat/Foresporsel benyttes ikke i svarmelding. Lovlige kodeverdier som kan brukes i Dialogmelding/Notat/Temakodet: 07 Endring av time bekreftet 34 Time kunne ikke endres 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>: 26 Forespørsel avvist 30 Ikke tilgang. Benyttes dersom innbygger ikke har tilgang til tjenesten digitalt Valgfrie elementer (klasse/element): Dialogmelding/Notat/TekstNotatInnhold 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

Dato	Endring
Mai 2024	Første utkast publisert