listAdvices (nieuw, nu met opmaak!)

/in /door

Met deze methode kunnen de actuele adviezen van de patiënt worden opgevraagd. Binnen Ysis kan elke discipline één of meerdere adviezen opstellen. Adviezen kunnen ook gedeeld worden tussen disciplines. Deze methode geeft alle adviezen voor een patiënt samen in één lijst terug.

Opmerkingen:

  • De wijziging ten opzichte van de vorige versie is dat de opmaak die nu in Ysis mogelijk is, wordt teruggegeven.
    Het advies wordt teruggegeven als html, met alle opmaak (inclusief tabellen en afbeeldingen en styling) als embedded html. De data is base64 encoded in de XML.
  • Alleen de huidige gepubliceerde adviezen worden teruggegeven.
  • Ysis is in staat notificaties te sturen wanneer dit wijzigt in Ysis. Dit moet wel specifiek worden afgestemd, ontworpen en gebouwd per pakket.
  • Bij technische, infrastructurele of security issues wordt een SOAP error teruggegeven. Als inhoudelijk de parameters in de request niet kloppen wordt een foutcode in de Response teruggegeven, zie onder de mogelijke fouten).


Zie de WSDL voor de exacte specificatie van de input en output.
WSDL:  https://acceptatie1-webservice.ysis.nl/20221121/mr/advice/default.wsdl
Endpoints:

Mogelijke foutcodes:

  • Y001 – “BSN unknown”: Voor deze BSN is er in Ysis voor deze organisatie geen dossier.
  • Y004 – “BSN not valid”: BSN nummer is geen valide BSN.

Voorbeeld Requests:
“Geef alle adviezen voor patient 123456782.”

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

Voorbeeld Responses
correcte response

<SOAP-ENV:Body>
    <ns3:listAdvicesResponse xmlns:mr=...>
        <ns2:status>OK</ns3:status>
        <ns3:advice>
            <ns3:adviceId>ad709af2-a53a-437a-b866-769c3a0a2bfc</ns3:adviceId>
            <ns3:discipline>MEDICAL</ns3:discipline>
            <ns3:discipline>PHYSIOTHERAPIST</ns3:discipline>
            <ns3:discipline>ERGOTHERAPIST</ns3:discipline>
            <ns3:title>Slikadvies</ns3:title>
            <ns3:html>PHATmFhbTogbWV2cm91dyBNdy4g---ennogveelmeer---ZlbTogMTUgZmVicnV</ns3:html>
            <ns3:date>2017-04-07</ns3:date>
            <ns3:author>J Klaassen</ns3:author>
            <ns3:authorEmployeeNumber>45435345</ns3:authorEmployeeNumber>
            <ns3:authorEmployeeFunction/>
        </ns3:advice>
        <ns3:advice>
            <ns3:adviceId>3afdf5e6-5c76-4501-a815-d2f514bd7877</ns3:adviceId>
            <ns3:discipline>PHYSIOTHERAPIST</ns3:discipline>
            <ns3:title>Oefenschema Fysiotherapie</ns3:title>
            <ns3:html>PHATmFhbTogbWV2cm91dyBNdy4g---ennogveelmeer---ZlbTogMTUgZmVicnV</ns3:html>
            <ns3:date>2017-04-06</ns3:date>
            <ns3:author>D Smith</ns3:author>
            <ns3:authorEmployeeNumber>1234567</ns3:authorEmployeeNumber>
            <ns3:authorEmployeeFunction>Klinish psycholoog</ns3:authorEmployeeFunction>
        </ns3:advice>
    </ns3:listAdviceResponse>
</SOAP-ENV:Body>

Functionele fout, moet onderzocht worden door de aanroepende partij, herhalen van de aanroep is niet zinvol.

<SOAP-ENV:Body>
    <ns4:listAdvicesResponse xmlns:mr="http://ysis.nl/webservices/medicalrecord" xmlns:ns3="http://ysis.nl/webservices/medicalrecord/20221121" xmlns:ns4="http://ysis.nl/webservices/medicalrecord/usermessages/20221121">
        <ns3:status>FAILED</ns3:status>
        <ns4:errorCode>Y001</ns4:errorCode>
        <ns4:errorText>BSN unknown</ns4:errorText>
    </ns4:listAdvicesResponse>
</SOAP-ENV:Body>

Technische fout

<SOAP-ENV:Body>
    <SOAP-ENV:Fault>
        <faultcode>SOAP-ENV:Server</faultcode>
        <faultstring xml:lang="en">een technische onvoorziene foutsituatie</faultstring>
    </SOAP-ENV:Fault>
</SOAP-ENV:Body>