User Tools

Site Tools


fmk:1.6.0:services:hent_dispenseringskort

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:

  • CurrentPeriod indikerer, at man ønsker den nuværende aktive periode returneret
  • CurrentAndPendingPeriods indikerer, at man ønsker den nuværende aktive og næstkommende periode returneret
  • PendingPeriods indikerer, at man ønsker næstkommende perioder returneret
  • AdministrationOverview indikerer, at man ikke ønsker perioder, men en oversigt over planlagte administrationer
  • PeriodIdentifier indikerer, at man ønsker en specifik periode via identifier
  • RequestedDate indikerer, 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/AdministrationOverview bruges i request, returneres AdministrationOverview i DispensingCard (ikke Period)
  • hvis en periode-baseret forespørgsel bruges (fx CurrentPeriod, CurrentAndPendingPeriods, PendingPeriods, PeriodIdentifier, RequestedDate), returneres Period (ikke AdministrationOverview)

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>
fmk/1.6.0/services/hent_dispenseringskort.txt · Last modified: by mrt

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki