Page History
Navitabs | ||||
---|---|---|---|---|
|
MANGLER ENDELIG GODKENDELSE
Indholdsfortegnelse
Table of Contents | ||||
---|---|---|---|---|
|
...
Oversigt over gældende og tidligere releases og eventuelle kommentarer.
Release | Kommentar |
---|---|
1.3.8 | Search operation kan ikke kaldes - tidligere disabled Teknisk opgradering af Bouncy Castle Understøttelse af NemLog-in 3 og MitID Fejlretning af af søgninger |
...
For eksempel, på TEST1-miljøet vil det være:
http://test1.ekstern-test.nspop.dk:8080/sor-opslag/SORLookupService
WSDL filen for servicen kan hentes ved at tilføje "?wsdl" til enden af URL'en, eksampel;
...
Output | ||
Element | Data type | Beskrivelse |
---|---|---|
ShakSorMapResp | List of ShakSorMap | Shak sor map objekt type |
Status | Status | Status for hvordan kaldet gik |
Fælles
Search Operation
Search operation er ikke taget i brug endnu. Kald af denne service operation vil returnere en fejl.
...
...
Fælles
Sikkerhed
Succesfuld anvendelse af SORLS service kræver, at der medsendes gyldig sikkerhedsbillet (SOSI Idkort) fra STS i kaldet.
Valideringen af de indkommende sikkerhedsbilletter foretages vha NSP Security API.
Sikkerhedsbillletter på niveau 3 og 4 (FOCES, VOCES, MOCES og lokale identifikationsmidler) tillades. 'På vegne af' understøttes ikke.
Namespaces
Alle kald til servicen vil benytte request typer defineret under namespacet:
http://sundhedsdatastyrelsen.dk/SORLookupService/2018/09/06/
Der er type med samme navne under andre namespaces, så det er vigtigt at få valgt den rigtige.
Alle svar fra servicen vil benytte response typer defineret under namespacet:
http://sundhedsdatastyrelsen.dk/SORLookupService/2018/09/06/
Eksterne typer
Mange af de data typer som bliver benyttet, kan typisk findes her:
https://sor-filer.sundhedsdata.dk/sor_produktion/xsd/
Typer under både v_1_0_0
og v_2_0_0
bliver benyttet.
Følgende lokationer bliver også inkluderet for typer:
http://digitaliser.dk/resource/1945/artefact/CVR_CVRnumberIdentifier.xsd
http://rep.oio.dk/kms.dk/xml/schemas/2007/05/23/
Alle typer hentet eksternt fra er ikke angivet i dette dokument, da de kan ses i WSDL-filen.
ArrayOfLong type
...
LocalAttributeCollectionType
...
EanLocationCodeState type
...
Enumeration af stadier. Kan have en af følgende værdier:
- Undefined
- None
- Inherited
- Own
Sikkerhed
Succesfuld anvendelse af SORLS service kræver, at der medsendes gyldig sikkerhedsbillet (SOSI Idkort) fra STS i kaldet.
Valideringen af de indkommende sikkerhedsbilletter foretages vha NSP Security API.
Sikkerhedsbillletter på niveau 3 og 4 (FOCES, VOCES, MOCES og lokale identifikationsmidler) tillades. 'På vegne af' understøttes ikke.
Namespaces
Alle kald til servicen vil benytte request typer defineret under namespacet:
http://sundhedsdatastyrelsen.dk/SORLookupService/2018/09/06/
Der er type med samme navne under andre namespaces, så det er vigtigt at få valgt den rigtige.
Alle svar fra servicen vil benytte response typer defineret under namespacet:
http://sundhedsdatastyrelsen.dk/SORLookupService/2018/09/06/
Eksterne typer
Mange af de data typer som bliver benyttet, kan typisk findes her:
https://sor-filer.sundhedsdata.dk/sor_produktion/xsd/
Typer under både v_1_0_0
og v_2_0_0
bliver benyttet.
Følgende lokationer bliver også inkluderet for typer:
http://digitaliser.dk/resource/1945/artefact/CVR_CVRnumberIdentifier.xsd
http://rep.oio.dk/kms.dk/xml/schemas/2007/05/23/
Alle typer hentet eksternt fra er ikke angivet i dette dokument, da de kan ses i WSDL-filen.
ArrayOfLong type
Element | Data type | Beskrivelse |
---|---|---|
long | long | En liste af tal værdier |
LocalAttributeCollectionType
Element | Data type | Beskrivelse |
---|---|---|
LocalAttribute1 | String | Lokal attribut 1 |
LocalAttribute2 | String | Lokal attribut 2 |
LocalAttribute3 | String | Lokal attribut 3 |
LocalAttribute4 | String | Lokal attribut 4 |
LocalAttribute5 | String | Lokal attribut 5 |
EanLocationCodeState type
Element | Data type | Beskrivelse |
---|---|---|
string | Enumeration af stadier. Kan have en af følgende værdier:
|
EanLocationCodeEntityType
EanLocationCodeEntityType type
...
ArrayOfEanLocationCodes type
...
type
Element | Data type | Beskrivelse |
---|---|---|
EdiIdentifierEanLocationCode | Long | En liste af EDI numre |
ArrayOfPrioritizedEntitySpecialityType
...
PrioritizedEntitySpecialityType
...
Lokationsnummer | ||
OnlyInternalIndicator | Boolean | Angiver om lokationsnummeret er til internt brug |
NonActiveIndicator | Boolean | Angiver om lokationsnummeret er ikke-aktivt |
SystemSupplierIdentifier | Long | Systemleverandør-id |
CommunicationSupplierIdentifier | Long | Netoperatør-id |
SystemTypeIdentifier | Long | EDB-system-id |
EdiAdministratorIdentifier | Long | EDI-Administrator-id |
SorNote | String | Angiver eventuelle bemærkninger til lokationsnummeret |
SorStatus | SorStatus | Angiver SOR enhedens status |
RegionCode | String | Regionens kode, f.eks. 1084 for RegionHovedstaden |
ArrayOfEanLocationCodes type
...
Element | Data type | Beskrivelse |
---|---|---|
ReplacingInfoTypeeanLocationCode | Liste af ReplacingInfoType | Liste af SOR-enheder |
...
Long | En liste af lokationsnumre |
ArrayOfEdiIdentifiers type
Element | Data type | Beskrivelse |
---|
Vejkodefeltet bruges kun til output - input i feltet bliver ignoreret.
...
EdiIdentifier | Long | En liste af EDI numre |
ArrayOfPrioritizedEntitySpecialityType
Element | Data type | Beskrivelse |
---|---|---|
PrioritizedEntitySpeciality | Liste af PrioritizedEntitySpecialityType | Liste af SOR-enhedens kliniske specialer. Der kan angives op til 8, hvoraf nr. 1 er hoved specialet. |
PrioritizedEntitySpecialityType
Element | Data type | Beskrivelse |
---|---|---|
SpecialityIdentifier | Long | Speciale-id: Identifikationskode der identificerer et lægefagligt speciale. Kommentar: Identifikationskoden er et begrebs-id fra SNOMED CT. |
SpecialityPriorityIdentifier | Long | Prioriteten af specialet. Hoved-/bi-speciale: Markerer om det er et hoved- eller bi-speciale. |
ArrayOfReplacingInfoType
Element | Data type | Beskrivelse |
---|---|---|
ReplacingInfoType | Liste af ReplacingInfoType | Liste af SOR-enheder |
AddressInformationType
Element | Data type | Beskrivelse |
---|
AdditionalAddressInformationText | String | Yderligere oplysninger om adressen |
AddressPostal | AddressPostalType | Indeholder yderligere adresse informationer |
InheritanceIndicator | Boolean | Indikerer om adressen er nedarvet eller ej ("TRUE" = Ja) |
SkipAddressValidation | Boolean | Indikerer om den indtastede adresse skal valideres. Kun til input. Er altid sat til false i retur objektet. |
MunicipalityCode | String | Kommunekode |
StreetCode | String | Vejkodefeltet bruges kun til output - input i feltet bliver ignoreret. |
RegionName | String | Indeholder navnet på den valgte regionskode. Feltet bruges kun til output |
- input i feltet bliver ignoreret. |
RegionCode | String |
Feltet bruges ikke - input i feltet bliver ignoreret. |
CoordETRS89z32NMeasure |
Status type
...
Decimal | Northing koordinater i UTM zone 32 (ETRS89, North). Feltet bruges kun til output - input i feltet bliver ignoreret. | |
CoordETRS89z32EMeasure | decimal | Easting koordinater i UTM zone 32 (ETRS89, East). Feltet bruges kun til output - input i feltet bliver ignoreret. |
AddressPostalType
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 (Bynavn) - input i feltet bliver ignoreret. |
CountryIdentificationCode | CountryIdentificationCodeType | Postadressens landekode |
Status type
Element | Data type | Beskrivelse |
---|---|---|
ErrorCode | Integer | Hvis kaldet var en succes, så vil denne have værdien 0. Ved validerings fejl, så vil denne have en positiv værdi. Ved Tekniske og praktiske fejl, så vil denne have en negativ værdi. |
Message | String | Hvis ErrorCode er 0, er dette felt tomt. Ellers indeholder den en kort beskrivelse af, hvilken fejl der skete. |
SorEntity
Element | Data type | Beskrivelse |
---|---|---|
SorIdentifier | Long | Unik nøgle der identificerer en SOR enhed |
SorType | String | Tekstværdi for SOR-type |
FirstFromDate | Date | Første dato hvorfra SOR enheden er gældende. |
FromDate | Date | Fra dato for sidste ændring på SOR enheden. Hvis det er en ændring til en af attributterne på SOR enheden vil FromDate indeholde datoen for dagen efter ændringen til en eller flere felter. |
ToDate | Date | Situation 1: ændringer til SOR enhed og hvor SOR enhed ikke lukkes Situation 2: SOR enhed lukkes |
UpdatedAt | Datetime | Ændringstidspunkt for SOR enhed |
GeographicalLocalisationIdentifier | Long | Id på geografisklokalitet |
GeographicalLocalisationName | String | Navn på den geografiske lokalitet |
HasGeographicalLocalisation | Boolean | Angiveer om SOR enheden har en grafisk lokation |
ParentSorIdentifier | Long | Forældre SOR-id |
ActivityAddressInformation | AddressInformationType | Aktivitetsadressen |
VisitingAddressInformation | AddressInformationType | Besøgsadressen |
PostalAddressInformation | AddressInformationType | Postadressen |
PharmacyIdentifier | String | SOR-enhedens apoteksnummer |
EntityName | String | SOR Enhedens navn |
EntityTypeIdentifier | Long | Teknisk nøgle for EntityType (SNOMED Concept Id) |
EntityTypeName | String | Angiver hvilken type enheden har - fx privat, regional, tandlægepraksis, klinisk enhed, skadestue. Feltet kan indeholde enten en type af institutionsejer eller en type af sundhedsinstitution eller en type af organisatorisk enhed. |
VirtualAddressInformation | VirtualAddressInformationType | Angiver enhedens hjemmesideadresse |
ReportingLevelIndicator | Boolean | Angiver om enheden er indberetningsniveau til Landspatientregisteret (LPR2) |
LocalAttributeCollection | LocalAttributeCollectionType | Der kan være op til 5 lokale attributter |
LocalCode | String | SOR-enhedens lokale kode. Attribut der frit kan benyttes af anvender organisationen. |
EanLocationCodeState | EanLocationCodeState | Angiver om lokationsnummer er nedarvet fra den hierarkiske mor. Kan være 'own', 'inherited' eller 'none'. |
EanLocationCodeEntity | EanLocationCodeEntityType | Angiver lokationsnummeret på SOR enheden |
CommunicationSupplier | String | Angiver netoperatør for lokationsnummeret. Obligatorisk hvis lokationsnummeret oprettes. Dette felt er ikke relevant, da feltet optræder under EanLocationCodeEntity. |
PatientsAdmittedIndicator | Boolean | Angiver om enheden er et sengeafsnit. Feltet er relateret til LPR2 og er ikke længere relevant. |
AmbulantActivityIndicator | Boolean | Angiver om enheden er et ambulatorie. Feltet er ikke længere relevant. |
ShakIdentifier | String | Angiver hvilken sygehusafdelingskode, der er knyttet til SORenheden. Den samme sygehusafdelingskode kan være knyttet til mere end én SORenhed. Der kan kun registreres officielle sygehusafdelingskoder. |
PrioritizedEntitySpecialityCollection | ArrayOfPrioritizedEntitySpecialityType | Liste af SOR enhedens kliniske specialer. Der kan angives op til 8, hvoraf nr. 1 er hovedspecialet. |
SystemSupplier | SystemSupplier | Angiver systemleverandøren for lokationsnummeret. Obligatorisk hvis lokationsnummeret oprettes. Dette felt er ikke relevant, da feltet optræder under EanLocationCodeEntity. |
ProviderIdentifier | String | SOR-enhedens ydernummer |
CVRnumberIdentifier |
SorEntity
...
Fra dato for sidste ændring på SOR enheden.
Hvis det er en ændring til en af attributterne på SOR enheden vil FromDate indeholde datoen for dagen efter ændringen til en eller flere felter.
...
Situation 1: ændringer til SOR enhed og hvor SOR enhed ikke lukkes
Dato for sidste dag hvor en række er aktiv, hvor der oprettes en ny række indeholdende SOR felter med nye værdier. ToDate i den nye række vil være null.
Situation 2: SOR enhed lukkes
Lukkedato for sidste dag hvor en SOR enhed er aktiv. Her findes der ikke nogen ny række, dvs. alle rækker tilknyttet SOR enhed har en dato i ToDate.
...
Teknisk nøgle for EntityType for næstøverste niveau i hierarkiet
SearchParameters type
String | CVR nummer for SOR-enheden |
ProductionUnitIdentifier |
SearchLimit type
...
String | P nummer for SOR-enheden | |
InstitutionOwnerSorId | Long | Sorid for øverste niveau i hierarkiet |
InstitutionOwnerEntityTypeId | Long | Teknisk nøgle for EntityType for øverste niveau i hierarkiet |
HealthInstitutionSorId | Long | Sorid for næstøverste niveau i hierarkiet |
HealthInstitutionEntityTypeId | Long | Teknisk nøgle for EntityType for næstøverste niveau i hierarkiet |
SearchScope type
Angiver scope for søgning, hvor alle enheder returneres, dvs. fremsøgte enhed og alle underliggende enheder.
ShakSorMap
Er returtype ved kald til SorShakMap og ShakSorMap operationerne. Begge operationer returnerer samme type. ShakSorMap kan returnere flere rækker, da det kan være flere SOR-enheder tilknyttet en SHAK-kode. SorShakMap returnerer kun en række, da der kun kan være en SHAK-kode tilknyttet en SOR-enhed.
...
MedCom fault code | Fault string | Beskrivelse | ||
---|---|---|---|---|
Søgefunktionen er ikke tilgængelig | Search funktionen er pt ikke tilgængelig | processing_problem | SOAP forspørgslen er ugyldig. Påkrævet namespace mangler | Namespace mangler i forespørgsel |
processing_problem | SOAP forspørgslen er ugyldig. Ingen gyldig SOAP-action er angivet | SOAP action mangler i forespørgsel | ||
processing_problem | SOAP forspørgslen er ugyldig. Den angivne operation findes ikke | Den angivne operation findes ikke | ||
processing_problem | Det er ikke muligt at læse forespørgslen | Fejl under læsning af body element | ||
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 | ||
processing_problem | 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 af CVR | ||
validation_error | Valideringsfejl: Identifier er ikke angivet | Valideringsfejl, sor eller shak identifier er ikke angivet i forespørgslen | ||
syntax_error | Det er ikke muligt at læse body | Fejl under transformeringen af SOAP body til et objekt | ||
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 | Der er sket en fejl i forsøget på at kontakte SOR databasen | Fejl under forespørgsel mod whitelistingdatabasen | ||
processing_problem | Der er sket en fejl i forsøget på at kontakte SDM databasen | Fejl under forespørgsel mod backenden | ||
processing_problem | Der er sket en uventet fejl | Uventet fejl |
Andre fejl kan forekomme Andre fejlkoder kan forekomme, men disse kommer fra backenden, eller dens underliggende services.
...