Functioneel Ontwerp BgZ (op basis van zibs release 2017)

Uit informatiestandaarden
< MedMij:Vprepub-2020.01
Versie door Pieter Edelman (overleg | bijdragen) op 26 jan 2021 om 09:00 (Release notes toevoegen voor KCR januari 2021)
Naar navigatie springen Naar zoeken springen


Patient Summary (BgZ)
Naar medmij.nl
AfsprakenstelselFunctioneelTechnischAfspraken-Functioneel-Technisch


1 Inleiding

1.1 Algemeen

Deze pagina beschrijft het functioneel ontwerp voor de Basisgegevensset Zorg binnen MedMij.

De Basisgegevensset Zorg, ofwel BgZ, is de minimale set van patiëntgegevens die specialisme, ziektebeeld en beroepsgroep overstijgend relevant is en die van belang is voor de continuïteit van zorg en is in Nederland door 'Registratie aan de Bron' gedefinieerd. Deze set aan patiëntgegevens wordt door alle zorgverleners hetzelfde vastgelegd. Hierdoor wordt uitwisseling van deze gegevens mogelijk gemaakt. De BgZ is gespiegeld aan de Europese Patient Summary.

De bekende use cases voor het uitwisselen van de BgZ zijn gericht op uitwisseling tussen zorgverleners voor spoedeisende hulp of ongeplande zorg. Tot op heden is uitwisseling vanuit het perspectief van de patiënt niet beschreven. Het doel van deze pagina is om de uitwisseling van de BgZ met de patiënt toe te voegen.

1.2 Doelgroep

De doelgroep voor deze pagina wijkt niet af van de algemene doelgroep van de MedMij functionele ontwerpen.

1.3 Kaders en uitgangspunten

1.3.1 Richtlijn

Geen nadere specificatie, anders dan genoemd in de algemene inleiding van de MedMij functionele ontwerpen.

1.3.2 Infrastructuur

Geen nadere specificatie, anders dan genoemd in de algemene inleiding van de MedMij functionele ontwerpen.

1.3.3 Geografische reikwijdte

Geen nadere specificatie, anders dan genoemd in de algemene inleiding van de MedMij functionele ontwerpen.

1.4 Kwalificatie

1.4.1 Introductie

Op deze informatiestandaard is een Nictiz kwalificatie van toepassing. Kwalificatie vindt plaats per systeemrol.

Kwalificatiescripts en meer informatie over de kwalificatie is te vinden via de betreffende paragraaf op de kwalificatiepagina.

1.4.2 Specifieke informatie over deze kwalificatie

Specifieke informatie over de kwalificatie van de transacties 'Raadplegen BgZ' en 'Beschikbaarstellen BgZ' is te vinden in Toelichting Kwalificatie BgZ.

2 Use Cases

2.1 Use case 1: Raadplegen Basisgegevensset Zorg in persoonlijke gezondheidsomgeving

2.1.1 Doel en relevantie

Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in gegevens uit de Basisgegevensset Zorg (BgZ) die over henzelf gaan.

2.1.2 Domein

Basisgegevensset Zorg in het domein van zorgaanbieders en patiënten.

2.1.3 Context

Het gaat om het elektronisch en gestructureerd beschikbaar maken van de BgZ vanuit een zorgaanbiederssysteem (XIS) naar een persoonlijke gezondheidsomgeving (PGO). Deze pagina bevat (verwijzingen naar) beschrijvingen van:

  • informatie,
  • bedrijfsrollen (actoren),
  • proces,
  • systemen,
  • systeemrollen,
  • transactiegroepen en transacties, inclusief de inhoud van deze transacties.

De beschrijving is infrastructuur-onafhankelijk.

2.1.4 Informatie

De BgZ op basis van zibs release 2017 bestaat uit een selectie van 28 zibs. Deze zibs vormen samen een verzameling van patiëntgegevens die minimaal nodig is om patiënten continuïteit van zorg te kunnen bieden.

Deze use case gebruikt de structuur van 18 secties die is aangebracht in BgZ 2017. Hierin zijn de onderdelen gegroepeerd waaruit de BgZ is opgebouwd. Deze secties komen sterk overeen met de secties van CCR/CCD en maken het o.a. mogelijk om in de technische implementatie (bv FHIR) structuur aan te brengen. In de MedMij FHIR implementatie gids staat de technische representatie van de betreffende zibs in zogenaamde FHIR profielen. In dit overzicht is te zien welk FHIR profiel bij welke zib hoort.

Voor het gebruik van codestelsel geldt de algemene richtlijn.

2.1.4.1 Raadplegen BgZ

Er zijn geen specifieke filtermogelijkheden (query parameters) gedefinieerd voor de BgZ. Bij het raadplegen van de BgZ wordt om alle gegevens behorende bij de patiënt gevraagd.

2.1.4.2 Beschikbaarstellen BgZ

Informatie-elementen in de BgZ staan hieronder. Deze informatie is ook in een nieuw tabblad te openen. Bij het beschikbaarstellen van de BgZ worden alle beschikbare gegevens behorende bij de patiënt beschikbaargesteld.

2.1.5 Bedrijfsrollen

Deze use case onderscheidt twee bedrijfsrollen, namelijk de Patiënt en de Zorgaanbieder zoals te zien in onderstaande tabel.

Bedrijfsrol Activiteit
Patiënt (PGO) Wil de eigen BgZ raadplegen
Zorgaanbieder (XIS) Stelt de BgZ beschikbaar

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

Activiteitendiagram Raadplegen BgZ

2.1.6 Procesbeschrijving

2.1.6.1 Patient journey - Thomas van Beek

De 'patient journey' van Thomas van Beek beschrijft enkele momenten waarop je als patiënt zijnde inzicht kan of zou willen hebben in zijn/haar BgZ.

Voor zijn afstuderen verhuist Thomas 9 maanden naar Groningen. Hij gaat daar bij een heel leuk bedrijf stagelopen. Om het voor hem makkelijk te maken en omdat hij een arts dicht in de buurt wil hebben, schrijft hij zich in bij het ziekenhuis in Groningen. Hiervoor moet het ziekenhuis in Amsterdam alle gegevens van Thomas overdragen aan het ziekenhuis in Groningen. Zo weet de nieuwe arts van Thomas precies wat het verloop van de diabetes is. Thomas is zelf eigenlijk wel nieuwsgierig naar zijn medische gegevens die verstuurd worden. In zijn PGO vindt hij de belangrijkste gegevens die over hem bekend zijn.

2.1.6.2 Proces

Het stuk van het proces waar het in deze use case omgaat is:

  • Het systeem van een zorgaanbieder (XIS) stelt de BgZ van de patiënt beschikbaar aan het systeem van een patiënt (PGO).

Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.

2.1.6.2.1 Preconditie

De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van de BgZ tussen het betreffende XIS en het eigen PGO.

De BgZ, of een gedeelte van de BgZ, welke de persoon wil inzien, bestaat en de zorgaanbieder (XIS) wil deze beschikbaarstellen.

Soms zijn er valide redenen om de BgZ, of gedeeltes daarvan, tijdelijk nog niet beschikbaar te stellen aan de patiënt. Bijvoorbeeld omdat de zorgverlener deze eerst zelf wil interpreteren en/of er eerst met de patiënt over wil spreken.
Een patiënt kan steeds zelf het initiatief nemen om de BgZ op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze use case beschrijving geen verschil.
2.1.6.2.2 Proces stappen
Stap Omschrijving
01 Het systeem van de patiënt (PGO) raadpleegt het systeem van de zorgaanbieder (XIS) voor de BgZ van de patiënt.
02 Het systeem van de zorgaanbieder (XIS) maakt (een deel van) de BgZ beschikbaar voor de patiënt.
03 De patiënt gebruikt de persoonlijke gezondheidsomgeving (PGO) om de BgZ in te zien.
2.1.6.2.3 Post conditie

De persoon kan de Basisgegevensset Zorg inzien via een persoonlijke gezondheidsomgeving (PGO).

2.1.7 Systemen & Systeemrollen

Zowel patiënt als zorgaanbieder maken ieder gebruik van een informatiesysteem:

  • PGO (patiënt)
  • XIS (zorgaanbieder)

Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de BgZ van zorgaanbieder naar de patiënt.

Systeem Naam systeemrol Systeemrolcode Omschrijving
PGO BGZRaadplegend MM--BZR-FHIR Raadplegen BgZ bij zorgaanbieder
XIS BGZBeschikbaarstellend MM--BZB-FHIR Beschikbaarstellen BgZ aan de patiënt

Zie ook onderstaande afbeelding.

Componenten diagram

2.1.8 Transacties & Transactiegroepen

Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

Transactiegroep Transactie Systeemrolcode Systeem Bedrijfsrol Technisch
BgZ (PULL) Raadplegen BgZ MM--BZR-FHIR]] PGO Patiënt BgZ in FHIR
Beschikbaarstellen BgZ MM--BZB-FHIR]] XIS Zorgaanbieder

2.1.9 Use case diagram

Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

Use case diagram inzien BgZ

3 Functionaliteit

Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

4 Verantwoordelijkheid voor informatie

Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

5 Afschermen van gegevens

Er zijn geen afspraken over het afschermen van gegevens.

6 Infrastructuur

Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

7 Referenties

Auteur(s) Titel Versie Datum Bron Organisatie
- Basisgegevensset Zorg - 12-08-2019 Alles over de BgZ Registratie aan de bron (RadB)
- BgZ - specificatie gebaseerd op zibs release 2017 1.1 19-04-2018 BgZ - specificatie gebaseerd op zibs release 2017 Registratie aan de bron (RadB)
Albert-Jan Spruyt & Jan A. Hazelzet Alles wat je wilt (moet) weten over CCR/CCD 1.0 13-09-2012 Alles wat je wilt (moet) weten over CCR/CCD Nictiz

8 Release notes

In onderstaande tabel staan de wijzigingen voor deze informatiestandaard. Zie de Ontwerpen landingspagina voor wijzigingen die op alle informatiestandaarden van toepassing zijn.

Release Versie BITS issue Omschrijving
2020.01 - November 2020 3.0.5 MM-1624 On the BgZ FHIR IG, the term "BgLZ" was used by mistake, this has been changed to the correct term "BgZ".
2020.01 - November 2020 3.0.4 MM-1408 Added a known issue on HCIM FunctionalOrMentalStatus to the BgZ and GGZ FHIR IG's. NL-CM:4.26.6 StatusDate in the profile FunctionalOrMentalStatus is mapped on period.start, but is a date nonetheless, this will be fixed in a future release. Also see MM-1570.
MM-1382 The profile on HCIM AdvanceDirective contained a mapping to BasicElements::Author on the Consent.consentingParty element. However, the HCIM does not specify an author. Therefore, this mapping has been removed.
2020.01 - November 2020 3.0.3 MM-1408 Added a known issue on HCIM FunctionalOrMentalStatus to the BgZ and GGZ FHIR IG's. NL-CM:4.26.6 StatusDate in the profile FunctionalOrMentalStatus is mapped on period.start, but is a date nonetheless, this will be fixed in a future release. Also see MM-1570.
MM-1382 The profile on HCIM AdvanceDirective contained a mapping to BasicElements::Author on the Consent.consentingParty element. However, the HCIM does not specify an author. Therefore, this mapping has been removed.
2020.01 - Oktober 2020 3.0.2 MM-1455 Changed the faulty HCIM name 'MedicalAid' to 'MedicalDevice' on the BgZ FHIR IG.
MM-1444 In the explanation on planning activities represented in HCIM PlannedCareActivityForTransfer mentioned both HCIM names as well as FHIR core resources which led to confusion. Because of conformance, this has been corrected, now only FHIR core resources are mentioned.
MM-1420 Added extra embedded examples to Observation.component:Amount.value[x]:valueQuantity in the HCIM AlcoholUse and HCIM TobaccoUse profiles to clarify the use of UCUM annotations in units.
2020.01 - September 2020 3.0.1 MM-1285 In the ValueSet RedenMedicatieAfspraakCodelijst, replaced the custom ART-DECOR code with SNOMED for the .designation.use element.
MM-1283 In HCIM Procedure, added mapping to the Requester (NL-CM:14.1.10) concept.
MM-1011 Replaced the term "StructureDefinitions" with the more precise term "profiles" in implementation guides.
MM-517 In zib-LaboratoryTestResult-Observation, removed the fixed value of "has-member" in related.type. Added guidance on the use of this profile in relation to other instances.
2020.01 - Zomerrelease 2020 3.0.0 MM-1204 In the zib-BloodPressure profile, the slices for diastolic and systolic pressure have been made required.
MM-972 The definition for the use of the lastn operation is unclear in the FHIR specification, therefore interpretation is added to the FHIR IG's of the information standards that use lastn.
MM-898 In zib-LaboratoryTestResult-Observation, Observation.interpretation.coding is sliced to support both the FHIR core ValueSet and the (partially overlapping) HCIM ValueSet.
MM-767 In zib-LaboratoryTestResult-Speciment(-Isolate), an extension to Speciment.collectionPeriod has been added to support the TimeInterval datatype from the pre-adopted HCIM.
MM-616 The mapping of the element RegistrationDate from HCIM AllergyIntolerance has been changed from AllergyIntolerance.reaction.onset to AllergyIntolerance.onsetDateTime. The mapping on StartDateTime has been changed from AllergyIntolerance.onset[x] to AllergyIntolerance.onsetDateTime.
MM-614 The cardinality of element AllergyIntolerance.code is now 1..1 in the zib-AllergyIntolerance profile, so it aligns with HCIM AllergyIntolerance.
MM-507 In "VitalSigns Profile NL", the cardinality of Observation.performer is relaxed from 1..* to 0..*
MM-419 The example search URL for NutritionAdvice contained a paramater for status=active, where the BgZ information standard specifies a search for all known NutritionAdvice resources. Also, status is not a concept in HCIM NutritionAdvice, which makes use of this element unnecessary. As a result, the status parameter is removed from the example search url and from the BgZ qualification material.
MM-404 In the HCIM Procedure profile, expanded the Procedure.performedPeriod element to Procedure.performed[x]. With this expansion, the profile meets the requirements of the HCIM, namely to capture a moment in time instead of a start/end date.
MM-319 In the HCIM Problem profile, the .onsetPeriod element was used to capture the HCIM concepts ProblemStartDate and ProblemEndDate, while no period is captured in the HCIM. Therefore, Condition.onsetPeriod is changed to Condition.onsetDateTime and the HCIM mapping for ProblemStartDate is corrected. The mapping for ProblemEndDate has been moved to Condition.abatementDateTime.
2019.01 - Mei 2020 2.1.14 MM-1094 Removed the retired 'zib-Appointment' profile in favor of 'eAfspraak-Appointment' in the BgZ CapabilityStatements. Added documentation about the use of the eAfspraak Appointment profile in combination with HCIM PlannedCareActivityForTransfer to the BgZ FHIR IG. Polished some HCIM terminology in the BgZ FHIR IG.
2019.01 - April 2020 2.1.13 MM-1025 Corrected the slicing logic at the discriminator path in the zib-Procedure profile.
MM-1003 In extensions zib-Payer-BankInformation and zib-TreatmentDirective-Verification, add the (required) .url element, and remove this url from the calling profile zib-Payer.
MM-939 The report element in the zib-Procedure profile used a non-existing canonical as a reference to the zib-TextResult profile. This has been fixed.
2019.01 - Maart 2020 2.1.10 MM-997 The consent-additionalSources extension for the zib-TreatmentDirective profile had a context restriction on Consent.source[x], while it actually was applied on Consent directly. This fix removes that restriction.
MM-953 Added documentation to conceptmap-ProbleemStatusCodelijst-To-Condition-Clinical-Status-Codes explaining what the relationship is between codes with equivalence type "specializes".
MM-926 In profiles zib-MedicalDeviceRequest and zib-AllergyIntolerance, add type slices on note.author[x] in order to conform to FHIR rules for extending polymorphic elements.
MM-657 Removed datatype Reference(EpisodeOfCare) and Reference(Encounter) in the .context element of the profiles zib-AlcoholUse, zib-DrugUse and zib-TobaccoUse.
2019.01 - Februari 2020 2.1.9 MM-901 The projectgroup has decided that the mapping of CanceledIndicator to .status in FHIR-profile zib-MedicationAgreement could be deleted because the information isn't necessarily anymore.
MM-900 The slices on .supportingInformation that reference zib-BodyHeight & zib-BodyWeight in FHIR-profile zib-MedicationAgreement are removed. These elements will be used as separate models.
MM-852 In HCIM MedicationUse profile: redefined slicing on MedicationStatement.derivedFrom into seperate slices to fix validator issues, also added mappings to the MedicationProcess information standard.
MM-440 Improvements have been made to the BgZ FHIR IG for the readability and findability of information. It concerns textual and style changes that have no impact on backwards compatibility of the standard.
MM-414 Ten behoeve van leesbaarheid en vindbaarheid van informatie zijn er in het functioneel ontwerp van BgZ verbeteringen doorgevoerd. Het betreft tekstuele-/stijlwijzigingen die geen impact hebben op backwards-compatibility van de standaard.
2019.01 - Januari 2020 2.1.8 MM-492 Added comment to AllergyIntolerance.comment in the HCIM Allergyintolerance FHIR profile to explain the mapping for ValueSet AllergieStatusCodelijst to AllergyIntolerance.clinicalStatus and AllergyIntolerance.verificationStatus. Added dataAbsentReason extension to AllergyIntolerance.verificationStatus.
MM-467 Added comment on MedicationRequest.reasonCode in HCIM MedicationAgreement profile to to explain mising HCIM mapping.
2019.01 - November 2.1.7 MM-806 Fixed MM430: adjusted incorrect FHIRPath constraints, moved extension to Consent.extension and moved mappings in extension from extension.value[x].reference to extension.value[x] in zib-TreatmentDirective profile.
2.1.6 MM-729 The description in MedicationStatement.informationSource of profile zib-MedicationStatement still mentioned the missing-type-reference extension, which isn't used anymore. The description has been updated to the new situation with the PractionerRole reference extension.
MM-430 The TreatmentDirective profile allowed at most 1 reference to an AdvanceDirective resource, because of restrictions in the FHIR base. There is now an extension inside the source element to allow referencing additional AdvanceDirective resources.
2019.01 - Oktober 2.1.5 MM-597 The example for NASAAL was missing urn:oid: preceding the OID value in system.
MM-594 Updated date time example in profile to include timezone as required by the FHIR specification.
2019.01 - September 2.1.4 MM-436 Aanpassen ConceptMap InterpretatieVlaggenCodelijst-to-observation-interpretation
MM-425 URL naar BGZ specificatie op FO en TO verwees naar versie 1.0, dit is aangepast naar de huidige en laatste versie 1.1.
MM-422 Aanpassen conceptnaam ResultaatVlaggen naar InterpretatieVlaggen in FHIR profiel voor LaboratoryResults.
MM-359 Nadere uitwerking van de BgZ kwalificatietoelichting voor XIS.
MM-358 Tekstcorrectie op de kwalificatie pagina ToelichtingKwalificatieBgZ.
2019.01 2.1.3 MM-348 Foutieve discrimator path voor HCIM MedicationAgreement bij MedicationStatement.derivedFrom.
MM-346 Ongeldig discriminator pad in code slicing in ZIB Verrichting.
MM-307 Aanpassen mapping van "Reden wijzigen of staken" en "Reden wijzigen of stoppen gebruik" van HCIM naar MP9.
MM-294 Naam mapping binnen div. FHIR profielen aangepast conform ZIB: HCIM LaboratoryTestResult-v4.1(2017EN).
MM-258 HCIM PharmaceuticalProduct: Added ValueSet 'IngredientCodeGTINCodeLijst' + correct reference url to ValueSet.
MM-248 Fixed typo in sliceName 'medicationTreament' --> 'medicationTreatment'.
2.1.2 MM-219 MedicationUse niet compleet na een resave in Forge.
2.1.1 MM-210 MedMij BgZ is nog gebaseerd op 1.0 i.p.v. 1.1
MM-206 Reference vanuit Observation naar Specimen Isolate onjuist.
2.1.0 MM-174 Corrected search url for PlannedCareActivityForTransfer - DeviceRequest. Added an '&'.
MM-161 CBV codes in ProcedureRequest.
MM-145 ContactPerson verwijzing informatiestandaarden vs patient zib.
MM-144 Problem zib ClinicalStatus can take on values which are not defined by the HCIM.
MM-143 Aanpassing modellering Procedure.performer in het profiel voor HCIM Verrichting.
MM-142 Onduidelijkheid in de modellering van de Aanvrager van een LaboratoriumUitslag.
MM-141 Vital Signs profielen inconsistent m.b.t. baseDefinition.
MM-134 MedicationUse StopType found values do not correspond with MedicationUseStopTypeCodeList values.
MM-127 TimeOfDay in InstructionsForUse and the Hapi Enumerators.
MM-125 Inconsistentie wiki vs simplifier.
MM-118 Profiel naam zib-Product niet passend bij Zib FarmaceutischProduct.
MM-115 Solved inconsistency in the List of StructureDefinitions. Also we will no longer check PlannedCareActivityForTransfer for MedicationAdministration in section 17 Zorgplan, because we found it was unimplementable as-is. Presumed solution will come from a future HCIM release.
MM-100 Mapping CBV naar SNOMED codes.
MM-99 Interval heeft Period maar geen PeriodUnit op simplifier.
MM-98 InstructionsForUse zib informatie model komt niet overeen met simplifier.
MM-94 Specimen microorganism en specimenSource mappen naar hetzelfde fhir element.
MM-50 Contact ondersteunt geen klinische contacten.
MM-42 medicatiegebruik - auteur - zorgverlener: kan niet alle info kwijt.
MM-41 voorschrijver/zorgverlener/zorgaanbieder past niet in medicationUse.
2018.06 2.0.1 MM-174 Corrected search url for PlannedCareActivityForTransfer - DeviceRequest. Added an '&'.
MM-128 CanceledIndicator possible values.
MM-66 Update mappings LaboratoriumUitslag in DiagnosticReport en Observation.
MM-55 Profile for HCIM TobaccoUse was missing a specification for PackYears unit - profile updated to 2.0.1.
MM-54 Wrong SNOMED code in search URL for FunctionalOrMentalStatus.
MM-23 Commentaar bij dagdeel codelijst verwijst naar dode URL.