Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

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

 Prosess og sekvensdiagram

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.

 Struktur på forespørsel

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:

<xcal:icalendar xsi:schemaLocation="urn:ietf:params:xml:ns:icalendar-2.0 iCalendar.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xcal="urn:ietf:params:xml:ns:icalendar-2.0">
	<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>2024-01-05T10:15:00</xcal:date-time>
					</xcal:dtstart>
					<xcal:dtend>
						<xcal:date-time>2024-01-05T10:30:00</xcal:date-time>
					</xcal:dtend>
					<xcal:uid>
						<xcal:text>c5988ec5-3873-4c93-8b31-fce14f58ac07</xcal:text>
					</xcal:uid>
					<xcal:contact>
						<xcal:text>8139301</xcal:text>
					</xcal:contact>
				</xcal:properties>
				<xcal:components/>
			</xcal:vevent>
		</xcal:components>
	</xcal:vcalendar>
</xcal: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

 Struktur på svar

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 DN="Endring av time bekreftet" V="07" S="2.16.578.1.12.4.1.1. 7602" /> 
</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.

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

 Forespørsel fra innbygger - Ønske om endring av time
<?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 ../../../sarepta/skjema/felleskomponenter/MsgHead-v1_2.xsd">
	<MsgInfo>
		<Type V="DIALOG_INNBYGGER_TIMEONSKE" DN="Dialog med innbygger - timeønske"/>
		<MIGversion>v1.2 2006-05-24</MIGversion>
		<GenDate>2019-05-16T07:08:11.0Z</GenDate>
		<MsgId>9277ad96-a664-42d0-90bf-e6130206b33a</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>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 time</ContentDescription>
		<RefDoc>
			<IssueDate V="2019-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 ../../../sarepta/skjema/dialogmelding/2013-01-23/dialogmelding-v1.1.xsd">
					<Foresporsel>
						<TypeForesp V="OT" S="2.16.578.1.12.4.1.1.7601" DN="Ønske om time"/>
						<Sporsmal>Jeg ønsker time helst torsdag formiddag, alternativt fredag etter kl 1300. Har slitt med langvarig tørrhost som jeg ønsker å få undersøkt.</Sporsmal>
						<KodetOpplysning V="1" S="2.16.578.1.12.4.1.1.1101" DN="Ja"/>
					</Foresporsel>
				</Dialogmelding>
			</Content>
		</RefDoc>
	</Document>
</MsgHead>
 Svar helsepersonell - Endring bekreftet
<?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 ../../../sarepta/skjema/felleskomponenter/MsgHead-v1_2.xsd">
	<MsgInfo>
		<Type V="DIALOG_INNBYGGER_TIMEONSKE" DN="Dialog med innbygger - timeønske"/>
		<MIGversion>v1.2 2006-05-24</MIGversion>
		<GenDate>2019-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>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>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 time</ContentDescription>
		<RefDoc>
			<IssueDate V="2019-05-16T10:01:24.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="05" S="2.16.578.1.12.4.1.1.7602" DN="Timereservasjon bekreftet"/>
						<TekstNotatInnhold>Du har fått time Torsdag kl 11:45.</TekstNotatInnhold>
					</Notat>
				</Dialogmelding>
			</Content>
		</RefDoc>
	</Document>
	<Document>
		<RefDoc>
			<IssueDate V="2019-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 ../../../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-05-23T11:45:00</date-time>
									</dtstart>
									<dtend>
										<date-time>2019-05-23T12: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>
 Svar helsepersonell - Time kunne ikke endres
<?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 ../../../sarepta/skjema/felleskomponenter/MsgHead-v1_2.xsd">
	<MsgInfo>
		<Type V="DIALOG_INNBYGGER_TIMEONSKE" DN="Dialog med innbygger - timeønske"/>
		<MIGversion>v1.2 2006-05-24</MIGversion>
		<GenDate>2019-05-23T09:30:47.0Z</GenDate>
		<MsgId>f3aebfe0-81b4-45b1-9b0b-0c8070a50de0</MsgId>
		<Ack V="J" DN="Ja"/>
		<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>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 time</ContentDescription>
		<RefDoc>
			<IssueDate V="2019-05-23T09:30:47.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"/>
						<TekstNotatInnhold>Det er svært viktig at du likevel møter opp til timen.</TekstNotatInnhold>
					</Notat>
				</Dialogmelding>
			</Content>
		</RefDoc>
	</Document>
	<Document>
		<RefDoc>
			<IssueDate V="2019-05-23T09:30:12"/>
			<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 ../../../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-06-06T11:45:00</date-time>
									</dtstart>
									<dtend>
										<date-time>2014-06-06T12:00:00</date-time>
									</dtend>
									<categories>
										<text>Konsultasjon</text>
									</categories>
									<uid>
										<text>37151045-713f-433c-a9f3-ef52bcdeb904</text>
									</uid>
									<contact>
										<text>910952</text>
									</contact>
									<related-to>
										<uri>64507c1c-1fbc-4caa-8407-822bda886570</uri>
									</related-to>
								</properties>
								<components/>
							</vevent>
						</components>
					</vcalendar>
				</icalendar>
			</Content>
		</RefDoc>
	</Document>

</MsgHead>

Generell info om meldingsutveksling med Helsenorge

For overordnet informasjon om meldingsutveksling med Helsenorge se her: Meldingsutveksling med Helsenorge

Endringslogg

 Click here to expand...

Dato

Endring

Mai 2024

Første utkast publisert

  • No labels