Intoxicaties - RIVO-Noord Zorgviewer Implementation Guide v1.27.0

RIVO-Noord Zorgviewer Implementation Guide, published by RIVO-NN HL7NL. This guide is not an authorized publication; it is the continuous build for version 1.27.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/RIVO-Noord/zorgviewer-ig/ and changes regularly. See the Directory of published versions

Resource Profile: Intoxicaties ( Abstract )

Official URL: http://fhir.hl7.nl/zorgviewer/StructureDefinition/Intoxicaties				Version: 1.27.0
Active as of 2026-10-22				Computable Name: Intoxicaties

Intoxicaties samenstelling voor het documenteren van de combinatie van Tabakgebruik, Alcoholgebruik en Drugsgebruik

Dit profiel is het resultaat van de vergelijking tussen de zib2017 STU3 en zibs2020 R4 FHIR Profiel, relevante informatiestandarden en de implementaties in de ontsloten systemen en instellingen. Voornamelijk bedoeld voor houvast van een client en voor validatie van output.

Zorginformatiebouwstenen

De volgende zibs vallen onder het thema intoxicaties.

View Definition

ViewDefinition voor intoxicaties

UI Wireframe

Intoxicaties

	Bron	Datum	Soort gebruik	Status	Middel	Hoeveelheid/Antwoord
Roken
▼	CGM	4-6-2026	roken	ja

Drugs
▼	CGM	4-6-2026	drugsgebruik	nooit

Alcohol
▼	CGM	4-6-2026	alcoholgebruik			1 /d

▼	Epic	3-7-2026	Alcohol Use History	Ja		1.43 alcoholic_units/day
	Toelichting alleen sterke drank
Roken
▼	Epic	25-5-2026 - 1-7-2026	Smoking History	Soms	Cigarette Smoker
	Toelichting Moeite met stoppen
Drugs
▼	Epic	27-10-2021	Drug Use History	Ja	METHAMFETAMINE

Roken
▼	Sanday	7-8-2025	roken	nooit

Alcohol
▼	Sanday	21-8-2025	hoe vaak drinken van alcohol (FiveShot1)			4 of meer keer per week (score 2)

▼	Sanday	21-8-2025	aantal alcoh. dranken op dag (FiveShot2)			10 of meer (score 2)

▼	Sanday	21-8-2025	geërgerd aan opm. drankgew. (FiveShot3)			ja (score 1)

▼	Sanday	21-8-2025	schuldig over drankgewoonten (FiveShot4)			ja (score 1)

▼	Sanday	21-8-2025	's ochts drinken tegen kater (FiveShot5)			ja (score 1)

Bron

Datum

Soort gebruik

Status

Middel

Hoeveelheid/Antwoord

Roken

▼

CGM

4-6-2026

roken

Drugs

▼

CGM

4-6-2026

drugsgebruik

nooit

Alcohol

▼

CGM

4-6-2026

alcoholgebruik

1 /d

▼

Epic

3-7-2026

Alcohol Use History

1.43 alcoholic_units/day

Toelichting
alleen sterke drank

Roken

▼

Epic

25-5-2026 - 1-7-2026

Smoking History

Soms

Cigarette Smoker

Toelichting
Moeite met stoppen

Drugs

▼

Epic

27-10-2021

Drug Use History

METHAMFETAMINE

Roken

▼

Sanday

7-8-2025

roken

nooit

Alcohol

▼

Sanday

21-8-2025

hoe vaak drinken van alcohol (FiveShot1)

4 of meer keer per week (score 2)

▼

Sanday

21-8-2025

aantal alcoh. dranken op dag (FiveShot2)

10 of meer (score 2)

▼

Sanday

21-8-2025

geërgerd aan opm. drankgew. (FiveShot3)

ja (score 1)

▼

Sanday

21-8-2025

schuldig over drankgewoonten (FiveShot4)

ja (score 1)

▼

Sanday

21-8-2025

's ochts drinken tegen kater (FiveShot5)

ja (score 1)

Gegevensherkomst

Label FHIR Path Expression FHIR Type Zib element Toelichting of regels

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

Datum effectivePeriod.select(iif(start.exists() and end.exists(), start.toString() + ' - ' + end.toString(), start | end)) | effectiveDateTime | issued Period:date WaarnemingGebruik, StartDatum - StopDatum EffectivePeriod is voorgeschreven in de ZIB, maar in veel gevallen zal de data geen periode bevatten. In die gevallen is de datum van vaststelling bepalend voor interpretatie.

Soort gebruik code.text | code.coding.display string WaarnemingGebruik De intoxicaties groep (roken, alcohol, drugs)

Status iif(code.coding.where(system='https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen' and code in ('2418' | '2419' | '2420' | '2421' | '2422')).exists(), '', valueCodeableConcept.text | valueCodeableConcept.coding.display | valueString) string *Status De status van de intoxicatie

Middel component.where(code.coding.exists(code = '410942007' or code = '53661000146106')).valueCodeableConcept.coding.display.combine(component.where(code.coding.exists(code = '410675002')).valueCodeableConcept.coding.display).join(' ') string Middel Soort middel en toedieningsvorm

Hoeveelheid/Antwoord iif(code.coding.where(system='https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen' and code in ('2418' | '2419' | '2420' | '2421' | '2422')).exists(), valueCodeableConcept.text | valueCodeableConcept.coding.display, iif(component.exists(), component.where(code.coding.where(code in ('266918002' | '228390007' | '160573003')).exists()).valueQuantity.value.toString() + ' ' + component.where(code.coding.where(code in ('266918002' | '228390007' | '160573003')).exists()).valueQuantity.unit+iif(component.where(code.coding.where(code='401201003').exists()).exists(), ' (' + component.where(code.coding.where(code='401201003').exists()).valueQuantity.value.toString() + ' ' + component.where(code.coding.where(code='401201003').exists()).valueQuantity.unit + ')', ''), valueQuantity.value.toString() + ' ' + valueQuantity.unit)) string Hoeveelheid Het aantal eenheden (glazen, sigaretten, pillen, shots etc.) per dag, week, maand of jaar of de freqentie van gebruik, met eventueel de pack years voor roken. Of het antwoord op de vraag in de 5-shot vragenlijst.

DETAILS

+Toelichting comment | note.text string Toelichting

CONTROL

(Groep) code.coding.where(system='https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen' or system='http://snomed.info/sct').translate('intoxicaties-groups').target[0].display code nvt Lookup LOINC 'groep' code middels <terminologie-base>/ConceptMap/intoxicaties-groups$translate?code=<code>
Gebruik deze om de regels te groeperen.
Verberg regels die GEEN groep hebben.

Label	FHIR Path Expression	FHIR Type	Zib element	Toelichting of regels
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`
Datum	`effectivePeriod.select(iif(start.exists() and end.exists(), start.toString() + ' - ' + end.toString(), start \| end)) \| effectiveDateTime \| issued`	`Period:date`	WaarnemingGebruik, StartDatum - StopDatum	EffectivePeriod is voorgeschreven in de ZIB, maar in veel gevallen zal de data geen periode bevatten. In die gevallen is de datum van vaststelling bepalend voor interpretatie.
Soort gebruik	`code.text \| code.coding.display`	`string`	WaarnemingGebruik	De intoxicaties groep (roken, alcohol, drugs)
Status	`iif(code.coding.where(system='https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen' and code in ('2418' \| '2419' \| '2420' \| '2421' \| '2422')).exists(), '', valueCodeableConcept.text \| valueCodeableConcept.coding.display \| valueString)`	`string`	*Status	De status van de intoxicatie
Middel	`component.where(code.coding.exists(code = '410942007' or code = '53661000146106')).valueCodeableConcept.coding.display.combine(component.where(code.coding.exists(code = '410675002')).valueCodeableConcept.coding.display).join(' ')`	`string`	Middel	Soort middel en toedieningsvorm
Hoeveelheid/Antwoord	iif(code.coding.where(system='https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen' and code in ('2418' \| '2419' \| '2420' \| '2421' \| '2422')).exists(), valueCodeableConcept.text \| valueCodeableConcept.coding.display, iif(component.exists(), component.where(code.coding.where(code in ('266918002' \| '228390007' \| '160573003')).exists()).valueQuantity.value.toString() + ' ' + component.where(code.coding.where(code in ('266918002' \| '228390007' \| '160573003')).exists()).valueQuantity.unit+iif(component.where(code.coding.where(code='401201003').exists()).exists(), ' (' + component.where(code.coding.where(code='401201003').exists()).valueQuantity.value.toString() + ' ' + component.where(code.coding.where(code='401201003').exists()).valueQuantity.unit + ')', ''), valueQuantity.value.toString() + ' ' + valueQuantity.unit))	`string`	Hoeveelheid	Het aantal eenheden (glazen, sigaretten, pillen, shots etc.) per dag, week, maand of jaar of de freqentie van gebruik, met eventueel de pack years voor roken. Of het antwoord op de vraag in de 5-shot vragenlijst.
DETAILS
+Toelichting	`comment \| note.text`	`string`	Toelichting
CONTROL
(Groep)	`code.coding.where(system='https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen' or system='http://snomed.info/sct').translate('intoxicaties-groups').target[0].display`	`code`	nvt	Lookup LOINC 'groep' code middels `<terminologie-base>/ConceptMap/intoxicaties-groups$translate?code=<code>` Gebruik deze om de regels te groeperen. Verberg regels die GEEN groep hebben.

Zoeken naar codes

NHG Tabel 45 Diagnostische Bepalingen Diagnostisch system=https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen

Request

N.B. BgZ gebruikt de categorie 'social-history' en HIS'en gebruiken 'vital-signs' voor het intoxicaties. Bij deze algemene queries komen altijd teveel gegevens terug.

Opvragen (search) intoxicaties (BgZ)

GET <ontsluiten-bronsysteem-base>/Observation?patient=<fhir_patient_id>&category=social-history
Opvragen (search) intoxicaties (huisartsgegevens)

GET <ontsluiten-bronsysteem-base>/Observation?patient=<fhir_patient_id>&category=vital-signs
Opvragen (search) alcoholgebruik (BgZ)

GET <ontsluiten-bronsysteem-base>/Observation?patient=<fhir_patient_id>&code=http://snomed.info/sct|228273003
Opvragen (search) alcoholgebruik (huisartsgegevens). HIS'en includeren ook de FiveShot vragenlijst antwoorden. Let op dat de komma-notatie van codes niet altijd wordt ondersteund.

GET <ontsluiten-bronsysteem-base>/Observation?patient=<fhir_patient_id>&code=https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen|1591,https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen|2418,https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen|2419,https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen|2420,https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen|2421,https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen|2422
Opvragen (search) alcoholgebruik (CGM). CGM slaat alcoholgebruik op zonder SNOMED-CT code; gebruik NHG Tabel 45 code 1591.

GET <ontsluiten-bronsysteem-base>/Observation?patient=<fhir_patient_id>&code=https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen|1591
Opvragen (search) drugsgebruik (Epic/CGM)

GET <ontsluiten-bronsysteem-base>/Observation?patient=<fhir_patient_id>&code=http://snomed.info/sct|228366006
Opvragen (search) drugsgebruik (Sanday/CGM)

GET <ontsluiten-bronsysteem-base>/Observation?patient=<fhir_patient_id>&code=https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen|3022
Opvragen (search) tabakgebruik (Epic/CGM)

GET <ontsluiten-bronsysteem-base>/Observation?patient=<fhir_patient_id>&code=http://snomed.info/sct|365980008
Opvragen (search) tabakgebruik (Sanday/CGM)

GET <ontsluiten-bronsysteem-base>/Observation?patient=<fhir_patient_id>&code=https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen|1739

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:

CapabilityStatements using this Profile: Bronsysteem: CGM, Bronsysteem: Epic, Bronsysteem: MediKIT and Bronsysteem: Sanday
This Profile is not used by any profiles in this Specification

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

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

Key Elements Table
Differential Table
Snapshot Table
Statistics/References
All

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
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
Bundle.implicitRules	This element is a modifier element. This element is included in summaries.	0..1	uri	A set of rules under which this content was created
Bundle.type	This element is included in summaries.	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.
Bundle.Slices for entry	This element is included in summaries. C	0..*	BackboneElement	Entry in the bundle - will have a resource, or information Slice: Unordered, Open by type:resource Constraints: bdl-8, bdl-5 Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Bundle.Slices for entry.entry:All Slices				Content/Rules for all slices
Bundle.Slices for entry.entry:All Slices.modifierExtension	This element is a modifier element. This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored
Bundle.Slices for entry.entry:TobaccoUse	This element is included in summaries. C	0..*	BackboneElement	Entry in the bundle - will have a resource, or information Constraints: bdl-8, bdl-5
Bundle.Slices for entry.entry:TobaccoUse.modifierExtension	This element is a modifier element. This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored
Bundle.Slices for entry.entry:TobaccoUse.resource	This element is included in summaries.	0..1	TobaccoUse	TobaccoUse
Bundle.Slices for entry.entry:AlcoholUse	This element is included in summaries. C	0..*	BackboneElement	Entry in the bundle - will have a resource, or information Constraints: bdl-8, bdl-5
Bundle.Slices for entry.entry:AlcoholUse.modifierExtension	This element is a modifier element. This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored
Bundle.Slices for entry.entry:AlcoholUse.resource	This element is included in summaries.	0..1	AlcoholUse	AlcoholUse
Bundle.Slices for entry.entry:DrugUse	This element is included in summaries. C	0..*	BackboneElement	Entry in the bundle - will have a resource, or information Constraints: bdl-8, bdl-5
Bundle.Slices for entry.entry:DrugUse.modifierExtension	This element is a modifier element. This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored
Bundle.Slices for entry.entry:DrugUse.resource	This element is included in summaries.	0..1	DrugUse	DrugUse
Bundle.Slices for entry.entry:DiagnosticResult	This element is included in summaries. C	0..*	BackboneElement	Entry in the bundle - will have a resource, or information Constraints: bdl-8, bdl-5
Bundle.Slices for entry.entry:DiagnosticResult.modifierExtension	This element is a modifier element. This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored
Bundle.Slices for entry.entry:DiagnosticResult.resource	This element is included in summaries.	0..1	gp DiagnosticResult	GeneralMeasurement
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-5	error	Bundle.entry, Bundle.entry:TobaccoUse, Bundle.entry:AlcoholUse, Bundle.entry:DrugUse, Bundle.entry:DiagnosticResult	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, Bundle.entry:TobaccoUse, Bundle.entry:AlcoholUse, Bundle.entry:DrugUse, Bundle.entry:DiagnosticResult	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

Name	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Bundle	0..*	Bundle	This is an abstract profile. Contains a collection of resources
Bundle.Slices for entry	0..*	BackboneElement	Entry in the bundle - will have a resource, or information Slice: Unordered, Open by type:resource Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Bundle.Slices for entry.entry:TobaccoUse	0..*	BackboneElement	Entry in the bundle - will have a resource, or information
Bundle.Slices for entry.entry:TobaccoUse.resource	0..1	TobaccoUse	TobaccoUse
Bundle.Slices for entry.entry:AlcoholUse	0..*	BackboneElement	Entry in the bundle - will have a resource, or information
Bundle.Slices for entry.entry:AlcoholUse.resource	0..1	AlcoholUse	AlcoholUse
Bundle.Slices for entry.entry:DrugUse	0..*	BackboneElement	Entry in the bundle - will have a resource, or information
Bundle.Slices for entry.entry:DrugUse.resource	0..1	DrugUse	DrugUse
Bundle.Slices for entry.entry:DiagnosticResult	0..*	BackboneElement	Entry in the bundle - will have a resource, or information
Bundle.Slices for entry.entry:DiagnosticResult.resource	0..1	gp DiagnosticResult	GeneralMeasurement
Documentation for this format