Document toolboxDocument toolbox

Z1.4.2 | BgZ: FHIR Workflow Task implementation

Owned by Ben van der Stigchel
Dec 18, 2023
4 min read

The Sending System may choose to provide a Workflow Task resource that can be used to exchange status updates and other workflow related details related to the healthcare process that demands the data exchange. In the context of a BgZ-referral, the Sending System may choose to provide a Workflow Task resource that is used to exchange details about status updates or other workflow updates related to the referral (see Notification scope).

An example of a BgZ Workflow Task profile

Name

Card.

Type

Comments

Name

Card.

Type

Comments

definition

0..1

Reference
(ActivityDefinition)

Reference to ActivityDefinition resources that defines the requested activity or service

status

1..1

code

requested | received | accepted | rejected | cancelled | completed

intent

1..1

code

“order”

priority

0..1

code

normal | urgent | asap | stat

code

1..1

CodeableConcept

 

-- coding

1..1

Coding

 

-- -- SNOMED

1..1

Slice

 

-- -- -- system

1..1

string

“http://snomed.info/sct”

-- -- -- code

1..1

code

“3457005”

-- -- -- display

0..1

string

“verwijzen van patiënt”

-- text

1..1

string

“Verwijzing”

description

0..1

string

 

focus

0..1

Reference(ReferralRequest | CarePlan)

 

for

0..1

Reference(nl-core-patient)

Reference to referred patient

authoredOn

0..1

dateTime

Date of referral submission

requester

0..1

BackboneElement

 

-- agent

1..1

Reference(nl-core-practitioner)

Reference to the practitioner who sent the referral

-- -- extension

 

Extension

 

-- -- -- practitionerRole

 

Extension(Reference(nl-core-practitionerrole))

Extension to relate the Practitioner to an organization, Location, HealthcareService, role, specialism, etc.

-- onBehalfOf

0..1

Reference(nl-core-organization)

Reference to the Sending Organization

owner

0..1

Reference(nl-core-organization)

Reference to the Receiving Organization

restriction

0..1

BackboneElement

 

-- period

0..1

Period

 

-- -- start

0..1

dateTime

Earliest date to start requested treatment or service

-- -- end

0..1

dateTime

Latest date to start requested treatment or service

input

0..*

BackboneElement

 

-- patientInformation

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- LOINC

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://loinc.org”

-- -- -- -- code

1..1

code

“79191-3”

-- -- -- -- display

0..1

string

“Patient demographics panel”

-- -- text

1..1

string

“Patient information”

-- -- valueString

1..1

string

“/Patient?_include=Patient:general-practitioner”

-- paymentDetails

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- LOINC

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://loinc.org”

-- -- -- -- code

1..1

code

“48768-6”

-- -- -- -- display

0..1

string

“Payment sources”

-- -- text

1..1

string

“Insurance information”

-- -- valueString

1..1

string

“/Coverage?_include=Coverage:payor:Patient&_include=Coverage:payor:Organization”

-- treatmentDirective

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- LOINC

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://loinc.org”

-- -- -- -- code

1..1

code

“11291000146105”

-- -- -- -- display

0..1

string

“Treatment instructions”

-- -- text

1..1

string

“Known treatment directives”

-- -- valueString

1..1

string

“/Consent?category=http://snomed.info/sct|11291000146105”

-- advanceDirective

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- LOINC

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://loinc.org”

-- -- -- -- code

1..1

code

“11341000146107”

-- -- -- -- display

0..1

string

“Living will and advance directive record”

-- -- text

1..1

string

“Known advance directives”

-- -- valueString

1..1

string

“/Consent?category=http://snomed.info/sct|11341000146107”

-- functionalStatus

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- LOINC

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://loinc.org”

-- -- -- -- code

1..1

code

“47420-5”

-- -- -- -- display

0..1

string

“Functional status assessment note”

-- -- text

1..1

string

“Last known functional / mental status”

-- -- valueString

1..1

string

“/Observation/$lastn?category=http://snomed.info/sct|118228005,http://snomed.info/sct|384821006”

-- problems

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- LOINC

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://loinc.org”

-- -- -- -- code

1..1

code

“11450-4”

-- -- -- -- display

0..1

string

“Problem list”

-- -- text

1..1

string

“All known problems”

-- -- valueString

1..1

string

“/Condition”

-- livingSituation

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- SNOMED

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://snomed.info/sct”

-- -- -- -- code

1..1

code

“365508006”

-- -- -- -- display

0..1

string

“Finding of residence and accommodation circumstances”

-- -- text

1..1

string

“Current living situation”

-- -- valueString

1..1

string

“/Observation/$lastn?code=http://snomed.info/sct|365508006”

-- drugUse

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- SNOMED

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://snomed.info/sct”

-- -- -- -- code

1..1

code

“228366006”

-- -- -- -- display

0..1

string

“Finding relating to drug misuse behavior”

-- -- text

1..1

string

“All known drug use”

-- -- valueString

1..1

string

“/Observation?code=http://snomed.info/sct|228366006”

-- alcoholUse

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- SNOMED

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://snomed.info/sct”

-- -- -- -- code

1..1

code

“228273003”

-- -- -- -- display

0..1

string

“Finding relating to alcohol drinking behavior”

-- -- text

1..1

string

“All known alcohol use”

-- -- valueString

1..1

string

“/Observation?code=http://snomed.info/sct|228273003”

-- tobaccoUse

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- SNOMED

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://snomed.info/sct”

-- -- -- -- code

1..1

code

“365980008”

-- -- -- -- display

0..1

string

“Finding of tobacco use and exposure”

-- -- text

1..1

string

“All known tobacco use”

-- -- valueString

1..1

string

“/Observation?code=http://snomed.info/sct|365980008”

-- nutritionAdvice

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- SNOMED

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://snomed.info/sct”

-- -- -- -- code

1..1

code

“11816003”

-- -- -- -- display

0..1

string

“Diet education”

-- -- text

1..1

string

“All known dietary recommendations”

-- -- valueString

1..1

string

“/NutritionOrder”

-- alert

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- LOINC

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://loinc.org”

-- -- -- -- code

1..1

code

“75310-3”

-- -- -- -- display

0..1

string

“Health concerns”

-- -- text

1..1

string

“All known alerts”

-- -- valueString

1..1

string

“/Flag”

-- allergyIntolerance

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- LOINC

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://loinc.org”

-- -- -- -- code

1..1

code

“48765-2”

-- -- -- -- display

0..1

string

“Allergies and adverse reactions”

-- -- text

1..1

string

“All known information regarding allergies”

-- -- valueString

1..1

string

“/AllergyIntolerance”

-- medicationUse

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- SNOMED

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://snomed.info/sct”

-- -- -- -- code

1..1

code

“16076005”

-- -- -- -- display

0..1

string

“Prescription”

-- -- text

1..1

string

“Known medication use”

-- -- valueString

1..1

string

“/MedicationStatement?category=urn:oid:2.16.840.1.113883.2.4.3.11.60.20.77.5.3|6&_include=MedicationStatement:medication”

-- medicationAgreement

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- SNOMED

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://snomed.info/sct”

-- -- -- -- code

1..1

code

“422037009”

-- -- -- -- display

0..1

string

“Provider medication administration instructions”

-- -- text

1..1

string

“Known medication agreements”

-- -- valueString

1..1

string

“/MedicationRequest?category=http://snomed.info/sct|16076005&_include=MedicationRequest:medication”

– administrationAgreement

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- SNOMED

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://snomed.info/sct”

-- -- -- -- code

1..1

code

“422979000”

-- -- -- -- display

0..1

string

“Medication regimen behavior finding”

-- -- text

1..1

string

“Known administration agreements”

-- -- valueString

1..1

string

“/MedicationDispense?category=http://snomed.info/sct|422037009&_include=MedicationDispense:medication”

-- medicalAids

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- LOINC

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://loinc.org”

-- -- -- -- code

1..1

code

“46264-8”

-- -- -- -- display

0..1

string

“History of medical device use”

-- -- text

1..1

string

“Known medical aids”

-- -- valueString

1..1

string

“/DeviceUseStatement?_include=DeviceUseStatement:device”

-- vaccinations

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- LOINC

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://loinc.org”

-- -- -- -- code

1..1

code

“11369-6”

-- -- -- -- display

0..1

string

“Immunization”

-- -- text

1..1

string

“Known vaccinations”

-- -- valueString

1..1

string

“/Immunization?status=completed”

-- bloodPressure

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- LOINC

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://loinc.org”

-- -- -- -- code

1..1

code

“85354-9”

-- -- -- -- display

0..1

string

“Blood pressure panel”

-- -- text

1..1

string

“Last known blood pressure”

-- -- valueString

1..1

string

“/Observation/$lastn?code=http://loinc.org|85354-9”

-- bodyWeight

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- LOINC

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://loinc.org”

-- -- -- -- code

1..1

code

“29463-7”

-- -- -- -- display

0..1

string

“Body weight”

-- -- text

1..1

string

“Last known body weight”

-- -- valueString

1..1

string

“/Observation/$lastn?code=http://loinc.org|29463-7”

-- bodyHeight

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- LOINC

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://loinc.org”

-- -- -- -- code

1..1

code

“8302-2”

-- -- -- -- display

0..1

string

“Body height”

-- -- text

1..1

string

“Last known body height”

-- -- valueString

1..1

string

“/Observation/$lastn?code=http://loinc.org|8302-2,http://loinc.org|8306-3,http://loinc.org|8308-9”

-- results

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- SNOMED

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://snomed.info/sct”

-- -- -- -- code

1..1

code

“15220000”

-- -- -- -- display

0..1

string

“Laboratory test”

-- -- text

1..1

string

“Last known laboratory results per type”

-- -- valueString

1..1

string

“/Observation/$lastn?category=http://snomed.info/sct|275711006&_include=Observation:related-target&_include=Observation:specimen”

-- procedures

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- LOINC

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://loinc.org”

-- -- -- -- code

1..1

code

“47519-4”

-- -- -- -- display

0..1

string

“History of procedures”

-- -- text

1..1

string

“Known surgical procedures”

-- -- valueString

1..1

string

“/Procedure?category=http://snomed.info/sct|387713003”

-- encounters

0..1

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- LOINC

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://loinc.org”

-- -- -- -- code

1..1

code

“46240-8”

-- -- -- -- display

0..1

string

“Hospitalizations+Outpatient visits”

-- -- text

1..1

string

“Known hospital admissions (no outpatient contacts)”

-- -- valueString

1..1

string

“/Encounter?class=http://hl7.org/fhir/v3/ActCode|IMP,http://hl7.org/fhir/v3/ActCode|ACUTE,http://hl7.org/fhir/v3/ActCode|NONAC”

-- plannedCare

0..4

Slice

 

-- -- type

1..1

CodeableConcept

 

-- -- coding

1..*

Coding

 

-- -- -- LOINC

1..1

Slice

 

-- -- -- -- system

1..1

string

“http://loinc.org”

-- -- -- -- code

1..1

code

“18776-5”

-- -- -- -- display

0..1

string

“Plan of care note”

-- -- text

1..1

string

“Known planned care activities”

-- -- valueString

1..1

string

“/ProcedureRequest?status=active” or

“/ImmunizationRecommendation” or

“/DeviceRequest?status=active&_include=DeviceRequest:device” or

“/Appointment?status=booked,pending,proposed”

As described in the section Notified Pull interaction every reference can be coded specific to the part. The codes of all HCIMs are in the table below.

HCIM

Code

System

HCIM

Code

System

Patient

MaritalStatus

ContactPerson

HealthProfessional

79191-3

http://loinc.org

Payer

48768-6

http://loinc.org

TreatmentDirective

11291000146105

http://snomed.info/sct

AdvanceDirective

11341000146107

http://snomed.info/sct

FunctionalOrMentalStatus

47420-5

http://loinc.org

Problem

11450-4

http://loinc.org

LivingSituation

365508006

http://snomed.info/sct

DrugUse

228366006

http://snomed.info/sct

AlcoholUse

228273003

http://snomed.info/sct

TobaccoUse

365980008

http://snomed.info/sct

NutritionAdvice

11816003

http://snomed.info/sct

Alert

75310-3

http://loinc.org

AllergyIntolerance

48765-2

http://loinc.org

MedicationAgreement

16076005

http://snomed.info/sct

AdministrationAgreement

422037009

http://snomed.info/sct

MedicationUse2

422979000

http://snomed.info/sct

MedicalDevice

46264-8

http://loinc.org

Vaccination

11369-6

http://loinc.org

BloodPressure

85354-9

http://loinc.org

BodyWeight

29463-7

http://loinc.org

BodyHeight

8302-2

http://loinc.org

LaboratoryTestResult

15220000

http://snomed.info/sct

Procedure

47519-4

http://loinc.org

Encounter

46240-8

http://loinc.org

PlannedCareActivityForTransfer

18776-5

http://loinc.org