====== Planlagt administration ====== Planlagt administration (PA) er et generelt begreb, som benyttes til at beskrive de doseringsplaner som oprettes af hjemmeplejen og/eller apoteket i forbindelse med dispenseringen af et [[fmk:1.6.0:xml-elementer:dispenseringskort]]. Planlagt administration beskriver den plan, som der foreligger for dispenseringen af en given [[fmk:1.6.0:xml-elementer:Lægemiddelordinationer|lægemiddelordination]] **Bemærk** der er ikke tale om en faktisk dispensering til borgeren, blot planen for hvordan medicinen forventes at blive dispenseret. En planlagt administration vil altid skulle tage form af en struktureret dosering, som bør reflektere den dosering, som er angivet på den lægemiddelordination, som denne administrationsplan er tilknyttet. En planlagt administration skal altid være tilknyttet en given lægemiddelordination. I de fleste tilfælde vil administration også være tilknyttet et [[fmk:1.6.0:xml-elementer:dispenseringskort]] men dette er ikke et krav. Det er også muligt at flytte en planlagt administration mellem 2 dispenseringskort, såfremt der ikke er andre forhold, der forhindrer dette. ===== Indhold ===== En planlagt administration findes i nogle forskellige versioner på FMK, alt efter hvilken service der benyttes til at hente data med. Men generelt vil den indeholde følgende elementer: * ''Identifier'' unikt ID for den pågældende PA * ''Version'' Versionsnummer, enten nuværende eller historisk * ''Created'' [[fmk:1.6.0:xml-elementer:modifikator|Modifikator]] oplysninger for personen som originalt oprettede denne PA * Optionelt: ''Modified'' [[fmk:1.6.0:xml-elementer:modifikator|Modifikator]]-oplysninger for personen som senest har foretaget ændringer på denne PA * Optionelt: ''ReportedBy'' [[fmk:1.6.0:xml-elementer:modifikator|Modifikator]]-oplysninger for personen som seneste har indberettet ændringer på denne PA * ''DrugMedication'' Oplysninger omkring [[fmk:1.6.0:xml-elementer:Lægemiddelordinationer|lægemiddelordinationen]] som PA er tilknyttet, kan også være en historisk version. * Optionelt: ''DispensingCardIdentifier'' ID'et på det dispenseringskort PA'en er tilknyttet * Optionelt: ''AdministrationInstruction'' en indtagelsesvejledning * Optionelt: ''DosageUnit'' en doseringsenhed * ''ValidFrom'' markeringen af hvornår administrationsplanen er gyldig fra (effektivt en startdato) * Optionelt: ''PlannedAdministrationFixed'' en række doseringsstrukturer for den faste del af administrationsplanen * Optionelt: ''PlannedAdministrationPRN'' en række doseringsstrukturer for PN delen af administrationsplanen * Optionelt: ''DispensingEndDate'' en planlagt slutdato for dispensering. Denne er beregnet ud fra doseringsstrukturen på lægemiddelordinationen. **Bemærk** Der vil kunne forekomme nogle andre elementer på de planlagte administrationer i nogle services. Fx forekommer et ''ValidWarrant'' element på den planlagte administration, når denne hentes igennem [[fmk:1.6.0:services:hent_dispenseringskort|hent dispenseringskort]] og ''DispensingCardIdentifier'' indgår ikke, da oplysningen er implicit i den situation. Disse afvigelser bør stå i den enkelte services' beskrivelse. ==== Bemærkninger ==== === Tom planlagt administration === Det er muligt at oprette en tom planlagt administration. Med dette menes, at der hverken angives ''PlannedAdministrationFixed'' eller ''PlannedAdministrationPRN''. Dette kan benyttes til at skabe en relation mellem en lægemiddelordination og et dispenseringskort, signalerende at organisationen bag dispenseringskortet forventer at ville dispensere den pågældnede ordination, men har endnu ikke taget stilling til den egentlige administrationsplan. FMK vil råde til, at såfremt det er muligt benyttes den mulighed ikke. Det er til alles bedste, at den egentlige administrationsplan oprettes samtidig, således at administrationsplanen bliver synlig for alle parter så hurtigt som muligt. Men såfremt systemet ønsker et workflow, hvor alle relevante ordinationer først tilknyttes, og herefter gennemgåes enkeltvis for at oprette administrationsplanen, supporteres dette ved at gøre som nævnt ovenfor. === DosageUnit er optionelt === Dette er primært en fallback, såfremt der hverken på lægemiddelordinationen eller den tilhørende planlagte administration er angivet en doseringsenhed. I dette tilfælde har FMK faktisk en default til at angive "stk.". Men såfremt dette bliver problematisk i fremtiden, tillader vi os i skemaet, at dette felt er optionelt. ===== Planlagt administration ID og Version ===== ''PlannedAdministration''-elementet indeholder først en identifikation af den planlagte administration, med ''Identifier'' og versionsnummer i ''Version''. Bemærk, at versionsnumrene ikke kan antages at være fortløbende. Se i øvrigt [[fmk:generel:versionsnummerering|Versionsnummerering]] for en generel beskrivelse af versionering i FMK. ===== Oprettet af (Created) ===== Created-elementet indeholder information omkring aktøren, der har oprettet den planlagte administration. Dette element er obligatorisk. Bemærk at den planlagte administration kan være oprettet af en person, der ikke er en autoriseret sundhedsperson. Dette er muligt, når personen arbejder på vegne af en autoriseret sundhedsperson. Created/DateTime-elementet indeholder tidspunktet for den planlagte administrations oprettelse, som det er registreret af FMK. "Oprettet af" vil blive registreret ved oprettelse af den planlagte administration, og information omkring "oprettet af" person, organisation og tidspunkt vil blive returneret på samtlige efterfølgende versioner af lægemiddelordinationen. ===== Ændret af (Modified) ===== Elementet Modified indeholder information omkring personen, der har oprettet versionen af den planlagte administration, samt tidspunkt. Er den planlagte administration ændret siden oprettelsen, vil der i Modified-elementet blive returneret information omkring personen, der har foretaget ændringen, se [[fmk:1.6.0:xml-elementer:modifikator|Modifikator]]. Modified/DateTime indeholder tidspunktet for seneste ændring, som det er registreret af FMK. Der returneres "ændret af" for seneste ændring. Er der sket ændringer mellem oprettelsen og seneste ændring, vil disse ikke blive returneret (f.eks. i form af yderligere ”Modified”-elementer), men skal søges i de tidligere versioner. Modified vil kun være knyttet til versionen af den planlagte administration. ===== Indrapporteret af (ReportedBy) ===== Elementet ReportedBy indeholder information omkring personen der har indrapporteret versionen af den planlagte administration til FMK, dvs. "certifikatejer". Elementet er ikke vist i eksemplet herunder, og vil ikke altid forekomme, se [[fmk:1.6.0:xml-elementer:modifikator|Modifikator]]. ReportedBy vil, såfremt det findes, kun være knyttet til versionen af lægemiddelordinationen. ===== Lægemiddelordinationen ===== I ''DrugMedication'' elementet findes informationer fra [[fmk:1.6.0:xml-elementer:Lægemiddelordinationer|lægemiddelordinationen]] som den planlagte administration er tilknyttet. Bemærk at dette kan være en historisk version af lægemiddelordinationen, også selvom man kigger på den seneste version af den planlagte administration. Det forventes, at de personer, som står bag den planlagte administration (og dispenseringskortet som den kan være tilknyttet), holder den planlagte administration up-to-date med lægemiddelordinationen. Det vil i realiteten sige, at når lægemiddelordinationen opdateres, vil det være påkrævet, at der laves en opdatering af den planlagte administration, såfremt den stadig er relevant for patientens dispensering. ===== Dispensingskort ===== I et ''DispensingCardIdentifier'' element kan der være angivet ID'et på det dispenseringskort, som den planlagte administration er tilknyttet. FMK forventer, at i de fleste tilfælde vil denne værdi være angivet, da det er et krav, at en planlagt administration er tilknyttet et dispenseringskort, såfremt organisationen ønsker at foretage en egentlig dispenserings af den planlagte administration for en given periode. ===== Indtagelsesvejledning ===== I elementet ''AdministrationInstruction'' kan der angives en indtagelsesvejledning, såfremt dette er relevant. Er oftest benyttet ved apoteket og dosisdispensering, såfremt en given pose fx skal indtages specifikt ved måltid el.lign. Feltet er optionelt og kan anvendes, når der er behov for en speciel instruktion i, hvordan medicinen bør indtages. ===== Doseringsenhed ===== I elementet ''DosageUnit'' kan der angives en doseringsenhed for den planlagte dispensering. Oftest vil denne stemme overens med doseringsenheden fra lægemiddelordinationen. **Bemærk** dog at Apoteket, ved dosisdispensering, i mange tilfælde foretrækker at angive deres doseringer i "Stk." og ikke i formen for lægemidlet fx "Tablet". ===== Administrationsplanen ===== Elementerne ''ValidFrom'', ''PlannedAdministrationFixed'' og ''PlannedAdministrationPRN'' udgør tilsammen den samlede administrationsplan for den pågældende lægemiddelordination. ''ValidFrom'' markerer tidspunktet for, hvornår planen er gyldig fra, det der før 1.6.0 kunne antages at være Doseringsstart. Denne er tilknyttet den enkelte version af den planlagte administration, dvs. den kan ændres imellem versioner. Ved opdatering bør denne oftest angives til dags-dato, alternativt til en dato i fremtiden, såfremt administrationen først begynder i fremtiden. ''PlannedAdministrationFixed'' udfyldes med administrationsplaner for den faste del af doseringen. Elementet indeholder en række ''PlannedAdministrationStructure'' elementer, som hver udgør en administrationsperiode af en given længde (eller uendelig). Ligesom på [[fmk:1.6.0:struktureret_dosering|struktureret dosering]] er rækkefølgen på disse vigtig, da den første angivne periode altid, er den der begyndes med, og den sidste angivne "afslutter" administrationsplanen. ''PlannedAdministrationPRN'' er magen til ''PlannedAdministrationFixed'', men råder over PN delen af doseringen. ''PlannedAdministrationStructure'' elementer indeholder følgende: * Optionelt: angivelse af ''IterationInterval'' eller ''NotIterated'' * Optionelt: angivelse af en ''PeriodLength'' * Optionelt: angivelse af en række ''Day'' elementer. **Bemærk** I 1.4.X havde man en dedikeret ''EmptyStructure'' struktur som signalerede, at man havde en periode uden en administrationsplan. Dette ændres til, at der i 1.6.0 blot udlades at angive nogle eller alle felterne. Hvis der er tale om en fastsat periode, så angives kun ''PeriodLength''. Såfremt der er tale om en tom periode uden slut, angivet et helt tomt element. ''IterationInterval'' anvendes, såfremt administrationsplanen gentages efter et givent interval (angivet i dage). ''NotIterated'' anvendes såfremt administrationsplanen skal udpensles i de specifikke dage med ''Day''-elementer hele vejen igennem perioden. ''PeriodLength'' angiver længden af en administrationsperiode. Såfremt administrationsperioden ikke skal afsluttes (i.e. fortsætte uendeligt), undlades dette element. ''Day'' elementerne udspecificerer doseringerne på de enkelte dage. Disse elementer indeholder: * Et ''Number'' element som udpeger dags-nummeret, hvor der skal gives en dosis. * En række ''Dose'' elementer der angiver de enkelte doseringer, der skal gives. ''Dose'' elementerne indeholder et "optionelt" ''Time'' element, som udpeger tidspunktet for doseringen fx Morgen. Dernæst et optionelt ''SequenceNumber'' element, som typisk anvendes ved dosisdispensering til at skille doseringer på samme tidspunkt ad i forskellige poser. Og til sidst angives et ''Quantity'' element, som angiver mængden af doseringsenheder, der gives på det pågældende tidspunkt. **Bemærk** ''Time'' elementerne er optionelle, men det forventes kun at dette supporteres for PN-delen af administrationsplanen. ===== Eksempel ===== 121818135 215618138 2012850101 Hanne Jensen Apoteksansat 123456789 Apotek Aarhus Kobbergade Apotek Kobbergade 17, 8000 Aarhus 00000000 ABC@XYZ.com 2025-04-24T17:01:09Z 8183183183 7484358138 823823231231 2025-04-20 2026-12-12 stk Efter måltid 2025-04-24 1 1 1199999 1 299999 1