eMediplan CHMED20AF Implementation Guide: Introduction

This page is part of the eMediplan CHMED20AF FHIR IG (R4) (v2.0.0: STU 1) based on FHIR R4. . For a full list of available versions, see the Directory of published versions

Introduction

CHMED16A and CHMED20AF define two different exchange formats:

  1. Medication Card document (CHMED16A: MedicationPlan (MP))
  2. Medication Prescription document (CHMED16A: Prescription (Rx))

These exchange formats are defined in two different document types, which correspond to a Bundle as FHIR Ressource. A Bundle has list of Entries. The first Entry is the Composition where alle contained Entries are then referenced.

Medication Card document

The Medication Card document summarizes the entire, current medication of a patient.

Bundle

Bundle Medication Card document
bundle_medicationplan.png

The FHIR ressource Bundle bundles the corresponding entries in a document. It contains

  • The profile this bundle correspons to (chmed20af-card-bundle)
  • The type of the bundle (fixed here on “document”)
  • An entry to the composition, the actual document that references different resources (further entry elements in the bundle)
  • Further entry elements to the patient, medication card entries, etc.

Medication Card document: Profile, Example (XML, JSON)

Composition

The Composition ressource defines the following parameter for the Medication Card document:

Parameter Description Resource/Datatype CHMED16A
informationRecipient Receiver (Patient or Gln of receiver) Extension (Patient or Practitioner) Patient or Patient.RCV (Gln of receiver)
privatefield Private Field Extension (string) PFields
identifier Logical identifier for document (GUID) Identifier Id
type Type of medication object, 1: MedicationPlan (MP) code MedType
subject Reference to the Patient Patient Patient
date Date of creation dateTime Dt
author Author Practitioner Auth
attester:professionalAuthenticator.time Validate date: Date of validation dateTime ValDt
attester:professionalAuthenticator.party Validated by: The Gln of the practitionier Practitioner ValBy
section:card List of medicaments MedicationStatement Medicaments
section:healthconcerns Health concerns Entry MedicalData
section:annotation Notes text Rmk

Composition Medication Card document: Profile, Example (XML, JSON)

Patient

Parameter Description Resource/Datatype CHMED16A
privatefield Private Field Extension (string) Patient.PFields
identifier Local identifier for this patient Identifier Patient.Id with PatientId.Type (LocalPatientIdentifier = 2)
name Name for this patient HumanName name.given = Patient.FName, name.family = Patient.LName
telecom Telephone number ContactPoint Patient.Phone
gender Gender code Patient.Gender, Male = 1, Female = 2
birthDate Date of birth date Patient.BDt
address Address for the patient Address address.line = Patient.Street, address.postalCode = Patient.Zip, address.city = Patient.City
communication.language Language of the patient CodeableConcept Patient.Lng conversion between ISO 639-1 (de) to urn:ietf:cbp:47 (de_CH) necessary”

Patient (Medication Card document): Profile, Example (XML, JSON)

Practitioner

Parameter Description Resource/Datatype CHMED16A
identifier Gln for this practitioner Identifier Auth.Gln
name Name for this practitioner HumanName name.given = Auth.FName, name.family = Auth.LName

Practitioner: Profile, Example (XML, JSON)

Medication Section

The medication section contains the entries for the current medications for patient.

Parameter Description Resource/Datatype CHMED16A
privatefield Private Field Extension (string) Medicament.PFields
medicationReference Reference to Medication Medication Medicament.Id with Medicament.IdType 2 (GTIN)
subject Reference to Patient Patient Patient
informationSource Person that provided the information about the taking of this medication Patient or Practitioner Medicament.AutoMed (Selfmedication) if Patient, Medicament.PrscbBy if Practitioner
reasonCode Taking reason text Medicament.TkgRsn
dosage:nonstructured Application Instructions Dosage Medicament.AppInstr
dosage:structured List of Posology Dosage Medicament.Pos
Dosage.timing When medication should be administered Timing Posology.DtFrom, Posology.DtTo, Posology.CyDu, Posology.InRes
Dosage.route How drug should enter body CodeableConect Medicament.Roa
Dosage.doseAndRate.dose[x] Amount of medication per dose SimpleQuantity, Range doseQuantity: TakingTime.A, doseRange: TakingTime.DoFrom, TakingTime.DoTo
Dosage.maxDosePerPeriod Amount of medication per dose Ratio TakingTime.MA

MedicationStatement: Profile, Example 1 (XML, JSON), Example 2 (XML, JSON), Example 3 (XML, JSON), Example 4 (XML, JSON)

Health Concerns Section

The health concern sections contains the medical data for the patient and the possible risks. If the risk category is specified without any risk specified in the code, the entire risk category is considered as explicitly excluded for the current patient. If the risk category does not exist, the risks are considered as unknown for the patient.

Entry Description Resource/Datatype CHMED16A
Body Weight Weight measurement for patient in kg Observation MedicalData.Meas.Weight
Body Height Weight measurement for patient in cm Observation MedicalData.Meas.Height
First day of last menstruation First day of last menstruation Observation MedicalData.DLstMen
Premature baby premature baby true only if age <= 18 months Observation MedicalData.Prem
Time of gestation Time of gestation only if Premature Baby Observation MedicalData.ToG.Weeks + MedicalData.ToG.Day
Risks per group Renal Insufficiency Condition MedicalData.RC
Risks per group Liver Insufficiency Condition MedicalData.RC
Risks per group Reproduction Condition MedicalData.RC
Risks per group Competitive athlete Condition MedicalData.RC
Risks per group Driver Condition MedicalData.RC
Risks per group Allergies Condition MedicalData.RC

Medication Prescription document

A Medication Prescription document can be structured in a bundle according to the prescription bundle profile.

Bundle

Bundle Medication Prescription document
bundle_prescription.png

The FHIR ressource Bundle bundles the corresponding entries in a document. It contains

  • The profile this bundle correspons to (chmed20af-pre-bundle)
  • The type of the bundle (fixed here on “document”)
  • An entry to the composition, the actual document that references different resources (further entry elements in the bundle)
  • Further entry elements to the patient, medication entries, etc.

Medication Prescription document: Profile, Example (XML, JSON)

Composition

The Composition ressource defines the following parameter for the Prescription:

Parameter Description Resource/Datatype CHMED16A
informationRecipient Receiver (Patient or Gln of receiver) Extension (Patient or Practitioner) Patient or Patient.RCV (Gln of receiver)
privatefield Private Field Extension (string) PFields
identifier Logical identifier for document (GUID) Identifier Id
type Type of medication object, 2: Prescription (Rx) code MedType
subject Reference to the Patient Patient Patient
date Date of creation dateTime Dt
author Author Practitioner Auth
attester:professionalAuthenticator.time Validate date: Date of validation dateTime ValDt
attester:professionalAuthenticator.party Validated by: The Gln of the practitionier Practitioner ValBy
section:prescription List of medicaments MedicationRequest Medicaments
section:annotation Notes text Rmk

Composition Medication Prescription document: Profile, Example (XML, JSON)

Patient

Parameter Description Resource/Datatype CHMED16A
privatefield Private Field Extension (string) Patient.PFields
identifier Local identifier for this patient Identifier Patient.Id with PatientId.Type (LocalPatientIdentifier = 2)
name Name for this patient HumanName name.given = Patient.FName, name.family = Patient.LName
telecom Telephone number ContactPoint Patient.Phone
gender Gender code Patient.Gender, Male = 1, Female = 2
birthDate Date of birth date Patient.BDt
address Address for the patient Address address.line = Patient.Street, address.postalCode = Patient.Zip, address.city = Patient.City

Patient (Medication Prescription document): Profile, Example (XML, JSON)

Practitioner

Parameter Description Resource/Datatype CHMED16A
identifier Gln for this practitioner Identifier Auth.Gln
identifier ZSR for this practitioner Identifier ZSR-Number of the organisation
name Name for this practitioner HumanName name.given = Auth.FName, name.family = Auth.LName

Practitioner: Profile, Example (XML, JSON)

Medication Prescribed Section

The medication section contains the entries for the prescriped medications for the patient.

Parameter Description Resource/Datatype CHMED16A
privatefield Private Field Extension (string) Medicament.PFields
medicationReference Reference to Medication Medication Medicament.Id with Medicament.IdType 2 (GTIN)
subject Reference to Patient Patient Patient
dosageInstruction:nonstructured Application Instructions Dosage Medicament.AppInstr
dosageInstruction:structured List of Posology Dosage Medicament.Pos
Dosage.timing When medication should be administered Timing Posology.DtFrom, Posology.DtTo, Posology.CyDu, Posology.InRes
Dosage.route How drug should enter body CodeableConect Medicament.Roa
Dosage.doseAndRate.dose[x] Amount of medication per dose SimpleQuantity, Range doseQuantity: TakingTime.A, doseRange: TakingTime.DoFrom, TakingTime.DoTo
Dosage.maxDosePerPeriod Amount of medication per dose Ratio TakingTime.MA
dispenseRequest.numberOfRepeatsAllowed Number of repetitions allowed unsignedInt Medicament.Rep
dispenseRequest.quantity Number of package to be delivered SimpleQuantity Medicament.NbPack
substitution.allowedCodeableConcept Medication is substitutable CodeableConcept Medicament.Subs

MedicationRequest: Profile, Example (XML, JSON)