getLocations – Ysis API Handleiding

Deze methode geeft terug welke locaties en afdelingen er voor deze organisatie zijn geconfigureerd in Ysis.

Opmerkingen:

Deze methode geeft altijd alleen de huidige status terug.
Er zijn geen parameters: aan de hand van de autorisatie kennen wij de organisatie. Deze methode geeft de complete lijst locaties en afdelingen
Ysis kent ook het begrip ‘Group’. De meeste van onze klanten gebruiken dit niet, maar hiermee is het mogelijk om meerdere gebruikersgroepen te definiëren in dezelfde organisatie met hun eigen gebruikers, locaties en afdelingen. Voor integratie kan in de meeste gevallen dit worden genegeerd en de locaties van de verschillende groepen als 1 lijst worden beschouwd.
Let op dat het WardID (afdelingsID) geen uniek nummer is, maar een volgnummer binnen de locatie. Als uniek ward identificatie met het locatieID en wardID samen gebruikt worden.

Zie de WSDL voor de exacte specificatie van de input en output.

WSDL: https://acceptatie1-webservice.ysis.nl/mr/query/locations/20160628/default.wsdl

Endpoints:

Acceptatie1: https://acceptatie1-webservice.ysis.nl/mr/query/locations/20160628
Acceptatie2: https://acceptatie2-webservice.ysis.nl/mr/query/locations/20160628
Productie: https://webservice.ysis.nl/mr/query/locations/20160628

Voorbeeld Requests:

“Geef mij alle afdelingen voor deze organisatie”

<soapenv:Body>
   <loc:getLocationsRequest/>
</soapenv:Body>

Voorbeeld Response

Correcte response

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <ns2:getLocationsResponse xmlns:ns2="http://ysis.nl/webservices/locations">
         <ns2:groups>
            <ns2:group>
               <ns2:groupId>21f73b6c-90b1-40c3-b7fd-4aa4b3df05c4</ns2:groupId>
               <ns2:groupName>GeriMedica1</ns2:groupName>
               <ns2:locations>
                  <ns2:location>
                     <ns2:locationId>029cc378-b01b-4af0-8b84-2830ca648d3e</ns2:locationId>
                     <ns2:locationName>InteraktContour</ns2:locationName>
                     <ns2:street>Bosweg</ns2:street>
                     <ns2:houseNumber>5</ns2:houseNumber>
                     <ns2:houseNumberAddition/>
                     <ns2:city>Nunspeet</ns2:city>
                     <ns2:zipCode/>
                     <ns2:country/>
                     <ns2:phoneNumber/>
                     <ns2:wards>
                        <ns2:ward>
                           <ns2:wardId>0</ns2:wardId>
                           <ns2:wardName>Regio Noord</ns2:wardName>
                           <ns2:targetAudience>NAH</ns2:targetAudience>
                           <ns2:bopz>false</ns2:bopz>
                           <ns2:awbz>false</ns2:awbz>
                           <ns2:declaredAsGP>false</ns2:declaredAsGP>
                           <ns2:extramural>false</ns2:extramural>
                           <ns2:primaryCare>false</ns2:primaryCare>
                        </ns2:ward>
                        <ns2:ward>
                           <ns2:wardId>1</ns2:wardId>
                           <ns2:wardName>Regio Zuid</ns2:wardName>
                           <ns2:targetAudience>NAH</ns2:targetAudience>
                           <ns2:bopz>false</ns2:bopz>
                           <ns2:awbz>false</ns2:awbz>
                           <ns2:declaredAsGP>false</ns2:declaredAsGP>
                           <ns2:extramural>false</ns2:extramural>
                           <ns2:primaryCare>false</ns2:primaryCare>
                        </ns2:ward>
                     </ns2:wards>
                  </ns2:location>
                  <ns2:location>
                     <ns2:locationId>0f132390-702f-4f15-a3ba-c16606639a05</ns2:locationId>
                     <ns2:locationName>Het Groene Hart</ns2:locationName>
                     <ns2:street>Hartstraat</ns2:street>
                     <ns2:houseNumber>1</ns2:houseNumber>
                     <ns2:houseNumberAddition/>
                     <ns2:city>Groenstad</ns2:city>
                     <ns2:zipCode/>
                     <ns2:country>Groenland</ns2:country>
                     <ns2:phoneNumber/>
                     <ns2:wards>
                        <ns2:ward>
                           <ns2:wardId>0</ns2:wardId>
                           <ns2:wardName>Het groene hart</ns2:wardName>
                           <ns2:targetAudience>ELV</ns2:targetAudience>
                           <ns2:bopz>true</ns2:bopz>
                           <ns2:awbz>false</ns2:awbz>
                           <ns2:declaredAsGP>false</ns2:declaredAsGP>
                           <ns2:extramural>true</ns2:extramural>
                           <ns2:primaryCare>false</ns2:primaryCare>
                           <ns2:ledgerAccount/>
                           <ns2:costCenter/>
                        </ns2:ward>
                     </ns2:wards>
                  </ns2:location>
               </ns2:locations>
            </ns2:group>
         </ns2:groups>
      </ns2:getLocationsResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Voorbeeld van de fout als het 'Organisatie' koppelvlak bij Gerimedica niet is geautoriseerd
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <SOAP-ENV:Fault>
         <faultcode>SOAP-ENV:Client</faultcode>
         <faultstring xml:lang="en">Access Denied</faultstring>
      </SOAP-ENV:Fault>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>