====== Annuller recept ======

Servicen anvendes til at ”annullere” en eller flere recepter. Dette forudsætter dog at recept­ordinationens status tillader denne statusændring.

Annullering af en recept vil typisk finde sted i forbindelse med seponering af en lægemiddelordination. Såfremt der eksisterer en tilhørende 'åben' recept på Receptserveren, bør denne annulleres. 

Annullering af recepter er også relevant ved oprydning / markering som 'ikke relevant'. Hvis medicinen ikke længere er relevant for patienten, bør recepten også annulleres, såfremt den  ikke allerede er afsluttet.

I særlige scenarier kan det ske at lægen annullerer en recept selvom apoteket har påbegyndt ekspeditionen. Det kan f.eks. ske med følgende forløb:

  - Lægen henter medicinkortet
  - Apoteket henter medicinkortet
  - Apoteket markerer receptens bestillinger til status "Ekspedition påbegyndt"
  - Lægen annullerer recepten

Resultatet vil være at recepten markeres annulleret, men det vil stadig være lovligt for apoteket at gennemføre den påbegyndte udlevering på bestillingen.


==== Forespørgsel ====

I request-dokumentet sendes patientes CPR-nummer, medicinkortets version og information omkring organisation og læge. Herefter følger en eller flere recepts-ider på recepter der skal annulleres.

<code xml>

<CancelPrescriptionRequest>
	<PersonIdentifier>1111111118</PersonIdentifier>
	<MedicineCardVersion>1341404077657004001</MedicineCardVersion>
	<ModifiedBy>
		<AuthorisedHealthcareProfessional>
			<AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier>
			<Name>Tess Christoffersen</Name>
		</AuthorisedHealthcareProfessional>
		<Organisation>
			<Name>Lægerne Vestergade</Name>
			<TelephoneNumber>86521348</TelephoneNumber>
			<Type>Yder</Type>
			<Identifier source="Yder">66974</Identifier>
		</Organisation>
	</ModifiedBy>
	<Prescription>
		<Identifier>121814002</Identifier>
	</Prescription>
</CancelPrescriptionRequest>

</code>

==== Svar ====

I svaret returneres patientens CPR-nummer, medicinkortets version (som i øvrigt er uændret), eventuelt med ”VersionMismatchWarning” en advarsel om at det medsendte versionsnummer ikke er det aktuelle, og herefter recepts-IDer på recepter der er annullerede. 

<code xml>

<CancelPrescriptionResponse>
	<PersonIdentifier>1111111118</PersonIdentifier>
	<MedicineCardVersion>1341404077657004001</MedicineCardVersion>
	<PrescriptionIdentifier>121814002</PrescriptionIdentifier>
</CancelPrescriptionResponse>

</code>