Fælles Medicinkort - Dokumentation

User Tools

Site Tools

You are here: start » fmk » 1.6.0 » services » registrer_udlevering
fmk:1.6.0:services:registrer_udlevering

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
fmk:1.6.0:services:registrer_udlevering [2025-10-14 11:32] – lbdofmk: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 ====== ====== 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 ==== ==== 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: 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.   * 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 ''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 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 ==== ==== 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"> <code xml "RegisterHandoverResponse.xml">
Line 27: Line 132:
     <PersonIdentifier>1111111118</PersonIdentifier>     <PersonIdentifier>1111111118</PersonIdentifier>
     <MedicineCardVersion>1341404077657004001</MedicineCardVersion>     <MedicineCardVersion>1341404077657004001</MedicineCardVersion>
-    <Handover>+    <CreatedTreatmentHandovers>
         <DrugMedicationIdentifier>123412789734</DrugMedicationIdentifier>         <DrugMedicationIdentifier>123412789734</DrugMedicationIdentifier>
-        <CreatedHandoversOnWarrant> +        <WarrantAndHandovers> 
-             <WarrantIdentifier>1332830239001</WarrantIdentifier> +             <WarrantIdentifier>134321374128937</WarrantIdentifier> 
-             <HandoverIdentifier>13328324670209</HandoverIdentifier> +             <RegisteredHandover> 
-        </CreatedHandoversOnWarrant> +                  <HandoverIdentifier>13328324670209</HandoverIdentifier> 
-    </DrugMedication>+                  <DrugAdministrationIdentifier>3412438013489</DrugAdministrationIdentifier> 
 +             </RegisteredHandover 
 +        </WarrantAndHandovers> 
 +    </CreatedTreatmentHandovers>
 </RegisterHandoverResponse> </RegisterHandoverResponse>
 </code> </code>
fmk/1.6.0/services/registrer_udlevering.1760441566.txt.gz · Last modified: (external edit)
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki