Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Stamkortregistret (SKR) er en service med operationer til registrering og udstilling af stamdata for borgere. Dette inkluderer pårørende, midlertidige adresser, sprog mm.  Servicen beskrives i det følgende, som forudsætter kendskab til HL7 CDA og webservices.

Ændringslog

...

Præcisering omkring antal midlertidige adresser, så der altid kun er én

...

Tilrettet, således at fornavn og efternavn på pårørende er påkrævede.

(Der er bestilt en ændring, således efternavn gøres optionelt)

...

Tilrettet således pårørendes telefonnummer, efternavn gøres optionel

Slut-dato på midlertidig adresse gøres optionel

...

Servicen beskrives i det følgende, som forudsætter kendskab til HL7 CDA og webservices.

...

Indhold

Table of Contents

HL7 CDA

...

Notifikationer i NAS

I forbindelse med skriveoperationer i SKR (oprettelse, opdateringer og sletninger) oprettes notifikationer via NAS. Se evt. NAS 2.0 Anvenderguide.

De enkelte notifikationer indholder ikke detaljer vedr. opdateringen eller stamkortet, men udelukkende oplysninger om det cprnummer der er blevet opdateret. Det er efterfølgende op til anvenderen at hente det opdaterede stamkort ud via snitfladerne.

...

Følgende er et eksempel på en opdateringsnotifikation:

...

Der anvendes dette topic: http://sundhedsdatastyrelsen.dk/PersonalDataCard/2020/11/01:DataCardUpdated

...

Stamkortet kan desuden hentes som et "on demand"-dokument via Dokumentdelingsservicen (DDSvia SFSK ("Synkroniseringsservice til Fælles Stamkort" i anvendernes fagsystemer).

WSDL-filer
JSON-output med overblik over WSDL'erne, der viser nyeste versioner, alle versioner og tilhørende operationer. <server>/skr/wsdl
Nyeste version af Stamkortregister DGWS<server>/skr/wsdl/dgws20240101
Nyeste version af Stamkortregister IDWS<server>/skr/wsdl/idws20240101

...

Response-eksempel (indeholder ingen ingen data):

Code Block
languagexml
titleCreateRelatives response
collapsetrue
<soap:Body>
	<ns5:CreateRelativesResponse xmlns:ns10="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns:ns11="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:ns2="urn:hl7-org:fsk" 
	xmlns:ns3="urn:hl7-org:v3" xmlns:ns4="urn:hl7-org:sdtc" xmlns:ns5="http://sundhedsdatastyrelsen.dk/skr/2024/01/01" xmlns:ns6="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
	wssecurity-utility-1.0.xsd" xmlns:ns7="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns8="http://www.w3.org/2001/04/xmlenc#" xmlns:ns9="http://
	www.w3.org/2000/09/xmldsig#"/>
</soap:Body>

...

Code Block
languagexml
titleDeleteRelatives request
collapsetrue
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:medcom="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:sosi="http://www.sosi.dk/sosi/2006/04/sosi-1.0.xsd" xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/08/addressing" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wst="http://schemas.xmlsoap.org/ws/2005/02/trust" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" id="Envelope">
    <soapenv:Header>
		...
    </soapenv:Header>
    <soapenv:Body>
        <ns4:DeleteRelativesRequest xmlns:ns2="urn:hl7-org:v3" xmlns:ns3="urn:hl7-org:sdtc" xmlns:ns4="http://sundhedsdatastyrelsen.dk/skr/2024/01/01" xmlns:ns5="urn:hl7-org:fsk" 
		xmlns:ns6="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns7="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd">
            <id assigningAuthorityName="CPR" extension="1509669054" root="1.2.208.176.1.2"/>
            <relativeId assigningAuthorityName="FSK" extension="1b0ccade-f3aa-4c74-b341-10528b5eb126" root="1.2.208.184.15.3"/>
            <relativeId assigningAuthorityName="FSK" extension="86ae6d2c-96a4-441f-99ee-c8ff30b4e579" root="1.2.208.184.15.3"/>
            <dataEnterer>
                <ns2:time value="20190711015959+0200"/>
                <ns2:assignedAuthor>
                    <ns2:id assigningAuthorityName="CPR" extension="0611809735" root="1.2.208.176.1.2"/>
                    <ns2:assignedPerson>
                        <ns2:name>
                            <ns2:given>Charles</ns2:given>
                            <ns2:family>Babbage</ns2:family>
                        </ns2:name>
                    </ns2:assignedPerson>
                    <ns2:representedOrganization classCode="ORG">
                        <ns2:id assigningAuthorityName="SOR" extension="1.2.208.176.1.2" root="1.2.208.176.1.1"/>
                        <ns2:name>Sundhedsdatastyrelsen</ns2:name>
                    </ns2:representedOrganization>
                </ns2:assignedAuthor>
            </dataEnterer>
        </ns4:DeleteRelativesRequest>
    </soapenv:Body>
</soapenv:Envelope>

Response-eksempel eksempel (indeholder ingen data):

Code Block
languagexml
titleDeleteRelatives response
collapsetrue
<soap:Body>
	<ns5:DeleteRelativesResponse xmlns:ns10="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns:ns11="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:ns2="urn:hl7-org:fsk" 
	xmlns:ns3="urn:hl7-org:v3" xmlns:ns4="urn:hl7-org:sdtc" xmlns:ns5="http://sundhedsdatastyrelsen.dk/skr/2024/01/01" xmlns:ns6="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
	wssecurity-utility-1.0.xsd" xmlns:ns7="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns8="http://www.w3.org/2001/04/xmlenc#" xmlns:ns9="http://
	www.w3.org/2000/09/xmldsig#"/>
</soap:Body>

...

Code Block
languagexml
titleUpdateTemporaryAddress request
collapsetrue
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:medcom="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:sosi="http://www.sosi.dk/sosi/2006/04/sosi-1.0.xsd" xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/08/addressing" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wst="http://schemas.xmlsoap.org/ws/2005/02/trust" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" id="Envelope">
    <soapenv:Header>
        ...
    </soapenv:Header>
    <soapenv:Body>
        <ns5:UpdateTemporaryAddressRequest xmlns:ns2="urn:hl7-org:fsk" xmlns:ns3="urn:hl7-org:v3" xmlns:ns4="urn:hl7-org:sdtc" xmlns:ns5="http://sundhedsdatastyrelsen.dk/skr/2024/01/01" 
		xmlns:ns6="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns7="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd">
            <id assigningAuthorityName="CPR" extension="1509669054" root="1.2.208.176.1.2"/>
            <ns2:temporaryAddress>
                <ns2:id extension="5e56a675-9f6e-4410-8920-c0b8a3047299" root="1.2.208.184.15.2"/>
                <ns2:addr isNotOrdered="false" use="H">
                    <ns3:streetAddressLine>Wallabyvej 42</ns3:streetAddressLine>
                    <ns3:streetAddressLine>Wallabyvej 42</ns3:streetAddressLine>
                    <ns3:streetAddressLine>Wallabyvej 42</ns3:streetAddressLine>
                    <ns3:streetAddressLine>Wallabyvej 42</ns3:streetAddressLine>
                    <ns3:postalCode>8000</ns3:postalCode>
                    <ns3:city>Aarhus</ns3:city>
                    <ns3:country>Sweden</ns3:country>
                    <ns3:useablePeriod value="20241029"/>
                    <ns3:useablePeriod value="20241029"/>
                </ns2:addr>
            </ns2:temporaryAddress>
            <dataEnterer>
                <ns3:time value="20190711015959+0200"/>
                <ns3:assignedAuthor>
                    <ns3:id assigningAuthorityName="CPR" extension="0611809735" root="1.2.208.176.1.2"/>
                    <ns3:assignedPerson>
                        <ns3:name>
                            <ns3:given>Charles</ns3:given>
                            <ns3:family>Babbage</ns3:family>
                        </ns3:name>
                    </ns3:assignedPerson>
                    <ns3:representedOrganization classCode="ORG">
                        <ns3:id assigningAuthorityName="SOR" extension="1.2.208.176.1.2" root="1.2.208.176.1.1"/>
                        <ns3:name>Sundhedsdatastyrelsen</ns3:name>
                    </ns3:representedOrganization>
                </ns3:assignedAuthor>
            </dataEnterer>
        </ns5:UpdateTemporaryAddressRequest>
    </soapenv:Body>
</soapenv:Envelope>

Response-eksempel eksempel (indeholder ingen data):

Code Block
languagexml
titleUpdateTemporaryAddress response
collapsetrue
<soap:Body>
	<ns5:UpdateTemporaryAddressResponse xmlns:ns10="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns:ns11="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:ns2="urn:hl7-org:fsk" 
	xmlns:ns3="urn:hl7-org:v3" xmlns:ns4="urn:hl7-org:sdtc" xmlns:ns5="http://sundhedsdatastyrelsen.dk/skr/2024/01/01" xmlns:ns6="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
	wssecurity-utility-1.0.xsd" xmlns:ns7="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns8="http://www.w3.org/2001/04/xmlenc#" xmlns:ns9="http://
	www.w3.org/2000/09/xmldsig#"/>
</soap:Body>

...

Code Block
languagexml
titleDeleteTemporaryAddress request
collapsetrue
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:medcom="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:sosi="http://www.sosi.dk/sosi/2006/04/sosi-1.0.xsd" xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/08/addressing" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wst="http://schemas.xmlsoap.org/ws/2005/02/trust" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" id="Envelope">
    <soapenv:Header>
        ...
    </soapenv:Header>
    <soapenv:Body>
        <ns4:DeleteTemporaryAddressRequest xmlns:ns2="urn:hl7-org:v3" xmlns:ns3="urn:hl7-org:sdtc" xmlns:ns4="http://sundhedsdatastyrelsen.dk/skr/2024/01/01" xmlns:ns5="urn:hl7-org:fsk" 
		xmlns:ns6="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns7="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd">
            <id assigningAuthorityName="CPR" extension="1509669054" root="1.2.208.176.1.2"/>
            <temporaryAddressId assigningAuthorityName="FSK" extension="5e56a675-9f6e-4410-8920-c0b8a3047299" root="1.2.208.184.15.2"/>
            <dataEnterer>
                <ns2:time value="20190711015959+0200"/>
                <ns2:assignedAuthor>
                    <ns2:id assigningAuthorityName="CPR" extension="0611809735" root="1.2.208.176.1.2"/>
                    <ns2:assignedPerson>
                        <ns2:name>
                            <ns2:given>Charles</ns2:given>
                            <ns2:family>Babbage</ns2:family>
                        </ns2:name>
                    </ns2:assignedPerson>
                    <ns2:representedOrganization classCode="ORG">
                        <ns2:id assigningAuthorityName="SOR" extension="1.2.208.176.1.2" root="1.2.208.176.1.1"/>
                        <ns2:name>Sundhedsdatastyrelsen</ns2:name>
                    </ns2:representedOrganization>
                </ns2:assignedAuthor>
            </dataEnterer>
        </ns4:DeleteTemporaryAddressRequest>
    </soapenv:Body>
</soapenv:Envelope>

Response-eksempel eksempel (indeholder ingen data):

Code Block
languagexml
titleDeleteTemporaryAddress response
collapsetrue
<soap:Body>
	<ns5:DeleteTemporaryAddressResponse xmlns:ns10="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns:ns11="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:ns2="urn:hl7-org:fsk" 
	xmlns:ns3="urn:hl7-org:v3" xmlns:ns4="urn:hl7-org:sdtc" xmlns:ns5="http://sundhedsdatastyrelsen.dk/skr/2024/01/01" xmlns:ns6="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
	wssecurity-utility-1.0.xsd" xmlns:ns7="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns8="http://www.w3.org/2001/04/xmlenc#" xmlns:ns9="http://
	www.w3.org/2000/09/xmldsig#"/>
</soap:Body>

...

ElementBeskrivelseTypeOptionel
timeTidspunkt for opdatering. Format: yyyyMMddHHmmssZ, fx. 20171024143445+0200varchar(19)Nej
assignedAuthor.idEn eller flere forekomster med værdi i attribut "extension" og type (fx CPR/AUTORISATION/SOR) i attribut "assigningAuthorityName". Ved responses forekommer kun ét element, hvor assigningAuthorityName="CPR" og extension="ANONYM" for at skjule følsomme oplysninger om eksempelvis sundhedsfaglige.

extension varchar(10), assigningAuthorityName varchar(30)

Nej
author.assignedAuthor.code

Bruger type (borger, pårørende eller sundhedsprofessionel). På response.

Atributter:

  • code: EnteredCitizen, EnteredCitizenRelative eller EnteredHealthcareprofessional
  • displayName: Læsbar bruger type
  • codeSystem: fast værdi
  • codeSystemName: fast værdi
-Nej
assignedAuthor.assigningPerson.name.given

For borgere: For- og mellemnavn på person bag opdatering

For sundhedsfaglige: enten for- og evt. mellemnavn på person bag opdatering eller titel - f.eks. "Lægesekretær"

varchar(80)Nej
assignedAuthor.assigningPerson.name.family

For borgere: Efternavn på person bag opdatering

For sundhedsfaglige: enten efternavn på person bag opdatering eller overordnet sundhedsorganisation - f.eks. "Region Nordjylland" and "Silkeborg kommune"

varchar(80)Nej
assignedAuthor.representedOrganization.id

Organisations id, såfremt der er tale om en sundhedsperson. Værdi findes i attribut "extension", type i attribut "assigningAuthorityName"
(Bemærk denne attribut udstilles ikke i CDA for Fælles stamkort version PDC-DK-v.2.0)

extension varchar(80), assigningAuthorityName varchar(30)Ja
assignedAuthor.representedOrganization.name

Organisations navn (Bemærk denne attribut udstilles ikke i CDA for Fælles stamkort version PDC-DK-v.2.0)

varchar(30)Ja

Migreringssnitflade

...

ElementBeskrivelseTypeOptionel
idSom attribut "extension" angives personens CPR-nummer (uden bindestreg)varchar(10)Nej
contactInformation0-3 forekomster med attribut use=H/MP/WP (H=home, MP=mobile phone, WP=work place). Telefonnummer angives i attributten "value" med præfix "tel:", fx value="tel:01123622"varchar(45)Ja
relatedPersonsListe-struktur tilsvarende relatedPerson i GetPersonalDataCard response-Ja
temporaryAddressDen midlertidige adresse der skal oprettes. Indeholder addr-struktur, som beskrevet længere nede-Ja
languageSprogkode. Format: ISO-639-1char(2)Ja
dataEntererMigrationSystemet der migrerer stamkort. Se tabel længere nede (delt struktur)-Nej

...

Fejlsituationer i forbindelse med MigratePersonalDataCard

Udover xml valideringsfejl og interne fejl kan migreringssnitfladen returnere følgende fejlkoder. 

...

WSDL-filer
Stamkortregister DGWS
<server>/skr/wsdl/dgws20180501
Stamkortregister DGWS
<server>/skr/wsdl/dgws20190801
Stamkortregister DGWS
<server>/skr/wsdl/dgws20200728
Stamkortregister DGWS
<server>/skr/wsdl/dgws20210602
Stamkortregister IDWS
<server>/skr/wsdl/idws20180501
Stamkortregister IDWS
<server>/skr/wsdl/idws20190801
Stamkortregister DGWSIDWS
<server>/skr/wsdl/
dgws20200728
idws20200728
Stamkortregister IDWS
<server>/skr/wsdl/
idws20200728
idws20210602

Valideringsbeskeder

Fejlkoder:

...