Page History
...
Notifikationsservicen udstilles på NSP'erne under adressenfølgende to adresser:
1) *\[miljøurl\]gos/service/notification*
...
Eksempel på endpoint i testmiljøerne (cNSP i TEST2-miljøet):
http://test2-cnsp.ekstern-test.nspop.dk:8080/gos/service/notification
Bemærk: NSP miljøernes loadbalancer router trafikken fra ovennævnte endpoint til brs-nsp/service/notification, idet dette er adressen i BRS.
Forespørgsel til Notifikationsservice
2) *\[miljøurl\]gos/service/notification20210921*
hvor den sætter operationen "notificationQuery" til rådighed. Hvis ServiceProviderName er angivet her, så anvendes det i forespørgslen til databasen, så data filtreres på baggrund af værdien af ServiceProviderName.
Eksempel på endpoint i testmiljøerne (cNSP i TEST2-miljøet):
http://test2-cnsp.ekstern-test.nspop.dk:8080/gos/service/notification20210921
Bemærk: NSP miljøernes loadbalancer router trafikken fra ovennævnte endpoint til brs-nsp/service/notification, idet dette er adressen i BRS.
Forespørgsel til Notifikationsservice
Notifikationsservicen kan forespørges på følgende to måder:
Uden angivelse af ServiceProviderName
Hvis ServiceProviderName ikke er angivet skal man ramme det første endpoint beskrevet i afsnit 2.4.1.
Body er defineret som et element af typen notificationQueryRequestBody, der er en complexType indeholdende en række felter. Betydningen af felterne er opsummeret i tabellen nedenfor:
notificationQueryRequestBody | |
|---|---|
Elementer | Beskrivelse |
Type | Typen af notifikationen. For en behandlingsrelation vil værdien være "BRS". |
SerialNumber | Et notifikationserienummer der bruges som afsæt i databasen. Kun notifikationer med et serienummer større end eller lig dette returneres. |
Man kan hente notifikationer der er "udstedt" til ens eget CVR nummer – altså notifikationer, hvis QueryableCvr matcher CVR nummeret i headeren ved kaldet til Notifikationsservicen.
Bemærk at CVR nummeret ikke indgår som en eksplicit parameter, da det er indeholdt i SOSI idkortet, der optræder i SOAP headeren.
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.
Eksempel
Følgende er et eksempel på et request til Notifikationsservice:
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<NotificationQueryRequestBody xmlns="http://nsi.dk/fmki20110601/notification">
<Type>BRS</Type>
<SerialNumber>1027</SerialNumber>
</NotificationQueryRequestBody> |
Med angivelse af ServiceProviderName
Hvis ServiceProviderName er angivet skal man ramme det andet endpoint beskrevet i afsnit 2.4.1.
Body er defineret som et element af typen notificationQueryRequestBody, der er en complexType indeholdende en række felter. Betydningen af felterne er opsummeret i tabellen nedenfor:
notificationQueryRequestBody | |
|---|---|
Elementer | Beskrivelse |
Type | Typen af notifikationen. For en behandlingsrelation vil værdien være "BRS". |
SerialNumber | Et notifikationserienummer der bruges som afsæt i databasen. Kun notifikationer med et serienummer større end eller lig dette returneres. |
| ServiceProviderName | Der kan være overlap mellem CVR numre, så derfor kan man bruge ServiceProviderName til yderligere filtrering. |
Man kan hente notifikationer der er "udstedt" til ens eget CVR nummer – altså notifikationer, hvis QueryableCvr matcher CVR nummeret i headeren ved kaldet til Notifikationsservicen.
...
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.
Eksempel
Følgende er et eksempel på et request til Notifikationsservice:
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<NotificationQueryRequestBody xmlns="http://nsi.dk/fmki20110601/notification">
<Type>BRS</Type>
<SerialNumber>1027</SerialNumber>
<ServiceProviderName>LAR service</ServiceProviderName>
</NotificationQueryRequestBody> |
...
TreatmentRelationRelayerData | |
|---|---|
Elementer | Beskrivelse |
OrganisationIdentifier | Organisationen inden for hvilken relationen skal findes. Feltet er struktureret og kan indeholde et sks, ydernummer, sor kode eller EAN-nummer. |
PatientCpr | Patientents CPR-nummer. |
HealthProfessionalCpr | Den sundhedsfagliges CPR-nummer. |
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). |
Eksempel
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<?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> |
...