This is an old revision of the document!
Table of Contents
Services
Dette dokument indeholder en beskrivelse af hvilke tiltag der er nødvendige for at EPJ-systemer og lægepraksissystemer kan benytte de services som ”Det Fælles Medicinkort” stiller til rådighed via Versionssnitfladen.
I denne og andre tekster anvendes forkortelsen FMK om Det Fælles Medicinkort.
Versionsservice snitfladen er tænkt brugbar i forbindelse med migreringer, eller check af lokale data hvor man for et antal medicinkort eller ordinationer ønsker en liste af alle versioner disse har været i – eller ønsker at skifte mellem FMK 1.2 og FMK 1.4 versionering.
Versionssnitfladen har egen WSDL og kan anvendes helt afkoblet fra resten af systemet.
Operationer
Versionsservice har to operationer – MedicineCardVersions, og DrugMedicationVersions – som hver returnerer en liste af de versioner de findes i. I FMK opereres der med to versioner alt efter snitfladeversion. I FMK 1.2.* brugte man fortløbende versionsnumre, mens man i FMK 1.4 og op anvender tidsstempler. Svaret fra operationerne indeholder begge versioner.
Hvis identifier i request udpeger et CPR eller ordinations-Id som ikke findes i systemet får man returneret identifieren i response og -1 som hhv. FMK 1.2 og FMK 1.4 versionsnummer.
MedicineCardVersions
Operationen tager en liste af CPR numre som input, mindst 1 og maksimalt 100 CPR numre ad gangen.
Sample request
<?xml version="1.0" encoding="UTF-8"?> <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance" id="Envelope"> <soapenv:Header> </soapenv:Header> <soapenv:Body> <ns:MedicineCardVersionsRequest xmlns:ns="http://www.dkma.dk/medicinecard/xml.schema/2014/08/01"> <ns:PersonIdentifier>0202011365</ns:PersonIdentifier> <ns:PersonIdentifier>0305605956</ns:PersonIdentifier> <ns:PersonIdentifier>0606213085</ns:PersonIdentifier> </ns:MedicineCardVersionsRequest> </soapenv:Body> </soapenv:Envelope>
Sample response
<?xml version="1.0" encoding="UTF-8"?> <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> <soapenv:Header> <mc2009:PrescriptionReplicationStatusStructure xmlns:mc2009="http://www.dkma.dk/medicinecard/xml.schema/2009/01/01"/> <mc2008:TimingListStructure xmlns:mc2008="http://www.dkma.dk/medicinecard/xml.schema/2008/06/01"> <mc2008:TimingStructure> <mc2008:SystemName>FMK</mc2008:SystemName> <mc2008:ServiceName>Versions.getMedicineCardVersions</mc2008:ServiceName> <mc2008:TimeInMilliseconds>25</mc2008:TimeInMilliseconds> </mc2008:TimingStructure> </mc2008:TimingListStructure> </soapenv:Header> <soapenv:Body> <medicinecard20140801:MedicineCardVersionsResponse xmlns:medicinecard20140801="http://www.dkma.dk/medicinecard/xml.schema/2014/08/01"> <medicinecard20140801:MedicineCardVersionsForCPR> <medicinecard20140801:PersonIdentifier>0202011365</medicinecard20140801:PersonIdentifier> <medicinecard20140801:MedicineCardVersions> <medicinecard20140801:VersionNumber_12>-1</medicinecard20140801:VersionNumber_12> <medicinecard20140801:VersionNumber_14>-1</medicinecard20140801:VersionNumber_14> <medicinecard20140801:MedicineCardVersions> </medicinecard20140801:MedicineCardVersionsForCPR> <medicinecard20140801:MedicineCardVersionsForCPR> <medicinecard20140801:PersonIdentifier>0305605956</medicinecard20140801:PersonIdentifier> <medicinecard20140801:MedicineCardVersions> <medicinecard20140801:VersionNumber_12>1</medicinecard20140801:VersionNumber_12> <medicinecard20140801:VersionNumber_14>1395142957642001238</medicinecard20140801:VersionNumber_14> </medicinecard20140801:MedicineCardVersions> <medicinecard20140801:MedicineCardVersions> <medicinecard20140801:VersionNumber_12>2</medicinecard20140801:VersionNumber_12> <medicinecard20140801:VersionNumber_14>1395143021970001238</medicinecard20140801:VersionNumber_14> </medicinecard20140801:MedicineCardVersions> … </medicinecard20140801:MedicineCardVersionsForCPR> <medicinecard20140801:MedicineCardVersionsForCPR> <medicinecard20140801:PersonIdentifier>0606213085</medicinecard20140801:PersonIdentifier> <medicinecard20140801:MedicineCardVersions> <medicinecard20140801:VersionNumber_12>-1</medicinecard20140801:VersionNumber_12> <medicinecard20140801:VersionNumber_14>-1</medicinecard20140801:VersionNumber_14> </medicinecard20140801:MedicineCardVersions> </medicinecard20140801:MedicineCardVersionsForCPR> </medicinecard20140801:MedicineCardVersionsResponse>
DrugMedicationVersions
Operationen tager en liste af ordinations-Id som input, mindst 1 og maksimalt 100 ad gangen.
Sample request
<?xml version="1.0"?> <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Header> <h:Header xmlns:h="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd"> <h:Linking> <h:FlowID>26b972e2aef14f858448686e15eae57a</h:FlowID> <h:MessageID>b873cc6b72814baba7f02ca5157fdaa9</h:MessageID> </h:Linking> </h:Header> </s:Header> <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <DrugMedicationVersionsRequest xmlns="http://www.dkma.dk/medicinecard/xml.schema/2014/08/01"> <DrugMedicationIdentifier>90446</DrugMedicationIdentifier> <DrugMedicationIdentifier>90446</DrugMedicationIdentifier> <DrugMedicationIdentifier>90446</DrugMedicationIdentifier> <DrugMedicationIdentifier>167021</DrugMedicationIdentifier> <DrugMedicationIdentifier>209457</DrugMedicationIdentifier> </DrugMedicationVersionsRequest> </s:Body> </s:Envelope>
Sample response
<?xml version="1.0" encoding="UTF-8"?> <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> <soapenv:Header> <mc2009:PrescriptionReplicationStatusStructure xmlns:mc2009="http://www.dkma.dk/medicinecard/xml.schema/2009/01/01"/> <mc2008:TimingListStructure xmlns:mc2008="http://www.dkma.dk/medicinecard/xml.schema/2008/06/01"> <mc2008:TimingStructure> <mc2008:SystemName>FMK</mc2008:SystemName> <mc2008:ServiceName>Versions.getDrugMedicationVersions</mc2008:ServiceName> <mc2008:TimeInMilliseconds>695</mc2008:TimeInMilliseconds> </mc2008:TimingStructure> </mc2008:TimingListStructure> </soapenv:Header> <soapenv:Body> <medicinecard20140801:DrugMedicationVersionsResponse xmlns:medicinecard20140801="http://www.dkma.dk/medicinecard/xml.schema/2014/08/01"> <medicinecard20140801:DrugMedicationsForIdentifier> <medicinecard20140801:DrugMedicationIdentifier>90446</medicinecard20140801:DrugMedicationIdentifier> <medicinecard20140801:DrugMedicationVersions> <medicinecard20140801:VersionNumber_12>1</medicinecard20140801:VersionNumber_12> <medicinecard20140801:VersionNumber_14>1331717241038179999</medicinecard20140801:VersionNumber_14> </medicinecard20140801:DrugMedicationVersions> <medicinecard20140801:DrugMedicationVersions> <medicinecard20140801:VersionNumber_12>2</medicinecard20140801:VersionNumber_12> <medicinecard20140801:VersionNumber_14>1399294241821001851</medicinecard20140801:VersionNumber_14> </medicinecard20140801:DrugMedicationVersions> </medicinecard20140801:DrugMedicationsForIdentifier> <medicinecard20140801:DrugMedicationsForIdentifier> <medicinecard20140801:DrugMedicationIdentifier>167021</medicinecard20140801:DrugMedicationIdentifier> <medicinecard20140801:DrugMedicationVersions> <medicinecard20140801:VersionNumber_12>1</medicinecard20140801:VersionNumber_12> <medicinecard20140801:VersionNumber_14>1377680049877001163</medicinecard20140801:VersionNumber_14> </medicinecard20140801:DrugMedicationVersions> <medicinecard20140801:DrugMedicationVersions> <medicinecard20140801:VersionNumber_12>2</medicinecard20140801:VersionNumber_12> <medicinecard20140801:VersionNumber_14>1381066427638001238</medicinecard20140801:VersionNumber_14> </medicinecard20140801:DrugMedicationVersions> <medicinecard20140801:DrugMedicationVersions> <medicinecard20140801:VersionNumber_12>3</medicinecard20140801:VersionNumber_12> <medicinecard20140801:VersionNumber_14>1383913780147001851</medicinecard20140801:VersionNumber_14> </medicinecard20140801:DrugMedicationVersions> <medicinecard20140801:DrugMedicationVersions> <medicinecard20140801:VersionNumber_12>4</medicinecard20140801:VersionNumber_12> <medicinecard20140801:VersionNumber_14>1383913856809001238</medicinecard20140801:VersionNumber_14> </medicinecard20140801:DrugMedicationVersions> <medicinecard20140801:DrugMedicationVersions> <medicinecard20140801:VersionNumber_12>5</medicinecard20140801:VersionNumber_12> <medicinecard20140801:VersionNumber_14>1383913945383001238</medicinecard20140801:VersionNumber_14> </medicinecard20140801:DrugMedicationVersions> <medicinecard20140801:DrugMedicationVersions> <medicinecard20140801:VersionNumber_12>6</medicinecard20140801:VersionNumber_12> <medicinecard20140801:VersionNumber_14>1383913950985001851</medicinecard20140801:VersionNumber_14> </medicinecard20140801:DrugMedicationVersions> <medicinecard20140801:DrugMedicationVersions> <medicinecard20140801:VersionNumber_12>7</medicinecard20140801:VersionNumber_12> <medicinecard20140801:VersionNumber_14>1410272058283001238</medicinecard20140801:VersionNumber_14> </medicinecard20140801:DrugMedicationVersions> </medicinecard20140801:DrugMedicationsForIdentifier> <medicinecard20140801:DrugMedicationsForIdentifier> <medicinecard20140801:DrugMedicationIdentifier>209457</medicinecard20140801:DrugMedicationIdentifier> <medicinecard20140801:DrugMedicationVersions> <medicinecard20140801:VersionNumber_12>-1</medicinecard20140801:VersionNumber_12> <medicinecard20140801:VersionNumber_14>-1</medicinecard20140801:VersionNumber_14> </medicinecard20140801:DrugMedicationVersions> </medicinecard20140801:DrugMedicationsForIdentifier> </medicinecard20140801:DrugMedicationVersionsResponse> </soapenv:Body> </soapenv:Envelope>
