====== Opdater dispenseringskort ======
Servicen benyttes til opdatering af et givent dispenseringskort. I opdateringen kan der angives nye værdier til alle de forskellige felter som også findes i [[fmk:1.6.0:services:opret_dispenseringskort|Opret Dispenseringskort]].

==== Forespørgsel ====

I [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#UpdateDispensingCardRequestType|request]]-dokumentet skal der medsendes en [[fmk:1.6.0:xml-elementer:medicinkortets_nogle|PersonIdentifier]] på den patient, som  dispenseringskortet tilhører. Såfremt det pågældnede dispenseringskort skal anvendes som dispenseringskort til organisationer, skal dette angives i ''OrganisationIdentifier'' på den pågældende organisation.

I elementet CreatedBy medsendes information omkring organisationen (udleverings- eller pakkeapoteket) og brugeren som foretager opdateringen, [[fmk:1.6.0:xml-elementer:modifikator|Modifikator]]. Er elementet oprettet af en anden aktør end personen, der foretager kaldet mod FMK, medsendes både et ReportedBy-element, og CreatedBy. Se evt. [[fmk:generel:aktorer_pa_fmk|Aktører på FMK]].

Data om selve dispenseringskortet og dets nye værdier, medsendes i elementet ''DispensingCard''. Det er muligt at oprette flere dosisdispenseringskort til samme patient i ét kald.

''DispensingCard'' indeholder følgende elementer:
  * ''Identifier'': Id på det dispenseringskort, som skal opdateres.
  * ''Version'': Nuværende versions-nummer for dispenseringskortet
  * ''Description'': En kort beskrivelse af kortet.
  * **Optionel** ''Delivery'': Beskrivelse af den forventede leveringsadresse el.lign. for kortet.
  * **Optionel** ''DaysForExpeditedDosageChange'': Angiver det antal dage, som der skal forventes, for at ændringer kan træde i kraft uden det kræver kontakt med den ansvarlige organisation. Bemærk, at det forventes, at FMK udfylder denne med en standard værdi, såfremt den ansvarlige organisation ikke gør.
  * Den ansvarlige organisation: Se næste afsnit.
  * **Optionel** ''DispensingNotes'': Kort note omkring den forventede fysiske dispensering.
  * **Optionel** ''DeliveryNotes'': Kort note omkring den forventede levering af dispenseringen.
  * **Optionel** ''DispensingMachineIdentification'': Informationer omkring en fysisk maskine, som patienten har til at udlevere poser fra en dosisdispenseringsrulle.

Yderligere beskrivelse af felterne kan findes på [[fmk:1.6.0:xml-elementer:dispenseringskort|denne side]].

Et dispenseringskort skal altid knyttes til en ansvarlig organisation. Hertil er der er 3 muligheder for at angive den ansvarlige:
  - Angivelse af en pakkegruppe med ''PackingGroupIdentifier''
  - Angivelse af et udleverings- og pakkeapotek med felterne: ''OrderedAtPharmacy'' & ''PackedAtOrganisation''
  - Angivelse af den dispenserende organisation med feltet: ''DispensingOrganisation''

Det forventes, at apoteker, som udfører dosisdispensering, benytter 1 eller 2, mens hjemmeplejen el.lign., som foretager manuel ophældning, benytter 3.

<file xml UpdateDispensingCardRequestPharmacy.xml>
<CreateDispensingCardRequest>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
	<CreatedBy>
		<HealthcareProfessional>
			<Indentifier source="CPR">2012850101</Indentifier>
			<Name>Hanne Jensen</Name>
		</HealthcareProfessional>
		<Role>Apoteksansat</Role>
		<Organisation>
                        <Identifier source="EAN-Lokationsnummer">123456789</Identifier>
                        <Type>Apotek</Type>			
                        <Name>Aarhus Kobbergade Apotek</Name>
			<AddressLine>Kobbergade 17, 8000 Aarhus</AddressLine>
			<TelephoneNumber>00000000</TelephoneNumber>
			<EmailAddress>ABC@XYZ.com</EmailAddress>
		</Organisation>
	</CreatedBy>
	<DispensingCard>
                <Identifier>123456987</Identifier>
                <Version>987654321</Version>
		<Description>Et herligt Dosisdispenseringskort</Description>
		<Delivery>
                         <DeliveryPriority>send til anden adresse samme dag</DeliveryPriority>
                         <AddressLine>Jernbrogade 5</AddressLine>
                         <AddressLine>8382 Hinnerup</AddressLine>
                </Delivery>
                <DaysOfChangeDeadline>4</DaysOfChangeDeadline>
		<PackingGroupIdentifier>852582</PackingGroupIdentifier>
		<DispensingNotes>Skal pakkes i grøn kasse</DispensingNotes>
		<DeliveryNotes>Leveres i ulige uger</DeliveryNotes>
	</DispensingCard>
</CreateDispensingCardRequest>
</file>

<file xml UpdateDispensingCardRequestCommunal.xml>
<UpdateDispensingCardRequest>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
	<CreatedBy>
		<HealthcareProfessional>
			<Indentifier source="CPR">1208911078</Indentifier>
			<Name>Mikkel Smed Hansen</Name>
		</HealthcareProfessional>
		<Role>Kommunal ansat til medicinhåndtering</Role>
		<Organisation>
                        <Identifier source="SOR">987654321</Identifier>
                        <Type>kommune</Type>		
                        <Name>Nordfyns Kommune</Name>
			<AddressLine>Østergade 23, 5400 Bogense</AddressLine>
			<TelephoneNumber>99999999</TelephoneNumber>
			<EmailAddress>XYZ@ABC.com</EmailAddress>
		</Organisation>
	</CreatedBy>
	<DispensingCard>
                <Identifier>123456987</Identifier>
                <Version>987654321</Version>
		<Description>Hjemmeplejen</Description>
		<DispensingOrganisation>
                        <Identifier source="SOR">987654321</Identifier>
                        <Type>kommune</Type>			
                        <Name>Nordfyns Kommune</Name>
			<AddressLine>Østergade 23, 5400 Bogense</AddressLine>
			<TelephoneNumber>99999999</TelephoneNumber>
			<EmailAddress>XYZ@ABC.com</EmailAddress>
		</DispensingOrganisation>
		<DispensingNotes>Ophældes hver anden mandag</DispensingNotes>
	</DispensingCard>
</UpdateDispensingCardRequest>
</file>

==== Svar ====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#UpdateDispensingCardResponseType|Svaret]] fra FMK indeholder det medsendte ''PersonIdentifier''. Desuden returneres en række ''DispensingCard'' elementer, som indeholder ''Identifier'' og ''Version'' på de(n) opdaterede dispenseringskort.

<file xml UpdateDispensingCardResponse.xml>
<UpdateDispensingCardResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <DispensingCard>
        <Identifier>234241231</Identifier>
        <Version>3213813130</Version>
    </DispensingCard>
</UpdateDispensingCardResponse>
</file>