Table of Contents
Hent dispenseringskort
Service anvendes af parter som arbejder med, eller ønsker indsigt i, patientens dispensering.
Forespørgsel
I request-dokumentet skal der medsendes en PersonIdentifier på den patient som dispenseringskortet tilhører. Såfremt dispenseringskort skal anvendes i organisationskontekst, angives dette i OrganisationIdentifier.
Herefter skal ét af følgende elementer vælges i RequestedPeriod:
CurrentPeriodindikerer, at man ønsker den nuværende aktive periode returneretCurrentAndPendingPeriodsindikerer, at man ønsker den nuværende aktive og næstkommende periode returneretPendingPeriodsindikerer, at man ønsker næstkommende perioder returneretAdministrationOverviewindikerer, at man ikke ønsker perioder, men en oversigt over planlagte administrationerPeriodIdentifierindikerer, at man ønsker en specifik periode via identifierRequestedDateindikerer, at man ønsker perioder, som var aktive på det angivne tidspunkt
Til sidst kan FillSubstitutionTemplates angives. Dette betyder at aktuelle substitutionskladder ønskes returneret. Dette har kun effekt for dispenseringskort fra apotek og for perioder som endnu ikke er sat til “Klar til pakning”, eller når AdministrationOverview anvendes.
Generisk request-skabelon
Brug samme skabelon og udskift kun indholdet af RequestedPeriod.
- GetDispensingCardRequestType_template.xml
<GetDispensingCardRequestType> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <RequestedPeriod> <!-- Vælg præcis ét af følgende: <CurrentPeriod/> <CurrentAndPendingPeriods/> <PendingPeriods/> <AdministrationOverview/> <PeriodIdentifier>9841685168</PeriodIdentifier> <RequestedDate>2025-04-20</RequestedDate> --> <CurrentAndPendingPeriods/> </RequestedPeriod> <!-- Optional --> <FillSubstitutionTemplates/> </GetDispensingCardRequestType>
Svar
Svaret fra FMK indeholder detaljer om Patient eller Organisation alt efter om der blev anvendt PersonIdentifier eller OrganisationIdentifier i forespørgslen.
En RequestDateTime returneres som tidspunktet FMK modtog requestet.
Potentielt returneres en række PatientRegistration elementer (aktive registreringer med mulig indflydelse på dispensering, fx “DD i bero” og “Ikke egnet til DD”). Historik hentes via dedikeret service.
Herefter kan følge en række DispensingCard elementer, som beskriver aktive dispenseringskort på patienten/organisationen. Se også Dispenseringskort.
Bemærk at DispensingCard er optionelt. Hvis patienten ikke har et aktivt dispenseringskort, vil elementet ikke optræde i svaret. Dette adskiller sig fra 1.4.6-snitfladen, hvor FMK gav valideringsfejl hvis intet DD-kort fandtes.
Choice i DispensingCard
I DispensingCard gælder følgende choice:
- enten
Period(0..*) - eller
AdministrationOverview(1)
Det betyder:
- hvis
RequestedPeriod/AdministrationOverviewbruges i request, returneresAdministrationOverviewiDispensingCard(ikkePeriod) - hvis en periode-baseret forespørgsel bruges (fx
CurrentPeriod,CurrentAndPendingPeriods,PendingPeriods,PeriodIdentifier,RequestedDate), returneresPeriod(ikkeAdministrationOverview)
Case A: RequestedPeriod = AdministrationOverview
- GetDispensingCardRequestType_administrationOverview.xml
<GetDispensingCardRequestType> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <RequestedPeriod> <AdministrationOverview/> </RequestedPeriod> <FillSubstitutionTemplates/> </GetDispensingCardRequestType>
- GetDispensingCardResponse_administrationOverview.xml
<GetDispensingCardResponse> <Patient> <Person> <Name> <GivenName>Hans</GivenName> <Surname>Jensen</Surname> </Name> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> </Person> </Patient> <RequestDateTime>2025-04-26T12:39:25Z</RequestDateTime> <DispensingCard> <Identifier>386168168</Identifier> <Version>1</Version> <Description>Et dispenseringskort</Description> <OrderedAtPharmacy> <Identifier source="EAN-Lokationsnummer">5790000172924</Identifier> <Type>Apotek</Type> <Name>Haderslev Løve Apotek</Name> </OrderedAtPharmacy> <PackedAtOrganisation> <Identifier source="EAN-Lokationsnummer">5790000171545</Identifier> <Type>Apotek</Type> <Name>Humlebæk Apotek</Name> </PackedAtOrganisation> <AdministrationOverview> <PlannedAdministration> <Identifier>891353188</Identifier> <Version>8978641385</Version> <DrugMedication>...</DrugMedication> <SubstitutionTemplate>...</SubstitutionTemplate> </PlannedAdministration> </AdministrationOverview> </DispensingCard> </GetDispensingCardResponse>
Case B: RequestedPeriod = periode-baseret (fx CurrentAndPendingPeriods)
- GetDispensingCardRequestType_currentAndPending.xml
<GetDispensingCardRequestType> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <RequestedPeriod> <CurrentAndPendingPeriods/> </RequestedPeriod> <FillSubstitutionTemplates/> </GetDispensingCardRequestType>
- GetDispensingCardResponse_currentAndPending.xml
<GetDispensingCardResponse> <Patient> <Person> <Name> <GivenName>Hans</GivenName> <Surname>Jensen</Surname> </Name> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> </Person> </Patient> <RequestDateTime>2025-04-26T12:39:25Z</RequestDateTime> <DispensingCard> <Identifier>386168168</Identifier> <Version>1</Version> <Description>Et dispenseringskort</Description> <PackingGroupIdentifier>43186145</PackingGroupIdentifier> <PackingGroupName>Borgere på Jernbrogade og Bakkegaarden</PackingGroupName> <OrderedAtPharmacy> <Identifier source="EAN-Lokationsnummer">5790000172924</Identifier> <Type>Apotek</Type> <Name>Haderslev Løve Apotek</Name> </OrderedAtPharmacy> <PackedAtOrganisation> <Identifier source="EAN-Lokationsnummer">5790000171545</Identifier> <Type>Apotek</Type> <Name>Humlebæk Apotek</Name> </PackedAtOrganisation> <Period> <Identifier>79816138</Identifier> <Version>12</Version> <Status>Pakning afsluttet</Status> <StartDate>2025-04-29</StartDate> <EndDate>2025-05-12</EndDate> <Dispensing> <Identifier>988413138</Identifier> <Version>787848468</Version> <ShortName>Panodil</ShortName> <Description>Hvid med lige kærv</Description> <Warning>...</Warning> <Substitution> <SubstitutionChosenByPatient/> <Drug> <Identifier source="Medicinpriser" sourceDate="2025-04-09">28101317587</Identifier> <Name>Pamol</Name> ... </Drug> </Substitution> <SubstitutionAtPacking> <Drug> <Identifier source="Medicinpriser" sourceDate="2025-04-09">28100636073</Identifier> <Name>Panodil</Name> ... </Drug> </SubstitutionAtPacking> <SubstitutionTemplate>...</SubstitutionTemplate> <PlannedAdministration> <Identifier>891353188</Identifier> <Version>8978641385</Version> <DrugMedication>...</DrugMedication> <ValidWarrant> <Identifier>135153834689</Identifier> <ValidFromDate>2024-01-01</ValidFromDate> <ValidToDate>2026-01-01</ValidToDate> </ValidWarrant> <Warning>...</Warning> <DosageUnit> <DosageUnitText>stk</DosageUnitText> </DosageUnit> <AdministrationInstruction>Synkes hele</AdministrationInstruction> <PlannedAdministrationFixed> <PlannedAdministrationStructure> <IterationInterval>1</IterationInterval> <StartDate>2024-05-01</StartDate> <Day> <Number>1</Number> <Dose> <Time>morning</Time> <SequenceNumber>699999</SequenceNumber> <Quantity>1</Quantity> </Dose> </Day> </PlannedAdministrationStructure> </PlannedAdministrationFixed> </PlannedAdministration> <TotalDispensedQuantity>24</TotalDispensedQuantity> </Dispensing> </Period> </DispensingCard> </GetDispensingCardResponse>
