====== Registrer sekundær udlevering ======

Denne service tillader registration af en eller flere nye
[[fmk:1.6.0:xml-elementer:Sekundær udlevering|sekundære udleveringer]] på baggrund af en eller flere tidligere udleveringer. Den sekundære udlevering foretages, efter at medicinen er udleveret til bosted eller lignende ved en udlevering, og der efterfølgende udleveres en delmængde af medicinen til patienten, af en medarbejder på et bosted eller lignende.


==== Forespørgsel ====

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

I forespørgslen skal der angives ''PersonIdentifier'' på den patient, der udleveres til. Dernæst angives et ''CreatedBy''-element med [[fmk:1.6.0:xml-elementer:modifikator|modifikator]]-informationer om personen, som registrerede den sekundære udlevering. Hvis kaldet til FMK er foretaget af en anden person end personen, som registrerede den sekundære udlevering, medsendes både en ''ReportedBy'' og en ''CreatedBy''.

Dernæst angives en eller flere ''SecondaryHandover''-elementer. Disse indeholder hver:
  * ''CreatedBy'' og ''ReportedBy'' (begge valgfrie på dette niveau), hvis flere sekundære udleveringer i samme kald er registreret/rapporteret af forskellige personer. Er de ikke angivet på det enkelte ''SecondaryHandover''-element, gælder forespørgslens øverste ''CreatedBy''/''ReportedBy'' for denne udlevering.
  * ''HandoverIdentifier'', ID på den udlevering, som den sekundære udlevering tilknyttes
  * ''DateTime'', dato og tidspunkt for den sekundære udlevering
  * Enten ''SingleUnits'' eller ''PackageQuantity'', de to er gensidigt udelukkende:
    * ''SingleUnits'', hvor mængden af sekundært udleveret medicin angives i enheder. Mængden angives i et ''DoseQuantity''-element og enheden (f.eks. 'stk') i et ''DosageQuantityUnitText''-element.
    * ''PackageQuantity'', hvor mængden af sekundært udleveret medicin i stedet angives som et helt antal pakninger (1-9999).

Bemærk at ''SubstitutedDrug'' - som findes på ''SingleUnits'' ved egentlige udleveringer - **ikke** kan angives på en sekundær udlevering. Substitueret lægemiddel registreres allerede på det ''Handover''-element, som den sekundære udlevering er tilknyttet.

<code xml RegisterSecondaryHandoverRequest.xml>
<RegisterSecondaryHandoverRequest>
    <PersonIdentifier source="CPR">2101010001</PersonIdentifier>
    <CreatedBy>
        <HealthcareProfessional>
            <Indentifier source="CPR">1208911078</Indentifier>
            <Name>Mikkel Smed Hansen</Name>
        </HealthcareProfessional>
        <Role>Kommunal ansat til medicinhåndtering</Role>
        <Organisation>
            <Identifier source="SOR">987654321</Identifier>
            <Type>kommune</Type>
            <Name>Nordfyns Kommune</Name>
            <AddressLine>Østergade 23, 5400 Bogense</AddressLine>
            <TelephoneNumber>99999999</TelephoneNumber>
            <EmailAddress>XYZ@ABC.com</EmailAddress>
        </Organisation>
    </CreatedBy>
    <SecondaryHandover>
        <HandoverIdentifier>1341234217390</HandoverIdentifier>
        <DateTime>2026-05-08T10:00:00</DateTime>
        <SingleUnits>
            <DoseQuantity>5</DoseQuantity>
            <DosageQuantityUnitText>stk</DosageQuantityUnitText>
        </SingleUnits>
    </SecondaryHandover>
    <SecondaryHandover>
        <HandoverIdentifier>1341234217391</HandoverIdentifier>
        <DateTime>2026-05-08T14:30:00</DateTime>
        <PackageQuantity>1</PackageQuantity>
    </SecondaryHandover>
</RegisterSecondaryHandoverRequest>
</code>

==== Svar ====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#RegisterSecondaryHandoverResponseType|Response]]

I svaret returneres identifiers for de sekundære udleveringer, der er oprettet, i samme rækkefølge, som de er indsat i forespørgslen, dvs. første ''Identifier'' i svaret svarer til første ''SecondaryHandover'' i forespørgslen, osv.

<code xml RegisterSecondaryHandoverResponse.xml>
<RegisterSecondaryHandoverResponse>
    <Identifier>12347812340378</Identifier>
    <Identifier>12347812340379</Identifier>
</RegisterSecondaryHandoverResponse>
</code>