Page History
...
<KeyIdentifier> <OID>1.2.208.176.1.6.1.1</ns2:OID> <Value>1212701XG7</ns2:Value> </ns2:KeyIdentifier>
SOAP Headers
I Nationale eCPR-servicen foretages skal der tilføjes SOAP header blocks, der unikt identificerer det software, der ønsker at kalde løsningen. Bemærk at denne identifikation ikke er en del af ID kortet, men implementeres som selvstændige XML-elementer i SOAP headeren indkapslet i et WhitelistingHeader
Footnote |
---|
WhitelistingHeader følger FMK standard. Det betyder ikke at det er nødvendigt at få whitelistet en løsning op mod Nationalt eCPR. |
element. Det er derfor ikke bundet til en session, men kan variere fra en forespørgsel til næste.
Headeren er tænkt som en udvidelse af MedCom - Den gode Webservice, og er under standardisering i SDS regi.
Der tilføjes et WhitelistingHeader element med flg. XML elementer til SOAP headeren. Alle er af type xs:string:
SystemOwnerName
SystemName
SystemVersion
OrgResponsibleName
OrgUsingName
OrgUsingID
RequestedRole
Eksempel
Nedenstående eksempel er en typisk WhitelistingHeader for et regionalt system.
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sdsd="http://www.sdsd.dk/dgws/2010/08" xmlns:sdsd20120601="http://www.sdsd.dk/dgws/2012/06" xmlns:medcom="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd"> <soapenv:Header> <sdsd201206:WhitelistingHeader> <sdsd:SystemOwnerName>Leverandør A</sdsd:SystemOwnerName> <sdsd:SystemName>System A</sdsd:SystemName> <sdsd:SystemVersion>1.5</sdsd:SystemVersion> <sdsd:OrgResponsibleName>ROS IT-afdeling</sdsd:OrgResponsibleName> <sdsd:OrgUsingName>Alb Plastikkirurgisk Dagafdeling</sdsd:OrgUsingName> <sdsd:OrgUsingID NameFormat="medcom:skscode">8001506</sdsd:OrgUsingID> <sdsd:RequestedRole>Læge</sdsd:RequestedRole> </sdsd201206:WhitelistingHeader> <!-- ... --> </soapenv:Header> <soapenv:Body> <!-- ... --> </soapenv:Body> </soapenv:Envelope>
SystemOwnerName
SystemOwnerName elementet indeholder det entydige navn på leverandøren af afsendersystemet.
Navn | sdsd:SystemOwnerName |
---|---|
Type | xs:string |
Værdisæt | Udfaldsrummet dikteres via det Centrale Virksomheds Register |
Eksempel | <SystemOwnerName>Pharma</SystemOwnerName> |
SystemName
SystemName elementet indeholder navnet på afsendersystemet.
Navn | sdsd:SystemName |
---|---|
Type | xs:string |
Værdisæt | Udfaldsrummet dikteres alene af leverandøren af afsendersystemet |
Eksempel | <SystemName>Medicinmodulet</SystemName> |
SystemVersion
SystemVersion elementet indeholder versionen på afsendersystemet.
Navn | sdsd:SystemVersion |
---|---|
Type | xs:string |
Værdisæt | Udfaldsrummet dikteres alene af leverandøren af afsendersystemet |
Eksempel | <SystemVersion>1.0</SystemVersion> |
OrgResponsibleName
OrgResponsibleName indeholder det entydige navn på den organisation, der har ansvaret for it-systemet. Dette bør svare til den sundhedsfaglige organisations registrering i CVR.
Navn | sdsd:OrgResponsibleName |
---|---|
Type | xs:string |
Eksempel | <OrgResponsibleName>Region Midt</OrgResponsibleName> |
OrgUsingName
OrgUsingName indeholder det entydige navn på den sundhedsfaglige organisation, der benytter it-systemet. Det bemærkes, at organisationen meget vel ikke kan identificeres via en klassifikation som CVR, som f.eks. en Fælles Akut Modtagelse i en region. Derfor anvendes der ikke klassifikationer for denne attribut. OrgUsingName er entydig.
Navn | sdsd:OrgUsingName |
---|---|
Type | xs:string |
Værdisæt | Udfaldsrummet dikteres af den i OrgUsingID anvendte klassifikation |
Eksempel | <OrgUsingName>ROS Infektionsmedicinsk Amb.</OrgUsingName> |
OrgUsingID
OrgUsingID indeholder det entydige id på den organisation, hvor brugeren aktuelt befinder sig når webservice kaldet udføres. Klassifikationen hvortil id’et hører er angivet i attributten OrgUsingID@NameFormat og headeren OrgUsingName angiver navnet på organisationen hørende til id’et. Hvilke typer der supporteres af eCPR er de samme som supporteres i FMK og er dokumenteret på Organisationskoder i FMK
Navn | sdsd:OrgUsingID |
---|---|
Type | xs:string |
Eksempel | <OrgUsingID NameFormat=“medcom:ynumber”>400777</OrgUsingID> |
OrgUsingID Identifier
Nedenstående tabel angiver hvilken type OrgUsingID, der skal anvendes for de forskellig typer systemer. Såfremt der er systemer, der ikke er angivet i nedenstående tabel, kan man lave en supportsag på NSPOP for at få afklaret hvilken type der skal anvendes.
Nationalt eCPR følger FMK i brugen af SOR.
System | Identifier |
---|---|
Regionalt EPJ system | SKS, 6 eller 7 ciffer. Nogle regioner har selv opfundet 8. og 9. ciffer. Disse ekstra ciffer ignoreres af eCPR og kun de første 7 anvendes. |
Privatklinik med SKS kode | SKS, 6 eller 7 ciffer. |
LPS Ydernummer | valideres op imod yderregisteret |
LPS uden Ydernummer | SOR Id |
Vagtlæge systemer | SOR Id |
Kommunalt EOJ | SOR Id |
Regionalt EOJ | SOR Id |
Privatejet EOJ | SOR Id |
Tandlægesystemer | Ydernummer, der valideres op imod yderregisteret. For klinikker uden ydernummer anvendes CVR, der valideres op imod det anvendte certifikat. |
Apoteker systemer | EAN Lokationsnummer, valideres op mod SOR |
Kommunalt bostedssystem | SOR Id |
Regionalt bostedssystem | SOR Id |
Special klinikker uden yder eller SKS | SOR Id |
Systemkald, regional PAS systemer | SKS, 4, 6 eller 7 ciffer. |
OrgUsingID@NameFormat
Klassifikationssættet i attributten OrgUsingID@NameFormat angiver den klassifikation, som attributterne OrgUsingID og OrgUsingName henter sine værdier fra. Bemærk at attributten skal anvendes i XML dokumenter uden namespace prefix, selvom det selvfølgelig er defineret i et namespace.
Navn | sdsd:OrgUsingID@NameFormat |
---|---|
Type | xs:string |
Format | ”medcom:ynumber”: Yderregisteret |
”medcom:pnumber”: CVR-P nummer | |
”medcom:skscode”: SHAK kode | |
”medcom:cvrnumber”: CVR nummer | |
”medcom:communalnumber”: Kommunekode | |
”medcom:sor”: SOR kode | |
”medcom:locationnumber”: EAN Lokationsnummer | |
Eksempel | <OrgUsingID NameFormat=“medcom:skscode”>650402</OrgUsingID> |
RequestedRole
RequestedRole elementet er beskrevet i afsnittet eCPR - Roller og rettigheder, sammen med rettigheder for de enkelte roller.
Navn | sdsd:RequestedRole |
---|---|
Type | xs:string |
Værdisæt | RequestedRole elementet er beskrevet i afsnittet eCPR - Roller og rettigheder. |
Eksempel | <RequestedRole>Læge</RequestedRole> |
Fejlhåndtering
Format fejl
Hvis en service modtager data der ikke opfylder krav til fx format, vil der returneres en fejl. Alle logiske fejl returneres på dansk som “faultstring” i SOAP Fault. Det kan fx se således ud, hvis man ikke overholder datoformatet for fødselsdag:
<Envelope> <Header> </Header> <Body> <Fault> <faultcode>Server</faultcode> <faultstring xml:lang="en"> Fejl i request ifm. med opdatering af eCPR-data, Ulovligt format for fødselsdag (ÅÅÅÅ-MM-DD): [2020-04-130] </faultstring> </Fault> </Body> </Envelope>
Header fejl
Hvis en af de krævede elementer mangler i headeren, eller det kaldende system ikke er autoriseret til at kalde eCPR, returneres en SOAP fault med fejlkode 4300 (Manglende system autorisation).
...
Footnotes Display |
---|
...
Ændringslog
1.0 | 2023-11-07 | Side publiceret | SDS |
1.1 | 2023-11-13 | Tilføjet beskrivelse af historik | SDS |
1.2 | 2023-12-06 | Tilføjet afsnit om SOAP headers | SDS |