Edit profile

Page History

Versions Compared

Old Version 28

changes.mady.by.user Unknown User (ksoe)

Saved on 28-09-2022

compared with

New Version Current

changes.mady.by.user Thomas Klemmensen

Saved on 29-01-2025

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

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

...

Element	Data type	Beskrivelse
Output
SorEntity	SorEntity	Sor entity object svarende til sor entity record i SDM databasen
Status	Status	Status for hvordan kaldet gik

...

GetSorEntityByProvider Operation

Denne operation benyttes til , at foretage opslag på et SOR-Id for, at få returneret, hvilken SHAK-kode der evt. er relateret til den pågældende SOR-enhed.Operationen kan kaldes med en dato for, at fremfinde en historisk mapning. Hvis dato ikke er udfyldt returneres mapning som er gældende dagsdatoat fremsøge en SOR-enheder vha. ydernummer. Som input til operationen angives et ydernummer, som veksles om til flere SOR-Id ved kald til SORES. Disse SOR-Id bruges til at hente tilhørende på SOR-enheder.

Element	Data type	Optional	Beskrivelse
Input

SorIdentifier

ProviderIdentifier

integer

string

Ydernummer for de SOR-

Id der angiver den SOR-enhed der ønskes at fremsøge SHAK-mapning for.datedate yesHvis udfyldt returneres historisk mapning fra angivne dato. Hvis ikke udfyldt, så returneres data fra dagsdato.OutputElementData typeBeskrivelse SorShakMapResp ShakSorMap

enheder der skal hentes.

Element	Data type	Beskrivelse
Output
SorEntityList	List<SorEntity>	Liste af Sor entity objekter svarende til sor entity records i SDM databasen

Shak sor map objekt type


Status	Status	Status for hvordan kaldet gik

...

SorShakMap Operation

Denne operation benyttes til, at foretage opslag på et SHAKSOR-Id for, at få returneret, hvilke SORhvilken SHAK-enheder kode der evt. er knyttet relateret til SHAKden pågældende SOR-kodenenhed.

Operationen kan kaldes med en dato for, at fremfinde en historisk mapning. Hvis dato ikke er udfyldt returneres mapning som er gældende dagsdato.

Element	Data type	Optional	Beskrivelse
Input
ShakIdentifierSorIdentifier	string7integer	no	ShakSOR-Id som der angiver den SOR-enhed der ønskes fremsøgt mapninger at fremsøge SHAK-mapning for.
date	date	yes	Hvis udfyldt returneres historisk mapning fra angivne dato. Hvis ikke udfyldt, så returneres data fra dagsdato.

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

...

ShakSorMap Operation

Denne operation benyttes til, at foretage opslag på et SHAK-Id for, at få returneret, hvilke SOR-enheder der er knyttet til SHAK-koden.

Operationen kan kaldes med en dato for, at fremfinde en historisk mapning. Hvis dato ikke er udfyldt returneres mapning som er gældende dagsdatoSearch operation er ikke taget i brug endnu. Kald af denne service operation vil returnere en fejl.

SearchparametersSearchParametersType

Element	Data type	Optional	Beskrivelse
Input
ShakIdentifier	string7	no	Søge parameter
SearchLimit	SearchLimitType	yes (default search scope = ALL)	Søge begrænsning
Shak-Id som der ønskes fremsøgt mapninger for.
date	date	yes	Hvis udfyldt returneres historisk mapning fra angivne dato. Hvis ikke udfyldt, så returneres data fra dagsdato.

SorEntitiesSorEntitylistEn liste over de SOR enheder

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

Fælles

Sikkerhed

Succesfuld anvendelse af SORLS service kræver, at der medsendes gyldig sikkerhedsbillet (SOSI Idkort) fra STS i kaldet.

...

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	String	CVR nummer for SOR-enheden
ProductionUnitIdentifier	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

...

OrganisationalLevelCode

ElementData typeBeskrivelseSorIdentifierIntegerSOR entydig idEanLocationCodeIntegerLokationsnummerEanLocationCodeSystemSupplierIdIntegerLocationCode System Supplier nummerEntityNameStringSOR Enhedens navnProviderIdentifierStringSOR-enhedens ydernummerPharmacyIdentifierStringApoteknummerLocalCodeStringSOR-enhedens lokale kode. Attribut der frit kan benyttes af anvender organisationen.CvrNumberIdentifierStringCVR nummer for SOR-enhedenGeographicalLocalisationIdIntegerId på geografisklokalitet

SearchLimit type

...

Long	SOR kode på organisational
OrganisationalLevelName	String	Navn på organisationen fra OrganisationalLevelCode

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.

Element	Data type	Beskrivelse
SorShakMapId	Integer	Unik ID for mapningsrecord
ShakId	String	Shak-kode der mappes
SorId	Integer	SorId der mappes.
IsDirectSorShakMapping	Boolean	True, hvis SHAK-koden er knyttet direkte til SOR-id I SOR. False, hvis SHAK-koden kommer fra en ovenliggende SOR-enhed.
ShakIdsDirectSorId	Integer	SOR-id for den enhed, som SHAK-koden er direkte knyttet til. Kun angivet, hvis der er en indirekte mapning mellem "ShakId" og "SorId". Indeholder null, hvis der er en direkte mapning mellem "Shakid og SorId"
FromDate	Date	Mapping recorden er gældende fradato. Der er en ny record hver gang der enten er en ændring i SHAK eller SOR. Dvs, denne dato genereres ud fra SOR-fra-dato, SHAK-fra-dato eller nedarvede SOR-fra-datoer.
ToDate	Date	Mapping recorden gældende til dato.
UpdatedAt	Datetime	Tidspunkt for genereringen af mapnings recorden.
SorType	String	Tekstværdi for SOR-type, enten IE, SI, OE
SorEntityName	String	SOR Enhedens navn
SorEntityTypeId	Integer	Teknisk nøgle for EntityType (SNOMED Concept Id)
SorEntityTypeName	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.
SorFirstFromDate	Date	Første dato hvorfra SOR enheden er gældende.
SorFromDate	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 attributten.
SorToDate	Date	Situation 1: ændringer til SOR enhed og hvor SOR enhed ikke lukkes Dato for sidste dag hvor en SOR række er aktiv, og 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.
SorUpdatedAt	Datetime	Ændringstidspunkt for SOR-enhed
SorParentSorId	Integer	Sor-Id for hierarkisk forælder entitet. Null for SorType institutionsejer (IE)
SorInstitutionOwnerSorId	Integer	Sor-Id der angiver institutionsejer (IE), dvs. øverste niveau i SOR hierarkiet for den enhed
SorInstitutionOwnerEntityName	String	Angiver navnet på enhedens institutionsejer. Er altid udfyldt.
SorInstitutionOwnerEntityTypeId	Integer	Teknisk nøgle (SNOMED Concept Id) der angiver typen af institutionsejer.
SorInstitutionOwnerEntityTypeName	String	Angiver hvilken type enheden har - enten privat, regional, kommunal, stat.
SorHealthInstitutionSorId	Integer	Sor-Id der angiver enhedens sundhedsinstitution, dvs. næstøverste niveau i SOR hierarkiet for den enhed. Er udfyldt for sortyperne SI og OE. Null hvis det er en IE sortype.
SorHealthInstitutionEntityName	String	Angiver navnet på enhedens sundhedsinstitution.
SorHealthInstitutionEntityTypeId	Integer	Teknisk Id (SNOMED Concept Id) der angiver typen af sundhedsinstitution.
SorHealthInstitutionEntityTypeName	String	Angiver typen af sundhedsinstitution fx tandlæge klinik, plejehjem, hospital
SorEanLocationCodeState	String	Enumeration af stadier. Kan have en af følgende værdier: Undefined None Inherited Own
SorEanLocationCode	Integer	SOR-enhedens lokationsnummer
SorGeographicalLocalisationId	Integer	Id for geografisk lokalitet til opslag i tabellen GeoLocalisation
SorGeographicalLocalisationName	String	Navn på den geografiske lokalitet
SorVisitingAddressInheritanceIndicator	Boolean	True hvis besøgsadressen er arvet via SOR-hierarkiet. Værdier: True/False.
SorVisitingAddressStreetName	String	Besøgsadressens vejnavn
SorVisitingAddressStreetCode	String	Besøgsadressens vejkode til vejregister i CPR
SorVisitingAddressStreetBuildingId	String	Besøgsadressens husnummer
SorVisitingAddressFloorId	String	Besøgsadressens etage
SorVisitingAddressSuiteId	String	Besøgsadressens dør eller til højre, til venstre eller midt for
SorVisitingAddressAdditionalAddressInfo	String	Besøgsadressens ekstra adresseinformation: Information der specificerer fysiske adresser.
SorVisitingAddressPostCodeId	String	Besøgsadressens postnummer
SorVisitingAddressDistrictName	String	Besøgsadressens postdistriktsnavn (Bynavn)
SorVisitingAddressMunicipalityCode	String	Besøgsadressens kommunekode, der identificerer en kommune i myndighedstabellerne i Det Centrale Personregister
SorVisitingAddressRegionCode	String	Besøgsadressens regionskode
SorVisitingAddressCountryIdCode	String	Besøgsadressens landekode. Pt indeholder SOR kun danske adresser.
SorVisitingAddressCoordETRS89z32NMeasure	Decimal	Besøgsadressens GPS koordinater (ETRS89, north)
SorVisitingAddressCoordETRS89z32EMeasure	Decimal	Besøgsadressens GPS koordinater (ETRS89, east)
SorPrioritizedEntitySpeciality1Id	Integer	Teknisk (SNOMED Concept Id) nøgle til enhedens klinisk hovedspeciale
SorPrioritizedEntitySpeciality1Name	String	Angiver enhedens hovedspeciale
SorPrioritizedEntitySpeciality2Id	Integer	Teknisk (SNOMED Concept Id) nøgle til klinisk speciale
SorPrioritizedEntitySpeciality2Name	String	Angiver enhedens bispeciale
SorPrioritizedEntitySpeciality3Id	Integer	Teknisk (SNOMED Concept Id) nøgle til klinisk speciale
SorPrioritizedEntitySpeciality3Name	String	Angiver enhedens bispeciale
SorPrioritizedEntitySpeciality4Id	Integer	Teknisk (SNOMED Concept Id) nøgle til klinisk speciale
SorPrioritizedEntitySpeciality4Name	String	Angiver enhedens bispeciale
SorPrioritizedEntitySpeciality5Id	Integer	Teknisk (SNOMED Concept Id) nøgle til klinisk speciale
SorPrioritizedEntitySpeciality5Name	String	Angiver enhedens bispeciale
SorPrioritizedEntitySpeciality6Id	Integer	Teknisk (SNOMED Concept Id) nøgle til klinisk speciale
SorPrioritizedEntitySpeciality6Name	String	Angiver enhedens bispeciale
SorPrioritizedEntitySpeciality7Id	Integer	Teknisk (SNOMED Concept Id) nøgle til klinisk speciale
SorPrioritizedEntitySpeciality7Name	String	Angiver enhedens bispeciale
SorPrioritizedEntitySpeciality8Id	Integer	Teknisk (SNOMED Concept Id) nøgle til klinisk speciale
SorPrioritizedEntitySpeciality8Name	String	Angiver enhedens bispeciale
ShakDateFrom	Date	Gyldig fra dato for SHAK enhed
ShakDateTo	Datetime	Gyldig til dato for SHAK enhed
ShakUpdatedAt	Datetime	Ændringstid for SHAK enhed
ShakName	String	Shak Navn
ShakInstitutionTypeId	String	ID for SHAK institutiontype
ShakInstitutionTypeName	String	SHAK institutionstype fra "sygehusniveau"
ShakOwnerTypeId	String	ID for SHAK owner type
ShakOwnerTypeName	String	SHAK owner type, f.eks. regional, privat, statslig...
ShakMainSpecialityId	String	ID for SHAK hovedspeciale.
ShakMainSpecialityName	String	SHAK hovedspeciale
ShakSpeciality1Id	String	ID for Shak bispeciale 1
ShakSpeciality1Name	String	SHAK bispeciale 1
ShakSpeciality2Id	String	ID for Shak bispeciale 2
ShakSpeciality2Name	String	SHAK bispeciale 2
ShakSpeciality3Id	String	ID for Shak bispeciale 2
ShakSpeciality3Name	String	SHAK bispeciale	2
OrganisationalLevelCode	Long	SOR kode på organisational
OrganisationalLevelName	String	Navn på organisationen fra OrganisationalLevelCode

Fejlkoder

De nedenstående er hvilke denne applikation definerer:

MedCom fault code	Fault string	Beskrivelse
search_disabled	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 fra backenden, eller dens underliggende services.

...

Content

Space Tools