Differences

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

--- fmk:1.6.0:services:effektuer_bestilling [2025-10-28 14:48] – [Forespørgsel] cgza
+++ fmk:1.6.0:services:effektuer_bestilling [2026-05-11 12:22] (current) – lbdo
@@ Line 5: / Line 5: @@
 ===== Forudsætninger =====
-Inden udleveringen påbegyndes skal apoteket tage en "lås" på udleveringsgurndlaget og oprette en tilhørende bestilling. Det gøres ved at kalde servicen [[Påbegynd håndtering af bestilling]]
+Inden udleveringen påbegyndes skal apoteket tage en "lås" på udleveringsgrundlaget og oprette en tilhørende bestilling. Det gøres ved at kalde servicen [[Påbegynd håndtering af bestilling]]
-Dette skal ske blandt andet for at sikre at den ikke er udleveret af et andet apotek.
+Dette skal ske blandt andet for at sikre, at den ikke er udleveret af et andet apotek.
-Herefter er bestillingens status "Ekspedition påbegyndt". Når bestillingen har fået denne status, vil det altid være tilladt efterfølgende at oprette en udlevering, uanset at lægen evt. i mellemtiden annullerer lægemiddelordinationen.
+Herefter er bestillingens status "Ekspedition påbegyndt". Når bestillingen har fået denne status, vil det altid være tilladt efterfølgende at oprette en udlevering, uanset om lægen i mellemtiden annullerer udleveringsgrundlaget.
 ===== Forespørgsel =====
@@ Line 16: / Line 16: @@
 I forespørgsel til FMK kan der sendes borgerens CPR-nummer. For personer uden CPR-nummer kan der anvendes en alternativ værdi, se [[fmk:generel:medicinkortets_nogle|Medicinkortets nøgle]]. Hvis modtageren er en organisation frem for en enkelt borger, angives i stedet organisationens ''OrganisationIdentifier''. I elementet CreatedBy medsendes information omkring organisationen og apoteket, som har foretaget oprettelsen, se [[fmk:1.6.0:xml-elementer:modifikator|Modifikator]]. Er udleveringen oprettet af en anden aktør, end den der foretager kaldet mod FMK, anvendes på dette sted et ReportedBy-element. Til sidst angives en række [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#effectuateordertype|EffectuateOrder]]-elementer.
 ==== EffectuateOrder ====
-Dette [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#effectuateordertype|element]]  indeholder først en ''WarrantIdentifier'' og en ''OrderIdentifier'' på det tilhørende udleveringgrundlag og dén bestilling, som udleveringen oprettes på. Hernæst angives et [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#createpharmacyhandovertype|CreatePharmacyHandover]]-element, som indeholder følgende:
+Dette [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#effectuateordertype|element]]  indeholder først en ''WarrantIdentifier'' og en ''OrderIdentifier'' på det tilhørende udleveringgrundlag og dén bestilling, som udleveringen oprettes på. Herefter angives et [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#createpharmacyhandovertype|CreatePharmacyHandover]]-element, som indeholder følgende:
   * ''DateTime'' -- tidspunkt for udlevering
@@ Line 25: / Line 25: @@
   * Optionelt ''ResponsibleOrganisation'', oplysninger om den udleverende organisation. Dette angives, hvis den udleverende organisation er forskellig fra organisationen, hvor bestillingen blev oprettet. Et eksempel kunne være et apoteksfilial tilknyttet et andet apotek, hvor det andet apotek er angives som ''OrderedAtPharmacy''.
-Efter ''CreatePharmacyHandover'' angives enten ''true'' eller ''false'' i ''TerminateWarrant''-elementet. Dette svarer til, om recepten er afsluttet, eller om der fortsat kan udleveres ud fra recepten.
+Efter ''CreatePharmacyHandover'' kan angives ''TerminateWarrant''-elementet hvis udleveringsgrundlaget skal afsluttes. Hvis ikke dette angives forbliver udleveringsgrundlaget åbent og der kan forsat foretages udleveringer på det.
-Sidst er det optionelt muligt at angive et element af typen [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#StartTrackAndTraceOnOrdertype|StartTrackAndTraceOnOrder]]. Angivelse af dette element indikerer, at FMK skal begynde at udsende Track&Trace-events baseret på bestillingen. Dette medfører at bestillingen får status ''Sendes''.
+Sidst er det optionelt muligt at angive et element af typen [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DetailsForTrackAndTracetype|DetailsForTrackAndTrace]]. Dette element indikerer, at FMK skal foretage Track&Trace på bestillingen. Bestillingen vil i så fald få status "Sendes", med mindre der angives et ''IsFinalEvent''-element.
-''StartTrackAndTraceOnOrder'' indeholder følgende elementer:
+''DetailsForTrackAndTrace'' indeholder følgende elementer:
   * Optionelt ''ExpectedDeliveryDate'', forventet leveringsdato for pakken
   * Optionelt ''EventFreeText'', fritekst
-  * Optionelt: enten en angivelse af ''ExpectedNextEventDateTime'' for forventet tidspunkt for oprettelse af næste Track&Trace-event -- alternativt flaget ''IsFinalEvent'', som indikerer, at FMK ikke forventes at oprette flere events.
+  * Optionelt: Et valg mellem et af følgende:
+    * ''ExpectedNextEventDateTime'' for forventet tidspunkt for oprettelse af næste Track&Trace-event.
+    * ''IsFinalEvent''-flag, som indikerer, at FMK ikke forventes at oprette flere events. Sættes dette, vil bestillingen få status "Udleveret".
+  * Optionelt: Op til flere ''AdditionalInformation''-elementer. Disse indeholder metadata i form af Key-Value par. Dette kan anvendes hvis man har brug for at angive yderligere information på en mere struktureret form.
 **Eksempel**
@@ Line 41: / Line 46: @@
     <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
     <CreatedBy>
-        <Other>
+        <HealthcareProfessional>
-            <Name>
+            <Identifier source="CPR">1111111118</Identifier>
-                <GivenName>Anne</GivenName>
+            <Name>Testrup Test Testesen</Name>
-                <Surname>Andersen</Surname>
+        </HealthcareProfessional>
-            </Name>
-        </Other>
         <Role>Apoteksansat</Role>
         <Organisation>
@@ Line 77: / Line 80: @@
                     </Form>
                     <Strength>
-                        <Value>50</Value>
+                        <StrengthItem>
-                        <UnitCode source="Medicinpriser" date="2014-03-10">MG</UnitCode>
+                            <Value>50</Value>
-                        <UnitText>mg</UnitText>
+                            <UnitCode source="Medicinpriser" date="2014-03-10">MG</UnitCode>
+                            <UnitText>mg</UnitText>
+                        <StrengthItem>
                     </Strength>
                 </SubstitutedDrug>
             </Package>
-            <HandoverComment>Oprettet i Betalingsservice</PharmacyComment>
+            <HandoverComment>Oprettet i Betalingsservice</HandoverComment>
             <LabelText>1 tablet morgen, middag og aften mod smerter</LabelText>
             <ResponsibleOrganisation>
+                <Identifier source="CVR-P">1008648049</Identifier>
+                <Type>Apotek</Type>
                 <Name>Ry Apoteksudsalg</Name>
                 <AddressLine>Siimtoften 2</AddressLine>
                 <AddressLine>8660 Ry</AddressLine>
-                <Type>Apotek</Type>
-	        <Identifier source="CVR-P">1008648049</Identifier>
             </ResponsibleOrganisation>
         </Handover>
-        <Terminate>true</Terminate>
+        <TerminateWarrant/>
-        <StartTrackAndTraceOnOrder>
+        <DetailsForTrackAndTrace>
             <ExpectedDeliveryDate>2026-03-12</ExpectedDeliveryDate>
             <ExpectedNextEventDateTime>2026-03-10T14:00:00Z</ExpectedNextEventDateTime>
-        </StartTrackAndTraceOnOrder>
+        </DetailsForTrackAndTrace>
     </Order>
 </EffectuateOrderRequest>
@@ Line 108: / Line 113: @@
 [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#effectuateorderresponsetype|Response]]
-indeholder den ''PersonIdentifier'' eller ''OrganisationIdentifier'', som bestillingen er tilknyttet. Dernæst forekommer en række ''Handover''-elementer, som hver indeholder:
+Svaret indeholder den ''PersonIdentifier'' eller ''OrganisationIdentifier'', som bestillingen er tilknyttet. Dernæst forekommer en række ''Handover''-elementer, som hver indeholder:
   * ''WarrantIdentifier''
   * ''OrderIdentifier''