Fælles Medicinkort - Dokumentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Kontroldatoer på lægemiddelordinationer =====

Der indføres mulighed for at påføre kontroldatoer på lægemiddelordinationer som vedrører AK-behandling med Vitamin K-antagonister, de såkaldte VKA lægemidler.
P.t. er det kun tilladt på lægemidler med følgende ATC-koder: B01AA03, B01AA04.

Kontroldatoer følger de generelle principper for opdateringer på lægemiddelordinationen. Dvs. at opdateres en lægemiddelordination med en eller flere kontroldatoer, er det lægen der opdaterer der har ansvar for at vurdere om kontroldatoerne skal med på den nye version. Det kan ikke forventes, at f.eks. en vagtlæge der substituerer lægemidlet for at lave en ny receptordination kan foretage en opfølgning, derfor skal det være muligt at opdatere med kontroldatoer der er overskredne.

**Bemærk** Det er kun tilladt at have op til 2 kontroldatoer på lægemiddelordinationen, den første af disse skal altid ligge i fortiden, og opdateres/sættes. Den anden kontroldato skal ligge i fremtiden.

Hvis UpdateDrugMedicationRequest xml'en indeholder et tomt <FollowUpDates> element slettes eksisterende kontroldatoer på lægemiddelordinationen. Hvis man ikke ønsker at opdatere kontroldatoerne, kan man enten returnere de oprindelige kontroldatoer eller helt udelade <FollowUpDates> elementet. **Bemærk derfor at der er forskellig betydning af om <FollowUpDates> elementet er udeladt eller tomt.**

"Bulk"-servicen til opdatering af medicinkortet kan i <CreateDrugMedication> og <UpdateDrugMedication> elementerne have tilsvarende <FollowUpdates> elementer angivet. Samme regler om undladelse/tomt element gælder


==== Forespørgsler ====

En lægemiddelordination vil kunne oprettes med en liste af kontroldatoer i elementet FollowUpDates, som vist i eksemplet herunder. 

<code xml CreateDrugMedicationRequest-FollowUpDates.xml>

<CreateDrugMedicationRequest>
	<PersonIdentifier>1111111118</PersonIdentifier>
	<MedicineCardVersion>1341404071666006001</MedicineCardVersion>
        <CreatedBy>
            <AuthorisedHealthcareProfessional>
                <AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier>
                <Name>Tess Christoffersen</Name>
                <SpecialityCode source="Medicinpriser" date="2013-11-18">PSYK</SpecialityCode>
            </AuthorisedHealthcareProfessional>
            <Organisation>
                <Name>Århus Universitetshospital, Skejby</Name>
                <AddressLine>Brendstrupgårdsvej 100</AddressLine>
                <AddressLine>8200 Århus N</AddressLine>
                <TelephoneNumber>89495566</TelephoneNumber>
                <EmailAddress>AarhusUniversitetshospital@auh.rm.dk</EmailAddress>
                <Type>Sygehus</Type>
                <Identifier source="SKS">7026</Identifier>
            </Organisation>    
        </CreatedBy>
	<DrugMedication>
		<FollowUpDates>
			<Date>2014-05-15</Date>
			<Date>2014-06-12</Date>
		</FollowUpDates>
		<BeginEndDate>
			<TreatmentStartDate>2014-05-01</TreatmentStartDate>
			<TreatmentEndingUndetermined/>
		</BeginEndDate>
		<Indication>
			<Code source="Medicinpriser" date="2014-05-01">42</Code>
		</Indication>
		<RouteOfAdministration>
			<Code source="Medicinpriser" date="2014-05-01">OR</Code>
		</RouteOfAdministration>
		<Drug>
			<Identifier  source="Medicinpriser" date="2014-05-01">28101234521</Identifier>
			<Name>Marevan</Name>
		</Drug>
		<Dosage>
			<Structures>
				<UnitTexts source="Local">
					<Singular>tablet</Singular>
					<Plural>tabletter</Plural>
				</UnitTexts>
				<Structure>
					<IterationInterval>1</IterationInterval>
					<StartDate>2014-05-01</StartDate>
					<DosageEndingUndetermined/>
					<Day>
						<Number>1</Number>
						<Dose>
							<Quantity>2</Quantity>
						</Dose>
					</Day>
				</Structure>
			</Structures>
		</Dosage>
		<SubstitutionAllowed>true</SubstitutionAllowed>
	</DrugMedication>
</CreateDrugMedicationRequest>

</code>

På samme måde kan lægemiddelordinationen opdateres med en liste af opføgningsdatoer i elementet FollowUpDates, som vist i eksemplet herunder.

<code xml UpdateDrugMedicationRequest.xml>
<UpdateDrugMedicationRequest>
        <PersonIdentifier>1111111118</PersonIdentifier>
        <MedicineCardVersion>1346404071666006001</MedicineCardVersion>
        <ModifiedBy>
            <AuthorisedHealthcareProfessional>
                <AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier>
                <Name>Tess Christoffersen</Name>
                <SpecialityCode source="Medicinpriser" date="2013-11-18">PSYK</SpecialityCode>
            </AuthorisedHealthcareProfessional>
            <Organisation>
                <Name>Århus Universitetshospital, Skejby</Name>
                <AddressLine>Brendstrupgårdsvej 100</AddressLine>
                <AddressLine>8200 Århus N</AddressLine>
                <TelephoneNumber>89495566</TelephoneNumber>
                <EmailAddress>AarhusUniversitetshospital@auh.rm.dk</EmailAddress>
                <Type>Sygehus</Type>
                <Identifier source="SKS">7026</Identifier>
            </Organisation>    
        </ModifiedBy>
        <DrugMedication>
                <Identifier>1347404071666006001</Identifier>
		<FollowUpDates>
			<Date>2014-05-29</Date>
                        <Date>2014-06-20</Date>
		</FollowUpDates>
		<BeginEndDate>
			<TreatmentStartDate>2014-05-10</TreatmentStartDate>
			<TreatmentEndingUndetermined/>
		</BeginEndDate>
		<Indication>
			<Code source="Medicinpriser" date="2014-05-01">42</Code>
		</Indication>
		<RouteOfAdministration>
			<Code source="Medicinpriser" date="2014-05-01">OR</Code>
		</RouteOfAdministration>
		<Drug>
			<Identifier  source="Medicinpriser" date="2014-05-01">28104557609</Identifier>
			<Name>Warfarin "Orion"</Name>
		</Drug>
		<Dosage>
			<Structures>
				<UnitTexts source="Local">
					<Singular>tablet</Singular>
					<Plural>tabletter</Plural>
				</UnitTexts>
				<Structure>
					<IterationInterval>1</IterationInterval>
					<StartDate>2014-05-01</StartDate>
					<DosageEndingUndetermined/>
					<Day>
						<Number>1</Number>
						<Dose>
							<Quantity>2</Quantity>
						</Dose>
					</Day>
				</Structure>
			</Structures>
		</Dosage>
		<SubstitutionAllowed>true</SubstitutionAllowed>
	</DrugMedication>
</UpdateDrugMedicationRequest>
</code>
==== Svar ====

Når lægemiddelordinationer hentes via FMK 1.4.4 snitfladen returneres eventuelle kontroldatoer i et tilsvarende <FollowUpDates> element. F.eks. for GetDrugMedicationResponse:

<code xml GetDrugmedicationResponse_FollowUpDates.xml>
<GetDrugMedicationResponse>
    <PersonIdentifier>1111111118</PersonIdentifier>
    <DrugMedication>
        <Identifier>1341404076312001001</Identifier>
        <Version>1341404077658001001</Version>
        <PreviousVersion>1341404076312002001</PreviousVersion>
        <Created>
            <By>
                <AuthorisedHealthcareProfessional>
                    <AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier>
                    <Name>Tess Christoffersen</Name>
                    <SpecialityCode source="Medicinpriser" date="2013-11-18">PSYK</SpecialityCode>
                </AuthorisedHealthcareProfessional>
                <Organisation>
                    <Name>Århus Universitetshospital, Skejby</Name>
                    <AddressLine>Brendstrupgårdsvej 100</AddressLine>
                    <AddressLine>8200 Århus N</AddressLine>
                    <TelephoneNumber>89495566</TelephoneNumber>
                    <EmailAddress>AarhusUniversitetshospital@auh.rm.dk</EmailAddress>
                    <Type>Sygehus</Type>
                    <Identifier source="SKS">7026</Identifier>
                </Organisation>    
            </By>
            <DateTime>2012-08-09T08:46:34.0Z</DateTime>
        </Created>
        <FollowUpDates>
            <Date>2014-05-15</Date>
            <Date>2014-06-12</Date>
        </FollowUpDates>
	<BeginEndDate>
		<TreatmentStartDate>2014-05-01</TreatmentStartDate>
		<TreatmentEndingUndetermined/>
	</BeginEndDate>
	<Indication>
		<Code source="Medicinpriser" date="2014-05-01">42</Code>
	</Indication>
	<RouteOfAdministration>
		<Code source="Medicinpriser" date="2014-05-01">OR</Code>
	</RouteOfAdministration>
	<Drug>
		<Identifier  source="Medicinpriser" date="2014-05-01">28101234521</Identifier>
		<Name>Marevan</Name>
	</Drug>
	<Dosage>
		<Structures>
			<UnitTexts source="Local">
				<Singular>tablet</Singular>
				<Plural>tabletter</Plural>
			</UnitTexts>
			<Structure>
				<IterationInterval>1</IterationInterval>
				<StartDate>2014-05-01</StartDate>
				<DosageEndingUndetermined/>
				<Day>
					<Number>1</Number>
					<Dose>
						<Quantity>2</Quantity>
					</Dose>
				</Day>
				<DosageTranslation>
					<ShortText>2 tabletter dagligt</ShortText>
					<LongText>2 tabletter dagligt</LongText>
					<AverageDailyDosage>2</AverageDailyDosage>
				</DosageTranslation>
			</Structure>
		</Structures>
                <Type>fast</Type>
	</Dosage>
        <SubstitutionAllowed>true</SubstitutionAllowed>
    </DrugMedication>
</GetDrugMedicationResponse>
</code>