Differences

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

--- fmk:1.6.0:services:aktiver_pn-kur [2025-10-14 11:39] – [Svar] chsk
+++ 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 en PN-kur er påbegyndt/påbegyndes på en given dato. Kaldet laver ikke ændringer på den tilhørende lægemiddelordination (LMO), men i servicesvar, der indeholder oplysninger om LMO’en, vil det fremgå, om der er en igangværende eller en planlagt fremtidig PN-kur. Det er ikke tilladt at registrere overlappende startdatoer, der ligger inden for perioden af en tidligere PN-kur (’påbegyndt’ + varighed).
+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 =====
-==== Forespørgsel ====
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#RegisterEpisodesRequestType | Request]]
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#RegisterPRNStartDatesRequestType | Request]]
+Patienten skal altid angives via ''PersonIdentifier''.
-Ved registrering skal patienten altid angives gennem elementet ''PersonIdentifier''. Derudover skal det fremgå, hvem der er ansvarlig for ændringen i ''ModifiedBy'' elementet, og eventuelt hvem der har rapporteret oplysningerne i ''ReportedBy'', hvis registreringen ikke foretages 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 ''PRNStart'' element. Hvert ''PRNStart''-element skal angive, hvilken ordination registreringen vedrører, samt hvornår PN-kuren starter/startede. Derfor skal et ''PRNStart'' indeholde et ''DrugMedicationIdentifier'', som peger på den konkrete LMO, og et ''Start'', som angiver startdatoen for PN-kuren. Der kan angives flere ''PRNStart'' i samme forespørgsel, dog skal de alle være for den samme patient.
+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. Der skal angives mindst én dato.
-<code xml RegisterPRNStartDatesRequest.xsd>
+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).
-<RegisterPRNStartDatesRequest>
+Der kan angives flere ''Episodes'' i samme forespørgsel, men de skal alle vedrøre den samme patient.
+<code xml RegisterEpisodesRequest.xsd>
+<RegisterEpisodesRequest>
   <PersonIdentifier source=”CPR”>1111111118</PersonIdentifier>
   <ModifiedBy>
-      <AuthorisedHealthcareProfessional>
+    <HealthcareProfessional>
-        <AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier>
+      <Identifier source="Autorisation">2Q5TK</Identifier>
-        <Name>Tess Christoffersen</Name>
+      <Name>Tess Christoffersen</Name>
-      </AuthorisedHealthcareProfessional>
+    </HealthcareProfessional>
-      <Organisation>
+    <Organisation>
-        <Name>Lægerne Vestergade</Name>
+      <Identifier source="Yder">66974</Identifier>
-        <TelephoneNumber>86521348</TelephoneNumber>
+      <Type>Yder</Type>
-        <Type>Yder</Type>
+      <Name>Lægerne Vestergade</Name>
-        <Identifier source="Yder">66974</Identifier>
+      <TelephoneNumber>86521348</TelephoneNumber>
-      </Organisation>
+    </Organisation>
-    </ModifiedBy>
+  </ModifiedBy>
-  <PRNStart>
+  <Episodes>
     <DrugMedicationIdentifier>234127183</DrugMedicationIdentifier>
-    <Start>2025-10-01</Start>
+    <EpisodeStart>2025-10-01</EpisodeStart>
-  </PRNStart>
+  </Episodes>
-  <PRNStart>
+  <Episodes>
     <DrugMedicationIdentifier>234127182</DrugMedicationIdentifier>
-    <Start>2025-11-15</Start>
+    <EpisodeStart>2025-11-15</EpisodeStart>
-  </PRNStart>
+    <EpisodeStart>2025-12-21</EpisodeStart>
-</RegisterPRNStartDatesRequest>
+  </Episodes>
+</RegisterEpisodesRequest>
 </code>
-==== Svar ====
+===== Svar =====
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#RegisterPRNStartDatesResponseType | request]]
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#RegisterEpisodesResponseType | Response]]
+Svaret indeholder den angivne ''PersonIdentifier'' samt de ''DrugMedicationIdentifier'', hvorpå der er registreret startdatoer. ''DrugMedicationIdentifier'' returneres i sorteret (stigende) rækkefølge.
-<code xml RegisterPRNStartDatesResponse.xsd>
+<code xml RegisterEpisodesResponse.xsd>
-<RegisterPRNStartDatesResponse>
+<RegisterEpisodesResponse>
   <PersonIdentifier source=”CPR”>1111111118</PersonIdentifier>
-  <DrugMedicationIdentifier>234127183</DrugMedicationIdentifier>
   <DrugMedicationIdentifier>234127182</DrugMedicationIdentifier>
-</RegisterPRNStartDatesResponse>
+  <DrugMedicationIdentifier>234127183</DrugMedicationIdentifier>
+</RegisterEpisodesResponse>
 </code>