HysioConnect v4.2.0

Connect Docsv4.2.0

Van staging naar productie

Wat er moet kloppen voordat je een productiekey krijgt: techniek, zorg en afspraken.

Zo verloopt de acceptatie

Je krijgt een productiekey pas na een gezamenlijke acceptatie.

  1. Testen op staging. Je doorloopt de Quickstart met alleen fictieve gegevens: minstens één gehoste sessie van begin tot eind en één /run.
  2. De checklist doorlopen. Je toont per punt hieronder aan dat het klopt. Hysio kijkt mee.
  3. Een acceptatieverslag. Eén document met de uitkomst per punt, met datum en sessie-ID's, zonder echte gegevens.
  4. Gezamenlijke acceptatie. Samen stellen we vast dat de techniek, de zorgwerkwijze en de afspraken over gegevens kloppen.
  5. Een aparte productiekey. Pas daarna volgt een productiekey. Productie gebruik je niet om te testen.

De precieze afspraken leggen we per koppeling vast.

Techniek

Deze punten toon je aan op staging, met fictieve gegevens.

Technische checklist

#Wat moet kloppenHoe je het aantoont
T1Je API-key staat alleen op je server, versleuteld; nooit in browsercode, logs of URL's. Staging en productie hebben elk een eigen key.Je beschrijft opslag en toegang.
T2Je controleert X-Hysio-Signature over de onbewerkte bytes, vóór je de JSON leest, met een vergelijking in constante tijd.Een geldige postback wordt aangenomen, een vervalste geweigerd.
T3Je bewaart het postback_secret van elke sessie versleuteld bij je eigen referentie.Je beschrijft de opslag.
T4Je postback-endpoint is een publiek HTTPS-adres zonder redirect en antwoordt pas met 2xx na duurzame opslag.Een postback komt binnen, wordt opgeslagen en krijgt 2xx.
T5Je verwerkt elke postback één keer per session_id; Hysio kan een postback opnieuw bezorgen.Je laat dezelfde postback twee keer bezorgen: het dossier krijgt één voorstel.
T6Per nieuwe sessie maak je een nieuwe, willekeurige Idempotency-Key. Dezelfde key gebruik je alleen om een onduidelijke start te herhalen. Nooit een patiënt-, dossier- of recordnummer en geen persoonsgegevens. Je controleert Idempotency-Replayed en koppelt een herhaalde respons nooit aan een ander dossier.Je laat de code zien die de key maakt en de header controleert.
T7Na de handtekeningcontrole vergelijk je session_id, de werkstroom en je eigen referentie met het dossier dat open staat. Pas dan zet je iets klaar.Een testcasus waarin het dossier wisselt: het voorstel landt niet bij de verkeerde cliënt.
T8Je handelt 401, 403, 404, 409, 422, 429 (met Retry-After) en 5xx af zoals de foutentabel zegt, zonder eindeloze poll-lus.Je wekt elke fout één keer op, waar dat kan.
T9Is output_json_status niet ready, dan toon je het Markdown-verslag. Markdown blijft leidend.Een testcasus met een werkstroom zonder JSON.
T10Komt er geen postback, dan lees je status en uitvoer zelf of vraag je een nieuwe bezorging aan.Je laat een postback mislukken en herstelt.
T11Je opent redirect_url ongewijzigd, inclusief het deel na #, en behandelt de link als geheim. Hij geldt 72 uur.Je laat de flow zien.
T12Een API-key is 365 dagen geldig. Je spreekt af wie hem vernieuwt en hoe hij wordt ingetrokken.De vervaldatum staat in de afspraken.
T13Je legt de ophaaldatum en een hash van het OpenAPI-contract vast.De hash staat in het acceptatieverslag.
T14Je gebruikt alleen werkstromen die voor de API aanstaan en waar je account toegang toe heeft.De lijst met werkstromen, zonder patiëntgegevens.

Samen met jou controleert Hysio ook dat een key geen sessie kan lezen die niet via de API is gestart, dat een upload op een stap zonder upload wordt geweigerd en dat een postback-adres in een intern netwerk wordt geweigerd.

Zorg

De zorgprofessional controleert elk voorstel en slaat zelf op.

Checklist voor de zorgwerkwijze

#Wat moet kloppenHoe je het aantoont
Z1Hysio vult velden als voorstel. De zorgprofessional klikt zelf op Opslaan; zonder die klik komt niets definitief in het dossier.Een schermopname in je testomgeving.
Z2Velden met een beslissing, zoals diagnose, indicatie, behandelplan en screeningsbesluit, blijven handmatig.In je veldmapping staan ze als handmatig gemarkeerd.
Z3Staat er al tekst in een veld, dan kiest de zorgprofessional: behouden of bewust vervangen. Nooit een stille overschrijving.Een testcasus met een gevuld veld.
Z4Minstens één intake en één consult met een fictieve cliënt, zoals de casus in het Demo-dossier.Het verslag in het acceptatieverslag, zonder echte gegevens.
Z5De zorgprofessional ziet of de overdracht gelukt is, en wat te doen als het niet lukt.Een schermopname van gelukt en mislukt.
Z6Je handleiding vraagt de zorgprofessional elk voorstel te controleren, waar nodig te verbeteren en zelf vast te stellen.De tekst uit je handleiding.

Afspraken en support

Voordat echte gegevens gaan, liggen de rollen, de gegevens en de support op papier.

Afspraken over gegevens en support

  • Rol per route. De praktijk is verwerkingsverantwoordelijke. Wie verwerker en wie subverwerker is, hangt af van de route en de klantrelatie; dat leggen we schriftelijk vast.
  • Afbakening per koppeling. Vóór de eerste verwerking staan opdrachtgever, verantwoordelijke, gegevens, functies, ontvanger, rechten, bewaartermijn en einde op papier.
  • Verwerkersovereenkomst. Voordat er echte gegevens gaan, ligt er voor elke praktijk een verwerkersovereenkomst: met Hysio bij een directe klantrelatie, of met jou als verwerker en Hysio als subverwerker. Lees de verwerkersovereenkomst van Hysio in het TrustCentre.
  • Contactpersonen. Vast staat wie de techniek bewaakt en wie de zorgwerkwijze.
  • Eerste en tweede lijn. Afgesproken is wie vragen van zorgprofessionals beantwoordt en wanneer Hysio meekijkt.
  • Meldroutes. Beide partijen kennen de route voor een storing, een datalek en een kwetsbaarheid.

Verder lezen