Connect Docsv4.2.0

Een resultaat is het begin van de controle.

Hysio verwerkt. Jouw systeem koppelt aan het dossier. De zorgprofessional beoordeelt de inhoud.

Wat je terugkrijgt

Een afgeronde sessie levert een verslag in Markdown. Is voor de werkstroom JSON ingesteld, dan kan daarnaast JSON beschikbaar komen. Controleer output_json_status voordat je die gebruikt. De structuur volgt de beschikbare layout of het ingestelde JSON-profiel; er is geen vast JSON-schema dat voor alle werkstromen geldt.

JSON, postbackbody (ingekort, fictief)

{
  "session_id": 1841,
  "idempotency_key": "partner-staging-test-001",
  "workflow": {
    "id": 12,
    "slug": "fictieve-werkstroom",
    "name": "Fictieve werkstroom"
  },
  "status": "completed",
  "output": "## Subjectief\nFictieve gesprekstekst.\n\n## Objectief\nFictieve observatie.",
  "output_json": {
    "subjectief": "Fictieve gesprekstekst.",
    "objectief": "Fictieve observatie."
  },
  "output_json_status": "ready",
  "completed_at": "2026-10-03T10:15:00+00:00"
}

De velden in output_json hangen af van de werkstroom en de layout. Dit voorbeeld toont geen bestaande koppeling met een dossiersysteem. Via GET /sessions/{session_id}/output lees je output, output_json, output_json_status, layout en completed_at. Die respons bevat geen session_id, idempotency_key, workflow of sessiestatus; bewaar de sessiereferentie zelf en lees de status via GET /sessions/{session_id}.

Van veld naar dossier

Een veld uit Hysio is een voorstel voor je dossier. Het wordt pas dossierinhoud nadat de zorgprofessional het heeft gecontroleerd.

Uit Hysio	In jouw systeem, vóór controle	In het dossier, na controle
`output_json.subjectief`	Ingevuld in het veld Subjectief, zichtbaar gemarkeerd als nog niet gecontroleerd	De zorgprofessional leest, past aan en slaat bewust op
Een veld zonder vaste plek in je dossier	Apart zichtbaar, niet automatisch in een klinisch veld	De zorgprofessional beslist of en waar het komt
Een leeg veld	Blijft leeg; vul het niet aan uit andere tekst	De zorgprofessional vult zelf aan
`output` (Markdown)	Het volledige verslag als leesbare bron naast de velden	Blijft beschikbaar ter controle

Mapping & meerdere kaarten

Hysio levert dezelfde uitvoer aan elk systeem. Welke sleutel in welk dossierveld komt, leg je vast in een mappingprofiel in je eigen systeem.

Exact koppelen. Koppel alleen sleutels die je kent. Raad niet op veldnamen en vul geen klinische context aan.
Versie bijhouden. Geef je profiel een versie. Verandert de layout of komt er een veld bij, pas het profiel dan bewust aan.
Onbekend blijft zichtbaar. Een onbekende sleutel of een ongeldige waarde toon je apart, als handmatige vervolgstap.
Aanvullen of vervangen, per kaart. Verdeelt jouw EPD een consult over meerdere schermen, zoals een anamnesekaart en een onderzoekskaart, leg dan per kaart vast of een veld bestaande tekst aanvult of vervangt. Vervang nooit stil wat de zorgprofessional al heeft ingevuld.
Lees dezelfde layout. Gebruik steeds hetzelfde beschikbare layoutnummer. Is de layoutlijst leeg, lees de uitvoer zonder layoutquery en beoordeel de JSON-status; zie stap 04 van de Quickstart.

De Demo-EPD laat met een fictieve casus zien hoe velden landen; de besloten Playground toont partnerprofielen in herkenbare dossierweergaven, met een toegangscode. Beide zijn demonstraties met fictieve gegevens; er wordt niet naar een echt dossiersysteem geschreven.

Vier stappen naar een gecontroleerde overname

Koppel aan het juiste contact

Controleer de handtekening, daarna sessie, werkstroom en je eigen referentie. Zo weet je bij welk zorgcontact het resultaat hoort.

Zet velden klaar

Vul de velden volgens je mappingprofiel. Houd lege en onbekende velden zichtbaar.

Laat controleren

Toon het verslag en de ingevulde velden aan de zorgprofessional, die leest, aanpast en aanvult.

Neem bewust over

Sla alleen op wat de zorgprofessional bevestigt. Overschrijf bestaande dossierinhoud nooit ongemerkt.

Een postback is geen goedkeuring. Een ontvangen resultaat betekent dat de verwerking klaar is, niet dat de inhoud is beoordeeld. Die beoordeling hoort bij de zorgprofessional, in jouw zorgproces.

Zoekresultaten