RIVO-Noord Zorgviewer Implementation Guide
1.24.0 - CI build NL

RIVO-Noord Zorgviewer Implementation Guide - Local Development build (v1.24.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Resource Profile: Contacten en Episodes ( Abstract )

Official URL: http://fhir.hl7.nl/zorgviewer/StructureDefinition/ContactenEpisodes Version: 1.24.0
Active as of 2026-05-08 Computable Name: ContactenEpisodes

Contacten en Episodes samenstelling voor het documenteren van de combinatie van Contact en Episode

Dit Profiel is het resultaat van de vergelijking tussen de zib2017 FHIR Profiel en de implementaties in Epic, Chipsoft, Topicus en Nexus. De elementen die in ieder geval in alle output beschikbaar zullen zijn. Voornamelijk bedoeld voor houvast van een client en voor validatie van output.

Zorginformatiebouwsteen

View Definition

ViewDefinition voor Contacten en Episodes

UI Wireframe

Contacten en Episodes

>< Bron Begin Eind Met Rol Locatie Status Type
+ Sanday 16-4-2026 Episode
+ Sanday 16-4-2026 Episode
+ CGM 4-3-2026 4-3-2026 Pharmeon acceptatie zorgverlener Huisartsen, niet apotheekhoudend finished Ambulatory
+ CGM 4-3-2026 4-3-2026 Pharmeon acceptatie zorgverlener Huisartsen, niet apotheekhoudend finished Ambulatory
+ CGM 4-3-2026 4-3-2026 Pharmeon acceptatie zorgverlener Huisartsen, niet apotheekhoudend finished Ambulatory
+ CGM 4-3-2026 4-3-2026 Pharmeon acceptatie zorgverlener Huisartsen, niet apotheekhoudend finished Ambulatory
+ CGM 4-3-2026 4-3-2026 Pharmeon acceptatie zorgverlener Huisartsen, niet apotheekhoudend finished Ambulatory
+ CGM 4-3-2026 4-3-2026 Pharmeon acceptatie zorgverlener Huisartsen, niet apotheekhoudend finished Ambulatory
+ CGM 4-3-2026 4-3-2026 Pharmeon acceptatie zorgverlener Episode
+ CGM 26-2-2026 26-2-2026 Pharmeon acceptatie zorgverlener Huisartsen, niet apotheekhoudend finished Ambulatory
+ Sanday 15-12-2025 Episode
+ Sanday 4-11-2025 Episode
+ Sanday 21-8-2025 Episode
+ Sanday 7-8-2025 Episode
+ Sanday 1-4-2025 Episode
+ Epic 27-3-2025 27-3-2025 E. Sieders, Chirurg
DJA. de Groot, Internist Oncoloog
A. (van Donderen-) Vrieze
...
UMCG HC unknown Inpatient Encounter
+ CGM 11-3-2025 11-3-2025 Pharmeon acceptatie zorgverlener Huisartsen, niet apotheekhoudend finished Ambulatory
+ Sanday 13-2-2025 14-10-2025 Episode
+ Sanday 4-7-2024 finished Other
+ CGM 3-6-2023 3-6-2023 Pharmeon acceptatie zorgverlener Huisartsen, niet apotheekhoudend finished Ambulatory
+ CGM 15-11-2012 15-11-2012 Pharmeon acceptatie zorgverlener Huisartsen, niet apotheekhoudend finished Ambulatory
+ CGM 15-11-2012 15-11-2012 Pharmeon acceptatie zorgverlener Episode
+ Nexus 16-8-2012 19-8-2012 Wit Orthopedie finished Klinisch
+ Chipsoft 14-8-2012 15-8-2012 J.H.R Peters Onbekende functiecode. finished inpatient
+ CGM 10-8-2012 10-8-2012 Pharmeon acceptatie zorgverlener Huisartsen, niet apotheekhoudend finished Ambulatory
+ CGM 10-8-2012 4-3-2026 Pharmeon acceptatie zorgverlener Episode
+ CGM 20-4-2011 20-4-2011 Pharmeon acceptatie zorgverlener Huisartsen, niet apotheekhoudend finished Ambulatory
+ CGM 20-4-2011 20-4-2011 Pharmeon acceptatie zorgverlener Huisartsen, niet apotheekhoudend finished Ambulatory
+ CGM 20-4-2011 20-4-2011 Pharmeon acceptatie zorgverlener Episode

Kolomdefinities

Kolom label FHIR Path Expression FHIR Type Zib element Toelichting of regels
Encounter
Bron meta.extension('http://hl7.org/fhir/4.0/StructureDefinition/extension-Meta.source').valueUri string nvt Lookup adhv uri (AGB-Z of OID) <adressering-base>/Organization?identifier=<.meta.tag.code> en gebruik dan Organization.name
Begin period.start dateTime BeginDatumTijd
Eind period.end dateTime EindDatumTijd
Met participant.individual.display.join(' ') string ContactMet::Zorgverlener
Rol participant.individual.extension('http://nictiz.nl/fhir/StructureDefinition/practitionerrole-reference').valueReference.display string nvt
Locatie location.location.display string Locatie::Zorgaanbieder
Status status code nvt
Type class.display code ContactType
EpisodeOfCare
Bron meta.extension('http://hl7.org/fhir/4.0/StructureDefinition/extension-Meta.source').valueUri string nvt Lookup adhv uri (AGB-Z of OID) <adressering-base>/Organization?identifier=<.meta.tag.code> en gebruik dan Organization.name
Begin extension('http://nictiz.nl/fhir/StructureDefinition/EpisodeOfCare-DateFirstEncounter').valueDateTime | period.start dateTime BeginDatumTijd
Eind extension('http://nictiz.nl/fhir/StructureDefinition/EpisodeOfCare-DateLastEncounter').valueDateTime | period.end dateTime EindDatumTijd
Met careManager.display string nvt
Rol '' string nvt
Locatie '' string nvt
Status '' string nvt
Type 'Episode' string nvt

Request

Bronsysteem herkennen

De Zorgviewer-backend of Ontsluiten bronsysteem MOET na bevragen van het bronsysteem aan elk resultaat resource een meta-tag toevoegen met de AGB, OID of URA identifier van de zorgaanbieder (zie Organization voor voorbeelden). Dit wordt vervolgens gebruikt in de "Bron" kolom in de Zorgviewer-frontend. N.B. We gebruiken hier een pre-adopt van de FHIR R4 Meta.source.

Toevoegen aan elke response, dus per resource (bij een read) of per Bundle (bij een search):

"meta": {
    "extension": [ {
        "url": "http://hl7.org/fhir/4.0/StructureDefinition/extension-Meta.source",
        "valueUri": "urn:oid:2.16.840.1.113883.2.4.3.8"
    } ]
}

Alternatief: Elke entry van een search response Bundle bevat een referentie naar de bijbehorende Patient (<resource>.subject|patient). Elke patient heeft een Patient.managingOrganization en in de gerefereerde Organization.identifier staat vervolgens o.a. de OID van het bronsysyeem. Of je gebruikt de identifiers om een volledige Organization op te zoeken in het adresboek en zie inhoud hier.

Usages:

  • This Profile is not used by any profiles in this Implementation Guide

You can also check for usages in the FHIR IG Statistics

Changes since version 1.23.0:

  • New Content
  • Formal Views of Profile Content

    Description of Profiles, Differentials, Snapshots and how the different presentations work.

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. Bundle C 0..* Bundle This is an abstract profile.
    Contains a collection of resources
    Constraints: bdl-7, bdl-9, bdl-3, bdl-4, bdl-1, bdl-2
    ... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
    ... type Σ 1..1 code document | message | transaction | transaction-response | batch | batch-response | history | searchset | collection
    Binding: BundleType (required): Indicates the purpose of a bundle - how it was intended to be used.

    doco Documentation for this format

    Terminology Bindings

    Path Status Usage ValueSet Version Source
    Bundle.type Base required BundleType 📍3.0.2 FHIR Std.

    Constraints

    Id Grade Path(s) Description Expression
    bdl-1 error Bundle total only when a search or history total.empty() or (type = 'searchset') or (type = 'history')
    bdl-2 error Bundle entry.search only when a search entry.search.empty() or (type = 'searchset')
    bdl-3 error Bundle entry.request only for some types of bundles entry.request.empty() or type = 'batch' or type = 'transaction' or type = 'history'
    bdl-4 error Bundle entry.response only for some types of bundles entry.response.empty() or type = 'batch-response' or type = 'transaction-response'
    bdl-7 error Bundle FullUrl must be unique in a bundle, or else entries with the same fullUrl must have different meta.versionId entry.where(fullUrl).select(fullUrl&resource.meta.versionId).isDistinct()
    bdl-9 error Bundle A document must have an identifier with a system and a value type = 'document' implies (identifier.system.exists() and identifier.value.exists())

    This structure is derived from Bundle

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. Bundle 0..* Bundle This is an abstract profile.
    Contains a collection of resources

    doco Documentation for this format
    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. Bundle C 0..* Bundle This is an abstract profile.
    Contains a collection of resources
    Constraints: bdl-7, bdl-9, bdl-3, bdl-4, bdl-1, bdl-2
    ... id Σ 0..1 id Logical id of this artifact
    ... meta Σ 0..1 Meta Metadata about the resource
    ... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
    ... identifier Σ 0..1 Identifier Persistent identifier for the bundle
    ... type Σ 1..1 code document | message | transaction | transaction-response | batch | batch-response | history | searchset | collection
    Binding: BundleType (required): Indicates the purpose of a bundle - how it was intended to be used.
    ... total ΣC 0..1 unsignedInt If search, the total number of matches
    ... link Σ 0..* BackboneElement Links related to this Bundle
    .... id 0..1 string xml:id (or equivalent in JSON)
    .... extension 0..* Extension Additional Content defined by implementations
    .... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
    .... relation Σ 1..1 string See http://www.iana.org/assignments/link-relations/link-relations.xhtml#link-relations-1
    .... url Σ 1..1 uri Reference details for the link
    ... entry ΣC 0..* BackboneElement Entry in the bundle - will have a resource, or information
    Constraints: bdl-8, bdl-5
    .... id 0..1 string xml:id (or equivalent in JSON)
    .... extension 0..* Extension Additional Content defined by implementations
    .... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
    .... link Σ 0..* See link (Bundle) Links related to this entry
    .... fullUrl Σ 0..1 uri Absolute URL for resource (server address, or UUID/OID)
    .... resource Σ 0..1 Resource A resource in the bundle
    .... search ΣC 0..1 BackboneElement Search related information
    ..... id 0..1 string xml:id (or equivalent in JSON)
    ..... extension 0..* Extension Additional Content defined by implementations
    ..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
    ..... mode Σ 0..1 code match | include | outcome - why this is in the result set
    Binding: SearchEntryMode (required): Why an entry is in the result set - whether it's included as a match or because of an _include requirement.
    ..... score Σ 0..1 decimal Search ranking (between 0 and 1)
    .... request ΣC 0..1 BackboneElement Transaction Related Information
    ..... id 0..1 string xml:id (or equivalent in JSON)
    ..... extension 0..* Extension Additional Content defined by implementations
    ..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
    ..... method Σ 1..1 code GET | POST | PUT | DELETE
    Binding: HTTPVerb (required): HTTP verbs (in the HTTP command line).
    ..... url Σ 1..1 uri URL for HTTP equivalent of this entry
    ..... ifNoneMatch Σ 0..1 string For managing cache currency
    ..... ifModifiedSince Σ 0..1 instant For managing update contention
    ..... ifMatch Σ 0..1 string For managing update contention
    ..... ifNoneExist Σ 0..1 string For conditional creates
    .... response ΣC 0..1 BackboneElement Transaction Related Information
    ..... id 0..1 string xml:id (or equivalent in JSON)
    ..... extension 0..* Extension Additional Content defined by implementations
    ..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
    ..... status Σ 1..1 string Status response code (text optional)
    ..... location Σ 0..1 uri The location, if the operation returns a location
    ..... etag Σ 0..1 string The etag for the resource (if relevant)
    ..... lastModified Σ 0..1 instant Server's date time modified
    ..... outcome Σ 0..1 Resource OperationOutcome with hints and warnings (for batch/transaction)
    ... signature Σ 0..1 Signature Digital Signature

    doco Documentation for this format

    Terminology Bindings

    Path Status Usage ValueSet Version Source
    Bundle.language Base extensible Common Languages 📍3.0.2 FHIR Std.
    Bundle.type Base required BundleType 📍3.0.2 FHIR Std.
    Bundle.entry.search.​mode Base required SearchEntryMode 📍3.0.2 FHIR Std.
    Bundle.entry.request.​method Base required HTTPVerb 📍3.0.2 FHIR Std.

    Constraints

    Id Grade Path(s) Description Expression
    bdl-1 error Bundle total only when a search or history total.empty() or (type = 'searchset') or (type = 'history')
    bdl-2 error Bundle entry.search only when a search entry.search.empty() or (type = 'searchset')
    bdl-3 error Bundle entry.request only for some types of bundles entry.request.empty() or type = 'batch' or type = 'transaction' or type = 'history'
    bdl-4 error Bundle entry.response only for some types of bundles entry.response.empty() or type = 'batch-response' or type = 'transaction-response'
    bdl-5 error Bundle.entry must be a resource unless there's a request or response resource.exists() or request.exists() or response.exists()
    bdl-7 error Bundle FullUrl must be unique in a bundle, or else entries with the same fullUrl must have different meta.versionId entry.where(fullUrl).select(fullUrl&resource.meta.versionId).isDistinct()
    bdl-8 error Bundle.entry fullUrl cannot be a version specific reference fullUrl.contains('/_history/').not()
    bdl-9 error Bundle A document must have an identifier with a system and a value type = 'document' implies (identifier.system.exists() and identifier.value.exists())
    ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() | (children().count() > id.count())

    This structure is derived from Bundle

    Summary

    Key Elements View

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. Bundle C 0..* Bundle This is an abstract profile.
    Contains a collection of resources
    Constraints: bdl-7, bdl-9, bdl-3, bdl-4, bdl-1, bdl-2
    ... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
    ... type Σ 1..1 code document | message | transaction | transaction-response | batch | batch-response | history | searchset | collection
    Binding: BundleType (required): Indicates the purpose of a bundle - how it was intended to be used.

    doco Documentation for this format

    Terminology Bindings

    Path Status Usage ValueSet Version Source
    Bundle.type Base required BundleType 📍3.0.2 FHIR Std.

    Constraints

    Id Grade Path(s) Description Expression
    bdl-1 error Bundle total only when a search or history total.empty() or (type = 'searchset') or (type = 'history')
    bdl-2 error Bundle entry.search only when a search entry.search.empty() or (type = 'searchset')
    bdl-3 error Bundle entry.request only for some types of bundles entry.request.empty() or type = 'batch' or type = 'transaction' or type = 'history'
    bdl-4 error Bundle entry.response only for some types of bundles entry.response.empty() or type = 'batch-response' or type = 'transaction-response'
    bdl-7 error Bundle FullUrl must be unique in a bundle, or else entries with the same fullUrl must have different meta.versionId entry.where(fullUrl).select(fullUrl&resource.meta.versionId).isDistinct()
    bdl-9 error Bundle A document must have an identifier with a system and a value type = 'document' implies (identifier.system.exists() and identifier.value.exists())

    Differential View

    This structure is derived from Bundle

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. Bundle 0..* Bundle This is an abstract profile.
    Contains a collection of resources

    doco Documentation for this format

    Snapshot View

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. Bundle C 0..* Bundle This is an abstract profile.
    Contains a collection of resources
    Constraints: bdl-7, bdl-9, bdl-3, bdl-4, bdl-1, bdl-2
    ... id Σ 0..1 id Logical id of this artifact
    ... meta Σ 0..1 Meta Metadata about the resource
    ... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
    ... identifier Σ 0..1 Identifier Persistent identifier for the bundle
    ... type Σ 1..1 code document | message | transaction | transaction-response | batch | batch-response | history | searchset | collection
    Binding: BundleType (required): Indicates the purpose of a bundle - how it was intended to be used.
    ... total ΣC 0..1 unsignedInt If search, the total number of matches
    ... link Σ 0..* BackboneElement Links related to this Bundle
    .... id 0..1 string xml:id (or equivalent in JSON)
    .... extension 0..* Extension Additional Content defined by implementations
    .... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
    .... relation Σ 1..1 string See http://www.iana.org/assignments/link-relations/link-relations.xhtml#link-relations-1
    .... url Σ 1..1 uri Reference details for the link
    ... entry ΣC 0..* BackboneElement Entry in the bundle - will have a resource, or information
    Constraints: bdl-8, bdl-5
    .... id 0..1 string xml:id (or equivalent in JSON)
    .... extension 0..* Extension Additional Content defined by implementations
    .... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
    .... link Σ 0..* See link (Bundle) Links related to this entry
    .... fullUrl Σ 0..1 uri Absolute URL for resource (server address, or UUID/OID)
    .... resource Σ 0..1 Resource A resource in the bundle
    .... search ΣC 0..1 BackboneElement Search related information
    ..... id 0..1 string xml:id (or equivalent in JSON)
    ..... extension 0..* Extension Additional Content defined by implementations
    ..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
    ..... mode Σ 0..1 code match | include | outcome - why this is in the result set
    Binding: SearchEntryMode (required): Why an entry is in the result set - whether it's included as a match or because of an _include requirement.
    ..... score Σ 0..1 decimal Search ranking (between 0 and 1)
    .... request ΣC 0..1 BackboneElement Transaction Related Information
    ..... id 0..1 string xml:id (or equivalent in JSON)
    ..... extension 0..* Extension Additional Content defined by implementations
    ..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
    ..... method Σ 1..1 code GET | POST | PUT | DELETE
    Binding: HTTPVerb (required): HTTP verbs (in the HTTP command line).
    ..... url Σ 1..1 uri URL for HTTP equivalent of this entry
    ..... ifNoneMatch Σ 0..1 string For managing cache currency
    ..... ifModifiedSince Σ 0..1 instant For managing update contention
    ..... ifMatch Σ 0..1 string For managing update contention
    ..... ifNoneExist Σ 0..1 string For conditional creates
    .... response ΣC 0..1 BackboneElement Transaction Related Information
    ..... id 0..1 string xml:id (or equivalent in JSON)
    ..... extension 0..* Extension Additional Content defined by implementations
    ..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
    ..... status Σ 1..1 string Status response code (text optional)
    ..... location Σ 0..1 uri The location, if the operation returns a location
    ..... etag Σ 0..1 string The etag for the resource (if relevant)
    ..... lastModified Σ 0..1 instant Server's date time modified
    ..... outcome Σ 0..1 Resource OperationOutcome with hints and warnings (for batch/transaction)
    ... signature Σ 0..1 Signature Digital Signature

    doco Documentation for this format

    Terminology Bindings

    Path Status Usage ValueSet Version Source
    Bundle.language Base extensible Common Languages 📍3.0.2 FHIR Std.
    Bundle.type Base required BundleType 📍3.0.2 FHIR Std.
    Bundle.entry.search.​mode Base required SearchEntryMode 📍3.0.2 FHIR Std.
    Bundle.entry.request.​method Base required HTTPVerb 📍3.0.2 FHIR Std.

    Constraints

    Id Grade Path(s) Description Expression
    bdl-1 error Bundle total only when a search or history total.empty() or (type = 'searchset') or (type = 'history')
    bdl-2 error Bundle entry.search only when a search entry.search.empty() or (type = 'searchset')
    bdl-3 error Bundle entry.request only for some types of bundles entry.request.empty() or type = 'batch' or type = 'transaction' or type = 'history'
    bdl-4 error Bundle entry.response only for some types of bundles entry.response.empty() or type = 'batch-response' or type = 'transaction-response'
    bdl-5 error Bundle.entry must be a resource unless there's a request or response resource.exists() or request.exists() or response.exists()
    bdl-7 error Bundle FullUrl must be unique in a bundle, or else entries with the same fullUrl must have different meta.versionId entry.where(fullUrl).select(fullUrl&resource.meta.versionId).isDistinct()
    bdl-8 error Bundle.entry fullUrl cannot be a version specific reference fullUrl.contains('/_history/').not()
    bdl-9 error Bundle A document must have an identifier with a system and a value type = 'document' implies (identifier.system.exists() and identifier.value.exists())
    ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() | (children().count() > id.count())

    This structure is derived from Bundle

    Summary

     

    Other representations of profile: CSV, Excel, Schematron