Order Catalog Implementation Guide
current - CI Build International flag

Order Catalog Implementation Guide, published by HL7 International - Orders and Observations Work Group. This is not an authorized publication; it is the continuous build for version current). This version is based on the current content of https://github.com/HL7/fhir-order-catalog/ and changes regularly. See the Directory of published versions

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Common profiles

Profiles applicable regarless of the kind of catalog (medications, lab tests, devices, order sets)

ValidityPeriod Extension

Extension adding catalog validity period to the CatalogHeader profile of Composition

CatalogReference Extension

Extension adding catalog reference to resources representing catalog items

CatalogHeader Profile

Profile of Composition for the header of a catalog of healthcare items (products, services, knowledge artifacts)

WarningDefinition Profile

Profile of ClinicalUseDefinition representing the definition of a warning

ContraindicationDefinition Profile

Profile of ClinicalUseDefinition representing the definition of a contraindication

IndicationDefinition Profile

Profile of ClinicalUseDefinition representing the definition of an indication

InteractionDefinition Profile

Profile of ClinicalUseDefinition representing the definition of an interaction

UndesirableEffectDefinition Profile

Profile of ClinicalUseDefinition representing the definition of an undesirable effect

CatalogMessageDefinition Profile

Profile of MessageDefinition for sending content of a catalog

ItemTransactionRequest Profile

Profile of Bundle for updating the content of a catalog in transaction mode

ItemTransactionResponse Profile

Profile of Bundle conveying the response to a transaction request for administering catalog content

Common examples

Examples applicable to any kind of catalog

Contraindication Allergy to Clarithromycin

instance of ClinicalUseDefinition conveying an allergy-type contraindication

Indication Acute Bacterial Pharyngitis

instance of ClinicalUseDefinition as an indication for acute bacterial pharyngitis

Indication Acute Bacterial Sinusitis

instance of ClinicalUseDefinition as an indication for acute bacterial sinusitis

Indication Acute Otitis Media

instance of ClinicalUseDefinition as an indication for acute otitis media

Message definition new catalog

MessageDefinition for messages conveying a new catalog to the receiver

Message definition catalog update

MessageDefinition for messages conveying an update to the receiver’s catalog

lab profiles

Profiles applicable to catalogs of orderable services of pathology and laboratory medicine

BillingSummary Extension

Extension adding a billing summary to the LabServiceDefinition profile of PlanDefinition

ScheduleSummary Extension

Extension adding a service schedule summary to the LabServiceDefinition profile of PlanDefinition

LimitationSummary Extension

Extension adding a service limitation summary to the LabServiceDefinition profile of PlanDefinition

RegulatorySummary Extension

Extension adding a textual summary of regulations applicable to the LabServiceDefinition profile of PlanDefinition

ResultInterpretationSummary Extension

Extension adding a markdown summary of result interpretation guidance applicable to the LabServiceDefinition profile of PlanDefinition

ServiceBillingCode Extension

Extension adding a service billing code (and possibly associated billing rules) to the LabServiceDefinition profile of PlanDefinition

SpecimenRequested Extension

Extension attaching specimen requested to a PlanDefinition.action, as a set of (possibly choosable) references to SpecimenDefiniton

LabChargeItemDefinition Profile

Profile of ChargeItemDefinition representing the definition of a billing code and its detailed properties and rules of applicability for a lab service

LabServiceDefinition Profile

Profile of PlanDefinition defining of a laboratory diagnostic service viewable and usable by potential consumers (clinicians, nurses, patients …)

LabProcedureDefinition Profile

Profile of ActivityDefinition representing the definition of a laboratory operational procedure

LabSpecimenDefinition Profile

Profile of SpecimenDefinition representing the definition of an IVD specimen used by a laboratory operational procedure

InputObservationDefinition Profile

Profile of ObservationDefinition defining an observation expected from the orderer by the performing laboratory for use in its procedures

LabObservationDefinition Profile

Profile of ObservationDefinition defining an observation outcome of a laboratory procedure, returned to the orderer of the service

Lab ToRCH example

The richest example of a laboratory medicine orderable service in this implementation guide

Lab service HSV 2 IgM titer

Lab E7 - simple test laboratory service - serum HSV 2 IgM titer

Lab service HSV 1 IgM titer

Lab E7 - simple test laboratory service - serum HSV 1 IgM titer

Lab service HSV IgM

Lab E7 - panel laboratory service - serum HSV 1 & 2 IgM screen panel + reflex titer

Lab service CMV IgM

Lab E7 - test laboratory service - serum CMV IgM test

Lab service Rubella IgM

Lab E7 - test laboratory service - serum Rubella IgM test

Lab service Toxoplasma gondii Ab

Lab E7 - panel laboratory service - serum Toxoplasma gondii Antibody panel

Lab service TORCH panel

Lab E7 - panel laboratory service - serum TORCH panel

Lab procedure Toxoplasma gondii

Lab E7 - laboratory procedure - Toxoplasma gondii serology

Lab procedure Rubella IgM

Lab E7 - laboratory procedure - Rubella serology

Lab procedure CMV IgM

Lab E7 - laboratory procedure - CMV IgM

Lab procedure HSV serology

Lab E7 - laboratory procedure - HSV 1 & 2 IgM

Lab procedure HSV 1 IgM titer

Lab E7 - laboratory procedure - HSV 1 IgM titer

Lab procedure HSV 2 IgM titer

Lab E7 - laboratory procedure - HSV 2 IgM titer

Lab specimen venous serum 3 mL

Lab E7 - 3 mL serum specimen

Lab specimen venous serum 2 mL

Lab E7 - 2 mL serum specimen

Lab observation HSV 2 IgM titer

Lab E7: observation HSV 2 IgM titer on serum

Lab observation HSV 1 IgM titer

Lab E7: observation HSV 1 IgM titer on serum

Lab observation HSV 2 IgM presence

Lab E7: observation HSV 2 IgM presence detection on serum

Lab observation HSV 1 IgM presence

Lab E7: observation HSV 1 IgM presence detection on serum

Lab observation Rubella IgM

Lab E7: observation Rubella IgM on serum

Lab observation CMV IgM

Lab E7: observation CMV IgM on serum

Lab observation Toxoplasma IgM

Lab E7: observation Toxoplasma IgM on serum

Lab observation Toxoplasma IgG

Lab E7: observation Toxoplasma IgG on serum

Lab observation Toxoplasma Ab interpretation

Lab E7: observation Toxoplasma Ab interpretation

Lab other examples

Common examples of laboratory medicine orderable services

A clinical laboratory catalog

Lab E* - Catalog header representing a clinical laboratory compendium, used by all lab examples in this implementation guide

Lab service serum K

Lab E1 - simple test laboratory service - serum K

Lab service blood electrolyte

Lab E2 - panel laboratory service - electrolyte on blood or plasma

Lab service 24H urine creat

Lab E3, E5 - panel laboratory service - creatinine on 24-hour urine specimen

Lab service serum creat

Lab E4, E5 - panel laboratory service - creatinine on serum or plasma specimen

Lab service creat renal clearance

Lab E5 - panel laboratory service - creatinine renal clearance using 24-hour urine specimen and serum or plasma specimen

Lab service vitamin D

Lab E6 - simple test laboratory service - vitamin D (in French)

Lab procedure 24H urine creat

Lab E3, E5 - panel laboratory procedure - 24-hour urine creatinine

Lab procedure serum creatinine

Lab E4, E5 - laboratory procedure - creatinine - on serum or plasma

Lab procedure serum K

Lab E1 - simple test laboratory procedure - serum K

Lab procedure blood electrolyte

Lab E2 - panel laboratory procedure - electrolyte on serum or plasma

Lab procedure creatinine clearance

Lab E5 - laboratory procedure carrying a single observation - creatinine renal clearance

Lab procedure vitamin D

Lab E6 - simple test laboratory procedure - vitamin D (in French)

Lab specimen venous serum

Lab E1, E4, E5, E6 - venous serum specimen requirement for a single chemistry test

Lab specimen capillary serum

Lab E4, E5 - capillary serum specimen requirement for a single chemistry test

Lab specimen serum/plasma

Lab E2: serum/plasma specimen

Lab specimen 24H urine

Lab E3: 24H urine specimen

Lab input observation - reason

Lab E1, E2: observation reason for test

Lab input observation - vitamin d

Lab E6: observation clinical context for vitamin D test

Lab observation serum Na

Lab E2: observation Na/serum

Lab observation serum K

Lab E1, E2: observation K/serum

Lab observation serum Cl

Lab E2 - definition of output observation Cl on serum

Lab observation collection duration

Lab E3 - definition of input/output observation urine collection duration

Lab observation urine volume

Lab E3 - definition of input/output observation 24-hour urine collection volume

Lab observation urine creat

Lab E3 - definition of lab observation 24-hour urine creatinine

Lab observation serum/plasma creat

Lab E4 - definition of lab observation serum/plasma creatinine

Lab observation creat renal clearance

Lab E5 - definition of lab observation - creatinine renal clearance in 24 hour urine and serum or plasma

Lab observation vitamin D

Lab E6: observation vitamin D on blood serum (in French)

Laboratory Organization

Lab E* - a fake laboratory Organization resource used by all laboratory examples of this implementation guide

Lab billing code and rule for vitamin D

Lab E6 - definition of charge item for laboratory service Vitamin D

Lab normal clinical focus for billing vitamin D

Lab E6 - value set of normal contexts enabling billing of Vitamin D test

Possible contexts for any lab test order

Contexts possibly associated with any laboratory test

Valid coded reasons for ordering a lab service

Lab E* - broadest value set of reasons for ordering a laboratory service

Lab compendium Create test

Lab E8 - transaction Bundle posted for creation of a test and its supporting resources into a laboratory compendium

Lab compendium test created

Lab E8 - transaction-response Bundle returned after creation of a test and its supporting resources into a laboratory compendium

Device profiles

Profiles applicable to catalogs of medical devices

DeviceModel Profile

Profile of DeviceDefinition to represent an item in a catalog of models of medical devices

Device examples

Examples of medical devices

A medical device catalog

Catalog header of a catalog of medical devices, used by all device examples in this implementation guide

Device model of breast pump

Device model of Philips Avent Breast Pump Single

Device model of presthetics-accessories

Titanium Healing Cap

Device model of interbody fusion system

Imola Interbody Fusion System

Drug profiles

Profiles applicable to catalogs of medicinal products

DrugKnowledge Profile

Profile of MedicationKnowledge to represent an item in a catalog of medications

DrugPackage Profile

Profile of PackagedProductDefinition to represent a packaging in an instance of MedicationKnowledge

Drug examples

Examples of medicinal products

Medications authorized for prescription in Healthyland

Catalog header of a catalog of medications, used by all medication examples in this implementation guide

Clarithromycin oral antibacterial

Clarithromycin 25 mg/ml granule for oral suspension

Clarithromycin package

Clarithromycin package of granules for oral suspension

Behavior: Capability Statements

The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.

Custodian of medication catalog

CapabilityStatement for custodian of catalog of medications

Custodian of medical device catalog

CapabilityStatement for custodian of catalog of medical devices

Custodian of laboratory service catalog

CapabilityStatement for custodian of catalog of laboratory services

Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

Laboratory service types ValueSet

Value set for types of laboratory service in the LabServiceDefinition profile of PlanDefinition

Laboratory service reimbursability categories ValueSet

ValueSet providing coarse categories of reimbursement dispositions for laboratory services

Bibliographic artifact ValueSet

Restrained value set for types of bibliographic artifact in the LabServiceDefinition profile of PlanDefinition

Order catalog message events ValueSet

ValueSet providing event codes for MessageHeader.eventCoding in FHIR messages conveying catalog content

Terminology: Code Systems

These define new code systems used by systems conforming to this implementation guide.

Laboratory service types CodeSystem

Code system for types of laboratory service

Laboratory service reimbursability categories CodeSystem

Code system providing coarse categories of reimbursement dispositions for laboratory services

Catalog message events CodeSystem

Code system providing event codes for messaging the content of order catalogs