Differences

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

--- fmk:1.6.0:services:aktiver_pn-kur [2026-02-13 13:23] – 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 startet på en eller flere datoer.
+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.
-  * Der kan **kun** registreres startdatoer, der er dags dato eller tidligere. Fremtidige datoer afvises.
-  * Der må **ikke** opstå dublerede startdatoer for den samme ''DrugMedicationIdentifier'' i samme kald.
-  * Hver ''DrugMedicationIdentifier'' må kun optræde i **én gang** i kaldet (dvs. den må ikke ligge i separate ''Registrations''-elementer).
-  * Kaldet ændrer ikke 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.
 ===== Forespørgsel =====
@@ Line 15: / Line 11: @@
 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''), hvor hver dato skal være dags dato eller tidligere.
+  * 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, og reglerne
+Følgende regler gælder (på tværs af alle ''Episodes'' i samme kald):
-om **ingen fremtidige datoer**, **ingen dublerede startdatoer for samme** ''DrugMedicationIdentifier'' og
+  * Der må **kun** registreres startdatoer, hvis den angivne ''DrugMedicationIdentifier'' peger på en LMO med PN-kur (''EpisodicTreatment'' i dosering). Hvis ikke, afvises kaldet.
-**én gang** pr. ''DrugMedicationIdentifier'' skal overholdes på tværs af alle ''Registrations'' i samme kald.
+  * ''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 39: / 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>
     <EpisodeStart>2025-12-21</EpisodeStart>
-  </Registrations>
+  </Episodes>
 </RegisterEpisodesRequest>
@@ Line 56: / 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>