Procedure - RIVO-Noord Zorgviewer Implementation Guide v1.11.0

RIVO-Noord Zorgviewer Implementation Guide
1.11.0 - CI build Netherlands flag

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

Resource Profile: Procedure

Official URL: http://fhir.hl7.nl/zorgviewer/StructureDefinition/Procedure				Version: 1.11.0
Active as of 2025-01-06				Computable Name: Procedure

Verrichtingen

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

ZIB Verrichting

View Definition

ViewDefinition voor Verrichtingen

User-Interface guidance

Een schets van het scherm met labels en sortering informatie

Kolom definities:

Kolom label FHIR Path 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 .performedPeriod.start dateTime VerrichtingBeginDatum Kunnen vage datums zijn.

Verrichting .code.text string VerrichtingType

Locatie .location.display string Locatie::Zorgaanbieder Zie discussie hier: BITS ticket MM-5002

Uitgevoerd door .performer.actor.display string Uitvoerder Meestal alleen specialisme

(1) UITKLAPVELD

Verrichtingcode .code.coding[] en dan .system, .code en .display string VerrichtingType Meerdere codes mogelijk.
Ignore NullFlavor.
Lookup system label middels <terminologie-base>/CodeSystem?url=<.system> en gebruik dan CodeSystem.title

Lateraliteit .bodySite.extension[url="http://nictiz.nl/fhir/StructureDefinition/BodySite-Qualifier"].valueCodeableConcept.text string ProbleemLateraliteit

Kolom label	FHIR Path	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	`.performedPeriod.start`	`dateTime`	VerrichtingBeginDatum	Kunnen vage datums zijn.
Verrichting	`.code.text`	`string`	VerrichtingType
Locatie	`.location.display`	`string`	Locatie::Zorgaanbieder	Zie discussie hier: BITS ticket MM-5002
Uitgevoerd door	`.performer.actor.display`	`string`	Uitvoerder	Meestal alleen specialisme
(1) UITKLAPVELD
Verrichtingcode	`.code.coding[]` en dan `.system`, `.code` en `.display`	`string`	VerrichtingType	Meerdere codes mogelijk. Ignore NullFlavor. Lookup system label middels `<terminologie-base>/CodeSystem?url=<.system>` en gebruik dan `CodeSystem.title`
Lateraliteit	`.bodySite.extension[url="http://nictiz.nl/fhir/StructureDefinition/BodySite-Qualifier"].valueCodeableConcept.text`	`string`	ProbleemLateraliteit

Zoeken naar codes

Request

Opvragen (search) verrichtingen

GET <ontsluiten-bronsysteem-base>/Procedure?patient=<fhir_patient_id>

N.B. Deze request is breder dan de BgZ request, waar alleen de chirugische verrichtingen worden opgevraagd.

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.

Usage:

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

Changes since version 1.10.0:

The data elements list has changed

One or more text definitions, invariants or bindings have changed

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
Procedure	C	0..*	Zib Procedure	Procedure dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources dom-1: If the resource is contained in another resource, it SHALL NOT contain any narrative dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource pro-1: Reason not done is only permitted if notDone indicator is true
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
Slices for extension				Content/Rules for all slices
procedureMethod		0..1	(Complex)	The method used to perform the procedure URL: http://hl7.org/fhir/StructureDefinition/procedure-method ele-1: All FHIR elements must have a @value or children ext-1: Must have either extensions or value[x], not both
url		1..1	uri	"http://hl7.org/fhir/StructureDefinition/procedure-method"
Slices for valueCodeableConcept				Content/Rules for all slices
valueCodeableConcept:valueCodeableConcept		0..1	CodeableConcept	ProcedureMethod Binding: VerrichtingMethodeCodelijst (extensible): VerrichtingMethodeCodelijst
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for basedOn	Σ	0..*	Reference(CarePlan \| ProcedureRequest \| ReferralRequest)	A request for this procedure Slice: Unordered, Open by type:$this.resolve()
basedOn:request	Σ	0..*	Reference(HCIM ProcedureRequest)	ProcedureRequest
status	?!Σ	1..1	code	preparation \| in-progress \| suspended \| aborted \| completed \| entered-in-error \| unknown Binding: EventStatus (required): A code specifying the state of the procedure.
notDone	?!Σ	0..1	boolean	True if procedure was not performed as scheduled
category	Σ	1..1	CodeableConcept	Classification of the procedure Binding: Procedure Category Codes (SNOMED CT) (example): A code that classifies a procedure for searching, sorting and display purposes. Example Example of category code: {"coding":[{"system":"http://snomed.info/sct","code":"387713003","display":"Surgical procedure"}]}
code	Σ	0..1	CodeableConcept	ProcedureType Binding: Procedure Codes (SNOMED CT) (example): A code to identify a specific procedure .
Slices for coding	Σ	0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system
coding:VerrichtingTypeCodelijst	Σ	0..*	Coding	ProcedureType Binding: VerrichtingTypeCodelijst (required): The name of the procedure using the Verrichtingenthesaurus DHD.
system	Σ	1..1	uri	Identity of the terminology system Fixed Value: http://snomed.info/sct
text	SΣ	0..1	string	Plain text representation of the concept
subject	Σ	1..1	Reference(Group \| nl-core-patient)	Who the procedure was performed on
Slices for performed[x]	Σ	0..1	Period	Date/Period the procedure was performed Slice: Unordered, Closed by type:$this
performed[x]:performedPeriod	SΣ	0..1	Period	Date/Period the procedure was performed
performer	Σ	0..*	BackboneElement	HealthProfessional \| Location::HealthcareProvider ele-1: All FHIR elements must have a @value or children
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored
actor	Σ	1..1	Reference(nl-core-practitioner \| nl-core-organization)	The reference to the practitioner
Slices for extension				Content/Rules for all slices
practitionerRole		0..1	Reference(nl-core-practitionerrole)	Optional Extensions Element URL: http://nictiz.nl/fhir/StructureDefinition/practitionerrole-reference
display	SΣ	0..1	string	Text alternative for the resource
location	SΣ	0..1	Reference(Location)	Where the procedure happened
display	SΣ	0..1	string	Text alternative for the resource
bodySite	Σ	0..*	CodeableConcept	ProcedureAnatomicalLocation Binding: VerrichtingAnatomischeLocatieCodelijst (extensible): Anatomical location which is the focus of the procedure.
Slices for extension	S	0..*	Extension	Extension Slice: Unordered, Open by value:url
ProcedureLaterality		0..1	(Complex)	ProcedureLaterality URL: http://nictiz.nl/fhir/StructureDefinition/BodySite-Qualifier
url		1..1	uri	"http://nictiz.nl/fhir/StructureDefinition/BodySite-Qualifier"
Slices for value[x]		0..1	CodeableConcept	Value of extension Slice: Unordered, Closed by type:$this
value[x]:valueCodeableConcept		0..1	CodeableConcept	BodySite qualifier Binding: VerrichtingLateraliteitCodelijst (extensible): ProcedureLateralityCodelist
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Procedure.extension:procedureMethod.valueCodeableConcept:valueCodeableConcept	extensible	VerrichtingMethodeCodelijst `http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.14.1.4--20171231000000`
Procedure.status	required	EventStatus `http://hl7.org/fhir/ValueSet/event-status` from the FHIR Standard
Procedure.category	example	Procedure Category Codes (SNOMED CT) `http://hl7.org/fhir/ValueSet/procedure-category` from the FHIR Standard
Procedure.code	example	Procedure Codes (SNOMED CT) `http://hl7.org/fhir/ValueSet/procedure-code` from the FHIR Standard
Procedure.code.coding:VerrichtingTypeCodelijst	required	VerrichtingTypeCodelijst (a valid code from SNOMED CT) `http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.14.1.2--20171231000000`
Procedure.bodySite	extensible	VerrichtingAnatomischeLocatieCodelijst `http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.14.1.1--20171231000000`
Procedure.bodySite.extension:ProcedureLaterality.value[x]:valueCodeableConcept	extensible	VerrichtingLateraliteitCodelijst `http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.14.1.3--20171231000000`

Constraints

Id	Grade	Path(s)	Details	Requirements
dom-1	error	Procedure	If the resource is contained in another resource, it SHALL NOT contain any narrative : contained.text.empty()
dom-2	error	Procedure	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Procedure	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource : contained.where(('#'+id in %resource.descendants().reference).not()).empty()
dom-4	error	Procedure	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
ele-1	error	ALL elements	All FHIR elements must have a @value or children : hasValue() \| (children().count() > id.count())
ext-1	error	ALL extensions	Must have either extensions or value[x], not both : extension.exists() != value.exists()
pro-1	error	Procedure	Reason not done is only permitted if notDone indicator is true : notDoneReason.empty() or notDone = true

This structure is derived from Zib Procedure

Name	Flags	Card.	Type	Description & Constraints
Procedure		0..*	Zib Procedure	Procedure
code		0..1	CodeableConcept	ProcedureType
text	S	0..1	string	Plain text representation of the concept
performedPeriod	S	0..1	Period	Date/Period the procedure was performed
performer		0..*	BackboneElement	HealthProfessional \| Location::HealthcareProvider
actor		1..1	Reference(nl-core-practitioner \| nl-core-organization)	The reference to the practitioner
display	S	0..1	string	Text alternative for the resource
location	S	0..1	Reference(Location)	Where the procedure happened
display	S	0..1	string	Text alternative for the resource
bodySite
extension	S	0..*	Extension	Extension
Documentation for this format