User Tools

Site Tools


fmk:1.6.0:services:registrer_los_recept_og_udlevering

This is an old revision of the document!


Registrer løs recept og udlevering

Servicen anvendes på apotekerne, primært i tilfælde hvor de bliver mødt med en fysisk recept, som de efterfølgende udleverer på. Da der er krav om, at recepter skal oprettes digitalt på FMK, gives der derfor mulighed for, at apotekerne kan registrere denne udlevering og samtidig indrapportere denne papir-recept, således recept og udlevering kan ses af andre, som henter medicinkortet.

Forespørgsel

Request

I forespørgslen til denne service anvendes der i 1.6.0 nu kun 1 mulighed for modtager for registreringen, PersonIdentifier. Hvor 1.4.X har haft mulighed for OrganisationIdentifier og Patient for henholdsvis organisationer og patienter uden CPR, lukkes der for dette i 1.6.0, da det ikke er hensigtsmæssigt.

I elementet CreatedBy indsætter apoteker information omkring organisationen og brugeren, som har underskrevet recepten, Modifikator.

I elementet EffectuatedBy angives information omkring organisationen og brugeren fra apoteket, som udfører udleveringen (se Modifikator). Udføres udleveringen af en anden aktør end personen, der foretager kaldet mod FMK medsendes både et ReportedBy-element, og EffectuatedBy. Se evt. Aktører på FMK.

Herefter angives en række WarrantAndHandover elementer, med detaljerne omkring den udskrevne recept og den udlevering, som er foretaget. Elementet indeholder følgende:

  • AuthorisationDateTime tidspunktet for receptudstedelse
  • Prescription informationer omkring recepten
  • Optionelt: Drug informationer omkring lægemidlet
  • Optionelt: Indication indikationen fra recepten
  • Optionelt: DosageText doseringstekst fra recepten
  • SubstitutionAllowed marking af om substitution var tilladt
  • Order Informationer omkring udleveringen.

Prescription-elementet indeholder følgende:

  • PackageNumber informationer omkring varenummeret fra recepten
  • Optionelt: PackageSize informationer omkring pakningsstørrelsen fra recepten
  • PackageQuantity antallet af pakninger fra recepten
  • Optionelt: ReimbursementClause informationer omkring hvorledes klausulbetingelse er opfyldt

Order elementet indeholder følgende:

  • Valg mellem OrderedAtPharmacy hvis recepten er indløst på et dansk apotek eller OrderedAbroad såfremt recpeten faktisk er indløst på et udenlansk apotek (efter-registrering)
  • Optionelt: op til 3 DeliveryInstructionText elementer med beskrivelse af leveringsinstruktioner
  • Optionelt: Delivery element, med informationer omkring udleveringssted
  • Optionelt: StartTrackAndTraceOnOrder element, som indikerer at Track&Trace skal håndteres på bestillingen. Elementet kan optionelt indeholde ekstra oplysninger, som beskrevet i Effektuer bestilling-service.
  • Handover element, med oplysninger omkring selve udleveringen.

Handover elementet indeholder følgende:

  • DateTime Tidspunktet for hvornår udleveringen blev foretaget.
  • Package, Informationer omkring de udleverede pakninger, antal, batchnummer og størrelse.
  • Optionelt: UsesSecondaryHandover, Indikation af om udleveringen foregår via sekundær udlevering
  • Optionelt: HandoverComment, Tekst som apoteket kan medsende
  • Optionelt: LabelText, Tekst som angivet på de fysiske label
  • Optioenlt: ResponsibleOrganisation, Informationer omkring den udleverende organisation
RegisterLoosePrescriptionAndHandoverRequest.xml
<RegisterLoosePrescriptionAndHandoverRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <CreatedBy>
        <HealthcareProfessional>
            <Identifier source="Autorisation">12345</Identifier>
            <Name>Jørgn Madsen</Name>
        </HealthcareProfessional>
        <Role>Læge</Role>
        <Organisation>
            <Identifier source="Yder">123456</Identifier>
            <Type>Yder</Type>
            <Name>Allé lægerne</Name>
            <AddressLine>...</AddressLine>
            <TelephoneNumber>...</TelephoneNumber>
            <EmailAddress>...</EmailAddress>
        </Organisation>
    </CreatedBy>
    <EffectuatedBy>
        <HealthcareProfessional>
            <Identifier source="CPR">2401010001</Identifier>
            <Name>Karl Karlsen</Name>
        </HealthcareProfessional>
        <Role>Apoteksansat</Role>
        <Organisation>
            <Identifier source="EAN-lokationsnummer">5790001381615</Identifier>
            <Type>Apotek</Type>
            <Name>Kolind Apotek</Name>
            <AddressLine>...</AddressLine>
            <TelephoneNumber>...</TelephoneNumber>
            <EmailAddress>...</EmailAddress>
        </Organisation>
    </EffectuatedBy>
    <WarrantAndHandover>
        <AuthorisationDateTime>2025-05-01T12:00:00Z</AuthorisationDateTime>
        <Prescription>
            <PackageNumber date="2025-05-01" source="Medicinpriser">686791</PackageNumber>
            <PacakgeSize>
                <Value>5.00</Value>
                <UnitCode date="2025-05-01" source="Medicinpriser">G</UnitCode>
                <UnitText>g</UnitText>
            </PacakgeSize>
            <PackageQuantity>8</PackageQuantity>
        </Prescription>
        <DosageText>Tag 1 morgen og 1 aften</DosageText>
        <SubstitutionAllowed>true</SubstitutionAllowed>
        <Order>
            <OrderedAtPharmacy>
                <Identifier source="EAN-lokationsnummer">5790001381615</Identifier>
                <Type>Apotek</Type>
                <Name>Kolind Apotek</Name>
                <AddressLine>...</AddressLine>
                <TelephoneNumber>...</TelephoneNumber>
                <EmailAddress>...</EmailAddress>
            </OrderedAtPharmacy>
            <Delivery>
                <DeliveryPriority>send til udleveringssted samme dag</DeliveryPriority>
                <DeliverySite>
                    <Identifier source="EAN-lokationsnummer">5790001381615</Identifier>
                    <Type>Apotek</Type>
                    <Name>Kolind Apotek</Name>
                    <AddressLine>...</AddressLine>
                    <TelephoneNumber>...</TelephoneNumber>
                    <EmailAddress>...</EmailAddress>
                </DeliverySite>
            </Delivery>
            <StartTrackAndTraceOnOrder>
                <ExpectedDeliveryDate>2025-05-25</ExpectedDeliveryDate>
            </StartTrackAndTraceOnOrder>
            <Handover>
                <DateTime>2025-05-07T12:00:00&gt;</DateTime>
                <Package>
                    <PackageNumber date="2025-05-05" source="Medicinpriser">686791</PackageNumber>
                    <PacakgeSize>
                        <Value>5.00</Value>
                        <UnitCode date="2025-05-05" source="Medicinpriser">G</UnitCode>
                        <UnitText>g</UnitText>
                    </PacakgeSize>
                    <PackageQuantity>8</PackageQuantity>
                </Package>
                <LabelText>Tag 1 morgen og 1 aften</LabelText>
            </Handover>
        </Order>
    </WarrantAndHandover>
</RegisterLoosePrescriptionAndHandoverRequest>

Svar

Response

Som svar fra service kommer patientens PersonIdentifier, eller Organisationens OrganisationIdentifier. Hvis Patient blev angivet i forespørgsel, opretter FMK et ID til denne person, som returneres i PersonIdentifier med source MedicinecardKey.

Herefter kommer en række WarrantAndHandover elementer, som indeholder ID'et på den oprettede recept, bestilling og udlevering i henholdsvis WarrantIdentifier, OrderIdentifier og HandoverIdentifier.

RegisterLoosePrescriptionAndHandoverResponse.xml
<RegisterLoosePrescriptionAndHandoverResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <WarrantAndHandover>
        <WarrantIdentifier>24361358103813</WarrantIdentifier>
        <OrderIdentifier>245138183138031</OrderIdentifier>
        <HandoverIdentifier>245138183138031</HandoverIdentifier>
    </WarrantAndHandover>
</RegisterLoosePrescriptionAndHandoverResponse>
fmk/1.6.0/services/registrer_los_recept_og_udlevering.1761859548.txt.gz · Last modified: (external edit)

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki