====== 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 =====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#registerlooseprescriptionandhandoverrequesttype|Request]]

I forespørgslen til denne service anvendes der i 1.6.0 nu kun 1 mulighed for modtager af 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, [[fmk:1.6.0:xml-elementer:modifikator|Modifikator]].

I elementet ''EffectuatedBy'' angives information omkring organisationen og brugeren fra apoteket, som udfører udleveringen (se [[fmk:1.6.0:xml-elementer:modifikator|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. [[fmk:generel:aktorer_pa_fmk|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
  * Optionelt: ''ReimbursementApprovedCode'' information omkring klausulkode
  * ''Order'' Informationer omkring udleveringen.

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#looseprescriptionType|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

''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'' [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#starttrackandtraceonordertype|element]], som indikerer at Track&Trace skal håndteres på bestillingen. Elementet kan optionelt indeholde ekstra oplysninger, som beskrevet i [[fmk:1.6.0:services: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

<file xml 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="Udleveringssted">451232341234</Identifier>
                    <Type>Medicinudleveringssted</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>
</file>

====== Svar ======
[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#RegisterLoosePrescriptionAndHandoverResponseType|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''.

<file xml RegisterLoosePrescriptionAndHandoverResponse.xml>
<RegisterLoosePrescriptionAndHandoverResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <WarrantAndHandover>
        <WarrantIdentifier>24361358103813</WarrantIdentifier>
        <OrderIdentifier>245138183138031</OrderIdentifier>
        <HandoverIdentifier>245138183138031</HandoverIdentifier>
    </WarrantAndHandover>
</RegisterLoosePrescriptionAndHandoverResponse>
</file>