This is an old revision of the document!
Table of Contents
Effektuér bestilling
Servicen anvendes i forbindelse med at 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å recepten 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 at lægen evt. i mellemtiden annullerer lægemiddelordinationen.
Forespørgsel
I forespørgsel til FMK sendes først 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 apotekeren som har foretaget oprettelsen, se Modifikator. Er udleveringen oprettet af en anden aktør end personen 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å. Hernæst 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 underSubstitutedDrug. - 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 somOrderedAtPharmacy.
Efter CreatePharmacyHandover angives enten true eller false i TerminateWarrant-elementet. Dette svarer til, om recepten er afsluttet, eller om der fortsat kan udleveres ud fra recepten.
Sidst er det optionelt muligt at angive et element af typen StartTrackAndTraceOnOrder. Angivelse af dette element indikerer, at FMK skal begynde at udsende Track&Trace-events baseret på bestillingen. Dette medfører at bestillingen får status Sendes.
StartTrackAndTraceOnOrder indeholder følgende elementer:
- Optionelt
ExpectedDeliveryDate, forventet leveringsdato for pakken - Optionelt
EventFreeText, fritekst - Optionelt: enten en angivelse af
ExpectedNextEventDateTimefor forventet tidspunkt for oprettelse af næste Track&Trace-event – alternativt flagetIsFinalEvent, som indikerer, at FMK ikke forventes at oprette flere events.
Eksempel
- EffectuateOrderRequest.xml
<EffectuateOrderRequest> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <CreatedBy> <Other> <Name> <GivenName>Anne</GivenName> <Surname>Andersen</Surname> </Name> </Other> <Role>Apoteksansat</Role> <Organisation> <Name>Skanderborg Apotek</Name> <AddressLine>Adelgade 27</AddressLine> <AddressLine>8660 Skanderborg</AddressLine> <Type>Apotek</Type> <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier> </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> <Value>50</Value> <UnitCode source="Medicinpriser" date="2014-03-10">MG</UnitCode> <UnitText>mg</UnitText> </Strength> </SubstitutedDrug> </Package> <HandoverComment>Oprettet i Betalingsservice</PharmacyComment> <LabelText>1 tablet morgen, middag og aften mod smerter</LabelText> <ResponsibleOrganisation> <Name>Ry Apoteksudsalg</Name> <AddressLine>Siimtoften 2</AddressLine> <AddressLine>8660 Ry</AddressLine> <Type>Apotek</Type> <Identifier source="CVR-P">1008648049</Identifier> </ResponsibleOrganisation> </Handover> <Terminate>true</Terminate> <StartTrackAndTraceOnOrder> <ExpectedDeliveryDate>2026-03-12</ExpectedDeliveryDate> <ExpectedNextEventDateTime>2026-03-10T14:00:00Z</ExpectedNextEventDateTime> </StartTrackAndTraceOnOrder> </Order> </EffectuateOrderRequest>
Svar
Svaret indeholder den PersonIdentifier eller OrganisationIdentifier, som bestillingen er tilknyttet. Dernæst forekommer en række Handover-elementer, som hver indeholder:
WarrantIdentifierOrderIdentifierHandoverIdentifier
- EffectuateOrderResponse.xml
<EffectuateOrderResponse> <PersonIdentifier source="CPR">1111111118</PersonIdentifier> <Handover> <WarrantIdentifier>1341404077656004004</WarrantIdentifier> <OrderIdentifier>1341404077656004006</OrderIdentifier> <HandoverIdentifier>1341404078102001010</HandoverIdentifier> </Handover> </EffectuateOrderResponse>
