Differences

This shows you the differences between two versions of the page.

--- fmk:1.4.6:opret_laegemiddelordination [2015-04-07 08:05] – created admin
+++ fmk:1.4.6:opret_laegemiddelordination [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-**TODO UPDATE - FRA APO2.0:**
+====== Opret lægemiddelordination ======
-====== Opret lægemiddelordination + tilladelse + bestilling ======
+Denne service gør det muligt at oprette en eller flere lægemiddelordinationer på et medicinkort.
-==== Lægemidler ordineret på papirrecept m.v. ====
+==== Ikke ajourført ====
-I de tilfælde hvor lægen har udstedt en papirrecept, eller har ordineret via telefon eller fax, kan apoteket registrere dette på FMK forud for eller i forbindelse med udleveringen. Apoteket kan registrere en lægemiddelordination + tilladelse + bestilling, oprettet af lægen men registreret af apoteket. Dette sker på en gang i samme kald, idet der er krævet at lægemiddelordination + tilladelse forbliver bestilt til apoteket, således at kun dette apotek kan foretage udleveringen.
+Det er muligt at oprette en lægemiddelordination på medicinkort der er markeret ikke ajourført. Hvis der er foretaget oprettelse eller opdateringer af lægemiddelordinationer, imens medicinkortet har været markeret som ikke ajourført og patienten indlagt, vil lægen på det tidspunkt medicinkortet ajourføres blive informeret herom. Lægen kan således hente det opdaterede medicinkort, og kan derefter foretage oprettelser eller ændringer på medicinkortet.
-Lægemiddelordinationen oprettet ud fra papirrecept m.v. påføres lægen som oprettet af (i CreatedBy-elementet) samt apoteket (i ReportedBy-elementet).
+==== Oprettelse af recept sammen med lægemiddelordination ====
-Der er en række restriktioner på lægemiddelordinationer oprettet ud fra en papirrecept m.v, der samlet har til formål at sikre at apoteket kun kan foretage en enkelt udlevering ud fra denne type af lægemiddelordination + tilladelse, og at udleveringen kun kan ske af dette apotek.
+En typisk arbejdsgang er at der oprettes en lægemiddelordination hvorefter der med det samme oprettes en recept, således at patienten kan afhente lægemidlet på apoteket. I servicekaldet til oprettelse af en lægemiddelordination er det derfor muligt at tilknytte en eller flere recepter samt evt. tilhørende bestillinger, der oprettes tilknyttet til lægemiddelordinationen.
-==== Dosisdispensering af ikke-receptpligtige lægemidler ====
+==== Oprettelse af tilknytning af recept til lægemiddelordination ====
-Yderligere anvendes samme service til at apoteket kan oprette en lægemiddelordination + tilladelse + bestilling på FMK, i de tilfælde hvor der skal dosispakkes lægemidler der ikke er receptpligtige og ikke er ordineret af lægen.
+I forbindelse med at data fra eksisterende "løse" recepter anvendes til at oprette nye lægemiddelordinationer, skal de "løse" recepter knyttes til de netop oprettede lægemiddelordinationer. I servicekaldet er det derfor muligt at tilknytte et antal løse recepter.
-Apoteket vil selv optræde i CreatedBy-elementet. Lægen og øvrige aktører kan se denne type af lægemiddelordination, men det vil være synligt at den er oprettet af et apotek til det formål at kunne dosisdispensere.
+==== Privatmarkering ====
-Bemærk at der stadig ikke skal oprettes lægemiddelordinationer på lægemidler der ikke er receptpligtige og ikke skal dosisdispenseres.
+Ved oprettelsen af en lægemiddelordination er det muligt at markere at patienten har bedt om [[fmk:generel:privatmarkering|privatmarkering]] på lægemiddelordinationen.
+==== Forespørgsel ====
-==== Dosisdispensering ud fra papirrecept m.v. ====
+I request-dokumentet skal der medsendes et CPR-nummer på den patient som skal have tilføjet en lægemiddelordination på medicinkortet, [[fmk:1.4.4:cpr-nummer|CPR-nummmer]].
-Ved dosisdispensering kan lægemiddelordination + tilladelse + bestilling registreres ud fra en papirrecept m.v, ved at apoteket kalder service.
+Desuden skal der medsendes et versionsnummer på medicinkortet for at sikre at afsendersystemet arbejder med opdaterede data, [[fmk:1.4.4:versionsnummer|Versionsnummer]].
-Reglen at der kun kan foretages en enkelt udlevering ud fra lægemiddelordination + tilladelse + bestilling oprettet på denne måde gælder dog stadig. Det er derfor væsentligt, at lægen inden næste gang der skal dosispakkes opdaterer lægemiddelordination + tilladelse. Derved kan der fremover også dosispakkes ud fra lægemiddelordinationen.
+I elementet CreatedBy medsendes information omkring organisationen (sygehuset, lægepraksisen, ...) og lægen som har foretaget oprettelsen, [[fmk:1.4.4:modifikator|Modifikator]]. Er elementet oprettet af en anden aktør en personen der foretager kaldet mod FMK anvendes på dette sted et ReportedBy-element, og der angives CreatedBy under DrugMedication. Se evt. [[fmk:generel:aktorer_pa_fmk|Aktører på FMK]].
-===== Forespørgsel =====
+Data til oprettelse af en eller flere lægemiddelordinationer medsendes i elementet DrugMedication (type CreateDrugMedication), herunder kan der også oprettes effektueringer på lægemiddelordinationen og der kan oprettes recepter samt evt. tilhørende bestillinger (effektueringer og recepter er ikke vist i eksemplet herunder). Se [[fmk:1.4.6:laegemiddelordination|Lægemiddelordination]] for en gennemgang af indholdet i lægemiddelordinationen.
-Eksemplet herunder viser en oprettelse af lægemiddelordination, tilladelse, bestilling og effektuering, ved at apoteket har fået en recept på papir eller via telefon. Kaldet indeholder følgende elementer:
+==== Borgervalgt medicin ====
-==== Identifikation af medicinkortet ====
+Der er i [[fmk:extensions:e2|extension E2]] mulighed for at angive, om en lægemiddelordination er lægeordineret eller borgervalgt. Dette gøres gennem et nyt Type element, der hører under DrugMedication elementet. Nederst vises et eksempel herpå.
-Medicinkortet der oprettes på angives med patientens CPR-nummer, erstatnings-CPR-nummer eller alternativt med [[apo:generel:medicinkortets_nogle|medicinkortets nøgle]]. Herunder er CPR-nummer vist. Desuden angives medicinkortets versionsnummer.
+**Bemærk**: Apoteker har mulighed for at kalde denne service med henblik på at oprette en borgervalgt lægemiddelordination. Apoteket har ikke mulighed for at angive en anden type end Borgervalgt. Omvendt har læger og tandlæger mulighed for at angive både Lægeordineret og Borgervalgt som ordinationstype.
-Medicinkortets versionsnummer kan angives. Hvor der udleveres ud fra en papirrecept m.v. har apoteket dog ikke lov til at slå op på medicinkortet uden at borgeren giver samtykke hertil, hvorfor dette typisk ikke vil ske.
+<file xml CreateDrugMedicationRequest.xml>
+<CreateDrugMedicationRequest>
+    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
+    <MedicineCardVersion>1341404077657004001</MedicineCardVersion>
+    <CreatedBy>
+        <AuthorisedHealthcareProfessional>
+            <AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier>
+            <Name>Tess Christoffersen</Name>
+        </AuthorisedHealthcareProfessional>
+        <Organisation>
+            <Name>Lægerne Vestergade</Name>
+            <TelephoneNumber>86521348</TelephoneNumber>
+            <Type>Yder</Type>
+            <Identifier source="Yder">66974</Identifier>
+        </Organisation>
+    </CreatedBy>
+    <DrugMedication>
+        <ParentIdentifier>234127182</ParentIdentifier>
+        <FollowUpDates>
+            <Date>2012-08-15</Date>
+            <Date>2012-08-20</Date>
+            <Date>2012-08-25</Date>
+        </FollowUpDates>
+        <BeginEndDate>
+            <TreatmentStartDate>2012-08-09</TreatmentStartDate>
+            <TreatmentEndDate>2012-08-30</TreatmentEndDate>
+        </BeginEndDate>
+        <Indication>
+            <Code source="Medicinpriser" date="2012-08-06">121</Code>
+        </Indication>
+        <RouteOfAdministration>
+            <Code source="Medicinpriser" date="2012-08-06">OR</Code>
+        </RouteOfAdministration>
+        <Drug>
+            <Identifier source="Medicinpriser" date="2012-08-06">28100902676</Identifier>
+            <Name>Primcillin</Name>
+        </Drug>
+        <Dosage>
+            <!-- Bemærk at fra og med Extension E2 vil UnitText ikke længere have en source attribut -->
+            <UnitText source="Local">tablet</UnitText>
+            <StructuresFixed>
+                <Structure>
+                    <IterationInterval>1</IterationInterval>
+                    <StartDate>2012-08-09</StartDate>
+                    <EndDate>2012-08-30</EndDate>
+                    <Day>
+                        <Number>1</Number>
+                        <Dose>
+                            <Time>morning</Time>
+                            <Quantity>1</Quantity>
+                        </Dose>
+                        <Dose>
+                            <Time>evening</Time>
+                            <Quantity>1</Quantity>
+                        </Dose>
+                    </Day>
+                </Structure>
+            </StructuresFixed>
+        </Dosage>
+        <SubstitutionAllowed>true</SubstitutionAllowed>
+        <ReimbursementClause>klausulbetingelse opfyldt</ReimbursementClause>
+    </DrugMedication>
+</CreateDrugMedicationRequest>
+</file>
+==== Svar ====
-Hvor medicinkortets versionsnummer er kendt bør dette dog angives.
+Svaret fra FMK indeholder det medsendte CPR-nummer og et nyt versionsnummer. Desuden returneres ID’er og versionsnumre for de nyoprettede lægemiddelordinationer, effektueringer og recepter (de sidste er ikke vist herunder).
+<code xml CreateDrugMedicationResponse.xml>
-==== Oprettet af og indrapporteret af ====
+<CreateDrugMedicationResponse>
+    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
+    <MedicineCardVersion>1341404079122001001</MedicineCardVersion>
+    <VersionMismatchWarning/>
+    <DrugMedication>
+        <Identifier>234241231</Identifier>
+        <Version>1341404079122003001</Version>
+    </DrugMedication>
+</CreateDrugMedicationResponse>
-I de tilfælde hvor apoteket modtager en papir- eller telefonrecept skal apoteket angive hvilken læge og hvilken organisation (lægepraksis, sygehus m.v.) der har oprettet, dvs. hvem der er den ordinerende person (se [[fmk:generel:aktorer_pa_fmk|Aktører på FMK]]), Dette angives i CreatedBy-elementet.
+</code>
-Desuden skal der angives information omkring farmaceuten eller farmakonomen der indrapporterer lægens ordination til FMK, samt apoteket. Dette angives i ReportedBy-elementet.
-Evt. kan CreatedBy på dette sted udelades, og erstattes af CreatedBy-elementet under DrugMedication-elementet, se evt. XML-skemaet. Dette giver dog først og fremmest mening såfremt der oprettes flere lægemiddelordinationer i samme kald, hvilket nok ikke vil være en typisk situation på apoteket.
+==== Angivelse af ordinationstype (Extension E2) ====
-Oprettes der en lægemiddelordination + tilladelse + bestilling i forbindelse med dosisdispensering af ikke-receptpligtige lægemidler anvendes kun CreatedBy-elementet, der udfyldes med information omkring farmaceuten eller farmakonomen samt apoteket.
+<file xml>
-==== Oprettelse af lægemiddelordination ====
+<CreateDrugMedicationRequest>
+    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
-I elementet DrugMedication angives detaljer omkring lægemiddelordinationen. Se evt. afsnittet [[apo:2.0:laegemiddelordination|Lægemiddelordination]] for en mere detaljeret beskrivelse.
+    <MedicineCardVersion>1341404077657004001</MedicineCardVersion>
+    <CreatedBy>
-=== Lægemiddelordinationens start- og slutdato (BeginEndDate) ===
+        ....
+    </CreatedBy>
-Lægemiddelordinationens startdato angives som dags dato, med mindre andet fremgår af papirrecepten. Slutdato kan ofte afledes af papirrecepten, f.eks. "... i 10 dage", ellers må slutdato udelades.
+    <DrugMedication>
+        <ParentIdentifier>234127182</ParentIdentifier>
-(Se også afklaringspunkt [[apo:2.0:afklaring:laegemiddelordinationer_tilladelser_bestillinger_registreret_af_apoteket|Lægemiddelordinationer + tilladelser + bestillinger registreret af apoteket]])
+        <!-- Type angives som Lægeordineret (default) eller Borgervalgt -->
+        <Type>Borgervalgt</Type>
-=== Indikation og administrationsvej ===
+        <FollowUpDates>
+            <Date>2012-08-15</Date>
-Indikation og administrationsvej skal angives. Disse elementer er obligatoriske, og skal angives ifølge takstdata, for indikation dog evt. i fritekst.
+            <Date>2012-08-20</Date>
+            <Date>2012-08-25</Date>
-=== Lægemiddel ===
+        </FollowUpDates>
+        ...
-Data omkring lægemidlet angives. For lægemidler i taksten kan dette fås ud fra varenummer. For lægemidler i et lokalt sortiment må data omkring lægemidler angives ud fra dette.
+    </DrugMedication>
-=== Dosering ===
-Doseringen skal angives. Den generelle regel i FMK er, at doseringer på formen antal morgen + middag + aften + nat skal angives på struktureret vis. Alle øvrige dosringer kan angives på struktureret vis også, men må også angives i fritekst.
-Se i øvrigt afklaring [[apo:2.0:afklaring:generel_datakvalitet_-_obligatoriske_felter|Generel datakvalitet - obligatoriske felter]]
-=== Substitution ===
-Der skal angives, såfremt lægen har angivet at substitution ikke er tilladt.
-==== Oprettelse af tilladelse ====
-På samme måde som apoteket registrerer lægemiddelordinationen oprettet af lægen skal apoteket registrere tilladelsen i Warrant-elementet.
-I ValidFromDate angives dato for lægens "godkendelse".
-I ValidToDate angives hvor længe tilladelsen skal være gyldig. Efter de nuværende regler to år, eller 7 dage for papirrecepter udstedt af vagtlæger.
-Oprettes der en tilladelse til udlevering af pakninger (dvs. alt andet end dosisdispensering) anvendes herefter elementet PackageRestriction, hvor der angives varenummer, pakningsstørrelse, antal pakninger og doserings-tekst. Doseringsteksten svarer til doseringen angivet på lægemiddelordinationen, såfremt denne er angivet som fritekst, eller som en kort tekst udledt af denne, såfremt doseringen på lægemiddelordinationen er struktureret.
-Oprettes der en tilladelse til udlevering ved dosisdispensering angives her kun det tomme element DoseDispensingRestriction.
-==== Oprettelse af bestilling ====
-I bestillingen angives information omkring apoteket der opretter ud fra papirrecepten i elementet OrderedAtPharmacy. Dette svarer til hvordan strukturen vil se ud på en lægemiddelordination + tilladelse oprettet af lægen og oprindeligt bestilt til apoteket, eller hvor apoteket senere har oprettet en bestilling til sig selv for at "låse" lægemiddelordination + tilladelse før en udlevering.
-Ved dosisdispensering skal bestillingen oprettes med yderligere information hertil, svarende til hvad der er beskrevet i afsnittet [[apo:2.0:opdater_bestilling|Opdater bestilling]].
-==== Oprettelse af effektuering ====
-Endeligt angives information for udleveringen i Effectuation-elementet, svarende til beskrivelsen i afsnittet [[apo:2.0:opret_effektuering|Opret effektuering]].
-For receptpligtige lægemidler må der ikke udleveres yderligere ud fra papirrecepten og data angivet på FMK af apoteket. Elementet TerminateWarrant skal derfor sættes til "true". I andre tilfælde kan værdien være "false", eksempelvis hvis der skal dosispakkes håndkøbslægemidler.
-<code xml CreateDrugMedicationRequest.xml>
-<?xml version="1.0" encoding="UTF-8"?>
-<CreateDrugMedicationRequest
-	xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01 CreateDrugMedicationRequest.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">
-	<!-- Medicinkort -->
-	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
-	<MedicineCardVersion>1341404077657004001</MedicineCardVersion>
-	<!-- Oprettet af lægen, indrapporteret af apoteket -->
-	<CreatedBy>
-		<m13:AuthorisedHealthcareProfessional>
-			<m12:AuthorisationIdentifier>2Q5TK</m12:AuthorisationIdentifier>
-			<m12:Name>Tess Christoffersen</m12:Name>
-		</m13:AuthorisedHealthcareProfessional>
-		<m13:Organisation>
-			<m12:Name>Lægerne Vestergade</m12:Name>
-			<m12:Type>Yder</m12:Type>
-			<m12:Identifier source="Yder">66974</m12:Identifier>
-		</m13:Organisation>
-	</CreatedBy>
-	<ReportedBy>
-		<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>
-	</ReportedBy>
-	<!-- Oprettelse af lægemiddelordination -->
-	<DrugMedication>
-		<BeginEndDate>
-			<m12:TreatmentStartDate>2014-03-07</m12:TreatmentStartDate>
-			<m12:TreatmentEndDate>2014-03-16</m12:TreatmentEndDate>
-		</BeginEndDate>
-		<Indication>
-			<m12:Code source="Medicinpriser" date="2014-03-03">121</m12:Code>
-		</Indication>
-		<RouteOfAdministration>
-			<m12:Code source="Medicinpriser" date="2014-03-03">OR</m12:Code>
-		</RouteOfAdministration>
-		<Drug>
-			<m13:Identifier source="Medicinpriser" date="2014-03-03">28100902276</m13:Identifier>
-			<m13:Name>Primcillin</m13:Name>
-		</Drug>
-		<Dosage>
-			<m13:Structures>
-				<m13:UnitTexts source="Medicinpriser">
-					<m12:Singular>tablet</m12:Singular>
-					<m12:Plural>tabletter</m12:Plural>
-				</m13:UnitTexts>
-				<m13:Structure>
-					<m13:IterationInterval>1</m13:IterationInterval>
-					<m13:StartDate>2014-03-07</m13:StartDate>
-					<m13:EndDate>2014-03-16</m13:EndDate>
-					<m13:Day>
-						<m12:Number>1</m12:Number>
-						<m12:Dose>
-							<m12:Time>morning</m12:Time>
-							<m12:Quantity>1</m12:Quantity>
-						</m12:Dose>
-						<m12:Dose>
-							<m12:Time>evening</m12:Time>
-							<m12:Quantity>1</m12:Quantity>
-						</m12:Dose>
-					</m13:Day>
-				</m13:Structure>
-			</m13:Structures>
-		</Dosage>
-		<SubstitutionAllowed>true</SubstitutionAllowed>
-		<!-- Oprettelse af tilladelse -->
-		<Warrant>
-			<ValidFromDate>2014-03-07</ValidFromDate>
-			<ValidToDate>2016-03-06</ValidToDate>
-			<PackageRestriction>
-				<PackageNumber source="Medicinpriser" date="2014-03-03">416636</PackageNumber>
-				<PackageQuantity>1</PackageQuantity>
-				<DosageText>1 tablet morgen og aften</DosageText>
-			</PackageRestriction>
-			<!-- Oprettelse af bestilling -->
-			<Order>
-				<OrderedAtPharmacy>
-					<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>
-				</OrderedAtPharmacy>
-				<!-- Oprettelse af effektuering -->
-				<Effectuation>
-					<DateTime>2014-03-07T02:14:12</DateTime>
-					<PackageDispensed>
-						<PackageQuantity>2</PackageQuantity>
-						<PackageNumber source="Medicinpriser" date="2014-03-03">138396</PackageNumber>
-						<PackageSize>
-							<Value>10</Value>
-							<UnitCode source="Medicinpriser" date="2014-03-03">ST</UnitCode>
-						</PackageSize>
-					</PackageDispensed>
-					<LabelText>1 tablet morgen og aften mod mellemørebetændelse</LabelText>
-				</Effectuation>
-			</Order>
-		</Warrant>
-	</DrugMedication>
 </CreateDrugMedicationRequest>
+</file>
-</code>
-====== Svar ======
-I svaret returneres de oprettede ID'er
-<code xml CreateDrugMedicationResponse.xml>
-<?xml version="1.0" encoding="UTF-8"?>
-<CreateDrugMedicationResponse
-	xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01 CreateDrugMedicationResponse.xsd"
-	xmlns="http://www.dkma.dk/medicinecard/xml.schema/2014/06/01"
-	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
-	<MedicineCardVersion>1341404077657004001</MedicineCardVersion>
-	<DrugMedication>
-		<Identifier>1341404077656004002</Identifier>
-		<Version>1341404077657004001</Version>
-		<Warrant>
-			<Identifier>1341404077656004003</Identifier>
-			<Version>1341404077657004001</Version>
-			<Order>
-				<Identifier>1341404077656004004</Identifier>
-				<Version>1341404077657004001</Version>
-				<Effectuation>
-					<Identifier>1341404077656004010</Identifier>
-					<Version>1341404077657004011</Version>
-				</Effectuation>
-			</Order>
-		</Warrant>
-	</DrugMedication>
-</CreateDrugMedicationResponse>
-</code>