====== Opret planlagt administration ====== Oprettelse af en [[fmk:1.6.0:xml-elementer:planlagtadministration|planlagt administration]] for en given lægemiddelordination. En planlagt administration beskriver hvordan medicinen forventes administreret af en given organisation, men organisationen behøver ikke nødvendigvis stå for den generelle dispensering af lægemidlet. En planlagt administration vil altid være knyttet til en given lægemiddelordination og kan samtidig være tilknyttet til et [[fmk:1.6.0:xml-elementer:dispenseringskort | dispenseringskort]], såfremt en given organisation faktisk forventer at stå for en fysisk dispensering af ordinationen. ====== Forespørgsel ====== [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#CreatePlannedAdministrationRequestType|Request]] 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 dette angives i ''OrganiastionIdentifier'' på den pågældende organisation. I elementet ''CreatedBy'' medsendes information omkring organisationen (udleverings- eller pakkeapoteket) og brugeren, som har foretaget oprettelsen, Modifikator. Er elementet oprettet af en anden aktør end personen, der foretager kaldet mod FMK, medsendes både et ''ReportedBy''-element og et''CreatedBy''-element. Se evt. [[fmk:generel:aktorer_pa_fmk|Aktører på FMK]]. I et ''CreatePlannedAdministration''-element medsendes detaljer omkring den planlagte administration. I hvert request kan der angives flere ''CreatePlannedAdministration'', såfremt man ønsker at oprette flere på en gang. Elementet indeholder følgende: * 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. ===== 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. 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'' 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, men hvor administrationen så angiver doseringen tages hver morgen. Elementet indeholder følgende: * Optionelt ''DosageUnit''-element: Beskriver i hvilken enhed administrationen foregår i. Såfremt den ikke angives ved oprettelse, vil enheden blive overført fra lægemiddelordinationen. * ''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 [[fmk:1.6.0:struktureret_dosering|struktureret dosering]]. * Optionelt ''PlannedAdministrationPRN''-element: Beskriver administrationen i detaljer for PN-delen. Har form som en [[fmk:1.6.0:struktureret_dosering|struktureret dosering]]. Se evt. [[fmk:1.6.0:xml-elementer:planlagtadministration#administrationsplanen|denne side]] for yderligere detaljer om administrationsplan. 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. 1111111118 2012850101 Hanne Jensen Apoteksansat 123456789 Apotek Aarhus Kobbergade Apotek Kobbergade 17, 8000 Aarhus 00000000 ABC@XYZ.com 4684681358 468138135138 6684311385 Tygges tablet tabletter 2025-04-24 1 2024-05-01 1 699999 1 1899999 1 ====== Svar ====== [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#CreatePlannedAdministrationResponseType|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. 1111111118 7813338143413 135513481358 2511 Lægemidlet er pauseret low