Medicinkortets nøgle

I versioner af FMK op til og med 1.4.4 identificeres Medicinkort med et dansk CPR-nummer som nøgle.

Fra version 1.4.4.E2 og 1.4.6 kan Medicinkortet have forskellige typer af nøgler, se generelt om Medicinkortets nøgle.

Normalt vil et medicinkort være til en person. For at kunne håndtere bl.a. “lægemidler til brug i praksis” kan der dog i visse sammenhænge findes medicinkort til organisationer.

Et medicinkort kan godt have flere nøgler. Dog kan nøgler for personer og organisationer ikke blandes. Eksempelvis kan en persons medicinkort til at begynde med have et eCPR-nummer som nøgle, og herefter få et “rigtigt” CPR-nummer. I dette tilfælde vil der kunne slås op med begge nøgler. I personinformation vil CPR-nummeret vil blive returneret, og eCPR-nummer vil blive returneret markeret som en alternativ nøgle.

Håndteringen af CPR-nummer, eCPR-numre m.v. benytter sig at FMK's generelle princip, hvor typen af indholdet af et element angives i en source-attribut. Alle systemer skal kunne håndtere at der returneres nye og hidtil ukendte typer, dvs. alle systemer skal kunne vise data alligevel, men ikke nødvendigvis oprette eller opdatere med ukendte typer.

Herunder er beskrevet de aktuelt kendte medicinkort-nøgler.

Et CPR-nummer angives i PersonIdentifier-elementet med værdien “CPR” i source-attributten. Eksemplet herunder viser et CPR-nummer returneret i et ellers tomt medicinkort.

Er source CPR vil de generelle regler for CPR være gældende. Dvs. maks længde er 10 tegn, alle tegn er numeriske osv.

GetMedicincardResponse-CPR-Empty.xml

<GetMedicineCardResponse>
    <MedicineCard>
        <Patient>
            <Person>
                <Name>
                    <GivenName>Anders</GivenName>
                    <Surname>Andersen</Surname>
                </Name>
                <PersonIdentifier source="CPR">3102701234</PersonIdentifier>
                <BirthDate>1973-02-01</BirthDate>
                <Gender>male</Gender>                
            </Person>
            <Address>
                <StreetName>A. Andersens Vej</StreetName>
                <StreetBuildingIdentifier>12</StreetBuildingIdentifier>
                <PostCodeIdentifier>1234</PostCodeIdentifier>
                <DistrictName>Andetsted</DistrictName>
            </Address>
        </Patient>
        <Version>0</Version>
        <HasOpenDosageDispensingPrescriptions>true</HasOpenDosageDispensingPrescriptions>
        <OrderedPrescriptionsExist>true</OrderedPrescriptionsExist>
    </MedicineCard>
</GetMedicineCardResponse>

Et eCPR-nummer findes i samme PersonIdentifier-element men med værdien X-eCPR i source-attributten. Foreløbig understøtter FMK kun X-eCPR. FMK's snitflade lægger ingen restriktioner i hvad erstatnings-CPR-nummer kan indeholde, men der valideres at eCPR nummeret er oprettet i Sundhedsdatastyrelsen eCPR2-service. For mere information omkring eCPR i FMK se: eCPR og eCPR-service.

Bemærk pga. dataformat fra eCPR servicen er det ikke muligt at formatere patientens adresse korrekt. Derfor vil vejnavn og husnummer altid være sat til en placeholder værdi i svaret, som henviser til at patientens fulde adresse kan findes i eCPR servicen.

Desuden kan der vælges værdier i felter såsom Køn, som ikke i dag understøttes i FMK. Disse værdier bliver af nødvendighed omdannes til en værdi som FMK kan udtrykke, fx bliver alle angivne køn som ikke er “Mand” til “Kvinde”.

<PersonIdentifier source="X-eCPR">3102701HB3</PersonIdentifier>

GetMedicincardResponse-X-eCPR-Empty.xml

<GetMedicineCardResponse>
    <MedicineCard>
        <Patient>
            <Person>
                <Name>
                    <GivenName>Henry</GivenName>
                    <Surname>Willow</Surname>
                </Name>
                <PersonIdentifier source="X-eCPR">3102701HB3</PersonIdentifier>
                <BirthDate>1970-02-31</BirthDate>
                <Gender>male</Gender>                
            </Person>
            <Address>
                <StreetName>Adressen findes i eCPR registeret</StreetName>
                <StreetBuildingIdentifier>999</StreetBuildingIdentifier>
                <PostCodeIdentifier>7844</PostCodeIdentifier>
                <DistrictName>Nystabel</DistrictName>
            </Address>
        </Patient>
        <Version>0</Version>
        <HasOpenDosageDispensingPrescriptions>false</HasOpenDosageDispensingPrescriptions>
        <OrderedPrescriptionsExist>false</OrderedPrescriptionsExist>
    </MedicineCard>
</GetMedicineCardResponse>

Et SORPERSON pseudo-personid anvendes til et medicinkort for organisationer via et SOR-id, og bør kun benyttes af denne organisation såfremt organisationen ønsker at få dosisdispenseret medicin som er tiltænkt specifikke behandlinger frem for en specifik patient.

I kommende snitflader vil medicinkort til organisationer bliver understøttet bedre med en struktur tilsvarende PersonIdentifier, men for at understøtte det på nuværende 1.4.4 & 1.4.6 snitflader, understøtter FMK disse medicinkort via source SOR på personIdentifier som en psudo-person.

Da anvendelsen primært er tiltænkt dosisdispensering, er det ikke muligt at benytte PersonIdentifiers med source SOR i en række services på FMK, da brugen af disse ikke har nogen relation til vedligeholdelse af et medicinkort til dosisdispensering. En liste af hvilke services der kan benyttes (og hvilke der ikke kan) findes her.

Bemærk pga dataformatet for SOR organisationer et det ikke muligt at skelne hus/bygnings-nummer. FMK vil indsætte hele vejnavn+nummer (op til 50 tegn) ind i StreetName feltet, StreetBuildingIdentifier vil være sat til en standard-værdi på 999 og skal ignoreres.

GetMedicincardResponse-SOR-Empty.xml

<GetMedicineCardResponse>
    <MedicineCard>
        <Patient>
            <Person>
                <Name>
                    <GivenName>Kirurgisk klinik Solhaven</GivenName>
                    <Surname>SOR Organisation</Surname>
                </Name>
                <PersonIdentifier source="SORPERSON">253071000076607</PersonIdentifier>
                <BirthDate>2999-12-31</BirthDate>
                <Gender>male</Gender>                
            </Person>
            <Address>
                <StreetName>Solhavensvej 1</StreetName>
                <StreetBuildingIdentifier>999</StreetBuildingIdentifier>
                <PostCodeIdentifier>5700</PostCodeIdentifier>
                <DistrictName>Skørping</DistrictName>
            </Address>
        </Patient>
        <Version>0</Version>
        <HasOpenDosageDispensingPrescriptions>true</HasOpenDosageDispensingPrescriptions>
        <OrderedPrescriptionsExist>false</OrderedPrescriptionsExist>
    </MedicineCard>
</GetMedicineCardResponse>

Der understøttes desuden at der kan returneres en teknisk nøgle, genereret af FMK. Denne vil have source-attributten MedicineCardKey. FMK's snitflade lægger ingen restriktioner i hvad en MedicineCardKey kan indeholde, ud over at længden er max 50 tegn. MedicineCardKeys anvendes i praksis kun, når der oprettes recepter til personer uden CPR. Disse svarer til det tidligere Recept-ID, det vil sige typisk et 18 cifret heltal. Denne source kan kun anvendes i forbindelse med håndtering (apotekernes ekspedition) af recepter til personer uden CPR.

<PersonIdentifier source="MedicineCardKey">134140012003001</PersonIdentifier>