Page History

Versions Compared

Old Version 47

changes.mady.by.user Unknown User (tbr@kvalitetsit.dk)

Saved on 25-04-2022

compared with

New Version 48

changes.mady.by.user Unknown User (tbr@kvalitetsit.dk)

Saved on 25-04-2022

Key

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

...

Notificeringer i NAS

I forbindelse med skriveoperationer i SKR (oprettelse, opdateringer og sletninger) sker der en notificering via NAS. Se evt. NAS 2.0 Anvenderguide.

De enkelte notificeringer indholder ikke detaljer vedr. opdateringen eller stamkortet, men udelukkende oplysninger om det cprnummer, for hvilket opdateringen har fundet sted. Det er efterfølgende op til anvenderen at hente det opdaterede stamkort ud via snitfladerne.

Følgende er et eksempel på en opdateringsnotificering:

...

Topic der anvendes: http://sundhedsdatastyrelsen.dk/PersonalDataCard/2020/11/01:DataCardUpdated

...

Derudover er et antal forældede snitflader der vil blive udfaset over tid, se længere nede i dokumentet.

Snitflade til normal brug

Sundhedsfaglige anvender servicen gennem en DGWS-snitflade, som skal kaldes med et MOCES niveau 4 medarbejdercertifikat. Sundhed.dk har dog undtagelsesvis whitelisting til at kalde med et niveau 3 certifikat.

...

WSDL-filer
HTML-side med overblik	<server>/skr/wsdl
Stamkortregister DGWS	<server>/skr/wsdl/dgws20210602
Stamkortregister IDWS	<server>/skr/wsdl/idws20210602

WSDL

WSDLen for SKR indeholder nedenstående operationer:

...

De enkelte operationer forklares i de følgende afsnit.

Serviceoperationer

Nedenfor beskrives de forskellige operationer i SKR servicen. For hver operation gives eksempler på request/response (for simpelhedens skyld uden DGWS/IDWS headers). Eksemplerne tjener dels til formål at give overblik over hvad der skal til for at bruge en operation, men demonstrerer samtidigt hvilke attributter der er krævet. Dvs. de forskellige requests angiver hvad der som minimum skal angives (dog ikke i situationer hvor der fx slettes to pårørende i samme request - ingen services kræver mere end én liste-indgang).

GetPersonalDataCard

Request

Element	Beskrivelse	Type	Optionel
id	Som attribut "extension" angives personens CPR-nummer (uden bindestreg)	varchar(10)	Nej

Response

Element	Beskrivelse	Type	Optionel
realmCode	Krævet pr. standard, fast værdi	-	-
typeId	Krævet pr. standard, fast værdi	-	-
templateId	Krævet pr. standard, fast værdi	-	-
id	Krævet pr. standard, fast værdi	-	-
code	Krævet pr. standard, fast værdi	-	-
title	Krævet pr. standard, fast værdi	-	-
effectiveTime	Tidspunkt for generering af svar
confidentialityCode	Krævet pr. standard, fast værdi	-	-
languageCode	Krævet pr. standard, fast værdi	-	-
versionNumber	Stamkortets versionsnummer	int(11)	Nej
recordTarget.patientRole.id	Borgerens CPR-nr i "extension"-attribut	int(10)	Nej
author.time	Dato/tid. Format: yyyyMMddHHmmssZ, fx. 20171024143445+0200	varchar(19)	Ja (2)
author.assignedAuthor.assignedPerson.name.given	Seneste stamkort-modifikator, fornavn	varchar(80)	Ja (1)
author.assignedAuthor.assignedPerson.name.family	Seneste stamkort-modifikator, efternavn	varchar(80)	Ja (1)
custodian.assignedCustodian.representedCustodianOrganization.id	Krævet pr. standard, fast værdi	-	-
Nedenstående elementer hører alle under component.structuredBody.component.section.entry.relatedPerson:
id	Pårørendes id (UUID). Skal benyttes som nøgle ifm. UpdateRelatives/DeleteRelatives	varchar(36)	Nej
associatedEntity.addr	Se tabel længere nede (delt struktur)	-	Ja
associatedEntity.telecom	0-3 forekomster med attribut use=H/MC/WP (H=home, MC=mobile contact, WP=work place). Telefonnummer angives i attributten "value" med præfix "tel:", fx value="tel:01123622"	varchar(45)	Ja (fra release 1.0.5)
associatedEntity.associatedPerson.name.given	Pårørendes for- og mellemnavn	varchar(80)	Nej
associatedEntity.associatedPerson.name.family	Pårørendes efternavn	varchar(80)	Ja (fra release 1.0.5)
relationshipType	Pårørendes type (en af følgende MedCom-typer: uspec_paaroerende, barn, aegtefaelle, forælder, barnebarn, svigerbarn, ingen_relationer, nabo, samboende, registreret_partner, søskende, øvrig_familie)	<relationshipType code=MecomType codeSystem="1.2.208.184.15.4" displayName=MecomType />	Ja
note	Fritekstbeskrivelse af den pårørendes rolle i forhold til borgeren, hvilke opgaver personen kan være behjælpelig med osv.	varchar(1000)	Ja
dataEnterer	Se tabel længere nede (delt struktur)	-	Nej
Nedenstående elementer hører alle under component.structuredBody.component.section.entry.temporaryAddress:
id	Midlertidig adresses id (UUID). Skal benyttes som nøgle ifm. UpdateTemporaryAddress/DeleteTemporaryAddress	varchar(36)	Nej
addr	Se tabel længere nede (delt struktur)	-	Nej
dataEnterer	Se tabel længere nede (delt struktur)	-	Nej
Nedenstående elementer hører alle under component.structuredBody.component.section.entry.language:
id	Sprog id (UUID). Skal benyttes som nøgle ifm. UpdateLanguage/DeleteLanguage	varchar(36)	Nej
languageCode	Sprogkode (kan være tom for fx spædbørn, borgere uden taleevne mm). Format: ISO-639-1	char(2)	Ja
dataEnterer	Se tabel længere nede (delt struktur)	-	Nej
Nedenstående elementer hører alle under component.structuredBody.component.section.entry.healthProvider:
id	Tandlæges id (UUID). Skal benyttes som nøgle ifm. UpdateHealthProvider/DeleteHealthProvider	varchar(36)	Nej
providerType	Indeholder sundhedspersonens type. Pt. altid code/displayName=tandlæge.	-	Nej
organization	Se tabel længere nede (delt struktur)	-	Ja
dataEnterer	Se tabel længere nede (delt struktur)	-	Nej
Nedenstående elementer hører alle under component.structuredBody.component.section.entry.patientContact:
telecom	0-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
dataEnterer	Se tabel længere nede (delt struktur)	-	Nej

...

Code Block

language	xml
title	GetPersonalDataCard response
collapse	true

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Header/>
  <SOAP-ENV:Body>
	<ns6:GetPersonalDataCardResponse xmlns:ns2="urn:hl7-org:v3" xmlns:ns3="urn:hl7-org:sdtc" xmlns:ns4="urn:hl7-org:fsk" xmlns:ns6="http://sundhedsdatastyrelsen.dk/skr/2021/06/02">
	  <ClinicalDocument classCode="DOCCLIN" moodCode="EVN">
		<ns2:realmCode code="DK"/>
		<ns2:typeId extension="POCD_HD000040" root="2.16.840.1.113883.1.3"/>
		<ns2:templateId root="1.2.208.184.15.1"/>
		<ns2:id assigningAuthorityName="MedCom" extension="NA" root="1.2.208.184"/>
		<ns2:code code="NA" codeSystem="1.2.208.184.15.1" displayName="Stamkort"/>
		<ns2:title>Det Fælles StamKort</ns2:title>
		<ns2:effectiveTime value="20211109105024+0100"/>
		<ns2:confidentialityCode code="N" codeSystem="2.16.840.1.113883.5.25"/>
		<ns2:languageCode code="da-DK"/>
		<ns2:versionNumber value="186"/>
		<ns2:recordTarget contextControlCode="OP" typeCode="RCT">
		  <ns2:patientRole classCode="PAT" nullFlavor="NA">
			<ns2:id assigningAuthorityName="CPR" extension="0309691444" root="1.2.208.176.1.2"/>
		  </ns2:patientRole>
		</ns2:recordTarget>
		<ns2:author>
		  <ns2:time value="20211109105023+0100"/>
		  <ns2:assignedAuthor>
			<ns2:id assigningAuthorityName="CPR" extension="ANONYM" root="1.2.208.176.1.2"/>
			<ns2:assignedPerson>
			  <ns2:name>
				<ns2:given>Anders</ns2:given>
				<ns2:family>Andersen</ns2:family>
			  </ns2:name>
			</ns2:assignedPerson>
		  </ns2:assignedAuthor>
		</ns2:author>
		<ns2:custodian>
		  <ns2:assignedCustodian>
			<ns2:representedCustodianOrganization>
			  <ns2:id root="NA"/>
			</ns2:representedCustodianOrganization>
		  </ns2:assignedCustodian>
		</ns2:custodian>
		<ns2:component>
		  <ns2:structuredBody>
			<ns2:component>
			  <ns2:section>
				<ns2:text>FSK</ns2:text>
				<ns2:entry>
				  <ns4:relatedPerson>
					<ns4:id extension="f4ea9b0a-21d2-45b6-9ab3-bfb2f4d777ec" root="1.2.208.184.15.3"/>
					<ns4:associatedEntity classCode="CON">
					  <ns2:addr isNotOrdered="false" use="H">
						<ns2:streetAddressLine>Trifork</ns2:streetAddressLine>
						<ns2:streetAddressLine>Europaplads 2</ns2:streetAddressLine>
						<ns2:postalCode>8000</ns2:postalCode>
						<ns2:city>Aarhus</ns2:city>
						<ns2:country>Denmark</ns2:country>
					  </ns2:addr>
					  <ns2:telecom use="H" value="tel:86111213"/>
					  <ns2:telecom use="MC" value="tel:25111213"/>
					  <ns2:telecom use="WP" value="tel:70111213"/>
					  <ns2:associatedPerson>
						<ns2:name>
						  <ns2:given>Chris</ns2:given>
						  <ns2:family>Green</ns2:family>
						</ns2:name>
					  </ns2:associatedPerson>
					</ns4:associatedEntity>
					<ns4:relationshipType code="barn" codeSystem="1.2.208.184.15.4" displayName="Barn"/>
					<ns4:note>54b0554f-2ac1-4140-a66f-5c692f2eeb5f Kan være behjælpelig med kørsel udenfor arbejdstiden</ns4:note>
					<ns4:dataEnterer>
					  <ns2:time value="20211109105021+0100"/>
					  <ns2:assignedAuthor>
						<ns2:id assigningAuthorityName="CPR" extension="ANONYM" root="1.2.208.176.1.2"/>
						<ns2:assignedPerson>
						  <ns2:name>
							<ns2:given>Anders</ns2:given>
							<ns2:family>Andersen</ns2:family>
						  </ns2:name>
						</ns2:assignedPerson>
					  </ns2:assignedAuthor>
					</ns4:dataEnterer>
				  </ns4:relatedPerson>
				</ns2:entry>
				<ns2:entry>
				  <ns4:patientContact>
					<ns4:telecom use="H" value="tel:536f08a1-cf84-4c8c-9266-03c9a687a1ce"/>
					<ns4:telecom use="MC" value="tel:25111213"/>
					<ns4:telecom use="WP" value="tel:25111214"/>
					<ns4:dataEnterer>
					  <ns2:time value="20211109104421+0100"/>
					  <ns2:assignedAuthor>
						<ns2:id assigningAuthorityName="CPR" extension="ANONYM" root="1.2.208.176.1.2"/>
						<ns2:assignedPerson>
						  <ns2:name>
							<ns2:given>Anders</ns2:given>
							<ns2:family>Andersen</ns2:family>
						  </ns2:name>
						</ns2:assignedPerson>
					  </ns2:assignedAuthor>
					</ns4:dataEnterer>
				  </ns4:patientContact>
				</ns2:entry>
			  </ns2:section>
			</ns2:component>
		  </ns2:structuredBody>
		</ns2:component>
	  </ClinicalDocument>
	</ns6:GetPersonalDataCardResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

UpdateContactInformation

Element	Beskrivelse	Type	Optionel
id	Som attribut "extension" angives personens CPR-nummer (uden bindestreg)	varchar(10)	Nej
telecom	0-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)	Nej
dataEnterer	Personen der opdaterer. Se tabel længere nede (delt struktur)	-	Nej

...

Code Block

language	xml
title	UpdateContactInformation response
collapse	true

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns2:UpdateContactInformationResponse xmlns:ns2="http://sundhedsdatastyrelsen.dk/skr/2021/06/02"/>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CreateRelatives

	Beskrivelse	Type	Optionel
id	Som attribut "extension" angives personens CPR-nummer (uden bindestreg)	varchar(10)	Nej
relatedPerson	Liste-struktur tilsvarende relatedPerson i GetPersonalDataCard response	-	Nej
relatedPerson.id	ID til den pårørende der skal oprettes (UUID)	varchar(36)	Ja
dataEnterer	Personen der opretter. Se tabel længere nede (delt struktur)	-	Nej

...

Code Block

language	xml
title	CreateRelatives response
collapse	true

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns2:CreateRelativesResponse xmlns:ns2="http://sundhedsdatastyrelsen.dk/skr/2021/06/02"/>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

UpdateRelatives

Element	Beskrivelse	Type	Optionel
id	Som attribut "extension" angives id på en "relatedPerson" fra svaret på en GetPersonalDataCard	varchar(10)	Nej
relatedPerson	Liste-struktur tilsvarende relatedPerson i GetPersonalDataCard response	-	Nej
dataEnterer	Personen der opdaterer. Se tabel længere nede (delt struktur)	-	Nej

...

Code Block

language	xml
title	UpdateRelatives response
collapse	true

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns2:UpdateRelativesResponse xmlns:ns2="http://sundhedsdatastyrelsen.dk/skr/2021/06/02"/>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

DeleteRelatives

Element	Beskrivelse	Type	Optionel
id	Som attribut "extension" angives personens CPR-nummer (uden bindestreg)	varchar(10)	Nej
relativeId	ID(er) på den/de pårørende der skal slettes. Hvert id skal matche id (UUID) på en relatedPerson fra svaret på en GetPersonalDataCard	varchar(36)	Nej
dataEnterer	Personen der sletter. Se tabel længere nede (delt struktur)	-	Nej

...

Code Block

language	xml
title	DeleteRelatives response
collapse	true

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns2:DeleteRelativesResponse xmlns:ns2="http://sundhedsdatastyrelsen.dk/skr/2021/06/02"/>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CreateTemporaryAddress

Element	Beskrivelse	Type	Optionel
id	Som attribut "extension" angives personens CPR-nummer (uden bindestreg)	varchar(10)	Nej
temporaryAddress.id	ID på den midlertidige adresse der skal oprettes (UUID)	varchar(36)	Ja
temporaryAddress.addr	Den midlertidige adresse der skal oprettes. Indeholder addr-struktur, som beskrevet længere nede	-	Nej
dataEnterer	Personen der opretter. Se tabel længere nede (delt struktur)	-	Nej

...

Code Block

language	xml
title	CreateTemporaryAddress response
collapse	true

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns2:CreateTemporaryAddressResponse xmlns:ns2="http://sundhedsdatastyrelsen.dk/skr/2021/06/02"/>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

UpdateTemporaryAddress

Element	Beskrivelse	Type	Optionel
id	Som attribut "extension" angives personens CPR-nummer (uden bindestreg)	varchar(10)	Nej
temporaryAddress.id	ID på den midlertidige adresse der skal opdateres. Skal modsvare id (UUID) på en temporaryAddress fra svaret på en GetPersonalDataCard	varchar(36)	Nej
temporaryAddress.addr	Den midlertidige adresse der skal oprettes. Indeholder addr-struktur, som beskrevet længere nede	-	Nej
dataEnterer	Personen der opdaterer. Se tabel længere nede (delt struktur)	-	Nej

...

Code Block

language	xml
title	UpdateTemporaryAddress response
collapse	true

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns2:UpdateTemporaryAddressResponse xmlns:ns2="http://sundhedsdatastyrelsen.dk/skr/2021/06/02"/>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

DeleteTemporaryAddress

Element	Beskrivelse	Type	Optionel
id	Som attribut "extension" angives personens CPR-nummer (uden bindestreg)	varchar(10)	Nej
temporaryAddressId	ID på den/de midlertidige adresse der skal slettes.	varchar(36)	Nej
dataEnterer	Personen der sletter. Se tabel længere nede (delt struktur)	-	Nej

...

Code Block

language	xml
title	DeleteTemporaryAddress response
collapse	true

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns2:DeleteTemporaryAddressResponse xmlns:ns2="http://sundhedsdatastyrelsen.dk/skr/2021/06/02"/>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CreateLanguage

Element	Beskrivelse	Type	Optionel
id	Som attribut "extension" angives personens CPR-nummer (uden bindestreg)	varchar(10)	Nej
language.id	ID på det sprog der skal oprettes (UUID)	varchar(36)	Ja
language.languageCode	Sprogkode. Format: ISO-639-1	char(2)	Nej
dataEnterer	Personen der opretter. Se tabel længere nede (delt struktur)	-	Nej

...

Code Block

language	xml
title	CreateLanguage response
collapse	true

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns2:CreateLanguageResponse xmlns:ns2="http://sundhedsdatastyrelsen.dk/skr/2021/06/02"/>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

UpdateLanguage

Element	Beskrivelse	Type	Optionel
id	Som attribut "extension" angives personens CPR-nummer (uden bindestreg)	varchar(10)	Nej
language.id	ID på det sprog der skal opdateres.	varchar(36)	Nej
language.languageCode	Sprogkode. Format: ISO-639-1	char(2)	Nej
dataEnterer	Personen der opdaterer. Se tabel længere nede (delt struktur)	-	Nej

...

Code Block

language	xml
title	UpdateLanguage response
collapse	true

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns2:UpdateLanguageResponse xmlns:ns2="http://sundhedsdatastyrelsen.dk/skr/2021/06/02"/>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

DeleteLanguage

Element	Beskrivelse	Type	Optionel
id	Som attribut "extension" angives personens CPR-nummer (uden bindestreg)	varchar(10)	Nej
languageId	ID på det sprog der skal slettes.	varchar(36)	Nej
dataEnterer	Personen der sletter. Se tabel længere nede (delt struktur)	-	Nej

...

Code Block

language	xml
title	DeleteLanguage response
collapse	true

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns2:DeleteLanguageResponse xmlns:ns2="http://sundhedsdatastyrelsen.dk/skr/2021/06/02"/>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

CreateHealthProvider

Element	Beskrivelse	Type	Optionel
id	Som attribut "extension" angives personens CPR-nummer (uden bindestreg)	varchar(10)	Nej
healthProvider.id	ID på den tandlæge der skal oprettes (UUID)	varchar(36)	Ja
healthProvider.providerType	Som attribut "code" angives "tandlæge", som er den eneste værdi der understøttes i aktuelle version.	-	Nej
healthProvider.organization	Tandlægeorganisation. Se tabel længere nede (delt struktur)	-	Nej
dataEnterer	Personen der opretter. Se tabel længere nede (delt struktur)	-	Nej

...

Code Block

language	xml
title	CreateHealthProviderWithId response
collapse	true

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns2:CreateHealthProviderResponse xmlns:ns2="http://sundhedsdatastyrelsen.dk/skr/2021/06/02"/>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

UpdateHealthProvider

Element	Beskrivelse	Type	Optionel
id	Som attribut "extension" angives personens CPR-nummer (uden bindestreg)	varchar(10)	Nej
healthProvider.id	ID på den tandlæge der skal opdateres	varchar(36)	Nej
healthProvider.providerType	Som attribut "code" angives "tandlæge", som er den eneste værdi der understøttes i aktuelle version.	-	Nej
healthProvide.organization	Tandlægeorganisation. Se tabel længere nede (delt struktur)	-	Nej
dataEnterer	Personen der opdaterer. Se tabel længere nede (delt struktur)	-	Nej

...

Code Block

language	xml
title	UpdateHealthProvider response
collapse	true

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns2:UpdateHealthProviderResponse xmlns:ns2="http://sundhedsdatastyrelsen.dk/skr/2021/06/02"/>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

DeleteHealthProvider

Element	Beskrivelse	Type	Optionel
id	Som attribut "extension" angives personens CPR-nummer (uden bindestreg)	varchar(10)	Nej
healthProvider.id	ID på den tandlæge der skal slettes.	varchar(36)	Nej
dataEnterer	Personen der sletter. Se tabel længere nede (delt struktur)	-	Nej

...

Code Block

language	xml
title	DeleteHealthProvider response
collapse	true

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns2:DeleteHealthProviderResponse xmlns:ns2="http://sundhedsdatastyrelsen.dk/skr/2021/06/02"/>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Addr

Bemærk at der på en "addr"-struktur skal anvendes attribut isNotOrdered="false", da funktionalitet afhænger af en bestemt rækkefølge af streetAddressLine.

Element

Beskrivelse

Type

Optionel

streetAddressLine

Adresselinje, 0-4 forekomster

varchar(80)

postalCode

Postnummer

varchar(10)

city

varchar(80)

country

Land

varchar(80)

useablePeriod

1 eller 2 forekomster. 1 til at indikere en periode gældende fra et givet tidpunkt og fremad, eller 2 til at angive et datointerval, f.eks. således (værdien operator="I" betyder "intersection"):

<cda:useablePeriod value="20140106" operator="I"/>
<cda:useablePeriod value="20250106" operator="I"/>

Format for value-attributten er yyyyMMdd

Info

Bemærk at Addr er en delt adresse struktur som benyttes af flere elementer, for midlertidig adresse "temporaryAddress" er useable period ikke optionel - der er det påkrævet at der sættes en start og en slutdato således adressen er gældende for en periode.

(Fra release 1.0.5 gøres slutdato'en optionel)

varchar(8) for value-attribut

Ja (men ikke for temporayAdress)

Organization

Organisation anvendes til at beskrive navn, adresse mv. for en tandlæge

Element	Beskrivelse	Type	Optionel
id	Som attribut "extension" angives organisationens ydernummer	varchar(80)	Ja
name	Navn på organisationen	varchar(120)	Ja
telecom	Telefonnummer på organisationen Attribut use=WP (WP=work place). Telefonnummer angives i attributten "value" med præfix "tel:", fx value="tel:01123622"	varchar(45)	Ja
addr.streetAddressLine	Adresselinje. Der kan forekomme op til 4 linjer i en adresse	varchar(80)	Ja
addr.postalCode	Postnummer	varchar(80)	Ja
addr.city	Bynavn	varchar(80)	Ja
addr.country	Land	varchar(80)	Ja

DataEnterer

Den generelle dataEnterer-struktur der anvendes på diverse request, samt på relatedPerson, temporaryAddress og language, ser ud som følger (organisationsoplysninger skal angives hvis der er tale om en sundhedsperson):

Element	Beskrivelse	Type	Optionel
time	Tidspunkt for opdatering. Format: yyyyMMddHHmmssZ, fx. 20171024143445+0200	varchar(19)	Nej
assignedAuthor.id	En eller flere forekomster med værdi i attribut "extension" og type (fx CPR/AUTORISATION/UDDANNELSESKODE) 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
assignedAuthor.assigningPerson.name.given	For- og mellemnavn på person bag opdatering	varchar(80)	Nej
assignedAuthor.assigningPerson.name.family	Efternavn på person bag opdatering	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"	extension varchar(80), assigningAuthorityName varchar(30)	Ja
assignedAuthor.representedOrganization.name	Organisations navn	varchar(30)	Ja

Savedatacardsnitflade

Denne snitflade muliggør at data kan opdateres asynkront på baggrund af et systemkald. Snitfladen understøtter niveau 3 ID-kort, via OCES funktionscertifikater (FOCES), og ikke niveau 4 ID-kort.
Snitfladen udstiller en enkelt operation, der tillader at enten oprettes borgerens stamdata, stamdata redigeres eller stamdata slettes. Det er ikke muligt at læse via denne snitflade, dertil skal eksisterende snitflader benyttes.

...

WSDL-filer
Stamkortregister DGWS	<server>/skr/wsdl/dgws20220210

WSDL

WSDLen indeholder nedenstående operationer:

Operation	Beskrivelse
savedatacard_2022_02_10.wsdl	Opdater en borgers stamkort.

Serviceoperationer for SaveDataCard

Element	Beskrivelse	Type	Optionel
id	Som attribut "extension" angives personens CPR-nummer (uden bindestreg)	varchar(10)	Nej
contactInformation	Element for opdatering af kontaktinformation.	-	Ja
contactInformation.contactInformation.lastupdated	Tidspunkt for seneste opdatering. Format: yyyyMMddHHmmssZ, fx. 20171024143445+0200	varchar(19)	Nej
contactInformation.contactInformation.telecom	0-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)	Nej
contactInformation.contactInformation.dataEnterer	Personen der opretter. Se tabel ovenfor (delt struktur)	-	Ja
relatedPersons	Element for opdatering af relatedPersons. Indeholder en liste af RelatedPersonType	-	Ja
relatedPersons.relatedPerson.id	Pårørendes id (UUID). Skal benyttes som nøgle ifm. UpdateRelatives/DeleteRelatives	varchar(36)	Ja
relatedPersons.relatedPerson.lastupdated	Tidspunkt for seneste opdatering. Format: yyyyMMddHHmmssZ, fx. 20171024143445+0200	varchar(19)	Nej
relatedPersons.relatedPerson.associatedEntity.addr	Se tabel ovenfor (delt struktur)	-	Ja
relatedPersons.relatedPerson.associatedEntity.telecom	0-3 forekomster med attribut use=H/MC/WP (H=home, MC=mobile contact, WP=work place). Telefonnummer angives i attributten "value" med præfix "tel:", fx value="tel:01123622"	varchar(45)	Ja (fra release 1.0.5)
relatedPersons.relatedPerson.associatedEntity.associatedPerson.name.given	Pårørendes for- og mellemnavn	varchar(80)	Nej
relatedPersons.relatedPerson.associatedEntity.associatedPerson.name.family	Pårørendes efternavn	varchar(80)	Ja (fra release 1.0.5)
relatedPersons.relatedPerson.relationshipType	Pårørendes type (en af følgende MedCom-typer: uspec_paaroerende, barn, aegtefaelle, forælder, barnebarn, svigerbarn, ingen_relationer, nabo, samboende, registreret_partner, søskende, øvrig_familie)	<relationshipType code=MecomType codeSystem="1.2.208.184.15.4" displayName=MecomType />	Nej
relatedPersons.relatedPerson.note	Fritekstbeskrivelse af den pårørendes rolle i forhold til borgeren, hvilke opgaver personen kan være behjælpelig med osv.	varchar(1000)	Ja
relatedPersons.relatedPerson.dataEnterer	Se tabel længere ovenfor (delt struktur)	-	Ja
relatedPersons.relatedPerson.tobeDeleted	Indikerer om opdateringen er en sletning af den pårørende.	boolean	Ja
temporaryAddress	Element for opdatering af midlertidig adresse.	-	Ja
temporaryAddress.temporaryAddress.id	Midlertid adresse id (UUID). Skal benyttes som nøgle ifm. opdatering og sletning af midlertidig adresse.	varchar(36)	Ja
temporaryAddress.temporaryAddress.lastupdated	Tidspunkt for seneste opdatering. Format: yyyyMMddHHmmssZ, fx. 20171024143445+0200	varchar(19)	Nej
temporaryAddress.temporaryAddress.addr	Se tabel ovenfor (delt struktur)	-	Nej
temporaryAddress.temporaryAddress.dataEnterer	Se tabel længere ovenfor (delt struktur)	-	Ja
temporaryAddress.temporaryAddress.tobeDeleted	Indikerer om opdateringen er en sletning af den pårørende.	boolean	Ja
language	Element for opdatering af sprog.		Ja
language.language.id	Sprog id (UUID). Skal benyttes som nøgle ifm. opdatering og sletning af sprog.	varchar(36)	Ja
language.language.lastupdated	Tidspunkt for seneste opdatering. Format: yyyyMMddHHmmssZ, fx. 20171024143445+0200	varchar(19)	Nej
language.language.languageCode	Sprogkode. Format: ISO-639-1	char(2)	Nej
language.language.dataEnterer	Se tabel længere ovenfor (delt struktur)	-	Ja
language.language.tobeDeleted	Indikerer om opdateringen er en sletning af sprog.	boolean	Ja
healthProvider	Element for opdatering af tandlæge.	-	Ja
healthProvider.healthProvider.id	Sprog id (UUID). Skal benyttes som nøgle ifm. opdatering og sletning af tandlæge.	varchar(36)	Ja
healthProvider.healthProvider.lastupdated	Tidspunkt for seneste opdatering. Format: yyyyMMddHHmmssZ, fx. 20171024143445+0200	varchar(19)	Nej
healthProvider.healthProvider.providerType	Som attribut "code" angives "tandlæge", som er den eneste værdi der understøttes i aktuelle version.	-	Nej
healthProvider.healthProvider.organization	Tandlægeorganisation. Se tabel ovenfor (delt struktur)	-	Nej
healthProvider.healthProvider.dataEnterer	Se tabel ovenfor (delt struktur)	-	Ja
healthProvider.healthProvider.tobeDeleted	Indikerer om opdateringen er en sletning af tandlægen.	boolean	Ja

...

Code Block

language	xml
title	SaveDataCard response
collapse	true

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns2:SaveDataCardResponse xmlns:ns2="http://sundhedsdatastyrelsen.dk/skr/2022/02/10"/>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Migreringssnitflade

Der er lavet en midlertidig migregingsnitflade der kan benyttes til migrerering af lokale stamkort.

...

WSDL-filer
Stamkortregister DGWS	<server>/skr/wsdl/dgws20210408

MigratePersonalDataCard

Request-eksempel: Migrate_request.xml

Element	Beskrivelse	Type	Optionel
id	Som attribut "extension" angives personens CPR-nummer (uden bindestreg)	varchar(10)	Nej
contactInformation	0-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
relatedPersons	Liste-struktur tilsvarende relatedPerson i GetPersonalDataCard response	-	Ja
temporaryAddress	Den midlertidige adresse der skal oprettes. Indeholder addr-struktur, som beskrevet længere nede	-	Ja
language	Sprogkode. Format: ISO-639-1	char(2)	Ja
dataEntererMigration	Systemet der migrerer stamkort. Se tabel længere nede (delt struktur)	-	Nej

Fejl situatuioner i forbindelse med MigratePersonalDataCard

Udover xml valideringsfejl og interne fejl kan migrerings snitflade returnerer følgende fejlkoder.

...

Code Block

title	Response body

<SOAP-ENV:Body>
  <SOAP-ENV:Fault>
	<faultcode>SOAP-ENV:Server</faultcode>
	<faultstring xml:lang="en">830: Fejl i request i forbindelse med migrering af stamkort, Borgerens midlertidige adresse eksisterer i forvejen</faultstring>
  </SOAP-ENV:Fault>
</SOAP-ENV:Body>

DataEntererMigration

Den generelle dataEnterer-struktur der anvendes på Migrations requestet, ser ud som følger, da det er en systembruger der benyttes ved migrationssnitfladen skal organisationsoplysninger angives:

Element	Beskrivelse	Type	Optionel
time	Tidspunkt for opdatering. Format: yyyyMMddHHmmssZ, fx. 20171024143445+0200	varchar(19)	Nej
assignedEntity.id	En eller flere forekomster med værdi i attribut "extension" og type 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(80), assigningAuthorityName varchar(30)	Nej
assignedEntity.addr.streetAddressLine	Adresselinje. Der kan forekomme op til 4 linjer i en adresse	varchar(80)	ja
assignedEntity.addr.postalCode	Postnummer	varchar(80)	ja
assignedEntity.addr.city	Bynavn	varchar(80)	ja
assignedEntity.addr.country	Land	varchar(80)	ja
assignedEntity.representedOrganization.id	Organisations id, såfremt der er tale om en sundhedsperson. Værdi findes i attribut "extension", type i attribut "assigningAuthorityName"	extension varchar(80), assigningAuthorityName varchar(30)	ja

Ældre snitflader

Der har tidligere været føldende snitflader. Disse bør ikke benyttes længere da de vil blive udfaset. Da disse kun har historisk værdi beskrives de ikke yderligere i dette dokument.

...

Content

Space Tools

Versions Compared

Old Version 47

New Version 48

Key

Notificeringer i NAS

Snitflade til normal brug

WSDL

Serviceoperationer

GetPersonalDataCard

Request

Response

UpdateContactInformation

CreateRelatives

UpdateRelatives

DeleteRelatives

CreateTemporaryAddress

UpdateTemporaryAddress

DeleteTemporaryAddress

CreateLanguage

UpdateLanguage

DeleteLanguage

CreateHealthProvider

UpdateHealthProvider

DeleteHealthProvider

Addr

Organization

DataEnterer

Savedatacardsnitflade

WSDL

Serviceoperationer for SaveDataCard

Migreringssnitflade

MigratePersonalDataCard

Fejl situatuioner i forbindelse med MigratePersonalDataCard

DataEntererMigration

Ældre snitflader