FHIR-gegevensuitwisseling — Stap-voor-stap handleiding

In deze handleiding leest u hoe u medische gegevens exporteert als FHIR R4 JSON, verstuurt naar een extern zorgsysteem, inkomende FHIR-berichten ontvangt en alle uitwisselingen bewaakt via het uitwisselingslogboek.

Vereisten

• De rechtenset Medical FHIR moet aan uw gebruikersaccount zijn toegewezen (naast de standaard rechtenset Medical Dossier).
• Medisch FHIR Instelling moet zijn geconfigureerd voordat u gegevens verstuurt of ontvangt. Zie de stappen hieronder.
• Er moet minimaal één Medisch Dossier met onderzoeken en observaties bestaan voor het betreffende contact.
• Er moet een actieve overeenkomst en geldige endpoint-inloggegevens zijn met de externe FHIR-partij (bijv. Enovation myhealthConnect).

Stap 1 — Medisch FHIR Instelling configureren

1. Gebruik de zoekfunctie (Alt+Q) en open Medisch FHIR Instelling.
2. Vul de velden in zoals afgesproken met uw integratiepartner.

Aanbevolen minimale configuratie

Vervang de voorbeeld-identifier-systeem-URI's door de URI's die zijn afgesproken met uw integratiepartner.

Stap 1a — OAuth 2.0 clientgeheim opslaan (indien van toepassing)

Als het authenticatietype OAuth 2.0 of Bearer Token is, sla het clientgeheim dan veilig op:

1. Selecteer op de pagina Medisch FHIR Instelling de actie Clientgeheim instellen.
2. Voer de geheime waarde in het gemaskeerde veld in.
3. Selecteer OK. Het geheim wordt versleuteld opgeslagen in geïsoleerde opslag en wordt nooit naar de database geschreven.

Het veld Clientgeheim is ingesteld toont Ja ter bevestiging.

Beveiligingsopmerking: Het clientgeheim is versleuteld en per bedrijf opgeslagen. Het kan na invoer niet meer worden teruggelezen. Gebruik Clientgeheim instellen opnieuw om het te vervangen. Gebruik Clientgeheim wissen om het te verwijderen.

Stap 2 — Een FHIR Bundle exporteren vanuit een Medisch Dossier

Gebruik dit om een FHIR R4 JSON Bundle te genereren met alle medische gegevens van een contact (alle onderzoeken, observaties en klinische notities).

1. Open de Medisch Dossier Kaart voor het betreffende contact.
2. Open in de actiebalk de groep FHIR.
3. Selecteer FHIR Bundle exporteren.
4. De gegenereerde FHIR JSON wordt getoond in een dialoogvenster. U kunt deze kopiëren voor inspectie of testen.

Als Valideren voor verzenden is ingeschakeld in de instellingen, wordt de JSON gevalideerd voordat deze wordt getoond. Validatiefouten worden als melding weergegeven.

Stap 3 — Een FHIR Bundle versturen naar een extern endpoint

1. Open de Medisch Dossier Kaart voor het betreffende contact.
2. Open in de actiebalk de groep FHIR.
3. Selecteer FHIR Bundle versturen.
4. Een bevestigingsdialoog toont de doelendpoint-URL. Bevestig om door te gaan.
5. De bundle wordt verstuurd naar de geconfigureerde Uitgaand endpoint-URL.
6. Een succesbericht wordt getoond als de externe server het verzoek accepteert (HTTP 2xx). Bij een mislukt verzoek wordt een foutmelding getoond met de HTTP-statuscode.

Controleer het FHIR-uitwisselingslogboek na het versturen om de HTTP-statuscode en het antwoord te verifiëren.

Stap 4 — Een Onderzoek Bundle exporteren of versturen

Gebruik dit om één onderzoekssessie met gekoppelde observaties en klinische notities te versturen, zonder de volledige dossierhistorie op te nemen.

1. Open de Medisch Onderzoek Kaart voor het betreffende onderzoek.
2. Open in de actiebalk de groep FHIR.
3. Selecteer FHIR Onderzoek Bundle exporteren om de JSON te genereren en te tonen.
4. Selecteer FHIR Onderzoek Bundle versturen om deze rechtstreeks naar het geconfigureerde endpoint te versturen.

Stap 5 — Het uitwisselingslogboek bewaken

Alle verstuurde en ontvangen FHIR-berichten worden vastgelegd in het Medisch FHIR-uitwisselingslogboek wanneer logboekregistratie is ingeschakeld.

Het logboek openen

• Vanuit de Medisch Dossier Kaart: FHIR-groep → FHIR-uitwisselingslogboek (gefilterd op het huidige contact).
• Via zoeken: open Medisch FHIR-uitwisselingslogboek direct om alle vermeldingen te bekijken.

Logboekkolommen

Logboekacties

Stap 6 — Inkomende FHIR-berichten ontvangen

Externe partijen kunnen FHIR R4 JSON versturen naar Dynamics Dossier via het standaard Business Central API-endpoint:

POST /api/qteam/medical/v1.0/companies({company-id})/fhirInboundMessages
Content-Type: application/fhir+json
Authorization: Bearer {token}

De body moet een geldige FHIR R4 JSON-payload bevatten (Bundle, Observation, Encounter, etc.).

Ingediende berichten worden opgeslagen in de lijst Inkomende FHIR-berichten met status Nieuw en zijn nog niet verwerkt.

Geef de API-endpoint-URL en authenticatie-instructies aan uw integratiepartner als onderdeel van het onboardingproces.

Stap 7 — Inkomende berichten verwerken

Inkomende berichten met status Nieuw moeten worden verwerkt om hun inhoud toe te wijzen aan de interne medische records.

1. Gebruik zoeken om Medische FHIR Inkomende Berichten te openen.
2. Selecteer het te verwerken bericht.
3. Verwerking verloopt automatisch via het geplande verwerkingsmechanisme, of kan handmatig worden gestart afhankelijk van de configuratie.

Na verwerking verandert de status in:

Als de verwerking mislukt omdat het FHIR-codeersysteem in het inkomende bericht niet wordt herkend, wordt de ruwe payload opgeslagen in het Uitwisselingslogboek voor beoordeling. Neem contact op met uw integratiepartner om de gebruikte codeersystemen te verifiëren.

Probleemoplossing

Zie ook:

• Medische dossiers
• Authenticatie
• FHIR-integratie