====== Erstat udleveringsgrundlag ======

Hvis apoteket opdager en fejl i et udleveringsgrundlag, kan de på vegne af lægen ved hjælp af denne operation 'overskrive' de fejlagtige udleveringsgrundlag med et nyt.

**Bemærk** Den optimale måde at håndtere fejl i udleveringsgrundlag vil være at bede lægen annullere det fejlagtige udleveringsgrundlag og oprette en ny korrekt. Men hvis dette ikke er praktisk muligt kan denne service anvendes.

==== Forespørgsel ====

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

Det er muligt at erstatte udleveringsgrundlag af typerne recept, dosisdispensering og praksisrecept. Ved erstat af recept- eller DD-udleveringsgrundlag benyttes PersonIdentifier med Source CPR eller X-eCPR. Ved erstatning af praksisrecept benyttes OrganisationIdentifier.

PersonIdentifier eller OrganisationIdentifier angives først i kaldet, og herunder data om lægepraksis eller sygehus samt om lægen på hvis vegne udleveringsgrundlaget erstattes, samt om apoteket, der indberetter ændringen. Herunder findes en eller flere Warrant-elementer, for hvert udleveringsgrundlag der skal erstattes.

=== Oprindelig udleveringsgrundlag ===
I elementet ''ReplaceWarrantIdentifier'' angives id på det udleveringsgrundlag, der skal erstattes.
Dette udleveringsgrundlag vil blive markeret udgået og påføres en reference til det nye udleveringsgrundlag. Se [[fmk:1.6.0:xml-elementer:udleveringsgrundlag]]

=== Lægens autorisationsdato === 

Ved erstatning af et udleveringsgrundlag skal der angives en dato og et tidspunkt hvor det nye udleveringsgrundlag er  godkendt. Dette angives son ”lægens autorisationsdato” i AuthorisationDateTime.

=== Gyldighed ===

Her kan angives gyldighedsperioden for det nye udleveringsgrundlag. Det vil dog sjældent være nødvendigt, da de som udgangspunkt skal baseres på det erstattede udleveringsgrundlag.

Se [[fmk:1.6.0:services:opret_udleveringsgrundlag#gyldighed|opret Udleveringsgrundlag]]

=== Lægemiddelordination ===

Hvis der erstattes på baggrund af en [[fmk:1.6.0:xml-elementer:lmo-relationer/#substitutionsrelationer|substitutionsrelation]] skal ID'et for den lægemiddelordination der substitueres til angives. Det vil blive valideret at den lægemiddelordination der substitueres til er i en substitutionsrelation med den lægemiddelordination som det oprindelige udleveringsgrundlag er koblet til.

=== Typen af udleveringsgrundlag ===

Der skal angives hvilken type det nye udleveringsgrundlag skal have, samt de nødvendige informationer for denne type. Der kan angives udleveringsgrundlag af følgende typer:
  * [[fmk:1.6.0:xml-elementer:udleveringsgrundlag#prescription|Recept]]
  * [[fmk:1.6.0:xml-elementer:udleveringsgrundlag#dosedispensed|Dosisdispensering]]
  * [[fmk:1.6.0:xml-elementer:udleveringsgrundlag#practiceprescription|Praksisrecept]]

Hvis der erstattes på baggrund af en [[fmk:1.6.0:xml-elementer:lmo-relationer/#substitutionsrelationer|substitutionsrelation]] hvor der skal substitueres fra én lægemiddelordination til flere lægemiddelordinationer kan der her angives flere recepter, hver med sin ''DrugMedicationIdentifier''.

=== Bestilling ===

Hvis der var en bestilling på det oprindelige udleveringsgrundlag, kan apoteket vælge at føre denne med over på det nye udleveringsgrundlag

=== Afslutning af oprindeligt grundlag ===

Apoteket skal angive hvordan det oprindelige udleveringsgrundlag skal afsluttes.
Dette gøres ved at angive enten ''InvalidateReplacedWarrant'' eller ''CloseReplacedWarrant''.
Hvis man vælger invalidate, skal man som altid ved invalidering angive en ''InvalidationReason''.

<code xml ReplaceWarrantRequest.xml>

<ReplaceWarrantRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <CreatedBy>
        <HealthcareProfessional>
            <Identifier source="Autorisation">2Q5TK</Identifier>
            <Name>Tess Christoffersen</Name>
        </HealthcareProfessional>
        <Role>Læge</Role>
        <Organisation>
            <Identifier source="Yder">66974</Identifier>
            <Type>Yder</Type>
            <Name>Lægerne Vestergade</Name>
        </Organisation>
    </CreatedBy>
    <ReportedBy>
        <HealthcareProfessional>
            <Identifier source="CPR">1212121234</Identifier>
            <Name>Anne< Andersen<</Name>
            <PersonIdentifier source="CPR">1212121234</PersonIdentifier>
        </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>
    </ReportedBy>
    <Warrant>
        <ReplaceWarrantIdentifier>21298478</ReplaceWarrantIdentifier>
        <AuthorisationDateTime>2025-07-31T09:30:47.0Z</AuthorisationDateTime>
        <ValidFromDate>2025-07-31Z</ValidFromDate>
        <ValidToDate>2027-07-31Z</ValidToDate>
        <Prescription>
            <PackageNumber source="Medicinpriser" date="2025-07-28">84194</PackageNumber>
            <PackageQuantity>1</PackageQuantity>
        </Prescription>
        <InvalidateReplacedWarrant>
           <ReasonText>Forkert pakning</ReasonText>
        </InvalidateReplacedWarrant>   
    </Warrant>
</ReplaceWarrantRequest>

</code>

Erstat udleveringsgrundlag også anvendes af apoteket til at 'konvertere' et recept-udleveringsgrundlag til en dosisdispenseret udleveringsgrundlag. I den situation vil som udgangspunkt blot lukke det erstattede udleveringsgrundlag 

<code xml>

<ReplacePrescriptionRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <CreatedBy>
        <HealthcareProfessional>
            <Identifier source="Autorisation">2Q5TK</Identifier>
            <Name>Tess Christoffersen</Name>
        </HealthcareProfessional>
        <Role>Læge</Role>
        <Organisation>
            <Identifier source="Yder">66974</Identifier>
            <Type>Yder</Type>
            <Name>Lægerne Vestergade</Name>
        </Organisation>
    </CreatedBy>
    <ReportedBy>
        <HealthcareProfessional>
            <Identifier source="CPR">1212121234</Identifier>
            <Name>Anne Andersen</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>
    </ReportedBy>
    <Warrant>
        <ReplaceWarrantIdentifier>21298478</ReplaceWarrantIdentifier>
        <AuthorisationDateTime>2025-07-31T09:30:47.0Z</AuthorisationDateTime>
        <DoseDispensed/>
        <CloseReplacedWarrant/>
    </Warrant>
</ReplaceWarrantRequest>

</code>
==== Svar ====

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

I svaret returneres et antal sæt med Id for det nye udleveringsgrundlag samt Id for det erstattede.

<code xml ReplaceWarrantResponse.xml>

<ReplaceWarrantResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <Warrant>
        <NewWarrantIdentifier>31298478</NewWarrantIdentifier>
        <ReplacedWarrantIdentifier>21298478</ReplacedWarrantIdentifier>
    </Warrant>
</ReplaceWarrantResponse>

</code>