This is an old revision of the document!
Table of Contents
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.
Forespørgsel
I 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.
Dernæst angives en række CreateHandoverOfDrugMedication-elementer. Hver af disse indeholder en DrugMedicationIdentifier på den relevante lægemiddelordination samt et eller flere CreateTreatmentHandover-elementer. Disse indeholder hver følgende oplysninger:
- Et valg mellem et flag at typen
CreateNewWarranteller ID på et udleveringsgrundlagExistingWarrantIdentifier. 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 angivestrue, hvis udleveringsgrundlaget skal lukkes,falsehvis udleveringsgrundlaget skal forblive åbent efter service-kald.- En sekvens af
Handover-elementer. Disse indeholder hver enDateTimefor udleveringstidpunktet, optionelt enCreatedBy-modifikator, og enten et Package- eller et SingleUnits-element. Desuden er det muligt optionelt at angive op til flere 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.
- "RegisterHandoverRequest.xml"
<RegisterHandoverRequest> <PersonIdentifier>1111111118</PersonIdentifier> <MedicineCardVersion>1341404079919002002</MedicineCardVersion> <CreatedBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier> <Name>Tess Christoffersen</Name> <SpecialityCode source="Medicinpriser" date="2013-11-18">PSYK</SpecialityCode> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægerne Vestergade</Name> <AddressLine>Vestergade 2</AddressLine> <AddressLine>8660 Skanderborg</AddressLine> <TelephoneNumber>86521348</TelephoneNumber> <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress> <Type>Yder</Type> <Identifier source="Yder">66974</Identifier> </Organisation> </CreatedBy> <CreateHandoverOfDrugMedication> <DrugMedicationIdentifier>1332830239001</DrugMedicationIdentifier> <CreateTreatmentHandover> <CreateNewWarrant/> <TerminateWarrant>true</TerminateWarrant> <Handover> <DateTime>2026-03-29T12:48:03.0Z</DateTime> <SingleUnits> <DoseQuantity>4</DoseQuantity> <DosageQuantityUnitText">stk</DosageQuantityUnitText> </SingleUnits> </Handover> </CreateTreatmentHandover> </CreateHandoverOfDrugMedication> </RegisterHandoverRequest>
Eksempel 2
Dette eksempel viser registration af en udlevering ved behandling på et eksisterende udleveringsgrundlag. Der er blevet udleveret en pakke af et lægemiddel, og der desuden registreres administration af medicinen.
- "RegisterHandoverRequest-existsingwarrant.xml"
<RegisterHandoverRequest> <PersonIdentifier>1111111118</PersonIdentifier> <MedicineCardVersion>1341404079919002002</MedicineCardVersion> <CreatedBy> <AuthorisedHealthcareProfessional> <AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier> <Name>Tess Christoffersen</Name> <SpecialityCode source="Medicinpriser" date="2013-11-18">PSYK</SpecialityCode> </AuthorisedHealthcareProfessional> <Organisation> <Name>Lægerne Vestergade</Name> <AddressLine>Vestergade 2</AddressLine> <AddressLine>8660 Skanderborg</AddressLine> <TelephoneNumber>86521348</TelephoneNumber> <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress> <Type>Yder</Type> <Identifier source="Yder">66974</Identifier> </Organisation> </CreatedBy> <CreateHandoverOfDrugMedication> <DrugMedicationIdentifier>1332830239001</DrugMedicationIdentifier> <CreateTreatmentHandover> <ExistingWarrantIdentifier>134321374128937</ExistingWarrantIdentifier> <TerminateWarrant>true</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>
Svar
I svaret returneres ID’er på de oprettede udleveringer og tilknyttede udleveringsgrundlag. Rækkefølgen er i øvrigt bevaret i forhold til request-dokumentet.
- "RegisterHandoverResponse.xml"
<RegisterHandoverResponse> <PersonIdentifier>1111111118</PersonIdentifier> <MedicineCardVersion>1341404077657004001</MedicineCardVersion> <CreatedTreatmentHandovers> <DrugMedicationIdentifier>123412789734</DrugMedicationIdentifier> <WarrantAndHandovers> <WarrantIdentifier>1332830239001</WarrantIdentifier> <RegisteredHandover> <HandoverIdentifier>13328324670209</HandoverIdentifier> <DrugAdministrationIdentifier>3412438013489</DrugAdministrationIdentifier> </RegisteredHandover </WarrantAndHandovers> </CreatedTreatmentHandovers> </RegisterHandoverResponse>
