Page History
...
| Table of Contents | ||
|---|---|---|
|
Releases SORUS WSDL
En oversigt over de forskellige releases, og eventuelle kommentarer omkring disse:
Release WSDL | Kommentar |
|---|
| 3. |
| 0 | Release af version 3 af WSDL |
- gældende version | |
| 2.0 | Release af version 2 - ikke tilgængelig |
| 1.0 | Release af version 1 |
| - ikke tilgængelig |
Neden for kan dokumentationen for de aktive WSDL versioner findes.
Version 3
Nyeste version af systemet.
...
Releases SORUS
Nyeste version af systemet.
| Release SORUS | Kommentar |
|---|---|
| 1.2.3 | Med rettelser efter QA v. Arosii. (SOR-429). SVN sendt til NSP d. 17.11.2022 - til TEST1 miljø. Godkendt v. Arosii. Deployed på TEST1 miljø og deployed på TEST2 miljø d. 20.01.23. Deploy til PROD miljø afventer at ekstern anvender har testet ok ved hul-i-gennem-test (opdateret d. 23.1.23) |
| 1.2.2 | Med rettelser efter QA v. Arosii. (SOR-414). SVN sendt til NSP d. 11.10.2022 - til TEST1 miljø Godkendt v. Arosii - sendt til Netic d. 13.10.22 |
| 1.2.1. | Med rettelser efter QA v. Arosii. (SOR-414). SVN sendt til NSP d. 21.9.2022 |
| 1.2.0 | Ændringer i forbindelse med overgang til Nemlogin3 og MitID (SOR-394) |
| 1.1 | Release af version 3 af WSDL |
| 1.0 | Release af version 1 af WSDL |
Endpoint
Endpoints til services på NSP er forskellige for kommuner/lægepraksissystemer og regioner.
Kommunerne/lægepraksissystemer benytter den centrale NSP, cnsp, og regionerne bruger den decentrale NSP.
Opdater servicen kan tilgås på adressen:
[miljø url]/sor-opdatering/v3/SOROpdateringService
Sti til TEST1-miljøet:
http https://test1-cnsp.ekstern-test.nspop.dk:80808443/sor-opdatering/v3/SOROpdateringService
Sti til TEST2-miljøet:
http https://test2-cnsp.ekstern-test.nspop.dk:80808443/sor-opdatering/v3/SOROpdateringService
WSDL filen for servicen kan hentes ved at tilføje "?wsdl" til enden af URL'en.
Endpoint til produktion - for RegionerProduktionsmiljø:
https://cnsp.nsp.dsdn.dk:8443/sor-opdatering/v3/SOROpdateringService
Via SDN - Kræver aftale med SDN.
Snitfladebeskrivelser
Fælles
...
Valideringen af de indkommende sikkerhedsbilletter foretages vha NSP Security API.Derudover validerer SORUS service, at den kaldende brugers forespørgsel overholder de i SORUS gældende forretningsregler.
Sikkerhedsbillleter på niveau 3 og 4 Sikkerhedsbillletter på niveau 3 og 4 (FOCES, VOCES, MOCES og lokale identifikationsmidler) tillades. 'På vegne af' understøttes ikke.
...
Alle kald til servicen vil benytte typer defineret under namespacet:
http://sundhedsdatastyrelsen.dk/SOROpdateringService/2019/10/08/
Alle typer benyttet i parametre og resultater i disse kald er defineret under namespacet:
...
| Element | Data type | Beskrivelse |
|---|---|---|
| SorIdentifier | Long | Unik nøgle der identificerer en SOR enhed. Genereres automatisk. En SOR-kode består af fire komponenter: - Fortløbende nummer - Namespace (7 cifre: "1000016") - Partition-ID (2 cifre) - Checksum-ciffer (1 cifre). Den første mulige SOR-kode er dermed '11000016002'. |
| SorType | SorTypeType | SOR-type. Angiver SOR-typen. Fx. "Institutionsejer" eller "Sundhedsinstitution". |
| SorStatus | SorStatusType | Angiver SOR enhedens status. Overbegreb - indeholder dato og opdateringsoplysninger. |
| GeographicalLocalisationIdentifier | Long | Id på den geografiske lokation. Bruges kun til output. Må kikke angives i input. |
| GeographicalLocalisationName | String | Navn på den geografiske lokation. Bruges kun til output. Må ikke angives i input |
| HasGeographicalLocalisation | Boolean | Angiver om SOR enheden har en geografisk lokation, skal være false eller tom hvis SOR typen er IO. Vil altid returneres som false. |
| ParentSorIdentifier | Long | Forældre SOR-id, må ikke udfyldes hvis SOR typen er IO. Ved Edit må feltet ikke udfyldes. Benyttes som input til CreateSorIntity operationen. Benyttes som output fra begge. |
| ActivityAddressInformation | AddressInformationType | Aktivitetsadressen, skal være tom hvis SOR typen er IO eller HI. Hvis en OU oprettes/redigeres uden en aktivitetsadresse, nedarves den fra egen besøgsadresse. |
| VisitingAddressInformation | AddressInformationType | Besøgsadressen, skal være tom hvis SOR typen er IO. Hvis HI/OU oprettes/redigeres uden en besøgsadresse, nedarves den fra enhedens egen postadresse. |
| PostalAddressInformation | AddressInformationType | Postadressen, skal være udfyldt vis SOR typen er IO. For HI og OU gælder det, hvis enheden oprettes/redigeres uden en postadresse, nedarves den fra forældre enhedens postadresse. |
| PharmacyIdentifier | String | SOR-enhedens apoteksnummer, skal være tom hvis SOR typen er IO, og hvis enheden ikke er en apoteksenhed |
| EntityName | String | SOR Enhedens navn |
| EntityTypeIdentifier | Long | Teknisk nøgle for EntityType (SNOMED Concept Id) |
| VirtualAddressInformation | VirtualAddressInformationType | Angiver enhedens hjemmesideadresse, email, telefonnummer og faxnummer. Er obligatorisk for IO. For HI/OU gælder: Hvis objektet er null, så bliver VirtualAddress autoamtisk nedarvet fra parent-enheden |
| ReportingLevelIndicator | Boolean | Angiver om enheden er indberetningsniveau til Landspatientregisteret (LPR2). Kun OU under HI med typen hospital kan have en. Feltet skal være false eller tom hvis SOR typen er IO eller HI, og hvis det ikke er en OU under en HI med typen hospital. |
| LocalAttributeCollection | LocalAttributeCollectionType | Der kan være op til 5 lokale attributter, skal være tom hvis SOR typen er IO eller HI |
| LocalCode | string | SOR-enhedens lokale kode. Kun OU under HI med typen hospital kan have en. Feltet skal være tom hvis SOR typen er IO eller HI, og hvis det er en OU som ikke er under en HI med typen hospital. Attribut der frit kan benyttes af anvender organisationen. |
| EanLocationCodeState | EanLocationCodeStateType | Angiver om lokationsnummer er nedarvet fra den hierarkiske mor. Kan være 'own', 'inherited' eller 'none'. |
| EanLocationCodeEntity | EanLocationCodeEntityType | Angiver lokationsnummeroplysninger på SOR enheden |
| PatientsAdmittedIndicator | boolean | Angiver om enheden er et sengeafsnit. Kun OU under HI med typen hospital kan have en. Feltet skal være false eller tom hvis SOR typen er IO eller HI, og hvis det ikke er en OU under en HI med typen hospital. |
| AmbulantActivityIndicator | boolean | Angiver om enheden er et ambulatorie. Kun OU under HI med typen hospital kan have en. Feltet skal være false eller tom hvis SOR typen er IO eller HI, og hvis det ikke er en OU under en HI med typen hospital. |
| ShakIdentifier | String | Angiver hvilken sygehusafdelingskode, der er knyttet til SOR-enheden. Den samme sygehusafdelingskode kan være knyttet til mere end én SORenhed. Der kan kun registreres officielle sygehusafdelingskoder. Skal være tom hvis SOR typen er IO. |
| PrioritizedEntitySpecialityCollection | ArrayOfPrioritizedEntitySpecialityType | Liste af SOR-enhedens kliniske specialer. Der kan angives op til 8, hvoraf nr. 1 er hovedspecialet. Skal være tom hvis SOR typen er IO eller HI. |
| ProviderIdentifier | String | SOR-enhedens ydernummer feltet skal være tom, hvis SOR typen er IO eller HI eller det er en OU som ikke er under en HI med typen "hospital". Kun OU ikke under HI med typen hospital kan have en. Input i feltet bliver ignoreret uden varsel hvis der er tale om en hospital OU. |
| CVRNumberIdentifier | string | CVR nummer for SOR-enheden. Obligatorisk hvis SOR typen er IO. |
| ProductionUnitIdentifier | String | P nummer for SOR-enheden, skal være tom hvis SOR typen er IO, eller hvis det er en OU under en HI med typen hospital |
| ReplacedByEntityCollection | ArrayOfReplacingInfoType | Liste af SOR-enheder denne enhed er blevet erstattet af |
| ReplacesEntityCollection | ArrayOfReplacingInfoType | Liste af SOR-enheder denne enhed erstatter |
...
| MedCom fault code | Fault string | Beskrivelse |
|---|---|---|
| missing_required_header | Ikke muligt at læse forespørgslen | Autentifikations fejl, kan ikke læse forespørgslen |
| ticket_missing | Der opstod en fejl under autentificeringen: Manglende sikkerhedsbillet i forespørgsel | Autentifikations fejl, manglende sikkerhedsbillet i forespørgsel |
| ticket_not_valid | Der opstod en fejl under autentificeringen: Sikkerhedsbilletten er ikke gyldig | Autentifikations fejl, ugyldig sikkerhedsbillet i forespørgsel |
| principal_user_present | Der opstod en fejl under autoriseringen: På vegne af understøttes ikke | Autorisations fejl, på vegne af tillades ikke adgang |
| organisation_missing | Der opstod en fejl under autoriseringen: Manglende organisation i sikkerhedsbilletten | Autorisations fejl, organisation ikke angivet |
| user_type_not_valid | Der opstod en fejl under autoriseringen: Brugertypen kan ikke autoriseres | Autorisations fejl, brugertypen tillades ikke adgang |
| not_authorized | CVR er ikke whitelistet | Autorisations fejl, manglende whitelisting |
| syntax_error | Det er ikke muligt at læse body | Fejl under transformeringen af SOAP body til et objekt |
| processing_problem | Ugyldig requesttype | Request typen i SOAP action findes ikke |
| processing_problem | Det er ikke muligt at læse forespørgslen | Request body kan ikke læses |
| processing_problem | Der er sket en fejl i forsøget på at kontakte SOR databasen | Fejl under forespørgsel mod whitelistingdatabasen |
| processing_problem | Error happened while contacting SOR backend | Fejl under forespørgsel mod backenden Supporten kan søge i SOR ekstern/SOR intern fejllogs |
| processing_problem | Det er ikke muligt at skrive objekt | Fejl under at skrive det transformerede objekt til klienten |
| processing_problem | Det er ikke muligt at skrive body | Fejl under transformeringen af object til XML |
| processing_problem | Det er ikke muligt at læse body | Fejl under transformeringen af SOAP body til et objekt |
Andre fejlkoder kan forekomme, men disse kommer fra backenden, eller dens underliggende servicesSOR Ekstern eller SOR Intern.
Det skal pointeres, at MedCom's fault code kan findes under detail sektionen af den resulterende SOAP fault. Den påkrævede faultstring vil altid være "Server".
...
For et eksempel implementation i Java, kan der med fordel tages udgangspunkt i servicens integrationstest:
https://svn.nspop.dk/svnsrc/capgeminicomponents/SORServices/NSP/sorus/trunk/SorUpdateService/src/test/java/dk/sds/nsp/sor/sorus/servletservletintegration/SorusV3ServletIT.java
Denne implementerer og bruger er JAX-WS klient for servicen, implementeret med Apache CXF. Klienten benytter også Seal.Java biblioteket til håndtering af SOSI ID kort og DGWS. Yderligere dokumentation på for seal biblioteket kan findes her:
...