This is an old revision of the document!

Opret effektuering

Servicen “opret effektuering” anvendes i sammenhæng med at ekspederes ud fra en eksisterende lægemiddelordination + tilladelse + bestilling på apoteket.

Ved dosisdispensering kan opgaven eventuelt være delt mellem pakkeapotek, der først opretter effektueringen, og udleveringsapoteket, der senere opdaterer effektueringen med yderligere information, se Opdater effektuering.

Se evt. også også Effektuering og forskel til apotekssnitflade 1

Forespørgsel

I kaldet til FMK sendes først borgerens CPR-nummer. For personer uden CPR-nummer kan der anvendes en alternativ værdi, se Medicinkortets nøgle.

Herefter versionsnummeret på medicinkort og lægemiddelordination der ekspederes ud fra. I forbindelse med oprettelse af en effektuering er det væsentligt at effektueringen oprettes på den rette version af lægemiddelordination + tilladelse + bestilling, se Versionering.

Bemærk at det kan være nødvendigt at oprette effektueringen på en anden version end den aktuelle, i de tilfælde hvor lægen har opdateret eller seponeret lægemiddelordinationen. Sker opdateringenen eller seponeringen på en dosisdispenseret lægemiddelordination bør lægen være informeret om at ændringen først slår igennem ved næste dosispakning. Sker opdateringen på en lægemiddelordination der udleveres som hele pakninger vil forsinkelsen være mindre, og dermed vil også sandsynligheden for at der er ændret samtidig med at lægemidlet udleveres være mindre. Apotekssystemet skal dog informere farmaceuten / farmakonomen om at der er foretaget en ændring, således at farmaceuten / farmakonomen evt. kan nå at ændre hvad der udleveres.

Aktører (CreatedBy / ReportedBy)

I FMK kan der skelnes mellem aktøren der har foretaget handlingen (her foretaget ekspeditionen) og aktøren “ansvarlig for kaldet til FMK”, anvender sin digitale signatur til at kalde FMK. Aktører er beskrevet nærmere i afsnittet Aktører på FMK.

Såfremt der ønskes skelnet mellem de to aktører anvendes på dette sted ReportedBy til personen “ansvarlig for kaldet til FMK”, og under de enkelte efterfølgende effektueringer i kaldet angives aktøren der har foretaget handlingen.
Såfremt der ikke ønskes skelnet mellem de to aktører (personen der foretager ekspeditionen er altid personen der anvender apotekssystemet til at kalde FMK) anvendes i stedet CreatedBy på dette sted.

Ved oprettelsen af effektueringen skal P-nummer anvendes til at identificere apoteket.

#TODO: Det skal afklares om dette er lig med “CreatedBy” apoteket eller om vi skal tilføje et element. Desuden skal der afklares om dette angives i CreatedBy, eller om vi har behov for at f.eks. lokationsnummer anvendes der.

Lægemiddelordination, tilladelse og bestilling

Ved oprettelse af en effektuering skal der angives hvilken lægemiddelordination, tilladelse og bestilling effektueringen oprettes på, og hvilken version der er taget udgangspunkt i ved ekspeditionen. I XML-strukturen angives dette via elementerne DrugMedication, Warrant og Order. Identifier- og Version- elementerne angiver ID og versionsnummer for de elementer de er placeret under.

I bestillingen kan dennes status evt. opdateres i “Status”-elementet.

#TODO Er dette en god ide, eller at blande “ansvarsområder”?

Effektuering

Data for selve effektueringen angives i Effectuation-elementet. I samme kald kan der angives flere effektueringer på forskellige lægemiddelordination + tilladelse + bestillinger eller på samme.

I effektueringen angives først i elementet DateTime apotekets tidsstempel for ekspeditionstidspunkt.

Effektuering af en eller flere pakninger

Ved ekspedition af en eller flere pakninger angives der først antal pakninger i PackageQuantity.

I PackageNumber angives pakningens varenummer. Ved angivelse af varenummer skal der i source-attributten angives hvad kilden til varenummer er, se Varenumre:

Ved oprettelse af effektueringer af lægemidler i intervallet for Medicinpriser (dvs. for lægemidler i taksten) angives begge attributter source = “Medicinpriser” og date = dato for den aktuelle takst der refereres til.
Ved oprettelse af effektueringer af frihandelsvarer angives source = “Frihandelsvare”. Attributten date er her ikke krævet.

Pakningsstørrelsen angives i PackageSize. Der angives en pakningsstørrelse som en numerisk værdi (Value), kode for enhed (UnitCode) og tekst for enhed (UnitText). For UnitCode angives source = “Medicinpriser” og date = dato for den aktuelle takst der refereres til.

Effektuering ved dosisdispensering

Ved ekspedition ved dosisdispensering angives der antal udleverede antal tabletter/kapsler/… i DoseDispensedQuantity-elementet. Værdien er uden enhed, men vil svare til doseringsenheden.

#TODO Det skal afklares om LabelTekst i dette tilfælde skal angives.

Angivelse af lægemiddel ved substitution

Ved effektuering kan der substitueres til et andet lægemiddel end angivet af lægen. Er der ikke substitueret angives ikke information omkring lægemiddel på effektueringen.

Ved substitution angives:

Lægemidlets drugid angives i Identifier-elementet. Ved angivelse af drugid skal der i source-attributten angives hvad kilden til lægemiddel er, se Lægemiddel på FMK:

Ved effektuering af effektueringer af lægemidler defineret i Medicinpriser (dvs. for lægemidler i taksten) angives begge attributter source = “Medicinpriser” og date = dato for den aktuelle takst der refereres til.
Ved effektuering af lægemidler i “Stærke vitaminer og mineraler” angives source = “Stærke vitaminer m.v.” og date = dato for den aktuelle takst
Lægemidler angives som “Tilknyttede behandlinger” bør substitueres til f.eks. frihandelsvare.
Ved effektueringer af lægemidler defineret lokalt kan der substitueres eller der kan ekspederes en frihandelsvare uden at lægemidlet substitueres.

Lægemidlets navn angives, og er obligatorisk.

Lægemidlets form kan angives for lægemidler i Medicinpriser og “Stærke vitaminer og mineraler”, og skal angives hvis der substitueres til andre typer af lægemidler. Formen angives idet der angives en form-kode med kilde i “Medicinpriser”. Form teksten kan angives, men overskrives med hvad der findes ved opslag.

Tilsvarende kan lægemidlet styrke angives for i Medicinpriser og “Stærke vitaminer og mineraler”, og skal angives hvis der substitueres til andre typer af lægemidler. Styrken angives enten som numerisk værdi og enhedskode samt evt. enheds-tekst og evt. komplet tekst, eller alternativt som komplet tekst.

Endeligt kan der der angives aktive substanser, såfremt der haves datagrundlag herfor. Angivelse af aktive substanser er først og fremmest relevant hvor der ikke findes fælles stamdata for lægemidlet der substitueres til.

Afslut tilladelse

Sidst under Warrant-elementet angives med true eller false i Terminate-elementet om tilladelsen er afsluttet, eller om der fortsat kan udleveres ud fra tilladelsen.

Eksempel: Opret effektuering af en enkelt pakning

CreateEffectuationRequest-Iterated.xml

<?xml version="1.0" encoding="UTF-8"?>
<CreateEffectuationRequest 
	xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01 CreateEffectuationRequest.xsd" 
	xmlns:m12="http://www.dkma.dk/medicinecard/xml.schema/2012/06/01" 
	xmlns:m13="http://www.dkma.dk/medicinecard/xml.schema/2013/06/01" 
	xmlns="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01" 
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<PersonIdentifier>1111111118</PersonIdentifier>
	<MedicineCardVersion>1341404071666006001</MedicineCardVersion>
	<CreatedBy>
		<m13:Other>
			<m12:Name>
				<m12:GivenName>Anne</m12:GivenName>
				<m12:Surname>Andersen</m12:Surname>
			</m12:Name>
			<m12:PersonIdentifier>1212121234</m12:PersonIdentifier>
		</m13:Other>
		<m13:Role>Farmakonom</m13:Role>
		<m13:Organisation>
			<m12:Name>Skanderborg Apotek</m12:Name>
			<m12:AddressLine>Adelgade 27</m12:AddressLine>
			<m12:AddressLine>8660 Skanderborg</m12:AddressLine>
			<m12:Type>Apotek</m12:Type>
			<m12:Identifier source="CVR-P">1003153308</m12:Identifier>
		</m13:Organisation>
	</CreatedBy>
	<DrugMedication>
		<Identifier>1341404071001001001</Identifier>
		<Version>1341404071655002002</Version>
		<Warrant>
			<Identifier>1341404071655002003</Identifier>
			<Version>1341404071655002004</Version>
			<Order>
				<Identifier>1341404070747001001</Identifier>
				<Version>1341404073119002002</Version>
				<Status>Afsendt</Status>
				<Effectuation>
					<DateTime>2014-03-10T11:12:39</DateTime>
					<PackageDispensed>
						<PackageQuantity>1</PackageQuantity>
						<PackageNumber source="Medicinpriser" date="2014-03-10">789</PackageNumber>
						<PackageSize>
							<Value>40</Value>
							<UnitCode source="Medicinpriser" date="2014-03-10">stk</UnitCode>
							<UnitText>stk</UnitText>
						</PackageSize>
					</PackageDispensed>
					<SubstitutedDrug>
						<Identifier source="Medicinpriser" date="2014-03-10">28101234504</Identifier>
						<Name>Eksemplificin</Name>
						<Form>
							<Code source="Medicinpriser" date="2014-03-10">TAB</Code>
							<Text>tabletter</Text>
						</Form>
						<Strength>
							<Value>50</Value>
							<UnitCode source="Medicinpriser" date="2014-03-10">MG</UnitCode>
							<UnitText>mg</UnitText>
						</Strength>
					</SubstitutedDrug>
					<LabelText>1 tablet morgen, middag og aften mod smerter</LabelText>
				</Effectuation>
			</Order>
			<Terminate>true</Terminate>
		</Warrant>
	</DrugMedication>
</CreateEffectuationRequest>

Eksempel: Opret effektuering ved dosisdispensering

Ved effektuering ved dosisdispensering anvendes elementet DoseDispensed/DoseDispensedQuantity, hvor der angives antal tabletter/kapsler/… der er dosispakket.

CreateEffectuationRequest-DoseDispsensed.xml

<?xml version="1.0" encoding="UTF-8"?>
<CreateEffectuationRequest 
	xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01 CreateEffectuationRequest.xsd" 
	xmlns:m12="http://www.dkma.dk/medicinecard/xml.schema/2012/06/01" 
	xmlns:m13="http://www.dkma.dk/medicinecard/xml.schema/2013/06/01" 
	xmlns="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01" 
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<PersonIdentifier>1111111118</PersonIdentifier>
	<MedicineCardVersion>1341404071666006001</MedicineCardVersion>
	<CreatedBy>
		<m13:Other>
			<m12:Name>
				<m12:GivenName>Anne</m12:GivenName>
				<m12:Surname>Andersen</m12:Surname>
			</m12:Name>
			<m12:PersonIdentifier>1212121234</m12:PersonIdentifier>
		</m13:Other>
		<m13:Role>Farmakonom</m13:Role>
		<m13:Organisation>
			<m12:Name>Skanderborg Apotek</m12:Name>
			<m12:AddressLine>Adelgade 27</m12:AddressLine>
			<m12:AddressLine>8660 Skanderborg</m12:AddressLine>
			<m12:Type>Apotek</m12:Type>
			<m12:Identifier source="CVR-P">1003153308</m12:Identifier>
		</m13:Organisation>
	</CreatedBy>
	<DrugMedication>
		<Identifier>1341404071001001001</Identifier>
		<Version>1341404071655002002</Version>
		<Warrant>
			<Identifier>1341404071655002003</Identifier>
			<Version>1341404071655002004</Version>
			<Order>
				<Identifier>1341404070747001001</Identifier>
				<Version>1341404073119002002</Version>
				<Status>Ekspedition påbegyndt</Status>
				<Effectuation>
					<DateTime>2014-03-10T11:12:39</DateTime>
					<DoseDispensed>
						<DoseDispensedQuantity>28</DoseDispensedQuantity>
					</DoseDispensed>
					<TerminateWarrant>false</TerminateWarrant>
				</Effectuation>
			</Order>
			<Terminate>true</Terminate>
		</Warrant>
	</DrugMedication>
</CreateEffectuationRequest>

Svar

Svaret ligner svaret på Opdater bestilling for de øverste elementer medicinkort, lægemiddelordination, tilladelse og effektuering. Herunder returneres effektuerings-ID og versionsnummer.

CreateEffectuationResponse.xml

<?xml version="1.0" encoding="UTF-8"?>
<CreateEffectuationResponse 
	xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01 CreateEffectuationResponse.xsd" 
	xmlns="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01" 
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<PersonIdentifier>1111111118</PersonIdentifier>
	<MedicineCardVersion>1341404078102001002</MedicineCardVersion>
	<PreviousVersion>1341404077657004001</PreviousVersion>
	<DrugMedication>
		<Identifier>1341404077656004002</Identifier>
		<Version>1341404078102001003</Version>
		<PreviousVersion>1341404077657004003</PreviousVersion>
		<Warrant>
			<Identifier>1341404077656004004</Identifier>
			<Version>1341404078102001007</Version>
			<PreviousVersion>1341404077657004005</PreviousVersion>
			<Order>
				<Identifier>1341404077656004006</Identifier>
				<Version>1341404078102001008</Version>
				<Effectuation>
					<Identifier>1341404078102001010</Identifier>
					<Version>1341404078102001011</Version>
				</Effectuation>
			</Order>
		</Warrant>
	</DrugMedication>
</CreateEffectuationResponse>

Fælles Medicinkort - Dokumentation

Table of Contents