====== Påbegynd håndtering af bestilling ======
Denne service anvendes primært fra apoteket, og benyttes til at markerer at en bestilling på et udleveringsgrundlag er påbegyndt. Dette gøres fx for at låse et udleveringsgrundlag fast til det pågældende apotek, som sikring for at de kan få lov bringe deres udlevering til afslutning på et senere tidspunkt.

Specielt for denne service er, at der både kan returneres fejl og fuldførte operationer i samme svar fra servicen. Normalt vil FMK altid advise alle ændringer såfremt noget i forespørgslen ikke har kunne fuldendes. Denne service vil i modsætning lave opdateringer på de steder hvor det er muligt, og returnere fejl på de opdateringer der ikke kan fuldføres.

OBS: tidligere snitfladeversioner har haft 2 særskilte services til denne funktionalitet -- kald med hhv. MOCES og VOCES/FOCES-certifikater. Disse 2 services er nu samlet i én, hvor svaret i stedet har to varianter afhængigt af rollen i kaldet.

====== Forespørgsel ======

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

I forespørgsel til denne service angives patientens ''PersonIdentifier'', alternativt anvendes ''OrganisationIdentifier'', såfremt der er tale om udleveringer til brug i praksis.

I elementet ''ModifiedBy'' medsendes information omkring organisationen og brugeren, som har foretaget opdateringen på FMK, [[fmk:1.6.0:xml-elementer:modifikator|Modifikator]]. Såfremt opdateringen er lavet af en anden aktør end personen, der foretager kaldet mod FMK medsendes både et ''ReportedBy''-element, og ''ModifiedBy''. Se evt. [[fmk:generel:aktorer_pa_fmk|Aktører på FMK]].

I ''OrderedAtPharmacy'' angives oplysningerne på det apotek, som påbegynder udleveringen.

Herefter angives en række ''Warrant'' elementer, som hver indeholder ''Identifier'' på det udleveringsgrundlag, man ønsker at påbegynde en bestilling af.

<file xml StartOrderHandlingRequest.xml>
<StartOrderHandlingRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <ModifiedBy>
        <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>
    </ModifiedBy>
    <OrderedAtPharmacy>
            <Identifier source="EAN-lokationsnummer">5790001381615</Identifier>
            <Type>Apotek</Type>
            <Name>Kolind Apotek</Name>
            <AddressLine>...</AddressLine>
            <TelephoneNumber>...</TelephoneNumber>
            <EmailAddress>...</EmailAddress>
    </OrderedAtPharmacy>
    <Warrant>
        <Identifier>31581313130303</Identifier>
    </Warrant>
    <Warrant>
        <Identifier>38513181310381</Identifier>
    </Warrant>
    <Warrant>
        <Identifier>41358138161393</Identifier>
    </Warrant>
</StartOrderHandlingRequest>
</file>

====== Svar ======

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

Som svar fra denne service kommer patientens ''PersonIdentifier'' alternativt ''OrganisationIdentifier'', såfremt det er udleveringer til brug i praksis.

Herefter kommer en række ''Warrant'' elementer, udfyldt med oplysningerne omkring det enkelte udleveringsgrundlag, som har fået påbegyndt en udlevering fra det pågældende apotek. Fulde eksempler hertil kan ses i [[fmk:1.6.0:xml-elementer:udleveringsgrundlag]].

Hvis service er blevet kaldt automatisk fra et apotekssystem (typisk via VOCES/FOCES-certifikat) indeholder svaret ikke ''Warrant''-elementer, men blot en række ''WarrantAndOrderIdentifier''-elementer, som hver indeholder identifier på hhv. udleveringsgrundlag og tilhørende bestilling(er).

Herudover kan komme en række ''StartOrderFailed'' elementer, som indeholder oplysninger på de udleveringsgrundlag, hvor der ikke kunne påbegyndes en ny udlevering på og grunden hertil. Elementerne indeholder følgende:
  * ''WarrantIdentifier'' ID på det enkelte udleveringsgrundlag
  * ''ReasonCode'' Nummeret på den pågældende fejl.
  * ''ReasonText'' En tekst som beskriver fejlen.
  * Optionelt: ''WarrantStatus'' Status for udleveringsgrundlaget
  * Optionelt: ''OrderIdentifier'' ID på den igangværende bestilling
  * Optionelt: ''OrderStatus'' Status for den igangværende bestilling
  * Optionelt: ''InProgressAtPharmacy'' Organisations oplysninger på det apotek, som har en igangværende udlevering
  * Optionelt: ''HandoverIdentifier'' ID'et på en udlevering

=== Eksempel 1 ===

Eksempel på svar fra kald:

<file xml StartOrderHandlingResponse.xml>
<StartOrderHandlingResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <Warrant>
        <Identifier>31581313130303</Identifier>
        <AttachedToDrugMedicationIdentifier>32138113</AttachedToDrugMedicationIdentifier>
        <CreatedFromDrugMedicationVersion>321358138030381</CreatedFromDrugMedicationVersion>
        <AuthorisationDateTime>2024-05-21T12:00:00Z</AuthorisationDateTime>
        <Created>
            <By>
                <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>
            </By>
            <DateTime>2024-05-21T12:00:00Z</DateTime>
        </Created>
        <ValidFromDate>2024-05-21</ValidFromDate>
        <ValidToDate>2026-05-21</ValidToDate>
        <Prescription>
            <PackageNumber date="2024-05-21" source="Medicinpriser">686791</PackageNumber>
            <PackageSize>
                <Value>5.00</Value>
                <UnitCode date="2024-05-21" source="Medicinpriser">G</UnitCode>
                <UnitText>gram</UnitText>
                <PackageSizeText>5 g</PackageSizeText>
            </PackageSize>
            <PackageQuantity>2</PackageQuantity>
        </Prescription>
        <Indication>
            <Code date="2024-05-21" source="Medicinpriser">277</Code>
            <Text>mod alkoholisme</Text>
        </Indication>
        <Drug>
            <Identifier date="2024-05-21" source="Medicinpriser">29117397124</Identifier>
            <Name>Bedrobinol &quot;CannGros&quot;</Name>
            <ATC>
                <Code date="2024-05-21" source="Medicinpriser">N02BG10</Code>
                <Text>Cannabinoider</Text>
            </ATC>
            <Form>
                <Code date="2024-05-21" source="Medicinpriser">UTTINDD</Code>
                <Text>urtete/inhalationsdamp, droge</Text>
            </Form>
            <Strength>
                <StrengthItem>
                    <Value>135</Value>
                    <UnitCode source="Medicinpriser">MG</UnitCode>
                    <UnitText>mg</UnitText>
                </StrengthItem>    
                <Text>135 mg</Text>
            </Strength>
        </Drug>
        <DosageText>1 morgen, 1 aften</DosageText>
        <SubstitutionAllowed/>
        <Status>åben</Status>
        <Order>
            <Identifier>351318138438</Identifier>
            <Created>
                <By>
                    <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>
                </By>
                <DateTime>2025-07-22T15:45:00</DateTime>
            </Created>
            <OrderedAtPharmacy>
                <Identifier source="EAN-lokationsnummer">5790001381615</Identifier>
                <Type>Apotek</Type>
                <Name>Kolind Apotek</Name>
                <AddressLine>...</AddressLine>
                <TelephoneNumber>...</TelephoneNumber>
                <EmailAddress>...</EmailAddress>
            </OrderedAtPharmacy>
            <Status>Ekspedition påbegyndt</Status>
        </Order>
        <Version>32138131303</Version>
    </Warrant>
    <Warrant>...</Warrant>
    <StartOrderFailed>
        <WarrantIdentifier>41358138161393</WarrantIdentifier>
        <ReasonCode>807</ReasonCode>
        <ReasonText>Receptens status er afsluttet, recepten kan ikke ekspederes</ReasonText>
        <WarrantStatus>afsluttet</WarrantStatus>
    </StartEffectuationFailed>
</StartOrderHandlingResponse>
</file>


=== Eksempel 2 ===

Eksempel på svar fra automatiseret kald:

<file xml StartOrderHandlingResponse-2.xml>
<StartOrderHandlingResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <WarrantAndOrderIdentifier>
        <WarrantIdentifier>31581313130303</Identifier>
        <OrderIdentifier>351318138438</OrderIdentifier>
    </WarrantAndOrderIdentifier>
    <WarrantAndOrderIdentifier>...</WarrantAndOrderIdentifier>
    <StartOrderFailed>
        <WarrantIdentifier>41358138161393</WarrantIdentifier>
        <ReasonCode>9876</ReasonCode>
        <ReasonText>Ekspedition er påbegyndt på Århus Løve Apotek</ReasonText>
        <OrderStatus>Ekspedition påbegyndt</OrderStatus>
        <InProgressAtPharmacy>
            <Identifier source="EAN-Lokationsnummer">5790000170067</Identifier>
            <Type>Apotek</Type>
            <Name>Århus Løve Apotek</Name>
            <AddressLine>Store Torv 5</AddressLine>
            <AddressLine>8000 Århus C</AddressLine>
        </InProgressAtPharmacy>
    </StartEffectuationFailed>
</StartOrderHandlingResponse>
</file>