getTreatmentRelationships

Met deze methode kan het behandelteam dat binnen Ysis betrokken is bij de patient worden opgevraagd.

Omdat behandelspecialisten in instellingen niet voor een specifieke afdeling of team werkzaam zijn, maar in Principe in de gehele instelling is Ysis gebasseerd op ‘behandelrelaties’ met disciplines. Meerdere mensen van een specifieke discipline kunnen betrokken zijn bij een patient. Dus er is sprake van behandelrelaties met disciplines, maar ook met personen. Zie voor meer informatie de Ysis help: https://help.gerimedica.nl/behandelrelatie/

Deze methode heeft twee toepassingen: Dit maakt het voor data-integraties mogelijk om op te vragen welke disciplines betrokken zijn bij deze patient. Hij kan daarnaast ook gebruikt worden om het volledige behandelteam te tonen. Voor deze laatste toepassing zijn ook de namen en functies van de behandelaren toegevoegd.

Zie de WSDL voor interface details

WSDL: https://acceptatie1-webservice.ysis.nl/20181008/mr/treatmentrelationships?wsdl

Enpoints:
Acceptance1: https://acceptatie1-webservice.ysis.nl/20181008/mr/treatmentrelationships
Acceptance2: https://acceptatie2-webservice.ysis.nl/20181008/mr/treatmentrelationships
Production: https://webservice.ysis.nl/20181008/mr/treatmentrelationships

Note :

• De namen van de Ysis gebruikers die een rol spelen bij een patient worden meegegeven, maar dit is enkel bedoelt om als informatie in uw systeem te tonen: dit is expliciet niet bedoelt om op te integreren. Integratie dient op basis van Discipline te gebeuren, ook in Ysis is het belangrijk dat er niet op basis van personen wordt gekoppeld: personen kunnen wisselen, de discipline blijft betrokken. Dit is ook de reden dat alleen de naam en functie wordt teruggegeven en niet de userID’s of personeelsnummers: deze namen zijn voor tonen only.
• ‘function’ is een optioneel veld in Ysis, houdt er rekening mee dat dit leeg kan zijn.
• Zie Selection values voor informatie hoe de disciplines in Ysis worden genoemd.

Possible error codes:

• Y001 – “BSN unknown”: Deze BSN is niet bekend voor deze organizatie in Ysis.
• Y004 – “BSN not valid”: BSN number is niet een valide BSN.

Example Request:
“Geef mij de behandelrelaties voor patiënt 123456782”

<soapenv:Body> 
   <ns:getTreatmentRelationshipsRequest> 
      <ns:bsn>123456782</ns:bsn> 
   </ns:getTreatmentRelationshipsRequest> 
</soapenv:Body>

Example Response:

correcte response

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <ns2:getTreatmentRelationshipsResponse xmlns:ns2="http://ysis.nl/webservices/medicalrecord/treatmentrelationships">
         <ns2:success>
            <ns2:healthProfessional>
               <ns2:discipline>DIETITIAN</ns2:discipline>
               <ns2:name>Diederik van Dijk</ns2:name>
               <ns2:function>Dietitian</ns2:function>
            </ns2:healthProfessional>
            <ns2:healthProfessional>
               <ns2:discipline>ERGOTHERAPIST</ns2:discipline>
               <ns2:name>Ellen Evertse</ns2:name>
               <ns2:function>Ergotherapist</ns2:function>
            </ns2:healthProfessional>
            <ns2:healthProfessional>
               <ns2:discipline>LOGOPEDIST</ns2:discipline>
               <ns2:name>Leo Landeweerd</ns2:name>
               <ns2:function>Speech therapist</ns2:function>
            </ns2:healthProfessional>
            <ns2:healthProfessional>
               <ns2:discipline>MEDICAL</ns2:discipline>
               <ns2:name>Barend Brandsma</ns2:name>
               <ns2:function>Specialist in geriatric medicine</ns2:function>
            </ns2:healthProfessional>
            <ns2:healthProfessional>
               <ns2:discipline>MEDICAL</ns2:discipline>
               <ns2:name>Another doctor</ns2:name>
            </ns2:healthProfessional>
         </ns2:success>
      </ns2:getTreatmentRelationshipsResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Functionele fout, moet uitgezocht worden door de aanroepende partij, maar herhalen van de aanroep heeft geen zin.

<SOAP-ENV: Body>
   <ns2:getTreatmentRelationships.....>
      <ns2:failure>
         <ns2:errorCode>Y004</ns2:errorCode>
         <ns2:message>Provided value '0380083003' is not a BSN</ns2:message>
      </ns2:failure>
   </ns2:getTreatmentRelationships>
</SOAP-ENV:Body>

Onbekend dossier

<SOAP-ENV:Body>
   <ns2:getTreatmentRelationshipsResponse xmlns:ns2="http://ysis.nl/webservices/medicalrecord/treatmentrelationships">
      <ns2:failure>
         <ns2:errorCode>Y001</ns2:errorCode>
         <ns2:message>Medical record for BSN '123456782' could not be found</ns2:message>
      </ns2:failure>
   </ns2:getTreatmentRelationshipsResponse>
</SOAP-ENV:Body>

Technische fout

<SOAP-ENV:Body> 
   <SOAP-ENV:Fault> 
      <fault code>SOAP-ENV: Client</fault code> 
      <faultstring xml: lang = "and"> Validation error </ faultstring> 
      <detail> 
         <jump-ws:ValidationError xmlns: jump-ws = "http://springframework.org/spring-ws"> cvc-complex-type.2.4.d: Invalid content was found starting with element 'ns: bsn'. No child element is expected at this point. </ Spring-ws: ValidationError> 
      </detail> 
   </SOAP-ENV:Fault> 
</SOAP-ENV:Body>

Aanroep zonder certificaat

<SOAP-ENV:Body>
   <SOAP-ENV:Fault>
      <faultcode>SOAP-ENV:Client</faultcode>
      <faultstring xml:lang="en">Client certificate was not sent with the request[Request: [remoteAddr=1.2.3.4, pathInfo=/20181008/mr/treatmentrelationships/, externalIpAddr=2.3.4.5]]</faultstring>
   </SOAP-ENV:Fault>
</SOAP-ENV:Body>