Zoekresultaten

Connect Docsv4.2.0
Van verslag naar dossier
Je dossiersysteem zet het verslag klaar en de zorgprofessional bepaalt wat in het dossier komt.
Wat je terugkrijgt
Een afgeronde sessie levert een Markdown-verslag en kan JSON opleveren als de werkstroom daarvoor is ingesteld.
Fictieve postback en resultaatvelden
Controleer output_json_status voordat je JSON gebruikt. De structuur volgt de beschikbare layout of het ingestelde JSON-profiel. Elke werkstroom kan een eigen schema hebben.
{
"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",
"tokens_used": 2140,
"completed_at": "2026-10-03T10:15:00+00:00"
}tokens_used is een technische verbruiksteller van de verwerking; voor het dossier heb je hem niet nodig. 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 wordt pas onderdeel van je dossier 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
Leg in je mappingprofiel vast welke sleutel bij welk dossierveld hoort.
Mapping, layout en meerdere kaarten
Hysio levert dezelfde uitvoer aan elk dossiersysteem.
- 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 je dossiersysteem 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.
Het Demo-dossier laat met een fictieve casus zien hoe velden landen; de besloten Playground toont profielen voor je dossier in herkenbare dossierweergaven, met een toegangscode. Beide zijn demonstraties met fictieve gegevens; er wordt niet naar een echt dossiersysteem geschreven.
Vier stappen voor dossierovername
- 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.
