====== Effektuér bestilling med substitution ======

** Bemærk det er endnu ikke endeligt besluttet at denne service bliver understøttet. Den er en del af de foreslåede ændringer vedrørende håndtering af substitutionsordinationer **


Denne service stilles til rådighed som et alternativ til den normale [[Effektuér bestilling]], og anvendes i de tilfælde hvor apoteket ønsker at udlevere en substitutionsmulighed (alt andet end den primære ordination) i en [[fmk:1.6.0:intro:relationer_struktur|substitutionsordination]]

Det vil sige servicen skal IKKE anvendes ved normal generisk substitution.

===== Forudsætninger =====

Inden udleveringen påbegyndes skal apoteket som altid tage en "lås" på udleveringsgrundlaget og evt. oprette en tilhørende bestilling. Det gøres ved at kalde servicen [[Påbegynd håndtering af bestilling]]

I dette tilfælde gøres det på udleveringsgrundlaget på den primære ordination i substitutionen. Det vil også være på dette udleveringsgrundlag, der ligger en evt. bestilling.

===== Forespørgsel =====
[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#EffectuateOrderSubstitutedRequest|Request]] 

Forespørgslen svarer fuldstændigt til forespørgslen til [[Effektuér bestilling]] med den ene undtaglese, at der i denne service også skal angvives ordinations ID for den substitutionsmulighed, der anvendes i udleveringen 

Det vil sige under det enkelte Handover element skal der angives et ID på den lægemiddelordination, der udleveres på baggrund af. Det er et krav at denne lægemiddelordination skal indgå i en substitutionsordination med den ordination, som det angivne udleveringsgrundlag er knyttet til. I modsat fald vi kaldet fejle.

Øvrige felter anvendes på samme måde som i den normale [[Effektuér bestilling]]. Bemærk dog at for alle felter der vedrører bestillingen eller udleveringsgrundlaget (eks. TerminateWarrant og Track&Trace) vedrører informationen udleveringsgrundlaget og bestillingen, der er knyttet til den primære ordination i substitutionen.

**Eksempel**

<code XML EffectuateOrderSubstitutedRequest.xml>

<EffectuateOrderRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <CreatedBy>
        <HealthcareProfessional>
            <Identifier source="CPR">1111111118</Identifier>
            <Name>Testrup Test Testesen</Name>
        </HealthcareProfessional>
        <Role>Apoteksansat</Role>
        <Organisation>
            <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
            <Type>Apotek</Type>
            <Name>Skanderborg Apotek</Name>
            <AddressLine>Adelgade 27</AddressLine>
            <AddressLine>8660 Skanderborg</AddressLine>
        </Organisation>
    </CreatedBy>
    <Order>
        <WarrantIdentifier>1341404071655002003</WarrantIdentifier>
        <OrderIdentifier>1341404070747001001</OrderIdentifier>
        <Handover>
            <DrugMedicationIdentifier>1234789098712343</DrugMedicationIdentifier> 
            <DateTime>2026-03-10T11:12:39Z</DateTime>
            <Package>
                <PackageQuantity>1</PackageQuantity>
                <PackageNumber source="Medicinpriser" date="2014-03-10">789</PackageNumber>
                <PackageSize>
                    <Value>40</Value>
                    <UnitCode source="Medicinpriser" date="2014-03-10">stk</UnitCode>
                    <UnitText>stk</UnitText>
                </PackageSize>
                <SubstitutedDrug>
                    <Identifier source="Medicinpriser" date="2014-03-10">28101234504</Identifier>
                    <Name>Eksemplificin</Name>
                    <Form>
                        <Code source="Medicinpriser" date="2014-03-10">TAB</Code>
                        <Text>tabletter</Text>
                    </Form>
                    <Strength>
                        <StrengthItem>
                            <Value>50</Value>
                            <UnitCode source="Medicinpriser" date="2014-03-10">MG</UnitCode>
                            <UnitText>mg</UnitText>
                        <StrengthItem>
                    </Strength>
                </SubstitutedDrug>
            </Package>
            <HandoverComment>Oprettet i Betalingsservice</HandoverComment>
            <LabelText>1 tablet morgen, middag og aften mod smerter</LabelText>
            <ResponsibleOrganisation>
                <Identifier source="CVR-P">1008648049</Identifier>
                <Type>Apotek</Type>
                <Name>Ry Apoteksudsalg</Name>
                <AddressLine>Siimtoften 2</AddressLine>
                <AddressLine>8660 Ry</AddressLine>
            </ResponsibleOrganisation>
        </Handover>
        <TerminateWarrant/>
        <DetailsForTrackAndTrace>
            <ExpectedDeliveryDate>2026-03-12</ExpectedDeliveryDate>
            <ExpectedNextEventDateTime>2026-03-10T14:00:00Z</ExpectedNextEventDateTime>
        </DetailsForTrackAndTrace>
    </Order>
</EffectuateOrderRequest>

</code>


===== Svar =====

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

Svaret indeholder den ''PersonIdentifier'' eller ''OrganisationIdentifier'', som bestillingen er tilknyttet. Dernæst forekommer en række ''Handover''-elementer, som hver indeholder:
  * ''WarrantIdentifier''
  * ''OrderIdentifier''
  * ''HandoverIdentifier''


<code xml EffectuateOrderResponse.xml>

<EffectuateOrderResponse>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
	<Handover>
		<WarrantIdentifier>1341404077656004004</WarrantIdentifier>
		<OrderIdentifier>1341404077656004006</OrderIdentifier>
		<HandoverIdentifier>1341404078102001010</HandoverIdentifier>
	</Handover>
</EffectuateOrderResponse>

</code>