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.
Version | Dato | Ændring | Ansvarlig |
---|---|---|---|
2018-08-31 | Initialt dokument | Trifork | |
2018-09-13 | Tilføjet manglende beskrivelse af ID-attribut for Language-struktur (UUID). Beskrivelse af, at Stamkort hentes via Det Fælles Stamkort | Trifork | |
2018-09-19 | Rettet et forkert link til CreateTemporaryAddress request eksempel. | Trifork | |
2018-10-09 | Tilføjet og updateres create requests eksempler med id (Uuid) | Trifork | |
2018-10-11 | Præcisering omkring antal midlertidige adresser, så der altid kun er én | SDS | |
2018-11-29 | 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) | SDS | |
2019-01-04 | Tilrettet således pårørendes telefonnummer, efternavn gøres optionel Slut-dato på midlertidig adresse gøres optionel | SDS | |
1.0.11 | 2019-08-02 | Opdateret beskrivelse af snitflade til 2019/08/01-snitfladen | Trifork |
1.0.17 | 2020-08-05 | Opdateret beskrivelse af snitflade til 2020/07/28-snitfladen | Kvalitetsit |
1.0.18 | 2021-04-27 | Ny migreringssnitflade | Kvalitetsit |
1.0.19 | 2021-06-08 | navne skift i snitflade fra fsk til skr | Kvalitetsit |
1.0.21 | 2021-09-02 | Præcisering af URL til wsproxy | KvalitetsIT |
1.0.22 | 2021-11-02 | Præcisering af snitflader | KvalitetsIT |
1.0.24 | 2022-04-27 | Dokumentation af valideringsbeskeder tilføjet | KvalitetsIT |
Modellen der anvendes til at repræsentere stamdata er HL7 CDA (se evt. http://www.hl7.org/implement/standards/product_brief.cfm?product_id=7), som er en XML-baseret standard til repræsentation af kliniske data. HL7 CDA er et begrebsapparat, som kan repræsentere en enorm mængde af forskelligartede data, hvoraf kun en lille delmængde anvendes i SKR. Det anbefales derfor at studere eksemplerne der refereres her på siden frem for modellen der defineres af HL7 CDA, da de giver et mere præcist billede af hvilke data der kræves og returneres af de forskellige operationer. CDA-terminologien gør, at man kan kvalificere de forskellige begreber gennem attributter (fx at en adresse er en hjemmeadresse ved at angive use="H"), og derfor sker der validering i SKR af, at disse attributter anvendes korrekt, så der ikke er tvivl om hvordan data skal fortolkes. Dvs. i praksis sker der en strengere validering end WSDL og XSDer dikterer.
Et stamkort består kort fortalt af borgerens navn- og adresseoplysninger samt et antal pårørende (med tilhørende kontakt- og fritekstoplysninger), evt. midlertidig(e) adresse(r), og borgerens sprog. SKR indeholder operationer til vedligehold af disse data. Der sker registrering af, hvem der opdaterer de forskellige elementer af borgerens stamkort, og disse oplysninger udstilles på stamkortet.
Et stamkort repræsenteres som et "ClinicalDocument", som er grundpillen i CDA. Ifm. SKR er der lavet en extension til CDA, som gør det muligt at repræsentere pårørende, midlertidige adresser, sprog mv. som entry-typer i dokumentets "structuredBody". Nedenfor ses ClinicalDocument-strukturen som det benyttes i SKR:
Selve dokumentets "header" indeholder (udover personen der senest har opdateret stamkortet) de statiske data, som trækkes fra CPR-registeret, og ikke kan opdateres gennem SKRs operationer. De egentlige stamkort-data ligger under "StructuredBody", som indeholder en liste en "entry"-sektioner. Disse kan i SKR-sammenhæng have indhold af typen relatedPerson, temporaryAddress, language og healthprovider. De to førstnævnte har sin egen id, som skal benyttes hvis man ønsker at slette eller opdatere entiteten via de relevante operationer. Hvis man fx ønsker at opdatere stamdata på en pårørende (RelatedPerson), så skal man bruge id'et man finder på vedkommende i "GetPersonalDataCard" til det request man sender til "UpdateRelatives"-operationen. Tilsvarende for midlertidige adresser.
Ifm. HL7 CDA er der defineret en række "OIDer", som hver især definerer et udfaldsrum for forskellige id/kode-typer. Meningen er, at der til et id (på fx en person, altså CPR-nummer) defineres et OID, som kan betragtes som en type-erklæring. For SKR er følgende OIDer aktuelle:
Type | OID | Beskrivelse | Eksempel |
---|---|---|---|
Patientkontakt | 1.3.6.1.4.1.19376.1.5.3.1.2.4 | Template-id på participant (se evt. https://wiki.ihe.net/index.php/1.3.6.1.4.1.19376.1.5.3.1.2.4) | <ns2:participant typeCode="IND"> <ns2:templateId root="1.3.6.1.4.1.19376.1.5.3.1.2.4"/> |
SOR | 1.2.208.176.1.1 | Type af organisations-ID baseret på SOR. | <id extension="368061000016003" root="1.2.208.176.1.1" assigningAuthorityName="SOR"/> |
SKS | 2.16.840.1.113883.3.4208.100.5 | Type af organisations-ID baseret på SKS. | <id extension="368061000016003" root="2.16.840.1.113883.3.4208.100.5" assigningAuthorityName="SKS"/> |
CVR-P | 1.2.208.184.15.9* | Type af organisations-ID baseret på CVR-P. | <id extension="368061000016003" root="1.2.208.184.15.9" assigningAuthorityName="CVR-P"/> |
CVR | 1.2.208.184.15.10* | Type af organisations-ID baseret på CVR. | <id extension="368061000016003" root="1.2.208.184.15.10" assigningAuthorityName="CVR"/> |
Ydernummer | 1.2.208.184.15.8* | Type af organisations-ID baseret på Ydernummer. | <id extension="368061000016003" root="1.2.208.184.15.8" assigningAuthorityName="Yder"/> |
Kommunekode | 1.2.208.184.15.11* | Type af organisations-ID baseret på Kommunekode. | <id extension="3680610000" root="1.2.208.184.15.11" assigningAuthorityName="Kommunekode"/> |
CPR | 1.2.208.176.1.2 | CPR-nummer | <id extension="2512489996" root="1.2.208.176.1.2" assigningAuthorityName="CPR"/> |
DK MedCom (member body) | 1.2.208.184 | Id på ClinicalDocument. Ikke aktual ifm. SKR (extension=NA) | <ns2:id assigningAuthorityName="MedCom" extension="NA" root="1.2.208.184"/> |
Fortrolighed | 2.16.840.1.113883.5.25 | Altid N=Normal ifm. SKR | <ns2:confidentialityCode code="N" codeSystem="2.16.840.1.113883.5.25"/> |
ISO-angivelse af sprog | 1.0.639.1 | ISO-639-1 formatteret sprog | <ns4:languageCode codeSystem="1.0.639.1">de</ns4:languageCode> |
ISO-angivelse af køn | 2.16.840.1.113883.5.1 | En borgers køn (M/F) | <ns2:administrativeGenderCode code="F" codeSystem="2.16.840.1.113883.5.1"/> |
Dokument type-id | 2.16.840.1.113883.1.3 | HL7-registreret RMIM (HL7 internal) | <ns2:typeId extension="POCD_HD000040" root="2.16.840.1.113883.1.3"/> |
Stamkode code system | 1.2.208.184.15.1* | Kodesystem, ikke aktuel ifm. SKR (code=NA) | <ns2:code code="NA" codeSystem="1.2.208.184.15.1" displayName="Stamkort"/> |
Midlertidig adresse | 1.2.208.184.15.2* | IDer (UUID) på midlertidige adresse | <ns4:temporaryAddress> |
Pårørende | 1.2.208.184.15.3* | IDer (UUID) på pårørende | <ns4:relatedPerson> |
Pårørende type | 1.2.208.184.15.4* | Følger MedCom-definerede typer for pårørende: uspec_paaroerende, barn, aegtefaelle, forældre, barnebarn, svigerbarn, ingen_relationer, nabo, samboende, registreret_partner, søskende, øvrig_familie | <ns2:code code="uspec_paaroerende" codeSystem="1.2.208.184.15.4"/> |
Uddannelseskode | 1.2.208.184.15.5* | IDer (UUID) på uddannelseskoder | <ns2:id assigningAuthorityName="UDDANNELSESKODE" extension="7170" root="1.2.208.184.15.5"/> |
Autorisationsid | 1.2.208.184.15.6* | IDer (UUID) på autorisationskoder | <ns2:id assigningAuthorityName="AUTORISATION" extension="09YM8" root="1.2.208.184.15.6"/> |
* id defineres endeligt af MedCom.
På oidref.com kan man i øvrigt se betydningen af enkeltcifre i de fleste OIDer, fx http://oidref.com/2.16.840.1.113883.1.3
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:
<ns3:Notify xmlns:ns2="http://www.w3.org/2005/08/addressing" xmlns:ns3="http://docs.oasis-open.org/wsn/b-2" xmlns:ns4="http://docs.oasis-open.org/wsn/t-1" xmlns:ns5="http://docs.oasis-open.org/wsrf/bf-2" xmlns:ns6="http://nsi.dk/advis/v10" xmlns:ns8="http://sundhedsdatastyrelsen.dk/skr/2021/06/02"> <ns3:NotificationMessage> <ns3:Topic Dialect="http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple">SKR-TOPIC</ns3:Topic> <ns3:Message> <ns6:NotifyContent id="0309691444" idType="http://nsi.dk/advis/v10/CPR"> <ns8:DataCardUpdated> <date value="2021-12-22"/> <id value="0309691444"/> <messageId value="AAABfeIdUdOcGhp3cE/gtlNPU0k="/> <type value="http://sundhedsdatastyrelsen.dk/MessageDefinition/PDC-notification"/> <version value="1"/> </ns8:DataCardUpdated> </ns6:NotifyContent> </ns3:Message> </ns3:NotificationMessage> </ns3:Notify> |
Topic der anvendes: http://sundhedsdatastyrelsen.dk/PersonalDataCard/2020/11/01:DataCardUpdated
Til SKR er der 3 hold gældende snitflader. Et hold til normalt brug, et til asynkron opdatering af stamkortet og et til migreringsbrug.
Derudover er et antal forældede snitflader der vil blive udfaset over tid, se længere nede i dokumentet.
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.
Borgere anvender servicerne gennem en IDWS-snitflade og har adgang til alle operationer. Der understøttes ikke fuldmagter.
Snitfladerne skal kaldes skal kaldes gennem NSP'ens DCC endpoint (afkoblingskomponenten). Driftsvejledningen beskriver i detaljer hvad der findes af endpoints.
Server-URL'er for de forskellige test-miljøer kan findes på Endpoints for eksterne testmiljøer.
Stamkortet kan desuden hentes som et "on demand"-dokument via Dokumentdelingsservicen (DDS).
WSDL-filer | |
---|---|
HTML-side med overblik | <server>/skr/wsdl |
Stamkortregister DGWS | <server>/skr/wsdl/dgws20210602 |
Stamkortregister IDWS | <server>/skr/wsdl/idws20210602 |
WSDLen for SKR indeholder nedenstående operationer:
Operation | Beskrivelse | |
---|---|---|
GetPersonalDataCard_2021_06_02 | Hent stamkort for en specifik borger.
| |
UpdateContactInformation_2021_06_02 | Opdater en borgers kontaktoplysninger | |
CreateRelatives_2021_06_02 | Opret en pårørende | |
UpdateRelatives_2021_06_02 | Opdater en pårørendes stamdata | |
DeleteRelatives_2021_06_02 | Slet en pårørende | |
CreateTemporaryAddress_2021_06_02 | Opret midlertidig adresse for den pågældende borger
| |
UpdateTemporaryAddress_2021_06_02 | Opdater midlertidig adresse | |
DeleteTemporaryAddress_2021_06_02 | Slet midlertidig adresse | |
CreateLanguage_2021_06_02 | Opret borgers sprog
| |
UpdateLanguage_2021_06_02 | Opdater borgers sprog | |
DeleteLanguage_2021_06_02 | Slet borgers sprog | |
CreateHealthProvider_2021_06_02 | Opret en tandlæge for den pågældende borger
| |
UpdateHealthProvider_2021_06_02 | Opdater tandlæge | |
DeleteHealthProvider_2021_06_02 | Slet en tandlæge | |
MigratePersonalDataCard_2021_04_08 | Migrering af data fra lokale fagsystemer til Fælles Stamkort |
De enkelte operationer forklares i de følgende afsnit.
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).
Element | Beskrivelse | Type | Optionel |
---|---|---|---|
id | Som attribut "extension" angives personens CPR-nummer (uden bindestreg) | varchar(10) | Nej |
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 |
(1): Mangler kun hvis der ikke findes et stamkort
(2): Mangler kun såfremt kald til CPR-enkeltopslag (SCES) fejler
I situationer hvor der endnu ikke er oprettet et stamkort, vil svaret være uden "structuredBody", men stadig med CPR-data i headeren.
Hvis der skulle opstå en teknisk fejl ifm. kommunikationen med CPR, vil svaret kun indeholde udvalgte attributter.
Request-eksempel:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://sundhedsdatastyrelsen.dk/skr/2021/06/02"> <soapenv:Header/> <soapenv:Body> <ns:GetPersonalDataCardRequest> <id assigningAuthorityName="CPR" extension="0309691444" root="1.2.208.176.1.2"/> </ns:GetPersonalDataCardRequest> </soapenv:Body> </soapenv:Envelope> |
Response-eksempel:
<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> |
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 |
Request-eksempel:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://sundhedsdatastyrelsen.dk/skr/2021/06/02" xmlns:urn="urn:hl7-org:v3" xmlns:cda="urn:hl7-org:v3"> <soapenv:Header/> <soapenv:Body> <ns:UpdateContactInformationRequest> <id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <telecom use="H" value="tel:VALIDATION_TOKEN"/> <telecom use="MC" value="tel:25111213"/> <telecom use="WP" value="tel:25111214"/> <dataEnterer> <cda:time value="20170921094500+0100"/> <cda:assignedAuthor> <cda:id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <cda:assignedPerson> <cda:name> <cda:given>Anders</cda:given> <cda:family>Andersen</cda:family> </cda:name> </cda:assignedPerson> </cda:assignedAuthor> </dataEnterer> </ns:UpdateContactInformationRequest> </soapenv:Body> </soapenv:Envelope> |
Response-eksempel (indeholder ingen data):
<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> |
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 |
Request-eksempel:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://sundhedsdatastyrelsen.dk/skr/2021/06/02" xmlns:fsk="urn:hl7-org:fsk" xmlns:cda="urn:hl7-org:v3"> <soapenv:Header/> <soapenv:Body> <ns:CreateRelativesRequest> <id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <fsk:relatedPerson> <fsk:associatedEntity classCode="CON"> <cda: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:addr> <cda:telecom use="H" value="tel:86111213"/> <cda:telecom use="MC" value="tel:25111213"/> <cda:telecom use="WP" value="tel:70111213"/> <cda:associatedPerson> <cda:name> <cda:given>Chris</cda:given> <cda:family>Green</cda:family> </cda:name> </cda:associatedPerson> </fsk:associatedEntity> <fsk:relationshipType code="barn" codeSystem="1.2.208.184.15.4" displayName="Barn"/> <fsk:note>VALIDATION_TOKEN Kan være behjælpelig med kørsel udenfor arbejdstiden</fsk:note> </fsk:relatedPerson> <dataEnterer> <cda:time value="20170921094500+0100"/> <cda:assignedAuthor classCode="ASSIGNED"> <cda:id extension="0501792275" root="1.2.208.176.1.2" assigningAuthorityName="CPR"/> <cda:representedOrganization classCode="ORG" determinerCode="INSTANCE"> <cda:id extension="241301000016007" root="1.2.208.176.1.1" assigningAuthorityName="SOR"/> <cda:name>Odense Universitetshospital - Svendborg Sygehus</cda:name> </cda:representedOrganization> </cda:assignedAuthor> </dataEnterer> </ns:CreateRelativesRequest> </soapenv:Body> </soapenv:Envelope> |
Request-eksempel med Id:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://sundhedsdatastyrelsen.dk/skr/2021/06/02" xmlns:fsk="urn:hl7-org:fsk" xmlns:cda="urn:hl7-org:v3"> <soapenv:Header/> <soapenv:Body> <ns:CreateRelativesRequest> <id assigningAuthorityName="CPR" extension="0207693049" root="1.2.208.176.1.2"/> <fsk:relatedPerson> <fsk:id assigningAuthorityName="FSK" extension="5477653c-4c46-4f50-a566-591d677b1111" root="1.2.208.184.15.3"/> <fsk:associatedEntity classCode="CON"> <cda: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:addr> <cda:telecom use="H" value="tel:86111213"/> <cda:telecom use="MC" value="tel:25111213"/> <cda:telecom use="WP" value="tel:70111213"/> <cda:associatedPerson> <cda:name> <cda:given>Glitterik</cda:given> <cda:family>Smørhår2</cda:family> </cda:name> </cda:associatedPerson> </fsk:associatedEntity> <fsk:relationshipType code="barn" codeSystem="1.2.208.184.15.4"/> <fsk:note/> </fsk:relatedPerson> <dataEnterer> <cda:time value="20170921094500+0100"/> <cda:assignedAuthor> <cda:id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <cda:assignedPerson> <cda:name> <cda:given>Kar</cda:given> <cda:family>Bunkel!</cda:family> </cda:name> </cda:assignedPerson> </cda:assignedAuthor> </dataEnterer> </ns:CreateRelativesRequest> </soapenv:Body> </soapenv:Envelope> |
Response-eksempel (indeholder ingen data):
<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> |
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 |
Request-eksempel:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://sundhedsdatastyrelsen.dk/skr/2021/06/02" xmlns:fsk="urn:hl7-org:fsk" xmlns:cda="urn:hl7-org:v3"> <soapenv:Header/> <soapenv:Body> <ns:UpdateRelativesRequest> <id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <fsk:relatedPerson> <fsk:id assigningAuthorityName="FSK" extension="RELATED_PERSON_ID" root="1.2.208.184.15.3"/> <fsk:associatedEntity classCode="CON"> <cda: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:addr> <cda:telecom use="H" value="tel:86111213"/> <cda:telecom use="MC" value="tel:25111213"/> <cda:telecom use="WP" value="tel:70111213"/> <cda:associatedPerson> <cda:name> <cda:given>Chris</cda:given> <cda:family>Green</cda:family> </cda:name> </cda:associatedPerson> </fsk:associatedEntity> <fsk:relationshipType code="barn" codeSystem="1.2.208.184.15.4" displayName="Barn"/> <fsk:note>Kan være behjælpelig med kørsel udenfor arbejdstiden</fsk:note> </fsk:relatedPerson> <dataEnterer> <cda:time value="20170921094500+0100"/> <cda:assignedAuthor> <cda:id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <cda:assignedPerson> <cda:name> <cda:given>Anders</cda:given> <cda:family>Andersen</cda:family> </cda:name> </cda:assignedPerson> </cda:assignedAuthor> </dataEnterer> </ns:UpdateRelativesRequest> </soapenv:Body> </soapenv:Envelope> |
Response-eksempel (indeholder ingen data):
<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> |
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 |
Request-eksempel:
<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"> <soapenv:Header/> <soapenv:Body> <ns:DeleteRelativesRequest> <id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <relativeId assigningAuthorityName="FSK" extension="RELATED_PERSON_ID" root="1.2.208.184.15.3"/> <dataEnterer> <cda:time value="20170921094500+0100"/> <cda:assignedAuthor> <cda:id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <cda:assignedPerson> <cda:name> <cda:given>Anders</cda:given> <cda:family>Andersen</cda:family> </cda:name> </cda:assignedPerson> </cda:assignedAuthor> </dataEnterer> </ns:DeleteRelativesRequest> </soapenv:Body> </soapenv:Envelope> |
Response-eksempel (indeholder ingen data):
<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> |
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 |
Request-eksempel:
<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:
<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):
<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> |
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 |
Request-eksempel:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://sundhedsdatastyrelsen.dk/skr/2021/06/02" xmlns:fsk="urn:hl7-org:fsk" xmlns:cda="urn:hl7-org:v3"> <soapenv:Header/> <soapenv:Body> <ns:UpdateTemporaryAddressRequest> <id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <fsk:temporaryAddress> <fsk:id assigningAuthorityName="FSK" extension="TEMP_ADDRESS_ID" root="1.2.208.184.15.2"/> <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="20170921094500+0100"/> <cda:assignedAuthor> <cda:id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <cda:assignedPerson> <cda:name> <cda:given>Anders</cda:given> <cda:family>Andersen</cda:family> </cda:name> </cda:assignedPerson> </cda:assignedAuthor> </dataEnterer> </ns:UpdateTemporaryAddressRequest> </soapenv:Body> </soapenv:Envelope> |
Response-eksempel (indeholder ingen data):
<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> |
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 |
Request-eksempel:
<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"> <soapenv:Header/> <soapenv:Body> <ns:DeleteTemporaryAddressRequest> <id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <temporaryAddressId assigningAuthorityName="FSK" extension="TEMP_ADDRESS_ID" root="1.2.208.184.15.2"/> <dataEnterer> <cda:time value="20170921094500+0100"/> <cda:assignedAuthor> <cda:id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <cda:assignedPerson> <cda:name> <cda:given>Anders</cda:given> <cda:family>Andersen</cda:family> </cda:name> </cda:assignedPerson> </cda:assignedAuthor> </dataEnterer> </ns:DeleteTemporaryAddressRequest> </soapenv:Body> </soapenv:Envelope> |
Response-eksempel (indeholder ingen data):
<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> |
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 |
Request-eksempel:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://sundhedsdatastyrelsen.dk/skr/2021/06/02" xmlns:urn="urn:hl7-org:v3" xmlns:cda="urn:hl7-org:v3" xmlns:fsk="urn:hl7-org:fsk"> <soapenv:Header/> <soapenv:Body> <ns:CreateLanguageRequest> <id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <fsk:language> <fsk:languageCode>se</fsk:languageCode> </fsk:language> <dataEnterer> <cda:time value="20170921094500+0100"/> <cda:assignedAuthor> <cda:id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <cda:assignedPerson> <cda:name> <cda:given>Anders</cda:given> <cda:family>Andersen</cda:family> </cda:name> </cda:assignedPerson> </cda:assignedAuthor> </dataEnterer> </ns:CreateLanguageRequest> </soapenv:Body> </soapenv:Envelope> |
Request-eksempel med id:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://sundhedsdatastyrelsen.dk/skr/2021/06/02" xmlns:fsk="urn:hl7-org:fsk" xmlns:cda="urn:hl7-org:v3"> <soapenv:Header/> <soapenv:Body> <ns:CreateLanguageRequest> <id extension="2512484916" root="1.2.208.176.1.2" assigningAuthorityName="CPR"/> <fsk:language> <fsk:id assigningAuthorityName="FSK" extension="5477653c-4c46-4f50-a566-591d677b1111" root="1.2.208.184.15.7"/> <fsk:languageCode>no</fsk:languageCode> </fsk:language> <fsk:language> <fsk:id assigningAuthorityName="FSK" extension="fc9dd3b9-e308-4b43-a7f8-a692abca6622" root="1.2.208.184.15.7"/> <fsk:languageCode>da</fsk:languageCode> </fsk:language> <fsk:language> <fsk:id assigningAuthorityName="FSK" extension="fc9dd3b9-e308-4b43-a7f8-a692abca6623" root="1.2.208.184.15.7"/> <fsk:languageCode>se</fsk:languageCode> </fsk:language> <dataEnterer> <cda:time value="20170921094500+0100"/> <cda:assignedAuthor> <cda:id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <cda:assignedPerson> <cda:name> <cda:given>Anders!</cda:given> <cda:family>Andersen</cda:family> </cda:name> </cda:assignedPerson> </cda:assignedAuthor> </dataEnterer> </ns:CreateLanguageRequest> </soapenv:Body> </soapenv:Envelope> |
Response-eksempel (indeholder ingen data):
<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> |
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 |
Request-eksempel:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://sundhedsdatastyrelsen.dk/skr/2021/06/02" xmlns:urn="urn:hl7-org:v3" xmlns:cda="urn:hl7-org:v3" xmlns:fsk="urn:hl7-org:fsk"> <soapenv:Header/> <soapenv:Body> <ns:UpdateLanguageRequest> <id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <fsk:language> <fsk:id assigningAuthorityName="FSK" extension="LANGUAGE_ID" root="1.2.208.184.15.7"/> <fsk:languageCode>se</fsk:languageCode> </fsk:language> <dataEnterer> <cda:time value="20170921094500+0100"/> <cda:assignedAuthor> <cda:id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <cda:assignedPerson> <cda:name> <cda:given>Anders</cda:given> <cda:family>Andersen</cda:family> </cda:name> </cda:assignedPerson> </cda:assignedAuthor> </dataEnterer> </ns:UpdateLanguageRequest> </soapenv:Body> </soapenv:Envelope> |
Response-eksempel (indeholder ingen data):
<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> |
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 |
Request-eksempel:
<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"> <soapenv:Header/> <soapenv:Body> <ns:DeleteLanguageRequest> <id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <languageId assigningAuthorityName="FSK" extension="LANGUAGE_ID" root="1.2.208.184.15.7"/> <dataEnterer> <cda:time value="20170921094500+0100"/> <cda:assignedAuthor> <cda:id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <cda:assignedPerson> <cda:name> <cda:given>Anders</cda:given> <cda:family>Andersen</cda:family> </cda:name> </cda:assignedPerson> </cda:assignedAuthor> </dataEnterer> </ns:DeleteLanguageRequest> </soapenv:Body> </soapenv:Envelope> |
Response-eksempel (indeholder ingen data):
<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> |
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 |
Request-eksempel:
<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:urn2="urn:hl7-org:v3"> <soapenv:Header/> <soapenv:Body> <ns:CreateHealthProviderRequest> <id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2" /> <urn:healthProvider> <urn:providerType code="tandlæge" codeSystem="1.2.208.184.15.12" displayName="dentist"/> <urn:organization> <urn2:id assigningAuthorityName="Yder" extension="123456" root="1.2.208.184.15.8"/> <urn2:name>Arthur Dents Bix 2</urn2:name> <urn2:telecom use="WP" value="tel:12345678"/> <urn2:addr isNotOrdered="false" use="H"> <urn2:streetAddressLine>Wallabyvej 42</urn2:streetAddressLine> <urn2:postalCode>1234</urn2:postalCode> <urn2:city>Sydney</urn2:city> <urn2:country>Danmark</urn2:country> </urn2:addr> </urn:organization> </urn:healthProvider> <dataEnterer> <urn2:time value="20170921094500+0100"/> <urn2:assignedAuthor> <urn2:id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <urn2:assignedPerson> <urn2:name> <urn2:given>Anders</urn2:given> <urn2:family>Andersen</urn2:family> </urn2:name> </urn2:assignedPerson> </urn2:assignedAuthor> </dataEnterer> </ns:CreateHealthProviderRequest> </soapenv:Body> </soapenv:Envelope> |
Request-eksempel med Id:
<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:urn2="urn:hl7-org:v3"> <soapenv:Header/> <soapenv:Body> <ns:CreateHealthProviderRequest> <id assigningAuthorityName="CPR" extension="2512484916" root="1.2.208.176.1.2" /> <urn:healthProvider> <urn:id assigningAuthorityName="FSK" extension="5477653c-4c46-4f50-a566-591d677b1111" root="1.2.208.184.15.13"/> <urn:providerType code="tandlæge" codeSystem="1.2.208.184.15.12" displayName="dentist"/> <urn:organization> <urn2:id assigningAuthorityName="Yder" extension="123456" root="1.2.208.184.15.8"/> <urn2:name>Arthur Dents Bix 2</urn2:name> <urn2:telecom use="WP" value="tel:12345678"/> <urn2:addr isNotOrdered="false" use="H"> <urn2:streetAddressLine>Wallabyvej 42</urn2:streetAddressLine> <urn2:postalCode>1234</urn2:postalCode> <urn2:city>Sydney</urn2:city> <urn2:country>Danmark</urn2:country> </urn2:addr> </urn:organization> </urn:healthProvider> <dataEnterer> <urn2:time value="20170921094500+0100"/> <urn2:assignedAuthor> <urn2:id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <urn2:assignedPerson> <urn2:name> <urn2:given>Anders</urn2:given> <urn2:family>Andersen</urn2:family> </urn2:name> </urn2:assignedPerson> </urn2:assignedAuthor> </dataEnterer> </ns:CreateHealthProviderRequest> </soapenv:Body> </soapenv:Envelope> |
Response-eksempel (indeholder ingen data):
<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> |
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 |
Request-eksempel:
<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:urn2="urn:hl7-org:v3"> <soapenv:Header/> <soapenv:Body> <ns:UpdateHealthProviderRequest> <id assigningAuthorityName="CPR" extension="2512484916" root="1.2.208.176.1.2"/> <urn:healthProvider> <urn:id assigningAuthorityName="FSK" extension="HEALTH_PROVIDER_ID" root="1.2.208.184.15.13"/> <urn:providerType code="tandlæge" codeSystem="1.2.208.184.15.12" displayName="dentist"/> <urn:organization> <urn2:id assigningAuthorityName="Yder" extension="123456" root="1.2.208.184.15.8"/> <urn2:name>Arthur Dents Bix 10</urn2:name> <urn2:telecom use="WP" value="tel:12345678"/> <urn2:addr isNotOrdered="false" use="H"> <urn2:streetAddressLine>Wallabyvej 42</urn2:streetAddressLine> <urn2:postalCode>1234</urn2:postalCode> <urn2:city>Sydney</urn2:city> <urn2:country>Danmark</urn2:country> </urn2:addr> </urn:organization> </urn:healthProvider> <dataEnterer> <urn2:time value="20170921094500+0100"/> <urn2:assignedAuthor> <urn2:id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <urn2:assignedPerson> <urn2:name> <urn2:given>Anders</urn2:given> <urn2:family>Andersen</urn2:family> </urn2:name> </urn2:assignedPerson> </urn2:assignedAuthor> </dataEnterer> </ns:UpdateHealthProviderRequest> </soapenv:Body> </soapenv:Envelope> |
Response-eksempel (indeholder ingen data):
<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> |
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 |
Request-eksempel:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://sundhedsdatastyrelsen.dk/skr/2021/06/02" xmlns:urn="urn:hl7-org:v3" > <soapenv:Header/> <soapenv:Body> <ns:DeleteHealthProviderRequest> <id assigningAuthorityName="CPR" extension="2512484916" root="1.2.208.176.1.2"/> <healthProviderId assigningAuthorityName="FSK" extension="HEALTH_PROVIDER_ID" root="1.2.208.184.15.13"/> <dataEnterer> <urn:time value="20170921094500+0100"/> <urn:assignedAuthor> <urn:id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/> <urn:assignedPerson> <urn:name> <urn:given>Anders</urn:given> <urn:family>Andersen</urn:family> </urn:name> </urn:assignedPerson> </urn:assignedAuthor> </dataEnterer> </ns:DeleteHealthProviderRequest> </soapenv:Body> </soapenv:Envelope> |
Response-eksempel (indeholder ingen data):
<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> |
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) | Ja | |
postalCode | Postnummer | varchar(10) | Ja | |
city | By | varchar(80) | Ja | |
country | Land | varchar(80) | Ja | |
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"/> Format for value-attributten er yyyyMMdd
| varchar(8) for value-attribut | Ja (men ikke for temporayAdress) |
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 |
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 |
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), samt 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 |
WSDLen indeholder nedenstående operationer:
Operation | Beskrivelse |
---|---|
savedatacard_2022_02_10.wsdl | Opdater en borgers stamkort. |
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) | Ja |
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) | Ja |
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) | Ja |
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) | Ja |
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) | Ja |
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 |
Request-eksempel:
<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> |
Response-eksempel (indeholder ingen data):
<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> |
Der er lavet en midlertidig migregingsnitflade der kan benyttes til migrerering af lokale stamkort.
De gennerelle beskrivelser under afsnittet om snitfladen til normalt brug er og så gældende her. I dette afsnit beskrives kun det der specielt for migreringssnitfladen.
Til migreringssnitfladen er der følgende wsdl fil.
WSDL-filer | |
---|---|
Stamkortregister DGWS | <server>/skr/wsdl/dgws20210408 |
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 |
Udover xml valideringsfejl og interne fejl kan migrerings snitflade returnerer følgende fejlkoder.
I denne situation har borgeren allerede verificere stamkortet i skr.
Der forsøges migrering af sprog, men da borgeren allerede har verificeret stamkortet fejles med fejlkode 800.
Request-eksempel: FailVerifiedLanguageExist_request.xml
<SOAP-ENV:Body> <SOAP-ENV:Fault> <faultcode>SOAP-ENV:Server</faultcode> <faultstring xml:lang="en">800: Fejl i request i forbindelse med migrering af stamkort, Fælles Stamkort er verificeret af borgeren</faultstring> </SOAP-ENV:Fault> </SOAP-ENV:Body> |
I denne situation har stakmkortet i skr allerede et arbejdstelefonnummer.
Der forsøges migrering af arbejdstelefonnummer.
Request-eksempel: FailWorkPhoneExist_request.xml
<SOAP-ENV:Body> <SOAP-ENV:Fault> <faultcode>SOAP-ENV:Server</faultcode> <faultstring xml:lang="en">810: Fejl i request i forbindelse med migrering af stamkort, Der eksisterer et telefonnummer af type arbejde i forvejen</faultstring> </SOAP-ENV:Fault> </SOAP-ENV:Body> |
I denne situation indeholder stakmkortet i skr borgerens sprog.
Der forsøges migrering af sprog.
Request-eksempel: FailLanguageExist_request.xml
<SOAP-ENV:Body> <SOAP-ENV:Fault> <faultcode>SOAP-ENV:Server</faultcode> <faultstring xml:lang="en">820: Fejl i request i forbindelse med migrering af stamkort, Borgerens sprog eksisterer i forvejen</faultstring> </SOAP-ENV:Fault> </SOAP-ENV:Body> |
I denne situation indeholder stakmkortet i skr en midlertidig adresse på borgeren.
Der forsøges migrering af midlertidig adresse.
Request-eksempel: FailTemporaryAddressExist_request.xml
<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> |
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 |
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.
WSDL-filer | |
---|---|
Stamkortregister DGWS | <server>/skr/wsdl/dgws20190801 |
Stamkortregister IDWS | <server>/skr/wsdl/idws20190801 |
Stamkortregister DGWS | <server>/skr/wsdl/dgws20200728 |
Stamkortregister IDWS | <server>/skr/wsdl/idws20200728 |
Ved valideringsfejl for et request til SKR returneres der en fejlbesked, som indeholder en kode og overdnet tekst samt detaljer for fejlen.
Eksempel: 200: Fejl i request i forbindelse med oprettelse af pårørende, Detaljer: Påkrævet element mangler: relatedPerson.associatedEntity.associatedPerson.name.given.
Nedenfor er de mulige fejlbeskeder beskrevet. Første tabel indeholder de overordnede fejlbeskeder og tilhørende fejlkoder, mens tabellen derunder indeholder de fejlbeskeder, der beskriver detaljer for fejlen.
Kode | Besked |
---|---|
100 | Der opstod en fejl |
101 | Der opstod en fejl i forbindelse med hent stamkort |
102 | Ingen data fundet |
200 | Fejl i request i forbindelse med oprettelse af pårørende |
201 | Intern fejl i forbindelse med oprettelse af pårørende |
210 | Fejl i request i forbindelse med ændring af pårørende |
211 | Intern fejl i forbindelse med ændring af pårørende |
220 | Fejl i request i forbindelse med sletning af pårørende |
221 | Intern fejl i forbindelse med sletning af pårørende |
230 | Fejl i request i forbindelse med oprettelse af sprog |
231 | Intern fejl i forbindelse med oprettelse af sprog |
240 | Fejl i request i forbindelse med ændring af sprog |
241 | Intern fejl i forbindelse med ændring af sprog |
250 | Fejl i request i forbindelse med sletning af sprog |
251 | Intern fejl i forbindelse med sletning af sprog |
260 | Fejl i request i forbindelse med oprettelse af midlertidig adresse |
261 | Intern fejl i forbindelse med oprettelse af midlertidig adresse |
270 | Fejl i request i forbindelse med ændring af midlertidig adresse |
271 | Intern fejl i forbindelse med ændring af midlertidig adresse |
280 | Fejl i request i forbindelse med sletning af midlertidig adresse |
281 | Intern fejl i forbindelse med sletning af midlertidig adresse |
290 | Fejl i request i forbindelse med oprettelse af tandlæge |
291 | Intern fejl i forbindelse med oprettelse af tandlæge |
300 | Fejl i request i forbindelse med ændring af tandlæge |
301 | Intern fejl i forbindelse med ændring af tandlæge |
310 | Fejl i request i forbindelse med sletning af tandlæge |
311 | Intern fejl i forbindelse med sletning af tandlæge |
320 | Fejl i request i forbindelse med ændring af kontaktinformation |
321 | Intern fejl i forbindelse med ændring af kontaktinformation |
500 | Ugyldig sikkerhedsbillet |
501 | Adgang til CPR-nummeret ikke tilladt |
502 | CPR-nummer angivet som DataEnterer i request matcher ikke CPR-nummer i certifikat |
503 | CVR-nummer er ikke whitelisted til DGWS niveau 3 kald på denne operation |
504 | Delegering ikke tilladt |
505 | CVR nummer ikke fundet i sikkerhedsbilletten |
506 | Bruger skal være identificeret ved CPR nummer |
507 | Brugertype kunne ikke bestemmes udfra sikkerhedsbillet |
508 | Forkert audience i sikkerhedsbillet |
509 | Ingen gyldig bruger type identificeret |
800 | Fejl i request i forbindelse med migrering af stamkort |
801 | Intern fejl i forbindelse med migrering af stamkort |
802 | Der opstod en fejl i forbindelse med migrering af stamkort |
810 | Fejl i request i forbindelse med migrering af stamkort |
820 | Fejl i request i forbindelse med migrering af stamkort |
830 | Fejl i request i forbindelse med migrering af stamkort |
Tidsstemplet [datetime] for elementet [element navn] overholder ikke det påkrævede format. |
Elementet [element navn] skal starte med følgende præfiks: [præfiks]. Fandt værdien: [element værdi] |
Ugyldig værdi fundet: [værdi] |
Ugyldigt element fundet: [element navn] |
Værdien [værdi] er ikke tilladt for elementet [element]. Tilladte værdier er: [tilladte værdier] |
[antal fundet] elementer blev fundet, men der tillades maks [antal tilladt]: [element navn] |
[antal fundet] elementer blev fundet, men mindst [antal påkrævet] elementer er påkrævet: [element navn] |
Der blev ikke fundet noget gyldigt indhold i elementet: [element navn] |
Påkrævet element mangler: [element navn] |
[antal] af de påkrævede adresseelementer ([elementer]) mangler i elementet: [element navn] |
Længden af værdien [værdi] overstiger det tilladte maks på [tilladt længde] |
Længden af værdien [værdi] er mindre end det påkrævede minimum på [påkrævet længde] |
Værdien "given + family" overstiger maks længde: [maks længde], Fundet: [længde]: [element navn] |
"given" skal indeholde mindst ét tegn. |
Root '[oid værdi]' og assigning authority '[værdi]' er ikke tilladte i elementet: [element navn] Tilladte elementer er: [elementer] |
Ugyldig relationshiptype code: [værdi] |
Person id ikke gyldigt. 10 cifre er påkrævet [element navn] [[id]] |
Id eksisterer ikke |
Kaldet til Cprexist fejlede: [exception message] |
Uspecificeret valideringsfejl ved indlæsning [request type] Request: [fejlbesked] |
Ugyldig language code: [sprogkode] |
Id for en eller flere af de specificerede pårørende matcher ikke nuværende data. |
Ingen pårørende fundet med UUID: [uuid] |
Ingen tandlæge fundet med UUID: [uuid] |
Ingen midlertidig adresse fundet med UUID: [uuid] |
Ingen sprog fundet med UUID: [uuid] |
Ingen id'er for pårørende i request. |
Intet id for tandlæge i request. |
Intet id for midlertidig adresse i request. |
Intet id for sprog i request. |
Der er allerede angivet en midlertidig adresse for borgeren. |
Der er allerede angivet en tandlæge for borgeren: [tandlæge navn] |
Der er allerede angivet et sprog for borgeren: [sprogkode] |
Et id for en pårørende i create-request findes allerede: [uuid] |
Id'et for midlertidig adresse i create-request findes allerede: [uuid] |
Id'et for tandlæge i create-request findes allerede: [uuid] |
Id'et for sprog i create-request findes allerede: [uuid] |
StartingDate må ikke være senere end EndingDate |
Et ukendt adresseelement blev fundet: UsablePeriod |
Mere end 2 period elementer blev fundet i adressen. |
Et ukendt adresseelement blev fundet. |
Adressen kunne ikke parses. |
Navn skal bestå af to dele: Given og family. |
Datetime string [datetime] overholder ikke det gyldige format: [datetime format] |
Ukendt phone type fundet. H, MC, or WP er gyldige. |
Mere end 4 street elementer blev fundet i addressen. |
Intern fejl: navne på klasser og labels skal matche. |
Ugyldigt input ved kald af MinLog service. |
Fejl ved oprettelse af MinLog data. |
Fejl ved forberedelse af input til MinLog registrering. |
Fejl ved oprettelse af MinLog data: CPRnummer er påkrævet for personen, hvis data hentes/opdateres. |
Fejl ved oprettelse af MinLog data: CPR for brugeren er påkrævet. |
Fejl ved oprettelse af MinLog data: Activity er påkrævet. |
Fejl ved oprettelse af MinLog data: Event time er påkrævet. |
Fejl ved oprettelse af MinLog data: Source system er påkrævet. |