getMessage

/in /door

Deze methode geeft 1 bericht terug van een patiënt op basis van het ID.
Hij kan gebruikt worden om op basis van een berichtID uit Ysis een specifiek bericht op te halen (bijvoorbeeld in reactie op een ‘notify’ die vanuit Ysis wordt ontvangen).

Opmerkingen:

  • Alleen Berichten die in Ysis gericht zijn aan de ‘Verzorging’ worden teruggegeven: berichten verkeer tussen disciplines in Ysis zijn niet vanuit de API te bevragen. Andere berichten zullen een fout geven dat het ID niet bestaat (zie onder)
  • reportID is optioneel. Indien het bericht in Ysis is aangemaakt vanuit een rapportage wordt hiernaar verwezen (Deze rapportage kan vervolgens middels de methode getReport worden opgehaald). Als in Ysis een ‘los’ bericht wordt aangemaakt is dit veld leeg. Een bericht is wel altijd gerelateerd aan een BSN.
  • 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/medicalrecord/query/usermessages/20170214?wsdl

Endpoints:

Mogelijke foutcodes:
Y001 – Patient unknown
Y002 – Identifier unknown

Voorbeeld Requests:
Voorbeeld voor gebruik in ‘Notify’/’Fetch’ real-time interfaces.
“Geef het bericht met ID 1234 voor Patient 123456782”

    <soapenv:Body>
        <ns:getMessageRequest>
            <ns:bsn>039131622</ns:bsn>
            <ns:messageId>ad709af2-a53a-437a-b866-769c3a0a2bfc</ns:messageId>
        </ns:getMessageRequest>
    </soapenv:Body>

Voorbeeld Responses

Correcte response:
    <SOAP-ENV:Body>
        <ns4:getMessageResponse xmlns:mr="http://ysis.nl/webservices/medicalrecord" xmlns:ns3="http://ysis.nl/webservices/medicalrecord/20170209" xmlns:ns4="http://ysis.nl/webservices/medicalrecord/usermessages/20170214">
            <ns3:status>OK</ns3:status>
            <ns4:message>
                <ns4:messageId>ad709af2-a53a-437a-b866-769c3a0a2bfc</ns4:messageId>
                <ns4:subject>Dhr. A Amstel, Locatie1/extramuraal</ns4:subject>
                <ns4:text>bericht #1</ns4:text>
                <ns4:creationDate>2017-04-07T17:07:48.000+02:00</ns4:creationDate>
                <ns4:author>Adminuser VCD Vinova</ns4:author>
                <ns4:authorDiscipline>MEDICAL</ns4:authorDiscipline>
                <ns4:authorEmployeeNumber>45435345</ns4:authorEmployeeNumber>
                <ns4:authorEmployeeFunction/>
                <ns4:reportId>3</ns4:reportId>
            </ns4:message>
        </ns4:getMessageResponse>
    </SOAP-ENV:Body>

Bij een functionele fout: dit moet onderzocht worden door de aanroepende partij, herhalen van de aanroep heeft geen zin
    <SOAP-ENV:Body>
        <ns4:getMessageResponse xmlns:mr="http://ysis.nl/webservices/medicalrecord" xmlns:ns3="http://ysis.nl/webservices/medicalrecord/20170209" xmlns:ns4="http://ysis.nl/webservices/medicalrecord/usermessages/20170214">
            <ns3:status>FAILED</ns3:status>
            <ns4:errorCode>Y004</ns4:errorCode>
            <ns4:errorText>BSN not valid</ns4:errorText>
        </ns4:getMessageResponse>
    </SOAP-ENV:Body>
Technische fout
    <SOAP-ENV:Body>
       <SOAP-ENV:Fault>
          <faultcode>SOAP-ENV:Server</faultcode>
         <faultstring xml:lang="en">Some technical exception message</faultstring>
       </SOAP-ENV:Fault>
    </SOAP-ENV:Body>