AMQP Behandleroversikt

Prosessen behandleroversikt kan benyttes for å vise tilgjengelige behandlere fra en kommunikasjonspart til innbygger. Dersom det finnes aktuelle behandlere skal EPJ-systemet svare tilbake med en liste med disse, alternativt svare med en kode som angir at det ikke fantes noen behandlere.

Det er innført en versjon 1.1 av meldingstypen der alle behandlere som er tilgjengelig skal sendes i responsen og som skal tas i bruk av nye aktører.

Sekvensdiagram for meldingstypen er vist i figuren under:

API-navn	DIALOG_INNBYGGER_BEHANDLEROVERSIKT
Funksjonelt område	Dialog
API-versjon og dato publisert	v1.1 Oct 25, 2024
Status	I Drift
API-dokumentasjon sist endret	Mar 28, 2025
Teknologi	AMQP

Følgende prosess skal aktiveres i adresseregisteret for å støtte funksjonaliteten.

Prosess	Funksjonalitet	Versjon
Dialog_Innbygger_BehandlerOversikt	Basisversjon for kommunikasjonsprosess	1.0
Dialog_Innbygger_BehandlerOversikt	Oppdatert versjon der fastlegen også sendes i respons og ikke blir lagt til default av Helsenorge. En ny versjon er nødvendig slik at Helsenorge vet om fastlege skal legges til eller ikke.	1.1

Tabellen under viser hvilke roller som inngår i prosessen, hvilke funksjoner de ulike rollene kan gjøre og hvilke meldinger som benyttes.

Versjon	Rolle	Funksjon	Meldingsinnhold
1.0	Innbygger	Hent	Dialogmelding 1.1 Pasientrelasjon
1.0	Helsepersonell	Svar	Dialogmelding 1.1 Helsepersonell
1.1	Innbygger	Hent	Dialogmelding 1.1 Pasientrelasjon
1.1	Helsepersonell	Svar	Dialogmelding 1.1 Helsepersonell

Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

Forespørsel om Behandleroversikt

Tjeneste	Forespørsel om behandleroversikt, synkron tjeneste
Bruksområde	Forespørsel fra helsenorge.no for å hente aktuelle behandlere for en innbygger.
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: `<Type V="DIALOG_INNBYGGER_BEHANDLEROVERSIKT" DN="Dialog med innbygger – behandleroversikt />` Obligatorisk verdi i MsgHead/MsgInfo/Ack er: `<Ack DN="Nei" V="N"/>`
Dialogmelding	Obligatoriske elementer (klasse/element): Dialogmelding/Foresporsel/TypeForesp Lovlige kodeverdier som kan brukes i TypeForesp: HB Hent behandler XML eksempel: `<Foresporsel> <TypeForesp V="HB" DN="Hent behandlere" ="2.16.578.1.12.4.1.1.7601"/> </Foresporsel>` RollerRelatertNotat Ikke aktuelt å bruke for denne tjenesten
iCalender	Ikke aktuelt å bruke for denne tjenesten
Helsepersonell	Ikke aktuelt å bruke for denne tjenesten
Pasientrelasjon	Obligatorisk informasjon når en annen person henter behandlere på vegne av pasient. Se Pasientrelasjon for korrekt bruk.
Vedlegg	Ikke aktuelt å bruke for denne tjenesten

Svar på Behandleroversikt

Tjeneste	Svar på forespørsel om hent behandlere, synkron tjeneste
Bruksområde	Svar fra kommunikasjonspart med aktuelle behandlere som finnes for en innbygger for tjenesten angitt i hodemeldingen. Dersom ingen behandlere finnes skal kode for dette returneres. Dersom det returneres behandlere skal også fastlegen returneres som del av listen.
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: `<Type V="DIALOG_INNBYGGER_BEHANDLEROVERSIKT" DN="Dialog med innbygger – behandleroversikt />` Obligatorisk verdi i MsgHead/MsgInfo/Ack er: `<Ack DN="Nei" V="N"/>`
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: 20 Behandlere 21 Behandlere ikke funnet 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>: 30 Ikke tilgang 31 Generell feil XML eksempel: `<Notat> <TemaKodet DN="Behandlere" V="20" S="2.16.578.1.12.4.1.1. 7602"/> </Notat>` RollerRelatertNotat Ikke aktuelt å bruke for denne tjenesten
iCalender	Ikke aktuelt å bruke for denne tjenesten
Helsepersonell	Obligatorisk informasjon dersom koden «20 Behandler» returneres: Obligatoriske elementer (klasse/element): FamiliyName GivenName Ident Valgfrie elementer (klasse/element): Kan benyttes til å sende fritekstinformasjon som vises til innbygger Angis med kodeverk 9060 og vises i brukerflaten i helsenorge Angis med kodeverk 9034 og vises i brukerflaten i helsenorge XML eksempel: <hcp:HelsepersonelListe > <hcp:Helsepersonell> <hcp:Helsepersonell> <fk1:TypeHealthcareProfessional DN="Lege" V="LE"/> <fk1:RoleToPatient DN="Vikar for fastlege" V="15" S="2.16.578.1.12.4.1.1.9034"/> <fk1:FamilyName>Koman</fk1:FamilyName> <fk1:GivenName>Magnar</fk1:GivenName> <fk1:Ident> <fk1:Id>9144889</fk1:Id> <fk1:TypeId DN="HPR-nummer" V="HPR" S="2.16.578.1.12.4.1.1.8116"/> </fk1:Ident> </hcp:Helsepersonell> <hcp:Merknad>Vikar til 1.5.2019</hcp:Merknad> </hcp:Helsepersonell> <hcp:Helsepersonell> <hcp:Helsepersonell> <fk1:TypeHealthcareProfessional DN="Sykepleier" V="SP"/> <fk1:RoleToPatient DN="Kontakt i primærhelseteam" V="22" S="2.16.578.1.12.4.1.1.9034"/> <fk1:FamilyName>Olsen</fk1:FamilyName> <fk1:GivenName>Arne</fk1:GivenName> <fk1:Ident> <fk1:Id>9144890</fk1:Id> <fk1:TypeId DN="HPR-nummer" V="HPR" S="2.16.578.1.12.4.1.1.8116"/> </fk1:Ident> </hcp:Helsepersonell> <hcp:Merknad>Jobber mandag og onsdag</hcp:Merknad> </hcp:Helsepersonell> </hcp:HelsepersonelListe>
Pasientrelasjon	Ikke aktuelt å bruke for denne tjenesten
Vedlegg	Ikke aktuelt å bruke for denne tjenesten

Ytterligere informasjon

Under er forskjellige typer supplerende informasjon

Eksempelmeldinger

<?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_BEHANDLEROVERSIKT" DN="Dialog med innbygger – behandleroversikt"/>
		<MIGversion>v1.2 2006-05-24</MIGversion>
		<GenDate>2019-05-16T16:12:20.0Z</GenDate>
		<MsgId>4297ae33-92a8-4614-be15-0f61dd453bdf</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>8130047</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" DN="Fastlege" S="2.16.578.1.12.4.1.1.9034"/>
					<FamilyName>September</FamilyName>
					<GivenName>August</GivenName>
					<Ident>
						<Id>1234</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>Hent behandlere</ContentDescription>
		<RefDoc>
			<IssueDate V="2019-05-16T16:12:15.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="HB" S="2.16.578.1.12.4.1.1.7601" DN="Hent behandlere"/>
					</Foresporsel>
				</Dialogmelding>
			</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 ../../../sarepta/skjema/felleskomponenter/MsgHead-v1_2.xsd">
	<MsgInfo>
		<Type V="DIALOG_INNBYGGER_BEHANDLEROVERSIKT" DN="Dialog med innbygger – behandleroversikt"/>
		<MIGversion>v1.2 2006-05-24</MIGversion>
		<GenDate>2019-05-16T16:12:23.0Z</GenDate>
		<MsgId>f4f6a4bd-47cd-459a-af6e-b49ef8c4ee08</MsgId>
		<Ack V="J" DN="Ja"/>
		<ConversationRef>
			<RefToParent>4297ae33-92a8-4614-be15-0f61dd453bdf</RefToParent>
			<RefToConversation>4297ae33-92a8-4614-be15-0f61dd453bdf</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" DN="Fastlege" S="2.16.578.1.12.4.1.1.9034"/>
					<FamilyName>September</FamilyName>
					<GivenName>August</GivenName>
					<Ident>
						<Id>1234</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>8130047</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>Liste over behandlere</ContentDescription>
		<RefDoc>
			<IssueDate V="2019-05-16T16:12:22.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="21" S="2.16.578.1.12.4.1.1.7602" DN="Behandlere ikke funnet"/>
					</Notat>
				</Dialogmelding>
			</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 ../../../sarepta/skjema/felleskomponenter/MsgHead-v1_2.xsd">
	<MsgInfo>
		<Type V="DIALOG_INNBYGGER_BEHANDLEROVERSIKT" DN="Dialog med innbygger – behandleroversikt"/>
		<MIGversion>v1.2 2006-05-24</MIGversion>
		<GenDate>2019-05-16T16:12:23.0Z</GenDate>
		<MsgId>f4f6a4bd-47cd-459a-af6e-b49ef8c4ee08</MsgId>
		<Ack V="J" DN="Ja"/>
		<ConversationRef>
			<RefToParent>4297ae33-92a8-4614-be15-0f61dd453bdf</RefToParent>
			<RefToConversation>4297ae33-92a8-4614-be15-0f61dd453bdf</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" DN="Fastlege" S="2.16.578.1.12.4.1.1.9034"/>
					<FamilyName>September</FamilyName>
					<GivenName>August</GivenName>
					<Ident>
						<Id>1234</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>8130047</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>Liste over behandlere</ContentDescription>
		<RefDoc>
			<IssueDate V="2019-05-16T16:12:22.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="21" S="2.16.578.1.12.4.1.1.7602" DN="Behandlere"/>
					</Notat>
				</Dialogmelding>
			</Content>
		</RefDoc>
	</Document>
	<Document>
		<RefDoc>
			<IssueDate V="2019-05-16T16:12:22.0Z"/>
			<MsgType V="XML" DN="XML-instans"/>
			<Description>Helsepersonelliste</Description>
			<Content>
				<HelsepersonelListe xmlns="http://www.kith.no/xmlstds/helsepersonell/2015-05-04" xmlns:fk1="http://www.kith.no/xmlstds/felleskomponent1" xsi:schemaLocation="http://www.kith.no/xmlstds/helsepersonell/2015-05-04 ../../../sarepta/skjema/felleskomponenter/helsepersonell-2015-05-04.xsd">
					<Helsepersonell>
						<Helsepersonell>
							<fk1:RoleToPatient V="15" S="2.16.578.1.12.4.1.1.9034" DN="Vikar for fastlege"/>
							<fk1:FamilyName>Fastlegesen</fk1:FamilyName>
							<fk1:GivenName>Magnar</fk1:GivenName>
							<fk1:Ident>
								<fk1:Id>941102</fk1:Id>
								<fk1:TypeId V="HPR" S="2.16.578.1.12.4.1.1.8116" DN="HPR-nummer"/>
							</fk1:Ident>
						</Helsepersonell>
						<Merknad>Vikarierer for fastlege August September hver onsdag frem til 1. juli 2015.</Merknad>
					</Helsepersonell>
					<Helsepersonell>
						<Helsepersonell>
							<fk1:RoleToPatient V="16" S="2.16.578.1.12.4.1.1.9034" DN="Turnuslege"/>
							<fk1:FamilyName>Turnuslegesen</fk1:FamilyName>
							<fk1:GivenName>Rita</fk1:GivenName>
							<fk1:Ident>
								<fk1:Id>941101</fk1:Id>
								<fk1:TypeId V="HPR" S="2.16.578.1.12.4.1.1.8116" DN="HPR-nummer"/>
							</fk1:Ident>
						</Helsepersonell>
						<Merknad>Er turnuskandidat på legekontoret frem til 1. september 2015.</Merknad>
					</Helsepersonell>
					<Helsepersonell>
						<Helsepersonell>
							<fk1:TypeHealthcareProfessional V="SP" DN="Sykepleier"/>
							<fk1:RoleToPatient V="22" S="2.16.578.1.12.4.1.1.9034" DN="Kontakt i primærhelseteam"/>
							<fk1:FamilyName>Sykepleier</fk1:FamilyName>
							<fk1:GivenName>Arne</fk1:GivenName>
							<fk1:Ident>
								<fk1:Id>9134190</fk1:Id>
								<fk1:TypeId V="HPR" S="2.16.578.1.12.4.1.1.8116" DN="HPR-nummer"/>
							</fk1:Ident>
						</Helsepersonell>
						<Merknad>Jobber mandag og onsdag</Merknad>
					</Helsepersonell>
				</HelsepersonelListe>
			</Content>
		</RefDoc>
	</Document>
</MsgHead>

Generell info om meldingsutveksling med Helsenorge

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