Book Creator
Add this page to your book

Book Creator
Remove this page from your book

This is an old revision of the document!

Indhold i FMK adviseringer

Indholdet i adviseringer vil i så høj grad som muligt indeholde information, der gør det muligt at identificere hvilket element der er ændret (medicinkort, lægemiddelordination, receptordination, effektuering) samt eventuelle versionsnumre.

XML skemaer for indhold i adviseringer

Hent Advis skemaer fra Github

Adviseringer for patienter med eCPR

I forbindelse med FMK's integration af eCPR, er der blevet indført en ny IDType som vil kunne anvendes alle steder hvor der idag bliver brug id typen for CPR numre:

IDType = http://nsi.dk/advis/v10/X-eCPR

og samtidig er alle advis skema'er for adviseringer for ændringer på Medicinkort, Bestillinger, Patient-Organisations-Relationer, Ændrede patientdata, Recepter og Manglende advis blevet samlet i et nyt namespace: http://www.dkma.dk/medicinecard/xml.schema/2019/06/01 . Abonnerer et klientsystem på topics i 2019/06/01 namespacet, vil alle adviseringer vedr. såvel CPR- som eCPR personer blive modtaget. Abonneres på topics i 2012/06/01 namespacet, modtages kun adviseringer vedr CPR-personer, da de gamle skemaer ikke tillader indhold med eCPR numre. Advis'er bliver altså til en vis grad udsendt dobbelt men for forskellige topics. Man skal altså ikke abonnere på adviser i begge namespaces for at modtage både eCPR og CPR adviseringer, men kun den nye version.

Ændringer direkte på medicinkortet

Ændringer direkte på medicinkortet sker ved suspendering m.v. og medicinafstemning. I indholdet for adviseringen fremgår handlingen i Action-elementet, og patientens CPR-nummer og medicinkortets versionsnummer findes i MedicineCard-elementet.

Topic for adviseringer, CPR og eCPR: http://www.sundhedsdata.dk/fmk/2019/06/01:MedicineCardUpdated

Handling på medicinkortet	Indhold i Action-elementet	Indhold i Action-elementet 2019/06/01
Suspendering af medicinkortet	MedicineCardSuspended	(Forekommer ikke)
Gensuspendering af medicinkortet	MedicineCardResuspended	(Forekommer ikke)
Ophæv suspendering af medicinkortet	MedicineCardUnsuspended	(Forekommer ikke)
Ajourføring af medicinkortet	MedicineCardReviewed	MedicineCardReviewed
Markering af medicinkortet ikke er ajourført	MedicineCardNotReviewed	MedicineCardNotReviewed
Ugyldig-markering af medicinkort	MedicineCardInvalidated	MedicineCardInvalidated
Ophæv ugyldig-markering af medicinkort	MedicineCardInvalidCleared	MedicineCardInvalidCleared

Eksempel - suspendering af medicinkortet

I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.sundhedsdata.dk/fmk/2019/06/01”.

<MedicineCardModification>
	<Action>MedicineCardSuspended</Action>
	<MedicineCard>
		<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
		<Version>1341404077658001002</Version>
	</MedicineCard>
</MedicineCardModification>

Ændringer af lægemiddelordinationen

Ændringer direkte af lægemiddelordination sker ved oprettelse, ændring, pausering og seponering af en del patientens medicinering, som fremgår af lægemiddelordinationen. Igen fremgår handlingen i Actionelementet, patientens CPR-nummer og medicinkortets versionsnummer findes i MedicineCard-elementet, og id og versionsnummer for lægemiddelordinationen findes i DrugMedication-elementet.

Topic for adviseringer, CPR og eCPR: http://www.sundhedsdata.dk/fmk/2019/06/01:MedicineCardUpdated

Handling på lægemiddelordinationen	Indhold i Action-elementet
Oprettelse lægemiddelordination	DrugMedicationCreated
Opdatering af lægemiddelordination	DrugMedicationUpdated
Pausering af lægemiddelordination	DrugMedicationPaused
Ophævelse af pausering af lægemiddelordination	DrugMedicationUnpaused
Seponering af lægemiddelordination	DrugMedicationWithdrawn
Afseponering af lægemiddelordination	DrugMedicationUnwithdrawn
Administrativ sletning af lægemiddelordination	DrugMedicationInvalidated

Eksempel - opdatering af en lægemiddelordination

I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.sundhedsdata.dk/fmk/2019/06/01”.

<MedicineCardModification>
	<Action>DrugMedicationUpdated</Action>
	<MedicineCard>
		<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
		<Version>1341404077658002001</Version>
		<DrugMedication>
			<Identifier>1341404077657002001</Identifier>
			<Version>1341404077658002002</Version>
		</DrugMedication>
	</MedicineCard>
</MedicineCardModification>

Handlinger på receptordinationer via FMK

Der kan adviseres ved handlinger foretaget på receptordinationer via FMK.

Handlinger på receptordinationer via FMK er oprettelse af receptordinationen på en lægemiddelordination, tilknytning og ophævelse af tilknytning til lægemiddelordination, markering af receptordination ikke relevant samt annullering af receptordination.

Se desuden Indhold i adviseringer fra Receptmodulet

I forbindelse med arbejdsgangen omkring hjemmesygeplejens receptanmodninger er det væsentligt at bemærke, at lægens handlinger skal foregå via FMK. Dvs. at lægen skal modtage adviseringen og oprette receptordinationen via FMK. Derved kan FMK danne en advisering ved lægens oprettelse af receptordination, hvorved hjemmesygeplejen ved at receptanmodningen er behandlet hos lægen.

Topic for adviseringer, CPR og eCPR: http://www.sundhedsdata.dk/fmk/2019/06/01:MedicineCardUpdated

Handling på receptordination	Indhold i Action-element
Oprettelse af receptordination	PrescriptionCreated
Oprettelse af tilknytning til lægemiddelordination	PrescriptionAttached
Ophævelse af tilknytning til lægemiddelordination	PrescriptionDetached
Markering receptordination som ”ikke aktuel”	PrescriptionDeprecated
Ophævelse markering som ”ikke aktuel”	PrescriptionUndeprecated
Annullering af receptordination	PrescriptionCancelled

Eksempel - oprettelse af receptordination

I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.sundhedsdata.dk/fmk/2019/06/01”.

<MedicineCardModification>
	<Action>PrescriptionCreated</Action>
	<MedicineCard>
		<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
		<Version>1341404077658002001</Version>
		<DrugMedication>
			<Identifier>1341404077657002001</Identifier>
			<Version>1341404077658002002</Version>
			<Prescription>
				<Identifier>32768</Identifier>
			</Prescription>
		</DrugMedication>
	</MedicineCard>
</MedicineCardModification>

Handlinger på effektueringer via FMK

Der kan adviseres ved handlinger foretaget på effektueringer via FMK.

Dvs. udelukkende handlinger på effektueringer direkte på lægemiddelordinationer. Handlinger der er foretaget på receptordinationer adviseres separat, se Indhold i adviseringer fra Receptmodulet.

Der dannes advisering ved oprettelse og sletning af effektuering på lægemiddelordinationer.

Topic for adviseringer, CPR og eCPR: http://www.sundhedsdata.dk/fmk/2019/06/01:MedicineCardUpdated

Handling på effektuering	Indhold i Action-elementet
Oprettelse af effektuering på lægemiddelordination	EffectuationCreated
Sletning af effektuering på lægemiddelordination	EffectuationDeleted
Adm. sletning af effektuering på lægemiddelordination	EffectuationInvalidated

Eksempel - oprettelse af effektuering

I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.sundhedsdata.dk/fmk/2019/06/01”.

<MedicineCardModification>
	<Action>EffectuationCreated</Action>
	<MedicineCard>
		<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
		<Version>1341404077658002001</Version>
		<DrugMedication>
			<Identifier>1341404077657002001</Identifier>
			<Version>1341404077658002002</Version>
			<Effectuation>
				<Identifier>1341404189632004002</Identifier>
			</Effectuation>
		</DrugMedication>
	</MedicineCard>
</MedicineCardModification>

Medicinanmodning

Der dannes en advisering når hjemmesygeplejen (eller andre) opretter en medicinanmodning i form af en recept- fornyelsesanmodning. En medicinanmodning i form af en udleveringsanmodning til apoteket på en eksisterende receptordination vil ikke medføre at der dannes en advisering.

Medicinanmodninger vil altid ske på et (e)CPR-nummer, og der vil blive oprettet en advisering med dette CPR-nummer som id. Desuden kan medicinanmodninger ske til en specifik receptudsteder, dvs. en organisation identificeret med ydernummer eller SKS-kode. For hver organisation der angives i PrescribingOrganisation-elementet i medicinanmodningen vil der blive oprettet en advisering til denne organisation, såfremt medicinanmodningen er specificeret til eller resultere i en receptanmodning. Herved kan f.eks. en speciallæge, der ikke har faste patienter tilknyttet, modtage adviseringer til sit ydernummer.

Topic for adviseringer, CPR og eCPR: http://www.sundhedsdata.dk/fmk/2019/06/01:OrderedEffectuationUpdated

Handling på receptanmodninger	Indhold i Action-elementet
Oprettelse af receptanmodning	OrderedEffectuationCreated
Afvisning af receptanmodning	OrderedEffectuationCancelled
Oprettelse af receptordination ud fra receptanmodning	OrderedEffectuationFulfilled
Sletning af receptanmodning	OrderedEffectuationDeleted

Ved en advis for Oprettelse af receptordination ud fra en receptanmodning vil der altid samtidigt blive dannet en advis for Oprettelse af receptordination, som beskrevet tidligere.

Eksempel - oprettelse af receptanmodning

I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.sundhedsdata.dk/fmk/2019/06/01”.

<OrderedEffectuationModification>
	<Action>OrderedEffectuationCreated</Action>
	<OrderedEffectuation>
		<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
		<Identifier>1341404077678001001</Identifier>
		<DrugMedicationIdentifier>1341404077657002001</DrugMedicationIdentifier>
	</OrderedEffectuation>
</OrderedEffectuationModification>

Eksempel - oprettelse af receptordination ud fra receptanmodning

I dette tilfælde adviseres der både med en OrderedEffectuation-element og med et MedicineCard-element. MedicineCard-delen svarer til hvad der adviseres omkring ved oprettelse af en receptordination. PersonIdentifier- og DrugMedicationIdentifier-elementerne forekommer derfor to gange i adviseringen.

I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.sundhedsdata.dk/fmk/2019/06/01”.

<OrderedEffectuationModification>
	<Action>OrderedEffectuationFulfilled</Action>
	<OrderedEffectuation>
		<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
		<Identifier>1341404077678001001</Identifier>
		<DrugMedicationIdentifier>1341404077657002001</DrugMedicationIdentifier>
	</OrderedEffectuation>
	<MedicineCard>
		<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
		<Version>1341404077658002001</Version>
		<DrugMedication>
			<Identifier>1341404077657002001</Identifier>
			<Version>1341404077658002002</Version>
			<Prescription>
				<Identifier>32768</Identifier>
			</Prescription>
		</DrugMedication>
	</MedicineCard>
</OrderedEffectuationModification>

Patienttilknytning

Der dannes en advisering når der registreres en patienttilknytning eller en patientilknytning ophæves. Se evt. Registrering af patientdata, 1.4.4 snitflade. Patienttilknytning er ikke versioneret, og adviseringen indeholder derfor ikke noget versionsnummer.

Der returneres heller ikke en type af relation eller en organisation, idet adviseringen ikke må indeholde personfølsom information. Derfor må abonnenten af advis være forberedt på at det udsendte advis er på en type der ikke kan hentes på den pågældende snitflade eller er interessant for det pågældende system. Eks. hvis et EOJ system på POR 1.4.4 snitfladen abonnerer på advis på patienttilknytning, så vil der blive afsendt advis for alle typer tilknytninger, men i POR 1.4.4 kan kun typen “Visiteret til hjemmesygeplejen” returneres. Det betyder at adviseringer på andre patienttilknytninger f.eks. “Indlagt” vil fejle, når der hentes på det pågældende identifier i POR 1.4.4.

Topic for adviseringer, CPR og eCPR: http://www.sundhedsdata.dk/fmk/2019/06/01:PatientOrganisationRelationUpdated

Handling på patienttilknytning	Indhold i Action-elementet
Registrer tilknytning	PatientOrganisationRelationRegistered
Ophæv tilknytning	PatientOrganisationRelationRemoved

Eksempel - registrering af tilknytning

I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.dkma.dk/medicinecard/xml.schema/2019/06/01”.

<PatientOrganisationRelationModification>
	<Action>PatientOrganisationRelationRegistered</Action>
	<RelationIdentifier>
		<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
		<Identifier>12313213211001001</Identifier>
	</RelationIdentifier>
</PatientOrganisationRelationModification>

Ændring af patientdata

Der dannes en advisering når der ændres patientdata dvs. hvis der oprettes, ændres eller slettes patientdata. Se evt. Registrering af patientdata. Patientdata er ikke versioneret, og adviseringen indeholder derfor ikke noget versionsnummer.

Der returneres heller ikke en type af data eller en organisation, idet adviseringen ikke må indeholde personfølsom information. Derfor må abonnenten af advis være forberedt på at det udsendte advis er på en type af patientdata, der ikke kan hentes på den pågældende snitflade eller ikke er interessant for det pågældende system.

Registreringen af patientdata benyttes i øjeblikket kun til “Dosisdispensering i bero” registreringer. Det har før været tiltænkt INR registreringer, dette blev dog aldrig en realitet i FMK.

Topic for adviseringer, CPR og eCPR: http://www.sundhedsdata.dk/fmk/2019/06/01:PatientRegistrationUpdated

Ændring af patientdata	Indhold i Action-elementet
Ændre patientdata	PatientRegistrationChange

Eksempel - ændring af patientdata

I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.dkma.dk/medicinecard/xml.schema/2019/06/01”.

<PatientRegistrationModification>
	<Action>PatientRegistrationChange</Action>
	<RegistrationIdentifier>
		<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
		<Identifier>12313213211001001</Identifier>
	</RegistrationIdentifier>
</PatientRegistrationModification>

Manglende advis afsendelse

Ved manglende adviseringer sendes der en AdvisLost besked i alle Topic's hvor beskeder kan være tabt, abonnere man på flere topics vil man således få AdvisLost beskeden én gang for hver topic. Ved manglende adviseringer vil der ikke benyttes ID eller IDType da denne advis gælder for alle systemer i stedet vil isSystemNotification være sat til true, hvilket bevirker at alle abonnenter vil modtage den uanset evt. id filtrering.

Ved manglende advis er indholdet som nedenfor, ResumedDate indeholder tidspunktet hvor advis afsendelse blev genoptaget.

Eksempel - manglende advis afsendelse

I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.dkma.dk/medicinecard/xml.schema/2019/06/01”.

<AdvisLost>
	<ResumedDate>2014-11-13T13:23:00+01:00</ResumedDate>
</AdvisLost>

Dosisdispensering advis

I forbindelse med 1.4.6E3 er der oprettet advis som er målrettet til apotekernes arbejdsgang med dosisdispensering, disse advis'er forefindes under namespacet xmlns=“http://www.dkma.dk/medicinecard/xml.schema/2019/06/01“.

Bemærk: Det har kortvarigt været tilfældet at skemaerne til disse Advis har lagt under namespacet for FMK 1.4.6E3: xmlns=“http://www.dkma.dk/medicinecard/xml.schema/2015/06/01/E3” dette var en uhensigtsmæssighed, og de faktiske advis vil komme ud under 2019 namespacet som nævnt ovenfor.

Topic for adviseringer, CPR og eCPR: http://www.sundhedsdata.dk/fmk/2019/06/01:DoseDispensingUpdated

Handling med Dosisdispensering	Indhold i Action-elementet	Note
Pakning af dosisdispenseringsperiode afsluttet	PeriodFinishedPacking	Udgår
Dosisdispenseringsperiode skifter status	PeriodChangeStatus	Erstatter PeriodFinishedPacking

PeriodFinishedPacking udgår da denne kunne indholdes i PeriodChangeStatus, og der ikke var brug for 2 forskellige måder at sige det samme på. Vi tillader os dette da det ikke forventes nogen systemer aktivt brugte disse advis.

Eksempel - dosisdispenserings advis

I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.dkma.dk/medicinecard/xml.schema/2019/06/01”.

<DoseDispensingCardModification>
	<Action>PeriodChangeStatus</Action>
	<DoseDispensing>
		<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
		<DoseDispensingCard>1</DoseDispensingCard>
		<DoseDispensingPeriod>2</DoseDispensingPeriod>
                <OldPeriodStatus>Planlagt</OldPeriodStatus>
                <NewPeriodStatus>Klar til pakning<NewPeriodStatus/>
	</DoseDispensing>
</DoseDispensingCardModification>

Fulde eksempler

Nedenstående eksempel viser hvad der forventes returneret fra adviserinsservicen, såfremt en klient notificeres om (i dette eksempel) at medicinkortet for patienten med CPR-nummer 1111111118 er suspenderet. Eventuelt skal schemaLocation tilpasses hvor skemaer findes lokalt.

FMK definerer indholdet af Topic-elementet samt elementet MedicineCardModification med underelementer.

<Notify xmlns="http://docs.oasis-open.org/wsn/b-2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<NotificationMessage>
		<Topic Dialect="http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple">http://www.dkma.dk/medicinecard/xml.schema/2019/06/01:MedicineCard</Topic>
		<Message>
			<NotifyContent id="1111111118" idType="http://nsi.dk/advis/v10/CPR" xmlns="http://nsi.dk/advis/v10" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
				<MedicineCardModification xmlns="http://www.dkma.dk/medicinecard/xml.schema/2019/06/01">
					<Action>MedicineCardSuspended</Action>
					<MedicineCard>
						<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
						<Version>1341404077678001001</Version>
					</MedicineCard>
				</MedicineCardModification>
			</NotifyContent>
		</Message>
	</NotificationMessage>
</Notify>

Hvor der adviseres omkring “oprettelse af receptordination ud fra receptanmodning” findes der både et OrderedEffectuation-element og et MedicineCard-element, det sidste svarende til indholdet i en advis omkring oprettelse af receptordination. Visse elementer forekommer derfor to gange i adviseringen.

<Notify xmlns="http://docs.oasis-open.org/wsn/b-2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://docs.oasis-open.org/wsn/b-2 wsn-b-2.xsd">
	<NotificationMessage>
		<Topic Dialect="http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple">http://www.dkma.dk/medicinecard/xml.schema/2019/06/01:MedicineCard</Topic>
		<Message>
			<NotifyContent id="1111111118" idType="http://nsi.dk/advis/v10/CPR" xmlns="http://nsi.dk/advis/v10" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
				<OrderedEffectuationModification xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2019/06/01 OrderedEffectuationModification.xsd" xmlns="http://www.dkma.dk/medicinecard/xml.schema/2019/06/01" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
					<Action>OrderedEffectuationFulfilled</Action>
					<OrderedEffectuation>
						<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
						<Identifier>1341404073312001002</Identifier>
						<DrugMedicationIdentifier>1341404077657002001</DrugMedicationIdentifier>
					</OrderedEffectuation>
					<MedicineCard xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2019/06/01 MedicineCardModification.xsd">
						<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
						<Version>1341404077658002001</Version>
						<DrugMedication>
							<Identifier>1341404077657002001</Identifier>
							<Version>1341404077658002002</Version>
							<PrescriptionMedication>
								<Identifier>32768</Identifier>
							</PrescriptionMedication>
						</DrugMedication>
					</MedicineCard>
				</OrderedEffectuationModification>
			</NotifyContent>
		</Message>
	</NotificationMessage>
</Notify>

Eksempel på manglende advis advisering:

<Notify xmlns="http://docs.oasis-open.org/wsn/b-2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> 
	<NotificationMessage>
		<Topic Dialect="http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple"> http://www.dkma.dk/medicinecard/xml.schema/2019/06/01:MedicineCard</Topic>
		<Message>
			<NotifyContent id="1111111118" idType="http://nsi.dk/advis/v10/CPR" xmlns="http://nsi.dk/advis/v10" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
				<AdvisLost xmlns="http://www.dkma.dk/medicinecard/xml.schema/2019/06/01" >
					<ResumedDate>2014-11-13T13:23:00+01:00</ResumedDate>
				</AdvisLost>
			</NotifyContent>
		</Message>
	</NotificationMessage>
</Notify>

Fælles Medicinkort - Dokumentation

Table of Contents

Indhold i FMK adviseringer

Adviseringer for patienter med eCPR

Ændringer direkte på medicinkortet

Eksempel - suspendering af medicinkortet

Ændringer af lægemiddelordinationen

Eksempel - opdatering af en lægemiddelordination

Handlinger på receptordinationer via FMK

Eksempel - oprettelse af receptordination

Handlinger på effektueringer via FMK

Eksempel - oprettelse af effektuering

Medicinanmodning

Eksempel - oprettelse af receptanmodning

Eksempel - oprettelse af receptordination ud fra receptanmodning

Patienttilknytning

Eksempel - registrering af tilknytning

Ændring af patientdata

Eksempel - ændring af patientdata

Manglende advis afsendelse

Eksempel - manglende advis afsendelse

Dosisdispensering advis

Eksempel - dosisdispenserings advis

Fulde eksempler