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)

...

  • brs?wsdl
  • 20250301/brs?wsdl
  • notification?wsdl
  • notification20210921?wsdl
  • notification20220314?wsdl

Eksempel:

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

...

  • secure-wsdl/brs
  • secure-wsdl/20250301/brs
  • secure-wsdl/notification
  • secure-wsdl/notification20210921
  • secure-wsdl/notification20220314

Eksempel:

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

...

Code Block
languagexml
firstline1
titleBRS Request (2025-udgave)
linenumberstrue
collapsetrue
<brs:treatmentRelationRequestBody
    xmlns:brs="http://sundhedsdatastyrelsen.dk/behandlingsrelationer/2025/03/01/brs"
    xmlns:brs1="http://nsi.dk/fmki20110601/brs">
    <brs:OrganisationIdentifier>
        <brs1:HospitalOrganisationIdentifier>561010</brs1:HospitalOrganisationIdentifier>
    </brs:OrganisationIdentifier>
    <brs:PatientCpr>3112910017</brs:PatientCpr>
    <brs:HealthProfessionalCpr>1007707419</brs:HealthProfessionalCpr>
    <brs:RelationLookupTimeInterval>
        <brs1:start>2023-01-01T16:16:31+01:00</brs1:start>
        <brs1:end>2024-01-01T16:16:31+01:00</brs1:end>
    </brs:RelationLookupTimeInterval>
    <brs:AcceptableRelations>
        <brs1:Relation>E</brs1:Relation>
    </brs:AcceptableRelations>
    <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>
    <brs:AuthorisationIdentifier></brs:AuthorisationIdentifier>
    <brs:ServiceProvider>
        <brs1:Name>myServiceProviderName</brs1:Name>
        <brs1:Vendor>arosii</brs1:Vendor>
        <brs1:Version>snapshot</brs1:Version>
    </brs:ServiceProvider>
    <brs1<brs:IncludeAllRelations>true</brs1brs:IncludeAllRelations>
</brs:treatmentRelationRequestBody>

...

Eksempel

Code Block
firstline
languagexml
1titleResponse fra Notifikationservice 2022/03/14Notifikationsservice
linenumberstrue
collapsetrue
<?xml version="'1.0"' encoding="'UTF-8" '?>
<ns6<ns5:NotificationQueryResponseBody xmlns:ns6="http://nsi.dk/nsp/behandlingsrelationer/2022/03/14/notification"
                                   xmlns="http://www.w3.org/2000/09/xmldsig#">
    <ns6:Notifications>
        <ns6:Type>BRS</ns6:Type>
        <ns6:SerialNumber>1</ns6:SerialNumber>
        <ns6:ExternalReferenceId>efa4a5f4-2216-4f17-9010-be6eeeb36d0b</ns6:ExternalReferenceId>
        <ns6:QueryableCvr>46837428</ns6:QueryableCvr>
        <ns8:TreatmentRelationAlarmType xmlns:ns8="http://nsi.dk/fmki20110601/2022/03/14/brs"
                                        xmlns:ns6="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
            <ns8:TreatmentRelationFollowup>
                <ns8:TreatmentRelationRelayerData>
                    <ns8:OrganisationIdentifier>
                        <ns8:SORIdentifier>12345678</ns8:SORIdentifier>
                    </ns8:OrganisationIdentifier>
                    <ns8:PatientCpr>3112910017</ns8:PatientCpr>
                    <ns8:HealthProfessionalCpr>1007707419</ns8:HealthProfessionalCpr>
                    <ns8:RelationLookupTimeInterval>
                        <ns8:start>2022-01-01T11:05:34+01:00</ns8:start>
                        <ns8:end>2023-01-01T11:05:34+01:00</ns8:end>
                    </ns8:RelationLookupTimeInterval>
                </ns8:TreatmentRelationRelayerData>
                <ns8:TimeLimit>2016-01-01T11:05:34+01:00</ns8:TimeLimit>
                <ns8:ExternalReferenceId>efa4a5f4-2216-4f17-9010-be6eeeb36d0b</ns8:ExternalReferenceId>
                <ns8:QueryableCvr>46837428</ns8:QueryableCvr>
                <ns8:MinimumAcceptableRelation xmlns=""
                                               Relation="E"/>
                <ns8:RequestSource>
                    <ns8:TreatmentRelationRequestBody>
                        <ns8:OrganisationIdentifier>
                            <ns8:SORIdentifier>12345678</ns8:SORIdentifier>
                        </ns8:OrganisationIdentifier>
                        <ns8:PatientCpr>3112910017</ns8:PatientCpr>
                        <ns8:HealthProfessionalCpr>1007707419</ns8:HealthProfessionalCpr>
                        <ns8:RelationLookupTimeInterval>
                            <ns8:start>2022-01-01T11:05:34+01:00</ns8:start>
                            <ns8:end>2023-01-01T11:05:34+01:00</ns8:end>
                        </ns8:RelationLookupTimeInterval>
                        <ns8:TimeLimit>2016-01-01T11:05:34+01:00</ns8:TimeLimit>
                        <ns8:ExternalReferenceId>efa4a5f4-2216-4f17-9010-be6eeeb36d0b</ns8:ExternalReferenceId>
                        <ns8:MinimumAcceptableRelation xmlns=""
                                                       Relation="E"/>
                        <ns8:FollowupRelations>
                            <ns8:All>All</ns8:All>
                        </ns8:FollowupRelations>
                        <ns8:AuthorisationIdentifier/>
                        <ns8:ServiceProvider>
                            <ns8:Name>myServiceProviderName</ns8:Name>
                            <ns8:Version>snapshot</ns8:Version>
                            <ns8:Vendor>arosii</ns8:Vendor>
                        </ns8:ServiceProvider>
                    </ns8:TreatmentRelationRequestBody>
                </ns8:RequestSource>
                <ns8:TreatmentRelationFollowupSerialNumber>0</ns8:TreatmentRelationFollowupSerialNumber>
                <ns8:UniqueId>85baa673-dd6b-420e-acbf-fc41a25ce611</ns8:UniqueId>
            </ns8:TreatmentRelationFollowup>
            <ns8:ActualRelation xmlns=""
                                Relation="E"/>
            <ns8:RelationsBySources>
                <ns8:RelationBySource>
                    <ns8:Source>HENVISNING_SOR</ns8:Source>
                    <ns8:Relation>E</ns8:Relation>
                </ns8:RelationBySource>
                <ns8:RelationBySource>
                    <ns8:Source>REFHOST</ns8:Source>
                    <ns8:Relation>E</ns8:Relation>
                </ns8:RelationBySource>
                <ns8:RelationBySource>
                    <ns8:Source>LPR3</ns8:Source>
                    <ns8:Relation>E</ns8:Relation>
                </ns8:RelationBySource>
                <ns8:RelationBySource>
                    <ns8:Source>LPR</ns8:Source>
                    <ns8:Relation>E</ns8:Relation>
                </ns8:RelationBySource>
            </ns8:RelationsBySources>
        </ns8:TreatmentRelationAlarmType>
    </ns6:Notifications>
</ns6:NotificationQueryResponseBody
Code Block
languagexml
titleResponse fra Notifikationsservice
linenumberstrue
collapsetrue
<?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-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.