Page History
...
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
Snitflader
Til SKR er der 2 3 hold gældende snitflader. Et hold til normalt brug, et til asynkron opdatering af stamkortet og et til migreringsbrug.
...
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.
Til SaveDatacard-snitfladen er der følgende wsdl fil:
| 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.ContactInformationType.lastupdated | Tidspunkt for seneste opdatering. Format: yyyyMMddHHmmssZ, fx. 20171024143445+0200 | varchar(19) | Nej |
| contactInformation.ContactInformationType.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.ContactInformationType.dataEnterer | Personen der opretter. Se tabel ovenfor (delt struktur) | - | Ja |
| RelatedPersons | Element for opdatering af relatedPersons. Indeholder en liste af RelatedPersonType | - | Ja |
| RelatedPersons.RelatedPersonType.id | Pårørendes id (UUID). Skal benyttes som nøgle ifm. UpdateRelatives/DeleteRelatives | varchar(36) | Ja |
| RelatedPersons.RelatedPersonType.lastupdated | Tidspunkt for seneste opdatering. Format: yyyyMMddHHmmssZ, fx. 20171024143445+0200 | varchar(19) | Nej |
| RelatedPersons.RelatedPersonType.associatedEntity.addr | Se tabel ovenfor (delt struktur) | - | Ja |
| RelatedPersons.RelatedPersonType.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.RelatedPersonType.associatedEntity.associatedPerson.name.given | Pårørendes for- og mellemnavn | varchar(80) | Nej |
| RelatedPersons.RelatedPersonType.associatedEntity.associatedPerson.name.family | Pårørendes efternavn | varchar(80) | Ja (fra release 1.0.5) |
| RelatedPersons.RelatedPersonType.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.RelatedPersonType.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.RelatedPersonType.dataEnterer | Se tabel længere ovenfor (delt struktur) | - | Ja |
| RelatedPersons.RelatedPersonType.tobeDeleted | Indikerer om opdateringen er en sletning af den pårørende. | boolean | Ja |
| temporaryAddress | Element for opdatering af midlertidig adresse. | - | Ja |
| temporaryAddress.temporaryAddressType.id | Midlertid adresse id (UUID). Skal benyttes som nøgle ifm. opdatering og sletning af midlertidig adresse. | varchar(36) | Ja |
| temporaryAddress.temporaryAddressType.lastupdated | Tidspunkt for seneste opdatering. Format: yyyyMMddHHmmssZ, fx. 20171024143445+0200 | varchar(19) | Nej |
| temporaryAddress.temporaryAddressType.addr | Se tabel ovenfor (delt struktur) | - | Nej |
| temporaryAddress.temporaryAddressType.dataEnterer | Se tabel længere ovenfor (delt struktur) | - | Ja |
| temporaryAddress.temporaryAddressType.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.HealthProviderType.id | Sprog id (UUID). Skal benyttes som nøgle ifm. opdatering og sletning af tandlæge. | varchar(36) | Ja |
| HealthProvider.HealthProviderType.lastupdated | Tidspunkt for seneste opdatering. Format: yyyyMMddHHmmssZ, fx. 20171024143445+0200 | varchar(19) | Nej |
| HealthProvider.HealthProviderType.providerType | Som attribut "code" angives "tandlæge", som er den eneste værdi der understøttes i aktuelle version. | - | Nej |
| HealthProvider.HealthProviderType.organization | Tandlægeorganisation. Se tabel ovenfor (delt struktur) | - | Nej |
| HealthProvider.HealthProviderType.dataEnterer | Se tabel ovenfor (delt struktur) | - | Ja |
| HealthProvider.HealthProviderType.tobeDeleted | Indikerer om opdateringen er en sletning af tandlægen. | boolean | Ja |
Request-eksempel:
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns="http://sundhedsdatastyrelsen.dk/skr/2021/06/02"
xmlns:cda="urn:hl7-org:v3"
xmlns:fsk="urn:hl7-org:fsk">
<soapenv:Header/>
<soapenv:Body>
<ns:CreateTemporaryAddressRequest>
<id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/>
<fsk:temporaryAddress>
<fsk:addr use="H" isNotOrdered="false">
<cda:streetAddressLine>Trifork</cda:streetAddressLine>
<cda:streetAddressLine>Europaplads 2</cda:streetAddressLine>
<cda:postalCode>8000</cda:postalCode>
<cda:city>Aarhus</cda:city>
<cda:country>Denmark</cda:country>
<cda:useablePeriod value="20140106"/>
<cda:useablePeriod value="20250106"/>
</fsk:addr>
</fsk:temporaryAddress>
<dataEnterer>
<cda:time value="20180101101010+0100" />
<cda:assignedAuthor classCode="ASSIGNED">
<cda:id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/>
<cda:assignedPerson>
<cda:name>
<cda:given>given</cda:given>
<cda:family>family</cda:family>
</cda:name>
</cda:assignedPerson>
<cda:representedOrganization classCode="ORG" determinerCode="INSTANCE">
<cda:id assigningAuthorityName="CVR" extension="30808460" root="1.2.208.184.15.10"/>
<cda:name>Navn på organisation</cda:name>
</cda:representedOrganization>
</cda:assignedAuthor>
</dataEnterer>
</ns:CreateTemporaryAddressRequest>
</soapenv:Body>
</soapenv:Envelope> |
Request-eksempel med id:
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns="http://sundhedsdatastyrelsen.dk/skr/2021/06/02" xmlns:urn="urn:hl7-org:fsk" xmlns:urn1="urn:hl7-org:v3">
<soapenv:Header/>
<soapenv:Body>
<ns:CreateTemporaryAddressRequest>
<id assigningAuthorityName="CPR" extension="2512484916" root="1.2.208.176.1.2" />
<urn:temporaryAddress>
<urn:id assigningAuthorityName="FSK" extension="01234567890123456789" root="1.2.208.184.15.2"/>
<urn:addr isNotOrdered="false" use="H">
<urn1:country>Danmark</urn1:country>
<urn1:city>84d7fb5d-09d2-456e-a2d5-9a2c32d7a0b8</urn1:city>
<urn1:postalCode>8241</urn1:postalCode>
<urn1:streetAddressLine>c05e60c1-bea0-4c66-98bd-7d5faffb5d41</urn1:streetAddressLine>
<urn1:useablePeriod operator="I" value="20180817"/>
<urn1:useablePeriod operator="I" value="20250817"/>
</urn:addr>
</urn:temporaryAddress>
<dataEnterer>
<urn1:time value="20180101101010+0100" />
<urn1:assignedAuthor classCode="ASSIGNED">
<urn1:id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/>
<urn1:assignedPerson>
<urn1:name>
<urn1:given>given</urn1:given>
<urn1:family>family</urn1:family>
</urn1:name>
</urn1:assignedPerson>
<urn1:representedOrganization classCode="ORG" determinerCode="INSTANCE">
<urn1:id assigningAuthorityName="CVR" extension="30808460" root="1.2.208.184.15.10"/>
<urn1:name>Navn på organisation</urn1:name>
</urn1:representedOrganization>
</urn1:assignedAuthor>
</dataEnterer>
</ns:CreateTemporaryAddressRequest>
</soapenv:Body>
</soapenv:Envelope> |
Response-eksempel (indeholder ingen data):
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<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/2021/06/02"/>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope> |
Migreringssnitflade
Der er lavet en midlertidig migregingsnitflade der kan benyttes til migrerering af lokale stamkort.
...