Differences

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

--- fmk:1.6.0:services:registrer_udlevering [2025-10-14 12:29] – lbdo
+++ fmk:1.6.0:services:registrer_udlevering [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== Registrer udlevering ved behandling ======
-Denne service tillader registration af en eller flere nye udleveringer af en eksisterende lægemiddelordination. Udleveringen foretages af lægen eller dennes medhjælp ved at medicinen udleveres til patienten. Service opretter et eller flere udleveringsgrundlag af typen "Udleveret ved behandling", som udleveringerne tilknyttes. Det er også muligt at angive ''WarrantIdentifier'' på allerede eksisterende udleveringsgrundlag, hvis udleveringerne i stedet ønskes tilknyttet til disse.
+Denne service tillader registrering af en eller flere nye udleveringer på en eksisterende lægemiddelordination. Udleveringen foretages af lægen eller dennes medhjælp, ved at medicinen udleveres til patienten. Servicen opretter et eller flere udleveringsgrundlag af typen "Udleveret ved behandling", som udleveringerne tilknyttes. Det er også muligt at angive ''WarrantIdentifier'' på allerede eksisterende udleveringsgrundlag, hvis udleveringerne i stedet ønskes tilknyttet til denne.
 ==== Forespørgsel ====
-I [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#registerhandoverrequesttype|forespørgslen]] skal det sikres, at der arbejdes på den seneste version af både medicinkortet og dermed også på seneste version af lægemiddelordinationen. Der skal medsendes information omkring lægens organisation (sygehus, praksis mm) og lægen, begge dele for lægen der foretager opdateringen af medicinkortet.
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#RegisterHandoverRequestType|Request]]
+I forespørgsel skal det sikres, at der arbejdes på den seneste version af medicinkortet og dermed også på seneste version af lægemiddelordinationen. Der skal medsendes information omkring lægens organisation (sygehus, praksis mm) og lægen, begge informationer skal være for lægen, der foretager opdateringen af medicinkortet.
 Dernæst angives en række [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#CreateHandoverOfDrugMedicationType|CreateHandoverOfDrugMedication]]-elementer. Hver af disse indeholder en ''DrugMedicationIdentifier'' på den relevante lægemiddelordination samt et eller flere [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#CreateTreatmentHandoverType|CreateTreatmentHandover]]-elementer. Disse indeholder hver følgende oplysninger:
   * Et valg mellem et flag at typen ''CreateNewWarrant'' eller ID på et udleveringsgrundlag ''ExistingWarrantIdentifier''. Herved er det muligt at angive, hvorvidt servicen skal oprette et nyt udleveringsgrundlag af typen "Udleveret ved behandling", eller udleveringen skal tilknyttes et allerede eksisterende udleveringsgrundlag af denne type.
-  * ''TerminateWarrant'' -- her angives ''true'', hvis udleveringsgrundlaget skal lukkes, ''false'' hvis udleveringsgrundlaget skal forblive åbent efter service-kald.
+  * Optionelt: ''TerminateWarrant'' -- angives, hvis udleveringsgrundlaget skal lukkes. Angives ikke, hvis udleveringsgrundlaget skal forblive åbent efter service-kald.
-  * En sekvens af ''Handover''-elementer. Disse indeholder hver en ''DateTime'' for udleveringstidpunktet, optionelt en ''CreatedBy''-modifikator, og enten et [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#packagehandovertype|Package]]-   eller et [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#singleunitshandovertype|SingleUnits]]-element. Desuden er det muligt optionelt at angive op til flere [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#createdrugadministrationonhandovertype|RegisterDrugAdministration]]-elementer, hvor faktisk medicinadministration kan registreres med tidspunkt og dosering.
+  * En sekvens af ''Handover''-elementer. Disse indeholder hver en ''DateTime'' for udleveringstidpunktet, optionelt en ''CreatedBy''-modifikator, og enten et [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#packagehandovertype|Package]]-   eller et [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#singleunitshandovertype|SingleUnits]]-element. Desuden er det muligt optionelt at angive op til flere [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#createdrugadministrationonhandovertype|RegisterDrugAdministration]]-elementer, hvor faktisk medicinadministration kan registreres på udleveringen.
 I ''Package'' angives oplysninger om udleverede pakker, herunder pakkens varenummer (''PackageNumber'') og evt. pakningsstørrelse (''PackageSize'') samt antallet af pakker (''PackageQuantity''). I ''SingleUnits'' angives i stedet en ''DoseQuantity'' og tilhørende ''DoseQuantityUnitText'' for mængden af medicin. Valget mellem disse to elementer afspejler, hvorvidt lægen har udleveret medicin til borgeren i pakker eller enkelte doser.
 I begge elementer er det muligt at angive lægemiddelsubstitution i ''SubstitutedDrug''-elementet, hvis der er blevet foretaget substitution ved udleveringen
+=== Eksempel 1 ===
+Dette eksempel viser registration af en udlevering ved behandling, hvor der er blevet udleveret 4 stk af et lægemiddel.
+<code xml "RegisterHandoverRequest.xml">
+<RegisterHandoverRequest>
+    <PersonIdentifier>1111111118</PersonIdentifier>
+    <MedicineCardVersion>1341404079919002002</MedicineCardVersion>
+    <CreatedBy>
+        <HealthcareProfessional>
+            <Identifier source="Autorisation">2Q5TK</Identifier>
+            <Name>Tess Christoffersen</Name>
+            <Information type="SpecialityCode">7170</Information>
+        </HealthcareProfessional>
+        <Role>Læge</Role>
+        <Organisation>
+            <Identifier source="Yder">66974</Identifier>
+            <Type>Yder</Type>
+            <Name>Lægerne Vestergade</Name>
+            <AddressLine>Vestergade 2</AddressLine>
+            <AddressLine>8660 Skanderborg</AddressLine>
+            <TelephoneNumber>86521348</TelephoneNumber>
+            <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress>
+        </Organisation>
+    </CreatedBy>
+    <CreateHandoverOfDrugMedication>
+        <DrugMedicationIdentifier>1332830239001</DrugMedicationIdentifier>
+        <CreateTreatmentHandover>
+            <CreateNewWarrant/>
+            <TerminateWarrant/>
+            <Handover>
+                 <DateTime>2026-03-29T12:48:03.0Z</DateTime>
+                 <SingleUnits>
+                      <DoseQuantity>4</DoseQuantity>
+                      <DosageQuantityUnitText">stk</DosageQuantityUnitText>
+                 </SingleUnits>
+            </Handover>
+        </CreateTreatmentHandover>
+    </CreateHandoverOfDrugMedication>
+</RegisterHandoverRequest>
+</code>
+=== Eksempel 2 ===
+Dette eksempel viser registrering af en udlevering ved behandling på et eksisterende udleveringsgrundlag. Der er blevet udleveret en pakke af et lægemiddel, og der er desuden registreret administration af medicinen.
+<code xml "RegisterHandoverRequest-existsingwarrant.xml">
+<RegisterHandoverRequest>
+    <PersonIdentifier>1111111118</PersonIdentifier>
+    <MedicineCardVersion>1341404079919002002</MedicineCardVersion>
+    <CreatedBy>
+        <HealthcareProfessional>
+            <Identifier source="Autorisation">2Q5TK</Identifier>
+            <Name>Tess Christoffersen</Name>
+            <Information type="SpecialityCode">7170</Information>
+        </HealthcareProfessional>
+        <Role>Læge</Role>
+        <Organisation>
+            <Identifier source="Yder">66974</Identifier>
+            <Type>Yder</Type>
+            <Name>Lægerne Vestergade</Name>
+            <AddressLine>Vestergade 2</AddressLine>
+            <AddressLine>8660 Skanderborg</AddressLine>
+            <TelephoneNumber>86521348</TelephoneNumber>
+            <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress>
+        </Organisation>
+    </CreatedBy>
+    <CreateHandoverOfDrugMedication>
+        <DrugMedicationIdentifier>123412789734</DrugMedicationIdentifier>
+        <CreateTreatmentHandover>
+            <ExistingWarrantIdentifier>134321374128937</ExistingWarrantIdentifier>
+            <TerminateWarrant/>
+            <Handover>
+                 <DateTime>2026-03-29T12:48:03.0Z</DateTime>
+                 <Package>
+                      <PackageQuantity>1</PackageQuantity>
+                      <PackageNumber source="Medicinpriser" date="2025-10-03">416636</PackageNumber>
+                      <PackageSize>
+                          <Value>100</Value>
+                          <UnitText>stk</UnitText>
+                      </PackageSize>
+                 </Package>
+                 <RegisterDrugAdministration>
+                      <AdministrationDateTime>2026-03-29T12:39:23.0Z</AdministrationDateTime>
+                      <DoseQuantity>2</DoseQuantity>
+                      <DosageQuantityUnitText>stk</DosageQuantityUnitText>
+                 </RegisterDrugAdministration>
+            </Handover>
+        </CreateTreatmentHandover>
+    </CreateHandoverOfDrugMedication>
+</RegisterHandoverRequest>
+</code>
 ==== Svar ====
-I [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#registerhandoverresponsetype|svaret]] returneres ID’er på de oprettede udleveringer og tilknyttede udleveringsgrundlag. Rækkefølgen er i øvrigt bevaret i forhold til request-dokumentet.
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#registerhandoverresponsetype|Response]]
+I svaret returneres ID’er på de oprettede udleveringer og tilknyttede udleveringsgrundlag. Rækkefølgen er bevaret ligesom i forespørgsel.
 <code xml "RegisterHandoverResponse.xml">
@@ Line 30: / Line 135: @@
         <DrugMedicationIdentifier>123412789734</DrugMedicationIdentifier>
         <WarrantAndHandovers>
-             <WarrantIdentifier>1332830239001</WarrantIdentifier>
+             <WarrantIdentifier>134321374128937</WarrantIdentifier>
              <RegisteredHandover>
                   <HandoverIdentifier>13328324670209</HandoverIdentifier>