INLEIDING

GeriMedica’s Fhir interfaces volgen de HL7 FHIR standaard. Waar nodig ondersteunen wij de nederlandse extensies waar deze beschikbaar komen (voor nederland-specifieke velden zoals het BSN).

Uitgangspunten:

  • Toegang tot deze resources zijn op twee manieren mogelijk:
    • Met een oAuth token. Dit is bedoelt voor (PGO) partners en geeft toegang tot de resources van 1 specifieke zorginstelling / organisatie in Ysis.
    • Via het Nuts-Bolt eOverdracht protocol.

Data

De resources zijn gebaseerd op de specificaties op zibs.nl (eng). Voor de technische standaard volgen wij het Simplifier project dat Nictiz beschikbaar heeft gesteld (waar naar verwezen wordt vanuit zibs.nl).

Voor de gedetailleerde definities van de resources verwijzen wij graag naar deze documentatie.

Op deze pagina volgt nu een samenvatting van hoe de data in Ysis via FHIR resources wordt gemapt. Voor resources waar de individuele velden-mapping niet vanzelfsprekend is, is er een pagina met aanvullende details.
In het algemeen geldt dat voor het verwerken van ontvangen resources we alleen de velden overnemen die ook in Ysis bestaan. Overige informatie blijft wel altijd beschikbaar in het archief.

Administratieve gegevens
Patient
ZIBs (NL): Patient-v3.1, Contactpersoon-v3.1. Incl Huisarts
FHIR (HL7 v3.01): Patient
Ysis: Admin tabblad: Basisgegevens, BSN, Adres, Contactpersonen en Huisarts

Verzekering
ZIBs(NL): Betaler-v3.1
FHIR (HL7 v3.01): Coverage
Ysis: Admin-Verzekeringsgegevens
Opmerking: in de praktijk worden deze vaak via de COV check opgehaald: dit is naar ons idee beter dan via de overdracht aangezien data vanuit de bron het meest betrouwbaar is.

Medische gegevens
Allergieën

ZIBs(NL): AllergieIntolerantie-v3.2
FHIR (HL7 v3.01): AllergieIntolerantie
Ysis: Medisch-Basisgegevens-Allergieën
Opmerking: Voor het gecodeerd aanleveren van data wordt in Ysis een ‘auto-suggest’ beschikbaar gemaakt op basis van de meest gebruikte allergieën in Ysis. Niet gecodeerde allergieën worden wel gedeeld, maar dan alleen als ‘narrative’ (tekst).
Aanleiding voor het toepassen van een eigen selectielijst: binnen de Snomed codelijsten is er geen eenduidige ‘refset’ hiervoor omdat het zowel medische als niet-medische stoffen kan bevatten. Daarbij zijn de HPK codelijsten waar vanuit de Zibs.nl naar wordt verwezen allen beschikbaar voor gebruikers met een Z-index licentie.
In de FHIR data worden alle snomed-codes toegestaan (bron: MedMij/Nictiz kwalificaties). Maar het nadeel hiervan is dat er meer dan 300.000 codes zijn in Snomed die alles van fysieke objecten t/m procedures bevatten. Dit is niet gebruiksvriendelijk in de praktijk als ‘auto-suggest’ in Ysis, vandaar een subset van de ongeveer 500 meest gebruikte allergieën, daarmee is het mogelijk om meer dan 99.99% van alle gebruikte allergieën te coderen. De overige allergieën worden als tekst teruggegeven.

OMGEVINGEN

De verschillende omgevingen in Ysis hebben de volgende URL’s:

Voor toelichting over de functie van de verschillende omgevingen, zie hier. De verdere documentatie op deze pagina is gebaseerd op de Acceptatie 1 testomgeving voor integraties.

Opmerkingen:

  • Bij het direct benaderen op basis van een ResourceID wordt altijd maar 1 resource teruggegeven, maar bij gebruik van een ‘search’ parameter wordt een bundel teruggegeven dat meerdere resources bevatten
  • De resultaten worden in een json formaat teruggegeven.