Page History

Versions Compared

Key

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

...

BRS benytter sin egen whitelist: register_notifications.whitelist i BRS databasen "register_notifications" og BRS kan kun kaldes af systemer der bruger et System-IDKort udstedt til forhåndsgodkendte CVR numre.

Ceritfikatoplysninger (Virksomheds-OCES) skal anvendes for at benytte behandlingsrelationsservice og organisationen bag anvendersystemet skal indgå en serviceaftale med Sundhedsdatastyrelsen, via NSP Operatøren.

...

Behandlingsrelationsservicen giver mulighed for at bestille opfølgninger gennem brug af notifikationsservicen. Da det forventes at denne option vil blive brugt af de fleste anvendere, er begge snitflader dokumenteret nedenfor.

Notifikation Applikationen vil returnere alle notifikationer, som er adresseret til kalderen. Notifikationer er fortløbende nummererede, og kalderen kan angive et offset, der sikrer at kun de nyeste notifikationer returneres. Hvis man ikke angiver offset kan man risikere at modtage de samme alarmer flere gange. Servicen sletter alarmer efter et centralt konfigurerbart tidsinterval.

Følgende punkter gælder for begge services:

...

Nedenfor ses en liste af typiske fejl der kan forekomme når en service kaldes. Fejl der returneres indeholder en fejlkode samt en fejltekst med yderligere detaljer. Teksten er ikke medtaget i tabellen nedenfor da den kan variere afhængig af hvad der gav anledning til fejlen.

Kode	Betydning
processing_problem	Som oftest validerings fejl, kan dog også opstå ved en generel fejl i servicen. Fault message vil indeholde yderligere beskrivelse af årsagen.
missing_required_header	En sikkerheds eller medcom header mangler i requestet
security_level_failed	Authentification level som angivet i headeren er ikke tilstrækkelig til at tilgå servicen.
invalid_idcard	Ugyldigt id-kort.
expired_idcard	Id-kortet er udløbet.
not_authorized	Manglende whitelisting (kontakt nsp operatøren for at blive whitelistet)

...

Path for WSDL uden security headers

[server-URL]/brs-nsp/service/[path]

Hvor path er en af følgende:

brs?wsdlbrs20220314
20250301/brs?wsdl
notification?wsdl
notification20210921?wsdl

notification20220314?wsdl

Eksempel:

http://localhost:8080/brs-nsp/service/brs?wsdl

...

secure-wsdl/brs
secure-wsdl/brs2022031420250301/brs
secure-wsdl/notification
secure-wsdl/notification20210921

secure-wsdl/notification20220314

Eksempel:

http://localhost:8080/brs-nsp/secure-wsdl/brs.wsdl

Anchor
_Toc477258564
_Toc477258564
Behandlingsrelationsservice

Versioner

Snitfladen til behandlingsrelationsservicen findes i to versioner, hver med sin egen version af treatmentRelation. Der er den oprindelige udgave, og den nye udgave fra 2025. I den nye udgave er ændringen at man får en liste af evidenskilder med tilbage i svaret.

Anchor
_Toc477258565
_Toc477258565
Endpoint

Behandlingsrelationsservicen kan tilgås i de decentrale NSP-miljøer (dNSP) under adressenadresserne

*\[miljøurl\]/brs-nsp/service/brs*
*\[miljøurl\]/brs-nsp/service/20250301/brs*

hvor den stiller operationen "treatmentRelation" til hvor den stiller operationen "treatmentRelation" til rådighed.

Denne operation tager en soap besked som input, indeholdende en header og en body. Headeren indeholder en WSSE header samt en Medcom header som specificeret i Den Gode Webservice (DGWS) version 1.0.1. SOSI idkortet i headeren skal være på niveau 3 og udstedt af SOSI-STS.

...

Hvis der derimod indenfor det angivne tidsrum opnås tilstrækkelig evidens, så de angivne kriterier er opfyldt, bliver der ikke genereret notifikationer.

Eksempel

Code Block

language	xml
firstline	1
title	BRS Request 2022/03/14(oprindelig snitflade)
linenumbers	true
collapse	true

<treatmentRelationRequestBody xmlns="httpshttp://nspopnsi.dk/nsp/behandlingsrelation/2022/03/14/fmki20110601/brs">
    <OrganisationIdentifier>
        <DoctorOrganisationIdentifier>561010<<HospitalOrganisationIdentifier>A12312</DoctorOrganisationIdentifier>HospitalOrganisationIdentifier>
    </OrganisationIdentifier>
    <PatientCpr>3112910017</PatientCpr>
    <HealthProfessionalCpr>1007707419</HealthProfessionalCpr>
    <RelationLookupTimeInterval>
        <start>2023-01-01T16:16:31+01:00</start>
        <end>2024-01-01T16:16:31+01:00</end>
    </RelationLookupTimeInterval>
    <MinimumAcceptableRelation>E</MinimumAcceptableRelation>
    <TimeLimit>2016-01-01T16:16:31+01<TimeLimit>2023-09-30T11:04:37+02:00</TimeLimit>
    <QueryableCvr>46837428</QueryableCvr>
    <Followup>false</Followup><AcceptableRelations>
    <AuthorisationIdentifier    <Relation>A</>Relation>
    <ServiceProvider></AcceptableRelations>
    <FollowupRelations>
    <Name>myServiceProviderName</Name>    <All>All</All>
    </FollowupRelations>
    <AuthorisationIdentifier>Aut</AuthorisationIdentifier>
    <ServiceProvider>
        <Version>snapshot<<Name>myServiceProviderName</Version>Name>
        <Vendor>arosii</Vendor>
        <Version>snapshot</Version>
    </ServiceProvider>
</treatmentRelationRequestBody>

Følgende er et eksempel på et request til BRS:

Code Block

language	xml
firstline	1
title	BRS Request (2025-udgave)
linenumbers	true
collapse	true

<treatmentRelationRequestBody<brs:treatmentRelationRequestBody
    xmlns:brs="http://nsisundhedsdatastyrelsen.dk/behandlingsrelationer/fmki20110601/brs"2025/03/01/brs"
    xmlns:brs1="http://nsi.dk/fmki20110601/brs">
  <OrganisationIdentifier>
  <brs:OrganisationIdentifier>
        <DoctorOrganisationIdentifier>132435</DoctorOrganisationIdentifier>
<brs1:HospitalOrganisationIdentifier>561010</brs1:HospitalOrganisationIdentifier>
    </brs:OrganisationIdentifier>
  <PatientCpr>0101601951</  <brs:PatientCpr>3112910017</brs:PatientCpr>
    <HealthProfessionalCpr>0101601803<<brs:HealthProfessionalCpr>1007707419</brs:HealthProfessionalCpr>
  <RelationLookupTimeInterval>  <brs:RelationLookupTimeInterval>
    <start>2013-09-30T00:00:00+02    <brs1:start>2023-01-01T16:16:31+01:00</brs1:start>
    <end>2013-10-25T23:59:00+02    <brs1:end>2024-01-01T16:16:31+01:00</brs1:end>
    </brs:RelationLookupTimeInterval>
  <TimeLimit>2013-09-30T11:04:37+02:00</TimeLimit>  <brs:AcceptableRelations>
  <QueryableCvr>31908574</QueryableCvr>
  <AcceptableRelations>
    <Relation>A<<brs1:Relation>E</brs1:Relation>
    <Relation>B</Relation>
  </brs:AcceptableRelations>
  <FollowupRelations>
    <All>All</  <brs:TimeLimit>2016-01-01T16:16:31+01:00</brs:TimeLimit>
    <brs:QueryableCvr>46837428</brs:QueryableCvr>
    <brs:FollowupRelations>
        <brs:All>All</brs:All>
    </brs:FollowupRelations>
  <AuthorisationIdentifier>DM712</  <brs:AuthorisationIdentifier></brs:AuthorisationIdentifier>
  <ServiceProvider>
  <brs:ServiceProvider>
        <Name>SJ<<brs1:Name>myServiceProviderName</brs1:Name>
    <Version>0.1</Version>
    <Vendor>Sundhed.dk</<brs1:Vendor>arosii</brs1:Vendor>
  </ServiceProvider>
</        <brs1:Version>snapshot</brs1:Version>
    </brs:ServiceProvider>
    <brs:IncludeAllRelations>true</brs:IncludeAllRelations>
</brs:treatmentRelationRequestBody>

...

treatmentRelationResponse
Elementer	Beskrivelse	Felt krævet
SufficientRelation	Om der var tilstrækkelig relation til at foretage opslaget ("beslutningen" foretages af BRS på basis af værdien i AcceptableRelations angivet i kaldet).	Nej
ActualRelation	Hvad de faktiske relationer er (på baggrund af kendt data fra eksterne registre).	Ja
RelationBySources	En liste over relationer efter kilder. Hver post er et par af datakilden, hvor relationen stammer fra, og den aktuelle relation fundet fra denne datakilde.	Ja
FollowupOrdered	Om en opfølgning er bestilt eller ej.	Nej
UniqueReferenceId	Et unikt referenceid, der kan bruges til at koble forespørgslen sammen med en eventuel senere notifikation. Indholdet af dette felt styres af BRS.	Ja
ExternalReferenceId	Værdien af feltet ExternalReferenceId fra forespørgslen. Hvis et sådant ikke var specificeret returneres et nyt generet id, forskelligt fra UniqueReferenceId.	Ja

Eksempel

Følgende er et eksempel eksempler på et response responses fra BRS:

Code Block

firstlinelanguage	1xml
title	Response fra BRS 2022/03/14(oprindelig snitflade)
linenumbers	true
collapse	true

<?xml version="1.0" encoding="UTF-8" ?>
<ns5<ns6:treatmentRelationResponseBody xmlns:ns5ns6="http://nsi.dk/fmki20110601/2022/03/14/brs"
                                   xmlns xmlns="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:ns2="http://www.w3.org/2000/09/xmldsig#" xmlns:ns3="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
>
    <ns5:SufficientRelation>true</ns5:SufficientRelation>
    <ns5:ActualRelation Relation="D"/>
    <ns5:RelationsBySources>
        <ns5:RelationBySource>
            <ns5:Source>HENVISNING_SOR</ns5:Source>
            <ns5:Relation>E</ns5:Relation>
        </ns5:RelationBySource>
        <ns5:RelationBySource>
            <ns5:Source>LPR</ns5:Source>
            <ns5:Relation>E</ns5:Relation>
        </ns5:RelationBySource>
        <ns5:RelationBySource>
            <ns5:Source>SSR</ns5:Source>
            <ns5:Relation>D</ns5:Relation>
        </ns5:RelationBySource>
        <ns5:RelationBySource>
            <ns5:Source>SIKREDE</ns5:Source>
            <ns5:Relation>D</ns5:Relation>
        </ns5:RelationBySource>
        <ns5:RelationBySource>
            <ns5:Source>REFHOST</ns5:Source>
            <ns5:Relation>D</ns5:Relation>
        </ns5:RelationBySource>
    </ns5:RelationsBySources>
    <ns5:FollowupOrdered>false</ns5:FollowupOrdered>
    <ns5:UniqueReferenceId>452eff59-6ef3-46b3-98e2-07df9c7ff50d</ns5:UniqueReferenceId>
    <ns5:ExternalReferenceId>97825e04-c6db-4894-bc8a-ee67070d4453</ns5:ExternalReferenceId>
</ns5:treatmentRelationResponseBody> xmlns:ns4="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:ns5="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns:ns7="http://rep.oio.dk/cpr.dk/xml/schemas/core/2005/03/18/" xmlns:ns8="http://rep.oio.dk/cvr.dk/xml/schemas/2005/03/22/">
	<ns6:SufficientRelation>true</ns6:SufficientRelation>
	<ns6:ActualRelations>
		<ns6:Relation>D</ns6:Relation>
	</ns6:ActualRelations>
	<ns6:FollowupOrdered>false</ns6:FollowupOrdered>
	<ns6:UniqueReferenceId>744bb53a-3c67-4a91-a3c1-eb91b9bc9e3e</ns6:UniqueReferenceId>
	<ns6:ExternalReferenceId>b1a35898-f699-4a76-a274-c005ee7d763a</ns6:ExternalReferenceId>
</ns6:treatmentRelationResponseBody>

Code Block

language	xml
firstline	1
title	Response fra BRS (2025-udgave)
linenumbers	true
collapse	true

<ns6:treatmentRelationResponseBody xmlns:ns6="http://nsi.dk/fmki20110601/brs" xmlns="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:ns2="http://www.w3.org/2000/09/xmldsig#" xmlns:ns3="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns4="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:ns5="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns:ns7="http://rep.oio.dk/cpr.dk/xml/schemas/core/2005/03/18/" xmlns:ns8="http://rep.oio.dk/cvr.dk/xml/schemas/2005/03/22/">
	<ns6:SufficientRelation>true</ns6:SufficientRelation>
	<ns6:ActualRelations>
		<ns6:Relation>D</ns6:Relation>
	</ns6:ActualRelations>
	<ns6:RelationsBySources>
		<ns6:RelationBySource>
			<ns6:Source>LPR</ns6:Source>
			<ns6:Relation>E</ns6:Relation>
		</ns6:RelationBySource>
		<ns6:RelationBySource>
			<ns6:Source>SIKREDE</ns6:Source>
			<ns6:Relation>D</ns6:Relation>
		</ns6:RelationBySource>
		<ns6:RelationBySource>
			<ns6:Source>HENVISNINGER</ns6:Source>
			<ns6:Relation>E</ns6:Relation>
		</ns6:RelationBySource>
		<ns6:RelationBySource>
			<ns6:Source>SSR</ns6:Source>
			<ns6:Relation>D</ns6:Relation>
		</ns6:RelationBySource>
	</ns6:RelationsBySources>
	<ns6:FollowupOrdered>false</ns6:FollowupOrdered>
	<ns6:UniqueReferenceId>bd80bca9-5f30-4e4c-b30f-0ebceb16ec24</ns6:UniqueReferenceId>
	<ns6:ExternalReferenceId>040865cd-6a2e-40b9-a574-e9a88e25d5d7<

Code Block

language	xml
title	Response fra BRS
collapse	true

<?xml version='1.0' encoding='UTF-8'?>
<ns6:treatmentRelationResponseBody xmlns="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:ns2="http://www.w3.org/2000/09/xmldsig#" xmlns:ns3="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns:ns4="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns5="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:ns6="http://nsi.dk/fmki20110601/brs" xmlns:ns7="http://rep.oio.dk/cvr.dk/xml/schemas/2005/03/22/" xmlns:ns8="http://rep.oio.dk/cpr.dk/xml/schemas/core/2005/03/18/">
  <ns6:SufficientRelation>false</ns6:SufficientRelation>
  <ns6:ActualRelations>
    <ns6:Relation>C</ns6:Relation>
  </ns6:ActualRelations>
  <ns6:FollowupOrdered>true</ns6:FollowupOrdered>
  <ns6:UniqueReferenceId>0044ba5a-8378-4d33-b128-03522ed26e85</ns6:UniqueReferenceId>
  <ns6:ExternalReferenceId>e4a4ab3f-3f7f-4e5d-a311-5942c14856b8</ns6:ExternalReferenceId>
</ns6:treatmentRelationResponseBody>

...

Notifikationsservicen kan forespørges på følgende to måder:

Uden Uden angivelse af ServiceProviderName

...

Code Block

language	xml
title	Request til Notifikationsservice
collapse	true

<NotificationQueryRequestBody xmlns="http://nsi.dk/fmki20110601/notification">
  <Type>BRS</Type>
  <SerialNumber>1027</SerialNumber>
</NotificationQueryRequestBody>

Med Med angivelse af ServiceProviderName

...

TreatmentRelationRelayerData
Elementer	Beskrivelse	Felt krævet
OrganisationIdentifier	Organisationen inden for hvilken relationen skal findes. Feltet er struktureret og kan indeholde et sks, ydernummer, sor kode eller EAN-nummer.	Ja
PatientCpr	Patientents CPR-nummer.	Ja
HealthProfessionalCpr	Den sundhedsfagliges CPR-nummer.	Ja
RelationLookupTimeInterval	Intervallet inden for hvilket relationen skal forefindes. Vil i første omgang være trukket ud fra id-kortet i den oprindelige treatmentRelationRequest (Intervallet sættes til id-kortets gyldighedsperiode).	Ja

Eksempel

...

firstline	1
title	Response fra Notifikationservice 2022/03/14
linenumbers	true
collapse	true

...

Ja
RelationLookupTimeInterval	Intervallet inden for hvilket relationen skal forefindes. Vil i første omgang være trukket ud fra id-kortet i den oprindelige treatmentRelationRequest (Intervallet sættes til id-kortets gyldighedsperiode).	Ja

Eksempel

Code Block

language	xml
title	Response fra Notifikationsservice
linenumbers	true
collapse	true

<?xml version='1.0' encoding='UTF-8'?>
<ns5:NotificationQueryResponseBody xmlns="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns2="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:ns3="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:ns4="http://www.w3.org/2000/09/xmldsig#" xmlns:ns5="http://nsi.dk/fmki20110601/notification" xmlns:ns6="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd">
  <ns5:Notifications>
    <ns5:Type>BRS</ns5:Type>
    <ns5:SerialNumber>1027</ns5:SerialNumber>
    <ns5:ExternalReferenceId>e4a4ab3f-3f7f-4e5d-a311-5942c14856b8</ns5:ExternalReferenceId>
    <ns5:QueryableCvr>31908574</ns5:QueryableCvr>
    <TreatmentRelationAlarmType:TreatmentRelationAlarmType xmlns:TreatmentRelationAlarmType="http://nsi.dk/fmki20110601/brs" xmlns="http://nsi.dk/fmki20110601/brs">
      <TreatmentRelationFollowup>
        <TreatmentRelationRelayerData>
          <OrganisationIdentifier>
            <DoctorOrganisationIdentifier>132435</DoctorOrganisationIdentifier>
          </OrganisationIdentifier>
          <PatientCpr>0101601951</PatientCpr>
          <HealthProfessionalCpr>0101601803</HealthProfessionalCpr>
          <RelationLookupTimeInterval>
            <start>2013-09-30T00:00:00+02:00</start>
            <end>2013-10-25T23:59:00+02:00</end>
          </RelationLookupTimeInterval>
        </TreatmentRelationRelayerData>
        <TimeLimit>2013-09-30T11:04:37+02:00</TimeLimit>
        <ExternalReferenceId>e4a4ab3f-3f7f-4e5d-a311-5942c14856b8</ExternalReferenceId>
        <QueryableCvr>31908574</QueryableCvr>
        <AcceptableRelations>
          <Relation>A</Relation>
          <Relation>B</Relation>
        </AcceptableRelations>
        <RequestSource>
          <TreatmentRelationRequestBody>
            <OrganisationIdentifier>
              <DoctorOrganisationIdentifier>132435</DoctorOrganisationIdentifier>
            </OrganisationIdentifier>
            <PatientCpr>0101601951</PatientCpr>
            <HealthProfessionalCpr>0101601803</HealthProfessionalCpr>
            <RelationLookupTimeInterval>
              <start>2013-09-30T00:00:00+02:00</start>
              <end>2013-10-25T23:59:00+02:00</end>
            </RelationLookupTimeInterval>
            <TimeLimit>2013-09-30T11:04:37+02:00</TimeLimit>
            <QueryableCvr>31908574</QueryableCvr>
            <AcceptableRelations>
              <Relation>A</Relation>
              <Relation>B</Relation>
            </AcceptableRelations>
            <FollowupRelations>
              <All>All</All>
            </FollowupRelations>
            <AuthorisationIdentifier>DM712</AuthorisationIdentifier>
            <ServiceProvider>
              <Name>SJ</Name>
              <Version>0.1</Version>
              <Vendor>Sundhed.dk</Vendor>
            </ServiceProvider>
          </TreatmentRelationRequestBody>
        </RequestSource>
        <TreatmentRelationFollowupSerialNumber>1123</TreatmentRelationFollowupSerialNumber>
        <UniqueId>0044ba5a-8378-4d33-b128-03522ed26e85</UniqueId>
      </TreatmentRelationFollowup>
      <ActualRelations>
        <Relation>C</Relation>
      </ActualRelations>
    </TreatmentRelationAlarmType:TreatmentRelationAlarmType>
  </ns5:Notifications>
</ns5:NotificationQueryResponseBody>

...

Se feks: STS - Guide til anvendere samt SEAL.JAVA 2 - Guide til anvendere og SEAL.NET Guide til anvendere.

Content

Space Tools

Versions Compared

Old Version 66

New Version Current

Key

Anchor
_Toc477258564
_Toc477258564
Behandlingsrelationsservice

Versioner

Anchor
_Toc477258565
_Toc477258565
Endpoint

Eksempel

Eksempel

Uden Uden angivelse af ServiceProviderName

Med Med angivelse af ServiceProviderName

Eksempel

Eksempel

Content

Space Tools

Page History

Versions Compared

Old Version 66

New Version Current

Key

Anchor_Toc477258564_Toc477258564Behandlingsrelationsservice

Versioner

Anchor_Toc477258565_Toc477258565Endpoint

Eksempel

Eksempel

Uden Uden angivelse af ServiceProviderName

Med Med angivelse af ServiceProviderName

Eksempel

Eksempel

Anchor
_Toc477258564
_Toc477258564
Behandlingsrelationsservice

Anchor
_Toc477258565
_Toc477258565
Endpoint