Fælles Medicinkort - Dokumentation

User Tools

Site Tools

You are here: start » fmk » 1.6.0 » services » opdater_planlagt_administration
fmk:1.6.0:services:opdater_planlagt_administration

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
fmk:1.6.0:services:opdater_planlagt_administration [2025-10-07 12:46] – [PlannedAdministration] sasfmk:1.6.0:services:opdater_planlagt_administration [2026-03-06 08:53] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ====== Opdater planlagt administration ====== ====== Opdater planlagt administration ======
-Opdatering af en [[fmk:1.6.0:xml-elementer:planlagtadministration|planlagt administration]] for en given lægemiddelordination. Opdatering kan ske af mange årsager, oftest vil det være en nødvendighed pga opdateringer i patientens medicin, andre gange er det påkrævet for at sikre den planlagte administration holdes up-to-date med lægemiddelordinationen.+Opdatering af en [[fmk:1.6.0:xml-elementer:planlagtadministration|planlagt administration]] for en given lægemiddelordination. Opdatering kan ske af mange årsager. Oftest vil det være en nødvendighed pga. opdateringer i patientens medicin, andre gange er det påkrævet, for at sikre den planlagte administration holdes up-to-date med lægemiddelordinationen.
  
-Ved en opdatering kan administrationen tilknyttes et dispenseringskort såfremt den ikke allerede var det, eller løsrive en planlagt administration fra at dispenseringskort, såfremt det er nødvendigt. Dette vil også betyde, at den planlagte administration vil kunne flyttes fra et dispenseringskort til et andet, fx hvis en apoteker skal påbegynde dosisdispensering i flere trin.+Ved en opdatering kan administrationen tilknyttes et dispenseringskort, såfremt den ikke allerede var det, eller løsrive en planlagt administration fra et dispenseringskort, såfremt det er nødvendigt. Dette vil også betyde, at den planlagte administration vil kunne flyttes fra et dispenseringskort til et andet, f.eks. hvis en apoteker skal påbegynde dosisdispensering i flere trin.
  
 ====== Forespørgsel ====== ====== Forespørgsel ======
- I request-dokumentet skal der medsendes en ''PersonIdentifier'' på den patient som forespørgslen omhandler. Såfremt den pågældende planlagte administration skal anvendes på et dosisdispenseringskort til organisationer, skal man i stedet angive ''OrganiastionIdentifier'' på den pågældende organisation. 
  
-I elementet ''Modified'' medsendes information omkring organisationen (udleverings eller pakkeapoteket) og brugeren som har foretaget opdateringen, Modifikator. Er elementet oprettet af en anden aktør end personen der foretager kaldet mod FMK, medsendes både et ''ReportedBy''-element, og ''ModifiedBy''. Se evt. [[fmk:generel:aktorer_pa_fmk|Aktører på FMK]]. +[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#UpdatePlannedAdministrationRequestType|Request]]
  
-I et ''UpdatePlannedAdministration'' element medsendes detaljer omkring den planlagte administration. I hvert request kan der angives flere ''UpdatePlannedAdministration'', såfremt man ønsker at opdatere flere på en gang. Elementet indeholder følgende: +I forespørgslen skal der medsendes en ''PersonIdentifier'' på den patient, som forespørgslen omhandler. Såfremt den pågældende planlagte administration skal anvendes på et dosisdispenseringskort til organisationer, skal man i stedet angive ''OrganisationIdentifier'' på den pågældende organisation. 
-  * ''Identifier'', ID på den planlagte administration som ønskes opdateret. + 
-  * ''Version'', Versions-nummer på den planlagte administration som ønskes opdateret. +I elementet ''ModifiedBy'' medsendes information omkring organisationen (udleverings- eller pakkeapoteket) og brugeren, som har foretaget opdateringen, [[fmk:1.6.0:xml-elementer:modifikator#:~:text=med%20SOR%20ID-,Modifikator,-FMK%20anvender%20så|Modifikator]]. Er elementet oprettet af en anden aktør end personen, der foretager kaldet mod FMK, medsendes både et ''ReportedBy''-element, og ''ModifiedBy''. Se evt. [[fmk:generel:aktorer_pa_fmk|Aktører på FMK]].  
-  * Optionelt: ''DispensingCardIdentifier'', ID på det dispenseringskort som den planlagte administration skal tilknyttes. Angives denne ikke, bliver administration kun tilknyttet ordinationen. + 
-  * ''DrugMedication'', element som indeholder ''Identifier'' og ''Version'' på den lægemiddelordination som administrationen skal tilknyttes. +I et ''UpdatePlannedAdministration''-element medsendes detaljer omkring den planlagte administration. I hvert request kan der angives flere ''UpdatePlannedAdministration'', såfremt man ønsker at opdatere flere på en gang.  
-  * ''AdministrationInstruction'', værdi som beskriver hvor administrationen indgives.+ 
 +Elementet indeholder følgende: 
 +  * ''Identifier'': ID på den planlagte administration, som ønskes opdateret. 
 +  * ''Version'': Versions-nummer på den planlagte administration, som ønskes opdateret. 
 +  * Optionelt: ''DispensingCardIdentifier'': ID på det dispenseringskort, som den planlagte administration skal tilknyttes. Angives denne ikke, bliver administration kun tilknyttet ordinationen. 
 +  * ''DrugMedication'': Element som indeholder ''Identifier'' og ''Version'' på den lægemiddelordination, som administrationen skal tilknyttes. 
 +  * ''AdministrationInstruction'': Værdi som beskriver, hvor administrationen indgives.
   * Valg mellem kombinationen af et ''PlannedAdministrationAccordingToDrugMedication'' element + Optionelt ''DosageUnit'' element **eller** et ''PlannedAdministration'' element.   * Valg mellem kombinationen af et ''PlannedAdministrationAccordingToDrugMedication'' element + Optionelt ''DosageUnit'' element **eller** et ''PlannedAdministration'' element.
  
 ===== PlannedAdministrationAccordingToDrugMedication ===== ===== PlannedAdministrationAccordingToDrugMedication =====
-''PlannedAdministrationAccordingToDrugMedication'' elementet angiver at administrationen ønskes oprettet med en administration magen til lægemiddelordinationens dosering. Dette er en mulighed som kan anvendes såfremt lægens dosering på ordinationen er tilstrækkelig struktureret til at den kan oversættes direkte til en planlagt administration. I tilfælde hvor dette ikke kan lade sig gøre, vil forespørgslen blive besvaret med en valideringsfejl.+''PlannedAdministrationAccordingToDrugMedication'' elementet angiver, at administrationen ønskes oprettet med en administration magen til lægemiddelordinationens dosering. Dette er en mulighed, som kan anvendes, såfremt lægens dosering på ordinationen er tilstrækkelig struktureret til, at den kan oversættes direkte til en planlagt administration. I tilfælde, hvor dette ikke kan lade sig gøre, vil forespørgslen blive besvaret med en valideringsfejl.
  
-Sammen med ''PlannedAdministrationAccordingToDrugMedication'' kan også angives et ''DosageUnit'' element, hvor indmelder kan få påsat sin egen doseringsenhed, såfremt den fra lægemiddelordinationen ikke er passende, eller indmelder benytter sig af andre standardenheder. Dette ses ofte ved dosisdispensering, hvor apoteket altid antager deres enheder er i "stk"+Sammen med ''PlannedAdministrationAccordingToDrugMedication'' kan også angives et ''DosageUnit''-element, hvor indmelder kan få påsat sin egen doseringsenhed, såfremt den fra lægemiddelordinationen ikke er passende, eller indmelder benytter sig af andre standardenheder. Dette ses ofte ved dosisdispensering, hvor apoteket altid antager, at deres enheder er i "stk."
  
 ===== PlannedAdministration ===== ===== PlannedAdministration =====
-''PlannedAdministration'' elementet beskriver en administration som defineres af brugeren, dette vil ofte være en præcisering af lægens dosering, fx i tilfælde hvor lægen ikke angiver et doseringstidspunkt, hvor administrationen så angiver doseringen tages hver morgen.+''PlannedAdministration''-elementet beskriver en administration, som defineres af brugeren. Dette vil ofte være en præcisering af lægens dosering, f.eks. i tilfælde hvor lægen ikke angiver et doseringstidspunkt og hvor administrationen så angiver doseringen tages hver morgen. 
  
-elementet indeholder følgende: +Elementet indeholder følgende: 
-  * Optionelt: ''DosageUnit'' element, beskriver hvilken enhed administrationen foregår i. Såfremt den ikke angives, vil enheden blive overført fra lægemiddelordinationen. +  * Optionelt ''DosageUnit''-element: Beskriver hvilken enhed administrationen foregår i. Såfremt den ikke angives ved oprettelse, vil enheden blive overført fra lægemiddelordinationen. 
-  * ''ValidFrom'' element, som udpeger hvornår administrationsplanen er gyldig fra. +  * ''ValidFrom''-element: Beskriver fra hvornår administrationsplanen er gyldig fra. 
-  * Optionelt: ''PlannedAdministrationFixed'' element, beskriver administrationen i detaljer for den faste del. Har form som en struktureret dosering. +  * Optionelt ''PlannedAdministrationFixed''-element: Beskriver administrationen i detaljer for den faste del og har form som en [[fmk:1.6.0:struktureret_dosering|struktureret dosering]]. 
-  * Optionelt: ''PlannedAdministrationAccordingToNeed'' element, beskriver administrationen i detaljer for PN-delen. Har form som en struktureret dosering.+  * Optionelt ''PlannedAdministrationPRN''-element:Beskriver administrationen i detaljer for PN-delen og har form som en [[fmk:1.6.0:struktureret_dosering|struktureret dosering]].
  
-Det kan bemærkes at alle elementer faktisk er optionelle, og det er derfor helt tilladt at der oprettes en planlagt administration uden faktisk at angive en administration. +Se evt. [[fmk:1.6.0:xml-elementer:planlagtadministration#administrationsplanen|denne side]] for yderligere detaljer om administrationsplan.
  
-<file xml UpdatePlannedDispensing.xml>+Det kan bemærkes, at alle elementer faktisk er optionelle, og det er derfor helt tilladt at der oprettes en planlagt administration uden faktisk at angive en administration.  
 + 
 +<file xml UpdatePlannedAdministration.xml>
 <UpdatePlannedAdministrationRequest> <UpdatePlannedAdministrationRequest>
     <PersonIdentifier source="CPR">1111111118</PersonIdentifier>     <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
Line 43: Line 50:
         <Role>Apoteksansat</Role>         <Role>Apoteksansat</Role>
         <Organisation>         <Organisation>
 +            <Identifier source="EAN-Lokationsnummer">123456789</Identifier>
 +            <Type>Apotek</Type>
             <Name>Aarhus Kobbergade Apotek</Name>             <Name>Aarhus Kobbergade Apotek</Name>
             <AddressLine>Kobbergade 17, 8000 Aarhus</AddressLine>             <AddressLine>Kobbergade 17, 8000 Aarhus</AddressLine>
             <TelephoneNumber>00000000</TelephoneNumber>             <TelephoneNumber>00000000</TelephoneNumber>
             <EmailAddress>ABC@XYZ.com</EmailAddress>             <EmailAddress>ABC@XYZ.com</EmailAddress>
-            <Type>Apotek</Type> 
-            <Identifier source="EAN-Lokationsnummer">123456789</Identifier> 
         </Organisation>         </Organisation>
     </ModifiedBy>     </ModifiedBy>
Line 91: Line 98:
  
 ====== Svar ====== ====== Svar ======
-Svaret fra FMK indeholder det medsendte ''PersonIdentifier'' eller ''OrganisationIdentifier''. Desuden returneres et eller flere ''PlannedAdministration'' elementer som indeholder ''Identifier'', ''Version'' og ''Warning'' elementer. Såfremt man har valgte at oprette mere end en planlagt administration i samme request, svarer ''PlannedAdministration'' elementerne i svaret til den rækkefølge som de planlagte administration blev angivet i forespørgslen.+ 
 +[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#UpdatePlannedAdministrationResponseType|Response]] 
 + 
 +Svaret fra FMK indeholder det medsendte ''PersonIdentifier'' eller ''OrganisationIdentifier''. Desuden returneres et eller flere ''PlannedAdministration''-elementer, som indeholder ''Identifier'', ''Version'' og ''Warning'' elementer. Såfremt man har valgt at oprette mere end en planlagt administration i samme request, svarer ''PlannedAdministration''-elementerne i svaret til den rækkefølge, som den planlagte administration blev angivet i forespørgslen.
  
 <file xml UpdatePlannedAdministrationResponse.xml> <file xml UpdatePlannedAdministrationResponse.xml>
fmk/1.6.0/services/opdater_planlagt_administration.1759841182.txt.gz · Last modified: (external edit)
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki