Fælles Medicinkort - Dokumentation

En borgers dosiskort kan hentes på 2 måder:

• Som PDF, hvilket ofte er tilstrækkelig for visning af dosiskort, se Hent dosisdispenseringskort som PDF
• Integreret i anvendersystemet via den nedenfor beskrevet service, som et dynamisk dosiskort. Hvad angår dynamisk visning af dosisdispenseringskort i anvendersystemer for sundhedsfaglige, anbefaler SDS at man anvender Hent dosisdispenseringskort som PDF. Der sker fortsat små justeringer af dosisdispenseringskortet, som løbende kan rettes på det centrale pdf.

For at hente dosisdispenseringskortet skal man kalde med et af følgende request-formater. De indeholder alle patientens CPR-nr. (PersonIdentifier) og giver mulighed for at inkludere en detaljeret specifikation (IncludeDetailedSpecification). En detaljeret specifikation betyder, at dosisdispenseringen leveres, ikke bare i skema-form, men desuden også i en form hvor man direkte kan aflæse indholdet af hver pose (DoseDispensedUnit).

Den første variant bruges til at hente dosisdispenseringens aktuelle periode, altså dosisdispenseringskort med den periode, hvor StartDate-EndDate omfatter dags dato (hvis en sådan er kendt i FMK). Hvis patienten har flere forskellige dosisdispenseringskort, returneres de i separate strukturer og perioderne er ikke nødvendigvis sammenfaldende tidsmæssigt.

<GetDoseDispensingCardRequest>
    <PersonIdentifier source="CPR">1403837853</PersonIdentifier>
    <RequestedPeriod>
        <CurrentPeriod/>
    </RequestedPeriod>
    <IncludeDetailedSpecification/>
</GetDoseDispensingCardRequest>

Den anden variant bruges til at hente dosisdispenseringens aktuelle og kommende perioder. Ud over den aktuelle periode omfatter det den kommende periode, såfremt den er kendt i FMK. Såfremt tidsfrist for ændringer til den kommende periode er overskredet, og den næstkommende periode også er kendt i FMK, så returneres denne også. Altså normalt to perioder, og hvis man kalder mellem Deadline og StartDate kan der returneres tre perioder. Hvis patienten har flere dosiskort, så kan der returneres 2 eller 3 perioder pr. dosiskort.

<GetDoseDispensingCardRequest>
    <PersonIdentifier source="CPR">1403837853</PersonIdentifier>
    <RequestedPeriod>
        <CurrentAndPendingPeriods/>
    </RequestedPeriod>
    <IncludeDetailedSpecification/>
</GetDoseDispensingCardRequest>

Den tredie variant bruges til at hente dosisdispenseringens kommende perioder. Denne fungerer som den ovenstående, dog uden at returnere den aktuelle periode. Denne vil typisk være interessant for udleverings-eller pakke-apoteket ifm. klargøring til pakning.

<GetDoseDispensingCardRequest>
    <PersonIdentifier source="CPR">1403837853</PersonIdentifier>
    <RequestedPeriod>
        <PendingPeriods/>
    </RequestedPeriod>
    <IncludeDetailedSpecification/>
</GetDoseDispensingCardRequest>

Den fjerde variant bruges til at hente dosisdispenseringen uden perioder. Det resulterer at der ses bort fra de indberettede dosisdispenseringsperioder og der returneres blot en 'dummy-periode' med alt dosisdispenseret medicin på tværs af dosisdispenseringsperioder. Bemærk med denne variant er det ikke tilladt at requeste detaljer (IncludeDetailedSpecification).

<GetDoseDispensingCardRequest>
    <PersonIdentifier source="CPR">1403837853</PersonIdentifier>
    <RequestedPeriod>
        <IgnorePeriods/>
    </RequestedPeriod>
</GetDoseDispensingCardRequest>

Den sidste variant bruges til at hente en dosisdispenseringsperiode på en specifik dato i fortiden, altså dosisdispenseringskort med den periode, hvor StartDate-EndDate omfatter en given dato (som er dags dato eller tidligere). Hvis patienten har flere forskellige dosisdispenseringskort med en periode på den givne dato, returneres de i separate strukturer og perioderne er ikke nødvendigvis sammenfaldende tidsmæssigt.

<GetDoseDispensingCardRequest>
    <PersonIdentifier source="CPR">1403837853</PersonIdentifier>
    <RequestedPeriod>
        <RequestedDate>2016-06-10</RequestedDate>
    </RequestedPeriod>
    <IncludeDetailedSpecification/>
</GetDoseDispensingCardRequest>

Svaret fra servicen varierer i de forskellige faser i udrulningen af dosisdispensering. Tidligere har FMK vist et beregnet dosiskort, denne funktionalitet er blevet udfaset og der vil derfor ikke returneres et dosiskort før apoteket har taget dosisdispensering via FMK i brug.

I den sidste fase vil der være tale om et 'eksplicit' dosisdispenseringskort. Det vil sige, hvis apoteket har indberettet et dosisdispenseringskort på FMK, og der pakkes ud fra dette i den pågældende periode, så vil det også være dette dosisdispenseringskort, der returneres.

Et response kan for eksempel se ud som nedenstående, som er inkl. detaljeret specifikation. Hvis request-strukturen ikke indeholder IncludeDetailedSpecification-elementet, så undlades DetailedSpecification-strukturerne i responset.

DetailedSpecification angiver indholdet og rækkefølgen af alle poser på dosisrullen for den pågældende periode. Dette er på dosiskortet bestemt ud fra sekvens numrene i de planlagte administrationer.

Bemærk at lægemiddelordinationer leveres med kun den relevante recept på uanset om der evt. findes andre recepter på samme lægemiddelordination. Tilsvarende leveres kun 0 eller 1 recept-effektuering pr. recept, nemlig den relevante recept-effektuering for den dosisdispenseringsperiode, hvorunder lægemiddelordinationen er indlejret, såfremt apoteks-ekspeditionen til denne periode er foretaget. Hvis det er en fremtidig periode, hvor apoteks-ekspeditionen endnu ikke er foretaget, så inkluderes ingen recept-effektueringer derpå.

Terminologien omkring recepter er ændret en smule fra 1.4.4 til 1.4.6, derfor hedder recept-elementet Prescription i 1.4.6.E2 og PrescriptionMedication i 1.4.4.E2. Der er ligeledes en række forskelle på strukturen af en recept i 1.4.4.E2 og 1.4.6.E2, sv.t. recept-strukturen ser ud i hhv. 1.4.4 og 1.4.6.

Privatmarkerede lægemiddelordinationer vises uden nogen detaljer, medmindre man kalder med angivelse af samtykke eller værdispring. Dette angives i en ConsentHeader (læs evt. mere om dette her). Navnet på denne struktur er forskelligt i 1.4.4.E2 (DoseDispensedMedicationWithNegativeConsent) og 1.4.6.E2 (PrivateDoseDispensedMedication). Udleveringsapoteket og pakkeapoteket har implicit samtykke til at se data, såfremt det er relevant i en aktuel bestilling, og i forbindelse med dosisdispensering er der altid en aktuel bestilling til den kommende dosispakning.

Et dosisdispenseringskort der er vedligeholdt på FMK returneres den PlannedAdministration som apoteket har indberettet.

Response-strukturen kan indeholde et element kaldet DoseDispensingOnHold, såfremt dosisdispenseringen aktuelt er sat i bero. Denne struktur leveres med, såfremt dosisdispenseringen er sat i bero på kaldstidspunktet, uanset hvilken/hvilke perioder der hentes.

Herunder vises et eksempel på en response-struktur i 1.4.6.E2 format hvor patienten har fået registeret et dosisdispenseringskort på FMK af apoteket.

Bemærk: FMK returnere altid max 1 dosisdispenseringsperiode med statussen “Planlagt” og denne vil altid være den periode med den tidligeste startdato. Dette kunne være ved nyopstart på DD, hvis man henter med nuværende og kommende periode, hvor nuværende periode er overskreder tidsfrist for ændring, men apoteket har ikke fået taget den under behandling. Så vil den fremtidige periode (såfremt denne også er blevet oprettet) IKKE være en del af svaret, da denne også vil have status planlagt.

<GetDoseDispensingCardResponse>
    <Patient>
        ...
    </Patient>
    <RequestDateTime>2019-12-13T13:53:57Z</RequestDateTime>
    <DoseDispensingCard>
        <Identifier>1576245237622003717</Identifier>
        <Description>Standard dosisdispenseringskort</Description>
        <OrderedAtPharmacy>
            <Name>Haderslev Løve Apotek</Name>
            <AddressLine>Gravene 1</AddressLine>
            <AddressLine>6100 Haderslev</AddressLine>
            <TelephoneNumber>74522443</TelephoneNumber>
            <Type>Apotek</Type>
            <Identifier source="EAN-Lokationsnummer">5790000172924</Identifier>
        </OrderedAtPharmacy>
        <PackedAtOrganisation>
            <Name>Humlebæk Apotek</Name>
            <AddressLine>Humlebæk Center 23</AddressLine>
            <AddressLine>3050 Humlebæk</AddressLine>
            <TelephoneNumber>49191979</TelephoneNumber>
            <Type>Apotek</Type>
            <Identifier source="EAN-Lokationsnummer">5790000171545</Identifier>
        </PackedAtOrganisation>
        <Period>
            <Identifier>1576245237622005717</Identifier>
            <Status>Planlagt</Status>
            <StartDate>2019-12-20</StartDate>
            <EndDate>2020-01-03</EndDate>
            <Deadline>2019-12-13T13:53:57Z</Deadline>
            <ProductionIdentifier>1234</ProductionIdentifier>
            <DoseDispensedMedication>
                <Identifier>1576245237622007717</Identifier>
                <DrugMedication>
                    <Identifier>23601</Identifier>
                    <Version>1576245237622002717</Version>
                    <Created>
                        ...
                    </Created>
                    <Modified>
                        ...
                    </Modified>
                    <Type>Lægeordineret</Type>
                    <BeginEndDate>
                        <CreatedDateTime>2019-12-13T13:53:57Z</CreatedDateTime>
                        <TreatmentStartDate>2019-11-13</TreatmentStartDate>
                        <TreatmentEndDate>2020-01-13</TreatmentEndDate>
                    </BeginEndDate>
                    <Indication>
                        <Code date="2009-02-16" source="Medicinpriser">2</Code>
                        <Text>mod for meget mavesyre</Text>
                    </Indication>
                    <RouteOfAdministration>
                        <Code date="2019-10-04" source="Medicinpriser">OF</Code>
                        <Text>Oftalmisk anvendelse</Text>
                    </RouteOfAdministration>
                    <Drug>
                        <ATC>
                            <Code date="2019-10-04" source="Medicinpriser">N06DA03</Code>
                            <Text>Rivastigmin</Text>
                        </ATC>
                        <Identifier date="2019-10-04" source="Medicinpriser">28103033598</Identifier>
                        <Name>Prometax</Name>
                        <Form>
                            <Code date="2019-10-04" source="Medicinpriser">KAPH</Code>
                            <Text>kapsler, hårde</Text>
                        </Form>
                        <Strength>
                            <Value>4.5</Value>
                            <UnitCode date="2019-10-04" source="Medicinpriser">MG</UnitCode>
                            <UnitText>mg</UnitText>
                            <Text date="2019-10-04" source="Medicinpriser">4,5 mg</Text>
                        </Strength>
                    </Drug>
                    <Dosage>
                        <UnitTexts>
                            <Singular>stk</Singular>
                            <Plural>stk</Plural>
                        </UnitTexts>
                        <StructuresAccordingToNeed>
                            <Structure>
                                <IterationInterval>1</IterationInterval>
                                <StartDate>2019-11-13</StartDate>
                                <EndDate>2020-01-13</EndDate>
                                <SupplementaryText>Mod smerter</SupplementaryText>
                                <Day>
                                    <Number>1</Number>
                                    <Dose>
                                        <Quantity>1</Quantity>
                                    </Dose>
                                </Day>
                                <DosageTranslation>
                                    ...
                                </DosageTranslation>
                            </Structure>
                            <DosageTranslationCombined>
                                ...
                            </DosageTranslationCombined>
                        </StructuresAccordingToNeed>
                        <Type>efter behov</Type>
                    </Dosage>
                    <SubstitutionAllowed>false</SubstitutionAllowed>
                    <Prescription>
                        <Identifier>313944840276088</Identifier>
                        <AttachedToDrugMedicationIdentifier>23601</AttachedToDrugMedicationIdentifier>
                        <CreatedFromDrugMedicationVersion>1576245237622002717</CreatedFromDrugMedicationVersion>
                        <AuthorisationDateTime>2019-12-13T13:53:57Z</AuthorisationDateTime>
                        <Created>
                           ...
                        </Created>
                        <ValidFromDate>2019-12-13</ValidFromDate>
                        <ValidToDate>2020-02-12</ValidToDate>
                        <DoseDispensedRestriction>
                            <CopyRequired>true</CopyRequired>
                            <StartDate>2019-12-13</StartDate>
                            <EndDate>2020-01-13</EndDate>
                        </DoseDispensedRestriction>
                        <Indication>
                            <Code date="2009-04-07" source="Medicinpriser">2</Code>
                            <Text>mod for meget mavesyre</Text>
                        </Indication>
                        <Drug>
                            <ATC>
                                <Code date="2009-04-07" source="Medicinpriser">G04BE01</Code>
                                <Text>Alprostadil</Text>
                            </ATC>
                            <Identifier date="2009-04-07" source="Medicinpriser">28103222101</Identifier>
                            <Name>Caverject Dual</Name>
                            <Form>
                                <Code date="2009-04-07" source="Medicinpriser">INJPSO</Code>
                                <Text>pulver og solvens til injektionsvæske, opløsning</Text>
                            </Form>
                            <Strength>
                                <Value>20.0</Value>
                                <UnitCode date="2009-04-07" source="Medicinpriser">RG</UnitCode>
                                <UnitText>mikrogram</UnitText>
                                <Text date="2009-04-07" source="Medicinpriser">20 mikg</Text>
                            </Strength>
                            <Substances>
                                <ActiveSubstance>
                                    <SubstanceText date="2009-04-07" source="Medicinpriser">ALPROSTADIL</SubstanceText>
                                </ActiveSubstance>
                            </Substances>
                        </Drug>
                        <DosageText>1-2 stk 3-4 gange dagligt</DosageText>
                        <SubstitutionAllowed>false</SubstitutionAllowed>
                        <Status>åben</Status>
                        <Order>
                            <Identifier>313944840276288</Identifier>
                            <Created>
                                ...
                            </Created>
                            <Modified>
                                ...
                            </Modified>
                            <OrderedAtPharmacy>
                                <Name>Humlebæk Apotek</Name>
                                <AddressLine>Humlebæk Center 23</AddressLine>
                                <AddressLine>3050 Humlebæk</AddressLine>
                                <TelephoneNumber>49191979</TelephoneNumber>
                                <Type>Apotek</Type>
                                <Identifier source="EAN-Lokationsnummer">5790000171545</Identifier>
                            </OrderedAtPharmacy>
                            <Status>Bestilt</Status>
                        </Order>
                        <Version>23829</Version>
                    </Prescription>
                </DrugMedication>
                <Warning>
                    <WarningCode>4141</WarningCode>
                    <WarningText>Lægemidlet må ikke substitueres</WarningText>
                    <Severity>high</Severity>
                </Warning>
                <Warning>
                    <WarningCode>4302</WarningCode>
                    <WarningText>Der er ikke overensstemmelse mellem den ordinerede mængde og den pakkede mængde. Doseringen afviger på følgende dage: 20-12-2019 - 03-01-2020</WarningText>
                    <Severity>high</Severity>
                </Warning>
                <Substitution>
                    <Drug>
                        <ATC>
                            <Code date="2011-02-19" source="Medicinpriser">V08AB05</Code>
                            <Text>Iopromid</Text>
                        </ATC>
                        <Identifier date="2011-02-19" source="Medicinpriser">28101201084</Identifier>
                        <Name>Ultravist</Name>
                        <Form>
                            <Code date="2011-02-19" source="Medicinpriser">INVSKO</Code>
                            <Text>injektions-/infusionsvæske, opløsning</Text>
                        </Form>
                        <Strength>
                            <Value>240.0</Value>
                            <UnitCode date="2011-02-19" source="Medicinpriser">MJM</UnitCode>
                            <UnitText>mg jod/ml</UnitText>
                            <Text date="2011-02-19" source="Medicinpriser">240 mg iod/ml</Text>
                        </Strength>
                        <Substances>
                            <ActiveSubstance>
                                <SubstanceText date="2011-02-19" source="Medicinpriser">Iopromid</SubstanceText>
                            </ActiveSubstance>
                        </Substances>
                    </Drug>
                </Substitution>
                <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                <PlannedAdministration>
                    <UnitTexts>
                        <Singular>tablet</Singular>
                        <Plural>tabletter</Plural>
                    </UnitTexts>
                    <PlannedAdministrationFixed>
                        <PlannedAdministrationStructure>
                            <IterationInterval>1</IterationInterval>
                            <StartDate>2019-12-13</StartDate>
                            <EndDate>2020-06-13</EndDate>
                            <Day>
                                <Number>1</Number>
                                <Dose>
                                    <Time>morning</Time>
                                    <SequenceNumber>79902</SequenceNumber>
                                    <Quantity>1</Quantity>
                                </Dose>
                            </Day>
                        </PlannedAdministrationStructure>
                    </PlannedAdministrationFixed>
                </PlannedAdministration>
                <TotalNumberOfDoseDispensedQuantity>15</TotalNumberOfDoseDispensedQuantity>
                <DoseDispensingEndDate>2020-01-13</DoseDispensingEndDate>
            </DoseDispensedMedication>
            <DetailedSpecification>
                <DispensableUnit>
                    <Date>2019-12-20</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576245237622007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-21</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576245237622007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-22</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576245237622007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-23</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576245237622007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-24</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576245237622007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-25</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576245237622007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-26</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576245237622007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-27</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576245237622007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-28</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576245237622007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-29</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576245237622007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-30</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576245237622007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-31</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576245237622007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2020-01-01</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576245237622007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2020-01-02</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576245237622007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2020-01-03</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576245237622007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
            </DetailedSpecification>
        </Period>
    </DoseDispensingCard>
</GetDoseDispensingCardResponse>

En liste af advarsler for det eksplicitte dosisdispenseringskort kan findes her: Advarsler til Dosisdispensering