listAdvices

/in /door

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

Opmerkingen:

  • De wijziging ten opzichte van de vorige versie is dat het nu mogelijk is dat meerdere disciplines gezamenlijk een advies geven. Dit is in Ysis mogelijk vanaf versie 2.43 (juli 2020)
  • 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/20200204/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:text>Hier komt mijn advies te staan omtrent (Slikken)
Standaard worden hier de volgende punten benoemd:
Punt 1.fgrgffb
</ns3:text>
            <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:text>Oefening 1.
Doel:
Uitgangshouding:
Beweging:</ns3:text>
            <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/20200204" xmlns:ns4="http://ysis.nl/webservices/medicalrecord/usermessages/20200204">
        <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>