Page History
...
En oversigt over de forskellige releases, og eventuelle kommentarer omkring disse:
Release WSDL | Kommentar |
|---|---|
| 4.0 | Release af version 4 af WSDL - gældende version |
| 3.0 | Release af version 3 af WSDL - gældende versionikke tilgængelig |
| 2.0 | Release af version 2 - ikke tilgængelig |
| 1.0 | Release af version 1 - ikke tilgængelig |
...
[miljø url]/sor-opdatering/v3v4/SOROpdateringService
For regioner:
TEST1-miljøet
https://test1-cnsp.ekstern-test.nspop.dk:8443/sor-opdatering/v3v4/SOROpdateringService
TEST2-miljøet:
https://test2-cnsp.ekstern-test.nspop.dk:8443/sor-opdatering/v3v4/SOROpdateringService
WSDL filen for servicen kan hentes ved at tilføje "?wsdl" til enden af URL'en.
Produktionsmiljø:
...
:
...
TEST1-miljøet
https://test1-cnsp.ekstern-testnsp.nspopdsdn.dk:8443/sor-opdatering/v3v4/SOROpdateringService
TEST2-miljøet:
https://test2-cnsp.ekstern-test.nspop.dk:8443/sor-opdatering/v3/SOROpdateringService
WSDL filen for servicen kan hentes ved at tilføje "?wsdl" til enden af URL'en.
Produktionsmiljø:
https://cnsp.nsp.dsdn.dk:8443/sor-opdatering/v3/SOROpdateringService
(Via SDN - Kræver aftale med SDN)
Snitfladebeskrivelser
Via SDN - Kræver aftale med SDN.
Snitfladebeskrivelser
Fælles
Sikkerhed
Succesfuld anvendelse af SORUS service kræver, at der medsendes gyldig sikkerhedsbillet (SOSI Idkort) fra STS i kaldet.
...
http://sundhedsdatastyrelsen.dk/SOROpdateringService/20192024/09/10/08/
Alle typer benyttet i parametre og resultater i disse kald er defineret under namespacet:
SOR.Services.SOAPServices.V3V4
Koder
Flere felter benytter koder frem for tekst strenge til at signalere over for servicen, hvilken type enhed der er ønsket at blive oprettet, eller hvor at enheden er placeret. Eksempel på sådan er SystemTypeIdentifier under EanLocationCodeEntityType.
...
| Element | Data type | Beskrivelse |
|---|---|---|
| Roles | ArrayOfSorSecurityGroupExternalType | Liste af sikkerheds grupper som skal bruges under autoriseringen af et kald. Hvert type af kald har sin type som er nødvendigt, for at kunne udføre operationen. Afsenders CVR nummer skal være knyttet til den afsendte gruppe. |
| Entities | SorIdentifierCollectionTypeArrayOfLong | Liste af SOR-koder hvis træer som afsenderen har adgang til at redigere i. Indholdet bruges kun under autorisering af CreateSorEntity, EditSorEntity, MoveSorEntity, ReplaceSorEntities, CloseSorEntity og MoveEanLocationCode. Benyttes ikke ved EDI operationer. |
...
| Element | Data type | Beskrivelse |
|---|---|---|
| StreetName | String | Vejnavn |
| StreetBuildingIdentifier | String | Husnummer |
| FloorIdentifier | String | Etage |
| SuiteIdentifier | String | Adressens dør eller til højre, til venstre eller midt for |
| PostOfficeBoxIdentifier | Integer | Postboks. Feltet bruges ikke i dag - input i feltet bliver ignoreret |
| PostCodeIdentifier | String | Postnummer |
| DistrictName | String | Postdistrikt - input i feltet bliver ignoreret. |
| CountryIdentificationCode | CountryIdentificationCodeType | Postadressens landekode |
...
ArrayOfLong
| Element | Data type | Beskrivelse |
|---|---|---|
| SorIdentifier | Liste af long | Liste af SOR-koder |
...
ArrayOfLong1
| Element | Data type | Beskrivelse |
|---|---|---|
| EanLocationCode | Liste af long | Liste af lokationsnumre |
...
ArrayOfLong2
| Element | Data type | Beskrivelse |
|---|---|---|
| EdiIdentifier | Liste af long | Liste af EDI meddelelsestyper |
ArrayOfSorIdentifierType
| Element | Data type | Beskrivelse |
|---|---|---|
| SorIdentifier | Liste af long | Liste af SOR-koder |
ArrayOfPrioritizedEntitySpecialityType
...
| Element | Data type | Beskrivelse |
|---|---|---|
| Name | String | Enhedens navn |
| SorId | Long | Enhedens SOR-kode |
| DateDate | DateTime | Dato for erstatning |
SorEntityType
| 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. |
| 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 |
| OrganizationalLevel | Long | Organisations kode |
SorSecurityGroupExternalType
...
| Element | Data type | Beskrivelse |
|---|---|---|
| FromDate | DateDateTime | Kun output-felt. Input i feltet bliver ignoreret. FromDate bliver default set til i dag+1 dag. Dvs. ændringer gælder altid fra i morgen. Under oprettelse (CreateSorEntity): Skal indeholde den første dag, hvor enheden er aktiv. Under rettelser (EditSorEntity), output: første dag ændring er aktiv/dato for dagen ændringen gælder fra. |
| ToDate | DateDateTime | Sidste dag enheden er aktiv. Kun output-felt. Input i feltet bliver ignoreret. Brug CloseSorEntity() til at lukke en enhed. |
| UpdatedAt | DateDateTime | Dato hvornår enheden sidst er opdateret. Kun output-felt. Input I feltet bliver ignoreret. |
| FirstFromDate | DateDateTime | Dato for hvornår enheden første gang var aktiv. Bliver kun brugt til output. Input i feltet bliver ignoreret. |
...
| Element | Data type | Beskrivelse |
|---|---|---|
| SorIdentifier | Long | SOR-kode på det SOR objekt som skal flyttes |
| ParentSorIdentifier | Long | SOR-kode på det SOR objekt der skal være den nye parent |
| FromDate | DateDateTime | Dato for hvornår at flytningen skal træde i kraft |
...
| Element | Data type | Beskrivelse |
|---|---|---|
| SorIdentifier | Long | SOR-kode på det SOR objekt som skal flyttes |
| FromDate | DateDateTime | Dato for hvornår at erstatningen skal træde i kraft |
| ReplacesEntityCollection | ArrayOfSorIdentifierTypeArrayOfLong | Liste af SOR-koder på de enheder som skal erstattes |
...
| Element | Data type | Beskrivelse |
|---|---|---|
| SorIdentifier | Long | SOR-kode på det SOR objekt som skal lukkes |
| ToDate | DateDateTime | Sidste dato for hvornår at enheden er aktiv |
...
| Element | Data type | Beskrivelse |
|---|---|---|
| SystemTypeIdentifier | Long | EDB-system-id |
| EanLocationCodeEntities | ArrayOfEanLocationCodeTypeArrayOfLong1 | Liste af lokationsnumre som skal opdateres |
...
| Element | Data type | Beskrivelse |
|---|---|---|
| CommunicationSupplierIdentifier | Long | VANS leverandør (ID) |
| EanLocationCodeEntities | ArrayOfEanLocationCodeTypeArrayOfLong1 | Liste af lokationsnumre som skal opdateres |
...
| Element | Data type | Beskrivelse |
|---|---|---|
| EdiAdministratorIdentifier | Long | EDI-Administrator-id |
| EanLocationCodeEntities | ArrayOfEanLocationCodeTypeArrayOfLong1 | Liste af lokationsnumre som skal opdateres |
...
| Element | Data type | Beskrivelse |
|---|---|---|
| RegionCode | Long | Region |
| EanLocationCodeEntities | ArrayOfEanLocationCodeTypeArrayOfLong1 | Liste af lokationsnumre som skal opdateres |
...
| Element | Data type | Beskrivelse |
|---|---|---|
| SystemSupplierIdentifier | Long | Systemleverandør-id |
| EanLocationCodeEntities | ArrayOfEanLocationCodeTypeArrayOfLong1 | Liste af lokationsnumre som skal opdateres |
...
| Element | Data type | Beskrivelse |
|---|---|---|
| EdiIdentifiers | ArrayOfEdiIdentifierTypeArrayOfLong2 | Liste af EDI-meddelelsestyper som skal tilføjes til lokationsnumre som skal opdateres. Ved tom liste slettes alle EDI numre fra lokationsnumre som skal opdateres. |
| EanLocationCodeEntities | ArrayOfEanLocationCodeTypeArrayOfLong1 | Liste af lokationsnumre som skal opdateres |
...
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".
Eksempel på kald
Java frameworks
For et eksempel implementation i Java, kan der med fordel tages udgangspunkt i servicens integrationstest:
"Server".
Eksempel på kald
Java frameworks
For et eksempel implementation i Java, kan der med fordel tages udgangspunkt i servicens integrationstest:https://svn.nspop.dk/src/components/sorus/trunk/SorUpdateService/src/test/java/dk/sds/nsp/sor/sorus/servletintegration/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 for seal biblioteket kan findes her:https://digitaliser.dk/group/374971
.NET frameworks
Seal.NET er .NET ekvivalenten til Seal.Java, og er dokumenteret her:http://digitaliser.dk/group/375117
Der eksisterer ingen eksempel implementation i .NET, men bibliotek og WSDL er frit tilgængelig til at lave en sådan.