Search

ZD Observation

Resources conforming to this profile are requested by ZorgDomein when populating the referral letter or request form with data from the source information system.

Queries on the https://[FHIRServerUrl]/Observation endpoint may include the following query parameters:

  • patient=[PatientID]: [PatientID] refers to the patient ID as provided in the Task resource that is requested by ZorgDomein during SSO.
  • encounter=[EncounterIds]: the resources in the search result must only contain Observation resources that reference one or more of the encounters identified by [EncounterIds] in Observation.context. [EncounterIds] may contain multiple, comma separated IDs. The Encounter ID’s are extracted from the result of a query for Encounter resources.
  • context=[EpisodeOfCareIds]: the resources in the search result must only contain Observation resources that reference one or more of the episodes identified by [EpisodeOfCareIds] in Observation.context. [EpisodeOfCareIds] may contain multiple, comma separated IDs. This query parameter is used to filter the list of observations in the data selection modal for “Aanvullend onderzoek”.
  • context:missing=true: indicates that the search result must not contain any Observation resource that has a value for Observation.context. This query parameter is used to filter the list of observations in the data selection modal for “Aanvullend onderzoek”.
  • code=[codes]: [codes] may contain multiple, comma separated values. The following codes are used:
    • http://fhir.nl/fhir/NamingSystem/journaalregeltypen|S – For encounter notes of type “Subjectief” (“S”) according to the “SOEP” system.
    • http://fhir.nl/fhir/NamingSystem/journaalregeltypen|O – For encounter notes of type “Objectief” (“O”) according to the “SOEP” system.
    • http://fhir.nl/fhir/NamingSystem/journaalregeltypen|E – For encounter notes of type “Evaluatie” (“E”) according to the “SOEP” system.
    • http://fhir.nl/fhir/NamingSystem/journaalregeltypen|P – For encounter notes of type “Plan” (“P”) according to the “SOEP” system.
    • http://zorgdomein.nl/fhir/ValueSet/observation-codes|VD – For encounter notes that don’t fit the “SOEP” system.
    • http://zorgdomein.nl/fhir/ValueSet/observation-codes|AO – For general examination results that should be mapped to the “Aanvullend onderzoek” field in the referral letter.
    • http://snomed.info/sct|228272008 – For registrations of high-risk health related behavior (Risicovol leefgedrag).
    • http://snomed.info/sct|416471007 – For registrations related to family history (Familieanamnese).
    • http://snomed.info/sct|363910003 – For registrations of psychosocial functioning (Psychosociale anamnese).
    • http://snomed.info/sct|161464003 – For registrations about history of psychiatric disorder (Psychiatrische voorgeschiedenis).
    • http://snomed.info/sct|3161000175102 – For registrations about suicide risk (Suïcidaliteit).
    • http://loinc.org|11996-6 – Gravida: total number of times the patient has been pregnant including the present pregnancy.
    • http://loinc.org|11977-6 – Para: total number of times the uterus has been emptied of viable offspring.
    • http://loinc.org|11778-8 – Delivery date for patient selected by practitioner using all pertinent information (a terme datum).
    • http://snomed.info/sct|57036006 – Fetal gestational age (zwangerschapsduur).
    • http://snomed.info/sct|364305003 – Pattern of menstrual cycle.
    • http://loinc.org|11957-8 – Fetal crown rump length.
    • http://snomed.info/sct|248983002 – Obstetric history.
    • http://loinc.org|8302-2 – Body height.
    • http://loinc.org|29463-7 – Body weight.
    • https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen| – For diagnostic test results that should be mapped to the lab results table in the referral letter or request form (used for telenephrology).
  • date=ge[date]: the resources in the search result must only contain Observation resources that have an Observation.effective value that is greater than or equal to [date].
  • _sort=-date: indicates that the resources in the search result must be sorted by date, descending.
  • _count=1: return only 1 resource in the search result.

The canonical URL for this profile is:

http://zorgdomein.nl/fhir/StructureDefinition/zd-observation

This profile builds on Observation.


identifier Σ 0..* Identifier
basedOn Σ 0..* Reference(CarePlan | DeviceRequest | ImmunizationRecommendation | MedicationRequest | NutritionOrder | ProcedureRequest | ReferralRequest)
status Σ ?! 1..1 codeBinding
category 0..* CodeableConceptBinding
system Σ 1..1 uri
version Σ 0..1 string
code Σ 0..1 code
display Σ 0..1 string
userSelected Σ 0..1 boolean
text S Σ 1..1 string
subject S Σ 0..1 Reference(ZD Patient)
context S 0..1 Reference(ZD Encounter)
effectiveDateTime dateTime
effectivePeriod Period
issued S Σ 0..1 instant
performer Σ 0..* Reference(ZD Practitioner | ZD Organization)
valueCodeableConcept CodeableConcept
valueString string
dataAbsentReason 0..1 CodeableConceptBinding
interpretation 0..1 CodeableConceptBinding
comment 0..1 string
bodySite 0..1 CodeableConcept
method 0..1 CodeableConcept
specimen 0..1 Reference(Specimen)
device 0..1 Reference(Device | DeviceMetric)
low 0..1 SimpleQuantity
high 0..1 SimpleQuantity
type 0..1 CodeableConceptBinding
appliesTo 0..* CodeableConcept
age 0..1 Range
text 0..1 string
type 0..1 codeBinding
target 1..1 Reference(Observation | QuestionnaireResponse | Sequence)
code Σ 1..1 CodeableConcept
valueQuantity Quantity
valueCodeableConcept CodeableConcept
valueString string
valueRange Range
valueRatio Ratio
valueSampledData SampledData
valueAttachment Attachment
valueTime time
valueDateTime dateTime
valuePeriod Period
dataAbsentReason 0..1 CodeableConceptBinding
interpretation 0..1 CodeableConceptBinding
referenceRange 0..* see (referenceRange)

See the profile on simplifier.net for additional details.

Resource example

Below you find an example of an Observation resource that conforms to the ZD Observation profile.

    {
      "resourceType" : "Observation",
      "id" : "zd-observation-11",
      "meta" : {
        "profile" : [
          "http://zorgdomein.nl/fhir/StructureDefinition/zd-observation"
        ]
      },
      "status" : "final",
      "code" : {
        "coding" : [
          {
            "system" : "http://zorgdomein.nl/fhir/ValueSet/observation-codes/",
            "code" : "anamnesis",
            "display" : "Anamnese"
          }
        ]
      },
      "subject" : {
        "reference" : "Patient/zd-patient-1",
        "display" : "K. Aelbrinck-de Jager"
      },
      "context" : {
        "reference" : "Encounter/zd-encounter-1"
      },
      "issued" : "2017-01-15T09:40:00+01:00",
      "performer" : [
        {
          "reference" : "Practitioner/zd-practitioner-1",
          "display" : "H. de Vries"
        }
      ],
      "valueCodeableConcept" : {
        "text" : "ca 15 jaar geleden knie verdraaid met sporten. Sindsdien ca 2x per jaar klachten van linker knie. Nu ook weer heeft met lopen knie verdraaid. In het verleden wel fysiotherapie gehad, toen weinig baat van gehad."
      }
    }
    
    <Observation xmlns="http://hl7.org/fhir">
      <id value="zd-observation-11"/>
      <meta>
        <profile value="http://zorgdomein.nl/fhir/StructureDefinition/zd-observation"/>
      </meta>
      <status value="final"/>
      <code>
        <coding>
          <system value="http://zorgdomein.nl/fhir/ValueSet/observation-codes/"/>
          <code value="anamnesis"/>
          <display value="Anamnese"/>
        </coding>
      </code>
      <subject>
        <reference value="Patient/zd-patient-1"/>
        <display value="K. Aelbrinck-de Jager"/>
      </subject>
      <context>
        <reference value="Encounter/zd-encounter-1"/>
      </context>
      <issued value="2017-01-15T09:40:00+01:00"/>
      <performer>
        <reference value="Practitioner/zd-practitioner-1"/>
        <display value="H. de Vries"/>
      </performer>
      <valueCodeableConcept>
        <text value="ca 15 jaar geleden knie verdraaid met sporten. Sindsdien ca 2x per jaar klachten van linker knie. Nu ook weer heeft met lopen knie verdraaid. In het verleden wel fysiotherapie gehad, toen weinig baat van gehad."/>
      </valueCodeableConcept>
    </Observation>