Differences

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

--- fmk:1.6.0:services:aktiver_pn-kur [2026-02-13 13:06] – adta
+++ fmk:1.6.0:services:aktiver_pn-kur [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== Aktiver PN-kur ======
-Servicen anvendes til at registrere, at én eller flere PN-kure er påbegyndte på en given dato. Kaldet ændrer ikke på de tilhørende lægemiddelordinationer (LMO). I servicesvar, der indeholder oplysninger om LMO’erne, vil det fremgå, om der findes en igangværende PN-kur.
+Servicen anvendes til at registrere, at en eller flere PN-kure (episodic treatment) er startet på angivne datoer for en given patient. En registrering knytter en konkret lægemiddelordination (LMO) til en eller flere startdatoer for PN-kur. Forespørgslen opdaterer ikke selve ordinationen, men registrerer udelukkende PN-kur startdatoer for de angivne ordinationer.
 ===== Forespørgsel =====
@@ Line 8: / Line 7: @@
 [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#RegisterEpisodesRequestType | Request]]
-Ved registrering skal patienten altid angives gennem elementet ''PersonIdentifier''.
+Patienten skal altid angives via ''PersonIdentifier''.
-Derudover skal det fremgå, hvem der er ansvarlig for registreringerne i ''ModifiedBy'' elementet, og eventuelt hvem der har udført registreringerne i ''ReportedBy'', hvis de ikke udføres af den ansvarlige.
+Derudover skal det fremgå, hvem der er ansvarlig for registreringerne i ''ModifiedBy'' elementet, og evt. hvem der har udført registreringerne i ''ReportedBy'', hvis de ikke udføres af den ansvarlige.
-Udover disse generelle felter skal forespørgslen indeholde mindst ét ''Registrations'' element. Hvert ''Registrations'' skal angive:
+Udover disse generelle felter skal forespørgslen indeholde mindst ét ''Episodes'' element. Hvert ''Episodes'' skal angive:
   * hvilken ordination registreringerne vedrører (''DrugMedicationIdentifier'' der peger på den konkrete LMO), og
-  * hvilke datoer PN-kuren startede på (''EpisodeStart'').
+  * hvilke datoer PN-kuren startede på (''EpisodeStart''), hvor hver dato skal være dags dato eller tidligere. Der skal angives mindst én dato.
-Der kan angives flere ''Registrations'' i samme forespørgsel, men de skal alle vedrøre den samme patient.
+Følgende regler gælder (på tværs af alle ''Episodes'' i samme kald):
+  * Der må **kun** registreres startdatoer, hvis den angivne ''DrugMedicationIdentifier'' peger på en LMO med PN-kur (''EpisodicTreatment'' i dosering). Hvis ikke, afvises kaldet.
+  * ''EpisodeStart''-datoer **skal** være dags dato eller tidligere. Fremtidige datoer afvises.
+  * Der må **ikke** forekomme dublerede ''EpisodeStart''-datoer for den samme ''DrugMedicationIdentifier'', hverken i samme kald eller på tværs af flere kald.
+  * Hver ''DrugMedicationIdentifier'' må kun optræde **én gang** i kaldet (dvs. den må ikke være fordelt på flere ''Episodes''-elementer).
+Der kan angives flere ''Episodes'' i samme forespørgsel, men de skal alle vedrøre den samme patient.
 <code xml RegisterEpisodesRequest.xsd>
@@ Line 34: / Line 39: @@
     </Organisation>
   </ModifiedBy>
-  <Registrations>
+  <Episodes>
     <DrugMedicationIdentifier>234127183</DrugMedicationIdentifier>
     <EpisodeStart>2025-10-01</EpisodeStart>
-  </Registrations>
+  </Episodes>
-  <Registrations>
+  <Episodes>
     <DrugMedicationIdentifier>234127182</DrugMedicationIdentifier>
     <EpisodeStart>2025-11-15</EpisodeStart>
-  </Registrations>
+    <EpisodeStart>2025-12-21</EpisodeStart>
+  </Episodes>
 </RegisterEpisodesRequest>
@@ Line 50: / Line 56: @@
 [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#RegisterEpisodesResponseType | Response]]
-Svaret indeholder den angivne ''PersonIdentifier'' samt de ''DrugMedicationIdentifier'', hvorpå der er registreret startdatoer.
+Svaret indeholder den angivne ''PersonIdentifier'' samt de ''DrugMedicationIdentifier'', hvorpå der er registreret startdatoer. ''DrugMedicationIdentifier'' returneres i sorteret (stigende) rækkefølge.
 <code xml RegisterEpisodesResponse.xsd>
@@ Line 56: / Line 62: @@
 <RegisterEpisodesResponse>
   <PersonIdentifier source=”CPR”>1111111118</PersonIdentifier>
-  <DrugMedicationIdentifier>234127183</DrugMedicationIdentifier>
   <DrugMedicationIdentifier>234127182</DrugMedicationIdentifier>
+  <DrugMedicationIdentifier>234127183</DrugMedicationIdentifier>
 </RegisterEpisodesResponse>
 </code>