getBopz

/in /door

Deze methode geeft de huidige juridische informatie van de patient terug. Dit bevat de wilsbekwaamheid, Juridische status, en 1 of meer VBM’s (vrijheidsbeperkende maatregel)
Zie de WSDL voor details

Note: deze methode komt beschikbaar in de 2.34 release van Ysis in april 2018.
Hij is beschikbaar op de acceptatie1 omgeving, maar nog niet op onze productieomgeving.
De oude methode ‘getBopzFullStatus’ blijft nog beschikbaar tot maart 2019.
Wijzigingen t.o.v. de huidige methode ‘getBopzFullStatus’:

  • Nieuw field voor ‘voorschrijver’ ( <ns2:prescriber> )
  • ID for elke VBM om het makkelijker te maken deze te mappen op bestaande data bij wijzigingen.
  • De <ns2:leaveAgreement> is nu onderdeel van de sectie <ns2:legalStatus>
  • nieuwe optie voor <ns2:mentalCapacity>/<ns2:capacity> en <ns2:legalStatus>/<ns2:status> : ‘Niet vastgesteld’. (‘NOT_DETERMINED’).
  • Standaard functionele foutcodes toegevoegd.
  • Dit koppelvlak geplaatst in een eigen endpoint met een eigen wsdl

WSDL: https://acceptatie1-webservice.ysis.nl/20180110/mr/bopz/default.wsdl
Endpoints:
Acceptatie1: https://acceptatie1-webservice.ysis.nl/20180110/mr/bopz
Acceptatie2: https://acceptatie2-webservice.ysis.nl/20180110/mr/bopz
Productie: https://webservice.ysis.nl/20180110/mr/bopz
Opmerkingen:

  • De evaluatiedatum is alleen gevuld als al een evaluatie heeft plaatsgevonden.
  • Alleen de huidige actieve VBM’s worden teruggegeven, geen historie.
  • Deze methode maakt gebruik van een aantal vaste selectielijsten (enums). Zie hier voor een lijst van sleutels en visuele weergave in Ysis
  • Ysis is in staat notificaties te sturen wanneer er iets rond de Bopz wijzigt in Ysis. Dit moet wel specifiek worden afgestemd, ontworpen en gebouwd per pakket, neem daarvoor contact met ons op.
  • 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).

Mogelijke foutcodes:

  • Y001 – “Medical record for BSN ‘123456782’ could not be found”: Voor deze BSN is er in Ysis voor deze organisatie geen dossier.
  • Y004 – “Provided value ‘317473253’ is not a BSN”: BSN nummer is geen valide BSN.

Voorbeeld Requests:
“Geef de juridische gegevens van patient 123456782”

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

Voorbeeld Responses
correcte response

<SOAP-ENV:Body>
   <ns2:getBopzResponse xmlns:ns2="http://ysis.nl/webservices/medicalrecord/bopz/20180110">
      <ns2:success>
         <ns2:bopz>
            <ns2:mentalCapacity>
               <ns2:determinedDate>2013-11-08</ns2:determinedDate>
               <ns2:capacity>NOT_DETERMINED</ns2:capacity>
               <ns2:comment>is in staat te beslissen over kleine zaken in hier en nu</ns2:comment>
            </ns2:mentalCapacity>
            <ns2:legalStatus>
               <ns2:admissionDate>2013-11-08</ns2:admissionDate>
               <ns2:status>INVOLUNTARY_VM</ns2:status>
               <ns2:leaveAgreement>Verlofafspraken</ns2:leaveAgreement>
               <ns2:expiryDate>2018-03-01</ns2:expiryDate>
            </ns2:legalStatus>
            <ns2:currentRestrictiveMeasures>
               <ns2:measure>
                  <ns2:id>bedc38cc-b788-4e17-9d3c-4321c3f672c7</ns2:id>
                  <ns2:problem>valt uit bed</ns2:problem>
                  <ns2:goal>goede nachtrust</ns2:goal>
                  <ns2:action>ballendeken</ns2:action>
                  <ns2:usage>USAGE_FIXED_TIMES</ns2:usage>
                  <ns2:name>Ballendeken</ns2:name>
                  <ns2:description>ballendeken toepassen</ns2:description>
                  <ns2:opinionPatient>Kan het niet schelen</ns2:opinionPatient>
                  <ns2:opinionRepresentative>Is goed</ns2:opinionRepresentative>
                  <ns2:isTreatmentPlanAvailable>true</ns2:isTreatmentPlanAvailable>
                  <ns2:isMentionedInTreatmentPlan>false</ns2:isMentionedInTreatmentPlan>
                  <ns2:isAgreedUpon>true</ns2:isAgreedUpon>
                  <ns2:isPatientRefusingRestrictiveMeasure>false</ns2:isPatientRefusingRestrictiveMeasure>
                  <ns2:status>VBM_AKKOORD</ns2:status>
                  <ns2:startDate>2018-01-14</ns2:startDate>
                  <ns2:prescriber>GeriMedica Admin</ns2:prescriber>
               </ns2:measure>
               <ns2:measure>
                  <ns2:id>da02ea92-3cd8-4e8d-a863-8e9c263168fd</ns2:id>
                  <ns2:problem>onrustig in bed 's nachts, geen ziekte inzicht, kan niet zelfstandig lopen. Ervaart veiligheid aan bedhekken (gaat er tegenaan liggen, zoekt steun)</ns2:problem>
                  <ns2:goal>letsel tgv val voorkomen, veiligheid</ns2:goal>
                  <ns2:action>bedhekken 1 kant hoog, bed tegen de muur</ns2:action>
                  <ns2:usage>USAGE_ALL_TIMES</ns2:usage>
                  <ns2:usageComment>eens per week</ns2:usageComment>
                  <ns2:name>Bedhekken omhoog</ns2:name>
                  <ns2:opinionPatient>geen verbale mening</ns2:opinionPatient>
                  <ns2:opinionRepresentative>familie wil graag bedhekken hoog is bang dat mw uit bed valt</ns2:opinionRepresentative>
                  <ns2:isTreatmentPlanAvailable>true</ns2:isTreatmentPlanAvailable>
                  <ns2:isMentionedInTreatmentPlan>false</ns2:isMentionedInTreatmentPlan>
                  <ns2:isAgreedUpon>true</ns2:isAgreedUpon>
                  <ns2:isPatientRefusingRestrictiveMeasure>false</ns2:isPatientRefusingRestrictiveMeasure>
                  <ns2:status>VBM_AKKOORD</ns2:status>
                  <ns2:startDate>2013-11-08</ns2:startDate>
                  <ns2:evaluationDate>2018-01-17</ns2:evaluationDate>
                  <ns2:prescriber>Adrienne Otten</ns2:prescriber>
               </ns2:measure>
            </ns2:currentRestrictiveMeasures>
         </ns2:bopz>
      </ns2:success>
   </ns2:getBopzResponse>
</SOAP-ENV:Body>

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

<SOAP-ENV:Body>
   <ns2:getBopzResponse xmlns:ns2="http://ysis.nl/webservices/medicalrecord/bopz/20180110">
      <ns2:failure>
         <ns2:errorCode>Y004</ns2:errorCode>
         <ns2:message>Provided value '317473253' is not a BSN</ns2:message>
      </ns2:failure>
   </ns2:getBopzResponse>
</SOAP-ENV:Body>

Technische fout

<SOAP-ENV:Body>
   <SOAP-ENV:Fault>
      <faultcode>SOAP-ENV:Client</faultcode>
      <faultstring xml:lang="en">Validation error</faultstring>
      <detail>
         <spring-ws:ValidationError xmlns:spring-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>