Page History

Versions Compared

Key

This line was added.
This line was removed.
Formatting was changed.

Navitabs

root	SOR Opslag Service (SORLS) - Leverancebeskrivelse
includeroot	true

MANGLER ENDELIG GODKENDELSE

Indholdsfortegnelse

Table of Contents

outline	true
exclude	Indholdsfortegnelse

...

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

Endpoint

Opslag servicen kan tilgås på adressen:

...

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;

...

Element	Data type	Beskrivelse
Output
ShakSorMapResp	List of ShakSorMap	Shak sor map objekt type
Status	Status	Status for hvordan kaldet gik

Search Operation

Search operation er ikke taget i brug endnu. Kald af denne service operation vil returnere en fejl.

...

SearchLimitType

...

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

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

Element	Data type	Beskrivelse
EanLocationCodelong	Long	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

...

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
eanLocationCode	Long	En liste af lokationsnumre

...

Beskrivelse
	string	Enumeration af stadier. Kan have en af følgende værdier: Undefined None Inherited Own

Beskrivelse

string

Enumeration af stadier. Kan have en af følgende værdier:

Undefined
None
Inherited
Own

EanLocationCodeEntityType 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

Element	Data type	Beskrivelse
ReplacingInfoTypeeanLocationCode	Liste af ReplacingInfoType	Liste af SOR-enheder

ArrayOfEdiIdentifiers type

Element	Data type	Beskrivelse

AdditionalAddressInformationTextStringYderligere oplysninger om adressenAddressPostalAddressPostalTypeIndeholder yderligere adresse informationerInheritanceIndicatorBooleanIndikerer om adressen er nedarvet eller ej ("TRUE" = Ja)SkipAddressValidationBooleanIndikerer om den indtastede adresse skal valideres. Kun til input. Er altid sat til false i retur objektet.MunicipalityCodeStringKommunekodeStreetCodeString

Vejkodefeltet bruges kun til output - input i feltet bliver ignoreret.

RegionNameStringIndeholder navnet på den valgte regionskode. Feltet bruges kun til output - input i feltet bliver ignoreret.RegionCodeStringFeltet bruges ikke - input i feltet bliver ignoreret.CoordETRS89z32NMeasureDecimalNorthing koordinater i UTM zone 32 (ETRS89, North). Feltet bruges kun til output - input i feltet bliver ignoreret.CoordETRS89z32EMeasuredecimalEasting koordinater i UTM zone 32 (ETRS89, East). Feltet 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

StreetNameStringVejnavnStreetBuildingIdentifierStringHusnummerFloorIdentifierStringEtageSuiteIdentifierStringAdressens dør eller til højre, til venstre eller midt forPostOfficeBoxIdentifierInteger


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

Postboks. Feltet bruges ikke i dag

- input i feltet bliver ignoreret.

PostCodeIdentifierDistrictNameStringPostdistrikt (Bynavn) - input

RegionCode

String

Postnummer

Feltet bruges ikke - input i feltet bliver ignoreret.

CountryIdentificationCode

CoordETRS89z32NMeasure

CountryIdentificationCodeTypePostadressens landekode

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 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.
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 type

...

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

ElementData typeBeskrivelseSorIdentifierIntegerSOR entydig idEanLocationCodeIntegerLokationsnummerEanLocationCodeSystemSupplierIdIntegerLocationCode System Supplier nummerEntityNameStringSOR Enhedens navnProviderIdentifierStringSOR-enhedens ydernummerPharmacyIdentifierStringApoteknummerLocalCodeStringSOR-enhedens lokale kode. Attribut der frit kan benyttes af anvender organisationen.CvrNumberIdentifier

String

CVR nummer for SOR-enheden

GeographicalLocalisationId

ProductionUnitIdentifier

IntegerId på geografisklokalitet

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

ElementData typeBeskrivelseAllString

Angiver scope for søgning, hvor alle enheder returneres, dvs. fremsøgte enhed og alle underliggende enheder.

All ChildrenStringAngiver scope for søgning, hvor enhedens børn returneres, dvs. alle underliggende enheder, men ikke den fremsøgte enhed selv.Direct ChildrenStringAngiver scope for søgning, hvor enhedens direkte børn returneres, dvs. enheder som ligger direkte under fremsøgt enhed, men ikke den fremsøgte enhed selv.

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.

...

search_disabled

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.

...

Content

Space Tools

Page History

Versions Compared

Old Version 23

New Version Current

Key

MANGLER ENDELIG GODKENDELSE

Indholdsfortegnelse

Endpoint

Search Operation

Fælles

Sikkerhed

Namespaces

Eksterne typer

ArrayOfLong type

LocalAttributeCollectionType

EanLocationCodeState type

Fælles

Sikkerhed

Namespaces

Eksterne typer

ArrayOfLong

type

LocalAttributeCollectionType

EanLocationCodeState type

EanLocationCodeEntityType type

ArrayOfPrioritizedEntitySpecialityType

PrioritizedEntitySpecialityType

ArrayOfEanLocationCodes type

ElementData typeBeskrivelseReplacingInfoTypeeanLocationCodeListe af ReplacingInfoTypeListe af SOR-enheder...LongEn liste af lokationsnumre

ArrayOfEdiIdentifiers type

ArrayOfPrioritizedEntitySpecialityType

PrioritizedEntitySpecialityType

ArrayOfReplacingInfoType

AddressInformationType

Status type

AddressPostalType

Status type

SorEntity

SorEntity type

SearchParameters type

SearchLimit type

SearchScope type

ShakSorMap

Element Data type Beskrivelse
ReplacingInfoTypeeanLocationCode Liste af ReplacingInfoType Liste af SOR-enheder
...
Long En liste af lokationsnumre