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

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, 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. 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.

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>

Svar

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

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>

Eksempel 2

Eksempel på svar fra automatiseret kald:

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>

Fælles Medicinkort - Dokumentation

Table of Contents

Påbegynd håndtering af bestilling

Forespørgsel

Svar

Eksempel 1

Eksempel 2