User Tools

Site Tools


fmk:1.6.0:services:effektuer_bestilling

Effektuér bestilling

Denne service anvendes i forbindelse med at der foretages en udlevering af eksisterende udleveringsgrundlag + bestilling på apoteket. Efter kald til denne service vil en bestilling enten have status “Udført” eller “Sendes”. Sidstnævnte er tilfældet, hvis bestillingen oprindeligt blev oprettet med et Delivery-element.

Forudsætninger

Inden udleveringen påbegyndes skal apoteket tage en “lås” på udleveringsgrundlaget og oprette en tilhørende bestilling. Det gøres ved at kalde servicen Påbegynd håndtering af bestilling

Dette skal ske blandt andet for at sikre, at den ikke er udleveret af et andet apotek.

Herefter er bestillingens status “Ekspedition påbegyndt”. Når bestillingen har fået denne status, vil det altid være tilladt efterfølgende at oprette en udlevering, uanset om lægen i mellemtiden annullerer udleveringsgrundlaget.

Forespørgsel

Request

I forespørgsel til FMK kan der sendes borgerens CPR-nummer. For personer uden CPR-nummer kan der anvendes en alternativ værdi, se Medicinkortets nøgle. Hvis modtageren er en organisation frem for en enkelt borger, angives i stedet organisationens OrganisationIdentifier. I elementet CreatedBy medsendes information omkring organisationen og apoteket, som har foretaget oprettelsen, se Modifikator. Er udleveringen oprettet af en anden aktør, end den der foretager kaldet mod FMK, anvendes på dette sted et ReportedBy-element. Til sidst angives en række EffectuateOrder-elementer.

EffectuateOrder

Dette element indeholder først en WarrantIdentifier og en OrderIdentifier på det tilhørende udleveringgrundlag og dén bestilling, som udleveringen oprettes på. Herefter angives et CreatePharmacyHandover-element, som indeholder følgende:

  • DateTime – tidspunkt for udlevering
  • Package – informationer om de udleverede pakker. Indeholder altid pakkens varenummer (PackageNumber). Det er desuden muligt at angive antallet af pakker (PackageQuantity) samt pakningsstørrelse (PackageSize). Hvis apoteket substituerer lægemidlet, skal det substituerede lægemiddel angives her under SubstitutedDrug.
  • Optionelt UsesSecondaryHandover-flag. Dette flag angives, hvis der benyttes sekundær udlevering.
  • Optionelt PharmacyComment, fritekst.
  • Optionelt LabelText, ettikettetekst på pakke
  • Optionelt ResponsibleOrganisation, oplysninger om den udleverende organisation. Dette angives, hvis den udleverende organisation er forskellig fra organisationen, hvor bestillingen blev oprettet. Et eksempel kunne være et apoteksfilial tilknyttet et andet apotek, hvor det andet apotek er angives som OrderedAtPharmacy.

Efter CreatePharmacyHandover kan angives TerminateWarrant-elementet hvis udleveringsgrundlaget skal afsluttes. Hvis ikke dette angives forbliver udleveringsgrundlaget åbent og der kan forsat foretages udleveringer på det.

Sidst er det optionelt muligt at angive et element af typen DetailsForTrackAndTrace. Dette element indikerer, at FMK skal foretage Track&Trace på bestillingen. Bestillingen vil i så fald få status “Sendes”, med mindre der angives et IsFinalEvent-element.

DetailsForTrackAndTrace indeholder følgende elementer:

  • Optionelt ExpectedDeliveryDate, forventet leveringsdato for pakken
  • Optionelt EventFreeText, fritekst
  • Optionelt: Et valg mellem et af følgende:
    • ExpectedNextEventDateTime for forventet tidspunkt for oprettelse af næste Track&Trace-event.
    • IsFinalEvent-flag, som indikerer, at FMK ikke forventes at oprette flere events. Sættes dette, vil bestillingen få status “Udleveret”.
  • Optionelt: Op til flere AdditionalInformation-elementer. Disse indeholder metadata i form af Key-Value par. Dette kan anvendes hvis man har brug for at angive yderligere information på en mere struktureret form.

Eksempel

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

Svar

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
EffectuateOrderResponse.xml
<EffectuateOrderResponse>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
	<Handover>
		<WarrantIdentifier>1341404077656004004</WarrantIdentifier>
		<OrderIdentifier>1341404077656004006</OrderIdentifier>
		<HandoverIdentifier>1341404078102001010</HandoverIdentifier>
	</Handover>
</EffectuateOrderResponse>
fmk/1.6.0/services/effektuer_bestilling.txt · Last modified: by lbdo

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki