====== Aktiver 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 =====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#RegisterEpisodesRequestType | Request]]

Patienten skal altid angives via ''PersonIdentifier''.

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 ''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.

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>

<RegisterEpisodesRequest>
  <PersonIdentifier source=”CPR”>1111111118</PersonIdentifier>
  <ModifiedBy>
    <HealthcareProfessional>
      <Identifier source="Autorisation">2Q5TK</Identifier>
      <Name>Tess Christoffersen</Name>
    </HealthcareProfessional>
    <Organisation>
      <Identifier source="Yder">66974</Identifier>
      <Type>Yder</Type>
      <Name>Lægerne Vestergade</Name>
      <TelephoneNumber>86521348</TelephoneNumber>
    </Organisation>
  </ModifiedBy>
  <Episodes>
    <DrugMedicationIdentifier>234127183</DrugMedicationIdentifier>
    <EpisodeStart>2025-10-01</EpisodeStart>
  </Episodes>
  <Episodes>
    <DrugMedicationIdentifier>234127182</DrugMedicationIdentifier>
    <EpisodeStart>2025-11-15</EpisodeStart>
    <EpisodeStart>2025-12-21</EpisodeStart>
  </Episodes>
</RegisterEpisodesRequest>

</code>

===== Svar =====

[[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 RegisterEpisodesResponse.xsd>

<RegisterEpisodesResponse>
  <PersonIdentifier source=”CPR”>1111111118</PersonIdentifier>
  <DrugMedicationIdentifier>234127182</DrugMedicationIdentifier>
  <DrugMedicationIdentifier>234127183</DrugMedicationIdentifier>
</RegisterEpisodesResponse>

</code>