This is an old revision of the document!
Table of Contents
Indhold i FMK adviseringer
Indholdet i adviseringer vil i så høj grad som muligt indeholde information, der gør det muligt at identificere hvilket element der er ændret (medicinkort, lægemiddelordination, receptordination, effektuering) samt eventuelle versionsnumre.
XML skemaer for indhold i adviseringer
Adviseringer for patienter med eCPR
I forbindelse med FMK's integration af eCPR, er der blevet indført en ny IDType som vil kunne anvendes alle steder hvor der idag bliver brug id typen for CPR numre:
IDType = http://nsi.dk/advis/v10/X-eCPR
og samtidig er alle advis skema'er for adviseringer for ændringer på Medicinkort, Bestillinger, Patient-Organisations-Relationer, Ændrede patientdata, Recepter og Manglende advis blevet samlet i et nyt namespace: http://www.dkma.dk/medicinecard/xml.schema/2019/06/01 . Abonnerer et klientsystem på topics i 2019/06/01 namespacet, vil alle adviseringer vedr. såvel CPR- som eCPR personer blive modtaget. Abonneres på topics i 2012/06/01 namespacet, modtages kun adviseringer vedr CPR-personer, da de gamle skemaer ikke tillader indhold med eCPR numre. Advis'er bliver altså til en vis grad udsendt dobbelt men for forskellige topics. Man skal altså ikke abonnere på adviser i begge namespaces for at modtage både eCPR og CPR adviseringer, men kun den nye version.
Ændringer direkte på medicinkortet
Ændringer direkte på medicinkortet sker ved suspendering m.v. og medicinafstemning. I indholdet for adviseringen fremgår handlingen i Action-elementet, og patientens CPR-nummer og medicinkortets versionsnummer findes i MedicineCard-elementet.
Topic for adviseringer, CPR og eCPR: http://www.sundhedsdata.dk/fmk/2019/06/01:MedicineCardUpdated
| Handling på medicinkortet | Indhold i Action-elementet | Indhold i Action-elementet 2019/06/01 |
|---|---|---|
| Suspendering af medicinkortet | MedicineCardSuspended | (Forekommer ikke) |
| Gensuspendering af medicinkortet | MedicineCardResuspended | (Forekommer ikke) |
| Ophæv suspendering af medicinkortet | MedicineCardUnsuspended | (Forekommer ikke) |
| Ajourføring af medicinkortet | MedicineCardReviewed | MedicineCardReviewed |
| Markering af medicinkortet ikke er ajourført | MedicineCardNotReviewed | MedicineCardNotReviewed |
| Ugyldig-markering af medicinkort | MedicineCardInvalidated | MedicineCardInvalidated |
| Ophæv ugyldig-markering af medicinkort | MedicineCardInvalidCleared | MedicineCardInvalidCleared |
Eksempel - suspendering af medicinkortet
I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.sundhedsdata.dk/fmk/2019/06/01”.
<MedicineCardModification> <Action>MedicineCardSuspended</Action> <MedicineCard> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <Version>1341404077658001002</Version> </MedicineCard> </MedicineCardModification>
Ændringer af lægemiddelordinationen
Ændringer direkte af lægemiddelordination sker ved oprettelse, ændring, pausering og seponering af en del patientens medicinering, som fremgår af lægemiddelordinationen. Igen fremgår handlingen i Actionelementet, patientens CPR-nummer og medicinkortets versionsnummer findes i MedicineCard-elementet, og id og versionsnummer for lægemiddelordinationen findes i DrugMedication-elementet.
Topic for adviseringer, CPR og eCPR: http://www.sundhedsdata.dk/fmk/2019/06/01:MedicineCardUpdated
| Handling på lægemiddelordinationen | Indhold i Action-elementet |
|---|---|
| Oprettelse lægemiddelordination | DrugMedicationCreated |
| Opdatering af lægemiddelordination | DrugMedicationUpdated |
| Pausering af lægemiddelordination | DrugMedicationPaused |
| Ophævelse af pausering af lægemiddelordination | DrugMedicationUnpaused |
| Seponering af lægemiddelordination | DrugMedicationWithdrawn |
| Afseponering af lægemiddelordination | DrugMedicationUnwithdrawn |
| Administrativ sletning af lægemiddelordination | DrugMedicationInvalidated |
Eksempel - opdatering af en lægemiddelordination
I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.sundhedsdata.dk/fmk/2019/06/01”.
<MedicineCardModification> <Action>DrugMedicationUpdated</Action> <MedicineCard> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <Version>1341404077658002001</Version> <DrugMedication> <Identifier>1341404077657002001</Identifier> <Version>1341404077658002002</Version> </DrugMedication> </MedicineCard> </MedicineCardModification>
Handlinger på receptordinationer via FMK
Der kan adviseres ved handlinger foretaget på receptordinationer via FMK.
Handlinger på receptordinationer via FMK er oprettelse af receptordinationen på en lægemiddelordination, tilknytning og ophævelse af tilknytning til lægemiddelordination, markering af receptordination ikke relevant samt annullering af receptordination.
Se desuden Indhold i adviseringer fra Receptmodulet
I forbindelse med arbejdsgangen omkring hjemmesygeplejens receptanmodninger er det væsentligt at bemærke, at lægens handlinger skal foregå via FMK. Dvs. at lægen skal modtage adviseringen og oprette receptordinationen via FMK. Derved kan FMK danne en advisering ved lægens oprettelse af receptordination, hvorved hjemmesygeplejen ved at receptanmodningen er behandlet hos lægen.
Topic for adviseringer, CPR og eCPR: http://www.sundhedsdata.dk/fmk/2019/06/01:MedicineCardUpdated
| Handling på receptordination | Indhold i Action-element |
|---|---|
| Oprettelse af receptordination | PrescriptionCreated |
| Oprettelse af tilknytning til lægemiddelordination | PrescriptionAttached |
| Ophævelse af tilknytning til lægemiddelordination | PrescriptionDetached |
| Markering receptordination som ”ikke aktuel” | PrescriptionDeprecated |
| Ophævelse markering som ”ikke aktuel” | PrescriptionUndeprecated |
| Annullering af receptordination | PrescriptionCancelled |
Eksempel - oprettelse af receptordination
I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.sundhedsdata.dk/fmk/2019/06/01”.
<MedicineCardModification> <Action>PrescriptionCreated</Action> <MedicineCard> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <Version>1341404077658002001</Version> <DrugMedication> <Identifier>1341404077657002001</Identifier> <Version>1341404077658002002</Version> <Prescription> <Identifier>32768</Identifier> </Prescription> </DrugMedication> </MedicineCard> </MedicineCardModification>
Handlinger på effektueringer via FMK
Der kan adviseres ved handlinger foretaget på effektueringer via FMK.
Dvs. udelukkende handlinger på effektueringer direkte på lægemiddelordinationer. Handlinger der er foretaget på receptordinationer adviseres separat, se Indhold i adviseringer fra Receptmodulet.
Der dannes advisering ved oprettelse og sletning af effektuering på lægemiddelordinationer.
Topic for adviseringer, CPR og eCPR: http://www.sundhedsdata.dk/fmk/2019/06/01:MedicineCardUpdated
| Handling på effektuering | Indhold i Action-elementet |
|---|---|
| Oprettelse af effektuering på lægemiddelordination | EffectuationCreated |
| Sletning af effektuering på lægemiddelordination | EffectuationDeleted |
| Adm. sletning af effektuering på lægemiddelordination | EffectuationInvalidated |
Eksempel - oprettelse af effektuering
I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.sundhedsdata.dk/fmk/2019/06/01”.
<MedicineCardModification> <Action>EffectuationCreated</Action> <MedicineCard> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <Version>1341404077658002001</Version> <DrugMedication> <Identifier>1341404077657002001</Identifier> <Version>1341404077658002002</Version> <Effectuation> <Identifier>1341404189632004002</Identifier> </Effectuation> </DrugMedication> </MedicineCard> </MedicineCardModification>
Medicinanmodning
Der dannes en advisering når hjemmesygeplejen (eller andre) opretter en medicinanmodning i form af en recept- fornyelsesanmodning. En medicinanmodning i form af en udleveringsanmodning til apoteket på en eksisterende receptordination vil ikke medføre at der dannes en advisering.
Medicinanmodninger vil altid ske på et (e)CPR-nummer, og der vil blive oprettet en advisering med dette CPR-nummer som id. Desuden kan medicinanmodninger ske til en specifik receptudsteder, dvs. en organisation identificeret med ydernummer eller SKS-kode. For hver organisation der angives i PrescribingOrganisation-elementet i medicinanmodningen vil der blive oprettet en advisering til denne organisation, såfremt medicinanmodningen er specificeret til eller resultere i en receptanmodning. Herved kan f.eks. en speciallæge, der ikke har faste patienter tilknyttet, modtage adviseringer til sit ydernummer.
Topic for adviseringer, CPR og eCPR: http://www.sundhedsdata.dk/fmk/2019/06/01:OrderedEffectuationUpdated
| Handling på receptanmodninger | Indhold i Action-elementet |
|---|---|
| Oprettelse af receptanmodning | OrderedEffectuationCreated |
| Afvisning af receptanmodning | OrderedEffectuationCancelled |
| Oprettelse af receptordination ud fra receptanmodning | OrderedEffectuationFulfilled |
| Sletning af receptanmodning | OrderedEffectuationDeleted |
Ved en advis for Oprettelse af receptordination ud fra en receptanmodning vil der altid samtidigt blive dannet en advis for Oprettelse af receptordination, som beskrevet tidligere.
Eksempel - oprettelse af receptanmodning
I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.sundhedsdata.dk/fmk/2019/06/01”.
<OrderedEffectuationModification> <Action>OrderedEffectuationCreated</Action> <OrderedEffectuation> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <Identifier>1341404077678001001</Identifier> <DrugMedicationIdentifier>1341404077657002001</DrugMedicationIdentifier> </OrderedEffectuation> </OrderedEffectuationModification>
Eksempel - oprettelse af receptordination ud fra receptanmodning
I dette tilfælde adviseres der både med en OrderedEffectuation-element og med et MedicineCard-element. MedicineCard-delen svarer til hvad der adviseres omkring ved oprettelse af en receptordination. PersonIdentifier- og DrugMedicationIdentifier-elementerne forekommer derfor to gange i adviseringen.
I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.sundhedsdata.dk/fmk/2019/06/01”.
<OrderedEffectuationModification> <Action>OrderedEffectuationFulfilled</Action> <OrderedEffectuation> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <Identifier>1341404077678001001</Identifier> <DrugMedicationIdentifier>1341404077657002001</DrugMedicationIdentifier> </OrderedEffectuation> <MedicineCard> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <Version>1341404077658002001</Version> <DrugMedication> <Identifier>1341404077657002001</Identifier> <Version>1341404077658002002</Version> <Prescription> <Identifier>32768</Identifier> </Prescription> </DrugMedication> </MedicineCard> </OrderedEffectuationModification>
Patienttilknytning
Der dannes en advisering når der registreres en patienttilknytning eller en patientilknytning ophæves. Se evt. Registrering af patientdata, 1.4.4 snitflade. Patienttilknytning er ikke versioneret, og adviseringen indeholder derfor ikke noget versionsnummer.
Der returneres heller ikke en type af relation eller en organisation, idet adviseringen ikke må indeholde personfølsom information. Derfor må abonnenten af advis være forberedt på at det udsendte advis er på en type der ikke kan hentes på den pågældende snitflade eller er interessant for det pågældende system. Eks. hvis et EOJ system på POR 1.4.4 snitfladen abonnerer på advis på patienttilknytning, så vil der blive afsendt advis for alle typer tilknytninger, men i POR 1.4.4 kan kun typen “Visiteret til hjemmesygeplejen” returneres. Det betyder at adviseringer på andre patienttilknytninger f.eks. “Indlagt” vil fejle, når der hentes på det pågældende identifier i POR 1.4.4.
Topic for adviseringer, CPR og eCPR: http://www.sundhedsdata.dk/fmk/2019/06/01:PatientOrganisationRelationUpdated
| Handling på patienttilknytning | Indhold i Action-elementet |
|---|---|
| Registrer tilknytning | PatientOrganisationRelationRegistered |
| Ophæv tilknytning | PatientOrganisationRelationRemoved |
Eksempel - registrering af tilknytning
I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.dkma.dk/medicinecard/xml.schema/2019/06/01”.
<PatientOrganisationRelationModification> <Action>PatientOrganisationRelationRegistered</Action> <RelationIdentifier> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <Identifier>12313213211001001</Identifier> </RelationIdentifier> </PatientOrganisationRelationModification>
Ændring af patientdata
Der dannes en advisering når der ændres patientdata dvs. hvis der oprettes, ændres eller slettes patientdata. Se evt. Registrering af patientdata. Patientdata er ikke versioneret, og adviseringen indeholder derfor ikke noget versionsnummer.
Der returneres heller ikke en type af data eller en organisation, idet adviseringen ikke må indeholde personfølsom information. Derfor må abonnenten af advis være forberedt på at det udsendte advis er på en type af patientdata, der ikke kan hentes på den pågældende snitflade eller ikke er interessant for det pågældende system.
Registreringen af patientdata benyttes i øjeblikket kun til “Dosisdispensering i bero” registreringer. Det har før været tiltænkt INR registreringer, dette blev dog aldrig en realitet i FMK.
Topic for adviseringer, CPR og eCPR: http://www.sundhedsdata.dk/fmk/2019/06/01:PatientRegistrationUpdated
| Ændring af patientdata | Indhold i Action-elementet |
|---|---|
| Ændre patientdata | PatientRegistrationChange |
Eksempel - ændring af patientdata
I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.dkma.dk/medicinecard/xml.schema/2019/06/01”.
<PatientRegistrationModification> <Action>PatientRegistrationChange</Action> <RegistrationIdentifier> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <Identifier>12313213211001001</Identifier> </RegistrationIdentifier> </PatientRegistrationModification>
Manglende advis afsendelse
Ved manglende adviseringer sendes der en AdvisLost besked i alle Topic's hvor beskeder kan være tabt, abonnere man på flere topics vil man således få AdvisLost beskeden én gang for hver topic. Ved manglende adviseringer vil der ikke benyttes ID eller IDType da denne advis gælder for alle systemer i stedet vil isSystemNotification være sat til true, hvilket bevirker at alle abonnenter vil modtage den uanset evt. id filtrering.
Ved manglende advis er indholdet som nedenfor, ResumedDate indeholder tidspunktet hvor advis afsendelse blev genoptaget.
Eksempel - manglende advis afsendelse
I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.dkma.dk/medicinecard/xml.schema/2019/06/01”.
<AdvisLost> <ResumedDate>2014-11-13T13:23:00+01:00</ResumedDate> </AdvisLost>
Dosisdispensering advis
I forbindelse med 1.4.6E3 er der oprettet advis som er målrettet til apotekernes arbejdsgang med dosisdispensering, disse advis'er forefindes under namespacet xmlns=“http://www.dkma.dk/medicinecard/xml.schema/2019/06/01“.
Bemærk: Det har kortvarigt været tilfældet at skemaerne til disse Advis har lagt under namespacet for FMK 1.4.6E3: xmlns=“http://www.dkma.dk/medicinecard/xml.schema/2015/06/01/E3” dette var en uhensigtsmæssighed, og de faktiske advis vil komme ud under 2019 namespacet som nævnt ovenfor.
Topic for adviseringer, CPR og eCPR: http://www.sundhedsdata.dk/fmk/2019/06/01:DoseDispensingUpdated
| Handling med Dosisdispensering | Indhold i Action-elementet | Note |
|---|---|---|
| Pakning af dosisdispenseringsperiode afsluttet | PeriodFinishedPacking | Udgår |
| Dosisdispenseringsperiode skifter status | PeriodChangeStatus | Erstatter PeriodFinishedPacking |
PeriodFinishedPacking udgår da denne kunne indholdes i PeriodChangeStatus, og der ikke var brug for 2 forskellige måder at sige det samme på. Vi tillader os dette da det ikke forventes nogen systemer aktivt brugte disse advis.
Eksempel - dosisdispenserings advis
I eksemplet herunder er namespaces udeladt, men refererer til xmlns=“http://www.dkma.dk/medicinecard/xml.schema/2019/06/01”.
<DoseDispensingCardModification> <Action>PeriodChangeStatus</Action> <DoseDispensing> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <DoseDispensingCard>1</DoseDispensingCard> <DoseDispensingPeriod>2</DoseDispensingPeriod> <OldPeriodStatus>Planlagt</OldPeriodStatus> <NewPeriodStatus>Klar til pakning<NewPeriodStatus/> </DoseDispensing> </DoseDispensingCardModification>
Fulde eksempler
Nedenstående eksempel viser hvad der forventes returneret fra adviserinsservicen, såfremt en klient notificeres om (i dette eksempel) at medicinkortet for patienten med CPR-nummer 1111111118 er suspenderet. Eventuelt skal schemaLocation tilpasses hvor skemaer findes lokalt.
FMK definerer indholdet af Topic-elementet samt elementet MedicineCardModification med underelementer.
<Notify xmlns="http://docs.oasis-open.org/wsn/b-2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <NotificationMessage> <Topic Dialect="http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple">http://www.dkma.dk/medicinecard/xml.schema/2012/06/01:MedicineCard</Topic> <Message> <NotifyContent id="1111111118" idType="http://nsi.dk/advis/v10/CPR" xmlns="http://nsi.dk/advis/v10" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <MedicineCardModification xmlns="http://www.dkma.dk/medicinecard/xml.schema/2012/06/01"> <Action>MedicineCardSuspended</Action> <MedicineCard> <PersonIdentifier>1111111118</PersonIdentifier> <Version>1341404077678001001</Version> </MedicineCard> </MedicineCardModification> </NotifyContent> </Message> </NotificationMessage> </Notify>
Hvor der adviseres omkring “oprettelse af receptordination ud fra receptanmodning” findes der både et OrderedEffectuation-element og et MedicineCard-element, det sidste svarende til indholdet i en advis omkring oprettelse af receptordination. Visse elementer forekommer derfor to gange i adviseringen.
<Notify xmlns="http://docs.oasis-open.org/wsn/b-2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://docs.oasis-open.org/wsn/b-2 wsn-b-2.xsd"> <NotificationMessage> <Topic Dialect="http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple">http://www.dkma.dk/medicinecard/xml.schema/2012/06/01:MedicineCard</Topic> <Message> <NotifyContent id="1111111118" idType="http://nsi.dk/advis/v10/CPR" xmlns="http://nsi.dk/advis/v10" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <OrderedEffectuationModification xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2012/06/01 OrderedEffectuationModification.xsd" xmlns="http://www.dkma.dk/medicinecard/xml.schema/2012/06/01" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Action>OrderedEffectuationFulfilled</Action> <OrderedEffectuation> <PersonIdentifier>1111111118</PersonIdentifier> <Identifier>1341404073312001002</Identifier> <DrugMedicationIdentifier>1341404077657002001</DrugMedicationIdentifier> </OrderedEffectuation> <MedicineCard xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2012/06/01 MedicineCardModification.xsd"> <PersonIdentifier>1111111118</PersonIdentifier> <Version>1341404077658002001</Version> <DrugMedication> <Identifier>1341404077657002001</Identifier> <Version>1341404077658002002</Version> <PrescriptionMedication> <Identifier>32768</Identifier> </PrescriptionMedication> </DrugMedication> </MedicineCard> </OrderedEffectuationModification> </NotifyContent> </Message> </NotificationMessage> </Notify>
Eksempel på manglende advis advisering:
<Notify xmlns="http://docs.oasis-open.org/wsn/b-2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <NotificationMessage> <Topic Dialect="http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple"> http://www.dkma.dk/medicinecard/xml.schema/2012/06/01:MedicineCard</Topic> <Message> <NotifyContent id="1111111118" idType="http://nsi.dk/advis/v10/CPR" xmlns="http://nsi.dk/advis/v10" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <AdvisLost xmlns="http://www.dkma.dk/medicinecard/xml.schema/2012/06/01" > <ResumedDate>2014-11-13T13:23:00+01:00</ResumedDate> </AdvisLost> </NotifyContent> </Message> </NotificationMessage> </Notify>