Differences

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

--- fmk:1.6.0:services:opret_udleveringsgrundlag [2025-07-29 09:58] – [Forespørgsel] bbk
+++ fmk:1.6.0:services:opret_udleveringsgrundlag [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 5: / Line 5: @@
 ==== Forespørgsel ====
-Patientens PersonIdentifier og medicinkortets versionsnummer angives først i dokumentet, og herunder data om lægepraksis eller sygehus samt om lægen der opretter udleveringsgrundlagene. Herunder findes en eller flere Warrant elementer, for hver af disse oprettes et udleveringsgrundlag.
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#createWarrantRequestType|Request]]
+I forespørgslen angives først ''PersonIdentifier'' eller ''Organisationidentifier'' samt medicinkortets versionsnummer. Herefter angives oplysninger om aktøren, der foretager oprettelsen (se også "Modifikator" herunder).
+Herefter følger en eller flere Warrant-elementer, et for hvert af de udleveringsgrundlag, der skal oprettes.
 === Lægemiddelordinationen som udgangspunkt  ===
-Elementet Warrant indeholder en reference til den lægemiddelordination som udleveringsgrundlaget skal gælde for. Udleveringsgrundlaget oprettes med en kombination af data fra lægemiddelordinationen og øvrige elementer i kaldet.
+Elementet Warrant indeholder en reference til den lægemiddelordination, som udleveringsgrundlaget skal gælde for.
+Udleveringsgrundlaget oprettes med en kombination af data fra lægemiddelordinationen og øvrige elementer i kaldet.
-=== Lægens autorisationsdato ===
-Der skal angives en dato og et tidspunkt hvor udleveringsgrundlaget er godkendt af lægen.
 === Reference til anmodning ===
@@ Line 21: / Line 22: @@
 Hvis udleveringsgrundlaget oprettes på bagrund af en anmodning, angives id'et på denne anmodning.
+=== Modifikator ===
-=== Gyldighed ===
+Der kan eventuelt angives en modifikator for hvert udleveringsgrundlag i kaldet. Dette anvendes, hvis der optræder forskellige aktører for udleveringsgrundlagene i kaldet, se [[fmk:generel:aktorer_pa_fmk|også aktører på FMK]].
-I ValidFromDate angives fra hvornår udleveringsgrundlaget er gyldig.
+=== Lægens autorisationsdato ===
-I ValidToDate angives hvornår til udleveringsgrundlaget skal være gyldig. Afhængig af typen af udleveringsgrundlag, er der visse lovmæssige begrænsninger for hvor længe det må være gyldigt. Det valideres at ValidToDate overholder disse regler.
+Der skal angives en dato og et tidspunkt, hvor udleveringsgrundlaget er godkendt af lægen (autorisationsdato).
-=== Oprettet af ===
+=== Gyldighed ===
-I CreatedBy angives modifikator oplysninger for den læge, der er ansvarlig for oprettelsen af udleveringsgrundlaget
+Der kan angives, hvornår udleveringsgrundlaget skal være gyldigt fra.
+Hvis intet angives, antages, at det skal være lig kaldtidspunktet, hvilket i så fald sættes af FMK. Der kan angives enten et specifikt gyldig fra tidspunkt i ''ValidFromDate'', som både kan være i fortiden eller fremtiden, eller der kan angives, at det er et endnu ukendt fremtidigt tidspunkt ved hjælp af ''UnspecifiedValidFrom''. Se [[fmk:1.6.0:services:aktiver ventende udleveringsgrundlag]].
+I ValidToDate angives, hvortil udleveringsgrundlaget skal være gyldig. Afhængig af typen af udleveringsgrundlag, er der visse lovmæssige begrænsninger for, hvor længe det må være gyldigt. Det valideres at ValidToDate overholder disse regler. Hvis ValidTo udelades, sættes den til den længst mulige gyldighed i henhold til gældende regler.
 === Typen af udleveringsgrundlag ===
-Der skal angives hvilket type udleveringsgrundlag der skal oprettes, samt de nødvendige informationer for denne type. Der kan oprettes udleveringsgrundlag af følgende typer:
+Der skal angives hvilken type udleveringsgrundlag der skal oprettes, samt de nødvendige informationer for denne type. Der kan oprettes udleveringsgrundlag af følgende typer:
   * [[fmk:1.6.0:xml-elementer:udleveringsgrundlag#prescription|Recept]]
   * [[fmk:1.6.0:xml-elementer:udleveringsgrundlag#dosedispensed|Dosisdispensering]]
-  * [[fmk:1.6.0:xml-elementer:udleveringsgrundlag#hospitalpharmacyprescription|Sygehusapotek-recept]]
+  * [[fmk:1.6.0:xml-elementer:udleveringsgrundlag#hospitalpharmacyhandover|Udlevering af medicin fra sygehusapotek]]
+=== Bestilling ===
+Det er muligt samtidigt at oprette en [[fmk:1.6.0:xml-elementer:bestilling]] til apoteket på udleveringsgrundlaget, hvis der er tale om et udleveringsgrundlag til udlevering på apotek (Recept eller Dosisdispensering).
+=== Eksempel ===
+<code xml>
+    <CreateWarrantRequest>
+         <PersonIdentifier source="CPR">1403837853</PersonIdentifier>
+         <MedicinecardVersion>54322135234542</MedicinecardVersion>
+         <Created>
+             <By>
+       	      ....
+             </By>
+             <DateTime>2025-11-19T09:30:47.0Z</DateTime>
+        </Created>
+        <Warrant>
+            <DrugMedicationIdentifier>1332830239</DrugMedicationIdentifier>
+            <RequestForWarrantIdentifier>54321232345</RequestForWarrantIdentifier>
+            <AuthorisationDateTime>2025-11-19T09:29:47.0Z</AuthorisationDateTime>
+            <UnspecifiedValidFrom/>
+            <Prescription>
+                <PackageNumber source="Medicinpriser">409632</PackageNumber>
+                <PackageSize>
+                    <Value>100</Value>
+                    <UnitCode source=""Medicinpriser"">ST</UnitCode>
+                    <UnitText>stk</UnitText>
+                    <PackageSizeText>100 stk</PackageSizeText>
+                </PackageSize>
+                <PackageQuantity>1</PackageQuantity>
+                <IterationNumber>10</IterationNumber>
+                <IterationInterval>2</IterationInterval>
+                <IterationIntervalUnit>uger</IterationIntervalUnit>
+            </Prescription>
+        </Warrant>
+        <Warrant>
+            <DrugMedicationIdentifier>123321123321</DrugMedicationIdentifier>
+            <AuthorisationDateTime>2024-11-19T09:12:12.0Z</AuthorisationDateTime>
+            <ValidFromDate>2024-12-01</ValidFromDate>
+            <ValidToDate>2025-12-31</ValidToDate>
+            <DoseDispensed/>
+            <Order>
+                <OrderedAtPharmacy>
+                    <Identifier source="EAN-lokationsnummer">5790001381615</Identifier>
+                    <Type>Apotek</Type>
+                    <Name>Kolind Apotek</Name>
+                    <AddressLine>...</AddressLine>
+                    <TelephoneNumber>...</TelephoneNumber>
+                    <EmailAddress>...</EmailAddress>
+                </OrderedAtPharmacy>
+            </Order>
+        </Warrant>
+    </CreateWarrantRequest>
+</code>
+==== Svar ====
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#createWarrantResponseType|Response]]
+Svaret indeholder identifier på den person eller organisation, som oprettelsen vedrører, samt medicinkortversion.
+Derudover returneres id'erne på de oprettede udleveringsgrundlag sammen med id'erne på de lægemiddelordinationer, de er oprettet på.
+=== Eksempel ===
+<code xml>
+    <CreateWarrantResponse>
+         <PersonIdentifier source="CPR">1403837853</PersonIdentifier>
+         <MedicinecardVersion>54322135234542</MedicinecardVersion>
+         <Warrant>
+            <DrugMedicationIdentifier>1332830239</DrugMedicationIdentifier>
+            <WarrantIdentifier>23412312321234</WarrantIdentifier>
+         </Warrant>
+         <Warrant>
+            <DrugMedicationIdentifier>124353211430239</DrugMedicationIdentifier>
+            <WarrantIdentifier>234123123255555</WarrantIdentifier>
+         </Warrant>
+    </CreateWarrantResponse>
+</code>