eMediplan CHMED Implementation Guide
2.1.0 - CI Build Switzerland flag

eMediplan CHMED Implementation Guide, published by IG eMediplan. This is not an authorized publication; it is the continuous build for version 2.1.0). This version is based on the current content of https://github.com/ahdis/chmed/ and changes regularly. See the Directory of published versions


Official URL: http://chmed.emediplan.ch/fhir/ImplementationGuide/ch.chmed.emediplan Version: 2.1.0
Active as of 2022-06-23 Computable Name: CHMED

Copyright/Legal: CC-BY-SA-4.0


Medication plans are a central pillar of any eHealth solution. To enable interoperability between eHealth systems in Switzerland, the organization ‘IG eMediplan’ was founded in 2016. Its aim is to support and provide public, open source, medication plan formats supported by a broad group of stakeholders from the public and private sectors.

Fig.: Example of a Mediplan

Fig.: Example of a Mediplan

About this IG and CHMED


The purpose of this implementation guide is to specify the medication plan exchange formats based on the FHIR® standard from HL7®.

Extending the CHMED23A format to a FHIR based definition (CHMED) has the following advantages:

  • CHMED formats can be validated for correctness, data types are well defined.
  • Base interoperabilty for other projects based on medications, e.g. mappings will be provided for the exchange formats for medication with the EPR in Switzerland.

The CHEMD format can be either in XML or JSON format. However, both are too big in size to be exchanged in a QR code.

HCI Solutions AG has built a converter for all software houses that have integrated the CHMED16A/CHMED23A. If you have questions or want more information please contact hotline@hcisolutions.ch directly.


  • Documents - in FHIR format to exchange the eMedication information.
  • Profiles - are constraints of FHIR resources and data types for the context of CHMED.
  • Extensions - are FHIR extensions that are added to be able to represent the complete CHMED context.
  • Terminologies - were defined and represented to allow exchange of coded data.
  • Dosage - describes the posology of a medicament in more detail.
  • Artifacts - provides a list of the FHIR artifacts included in this implementation guide.


The meaning of the flag mustSupport for this implementation guide follows the definition of CH EMED, the Swiss eMedication IG from which CHMED is derived.


You can download this implementation guide in NPM format from here.

Change Log

Significant changes to this specification since its initial version.


The ‘eMedication Plan CHMED23A’ paper describes the specification and reference implementation of the object model for a medication plan, the so-called CHMED23A.

The reference consists of:

  • The content and layout specification for the electronic document, a JSON file including a medication (Med) for which the format (MedF) and compression (IsCompressed) is being specified.
    • Med will be a string if compressed or a JSON object otherwise
    • The JSON file must be encoded in UTF-8

The content and layout specification for a paper-based layout used in Print/PDF scenarios is described in the document ‘eMediplan_Paper-based_Layout’.

This allows IT systems to store and transmit electronic medication plans as JSON file in UTF-8. It also makes it possible to transmit the mediplan print-based using QR barcodes. Therefore, the mediplan is readable by users and systems alike. This is necessary to guarantee a simple handling.

A typical compressed CHMED23A object would look like this:

    "MedF": "ChMed23A", 
    "IsCompressed": true, 

It is recommended to use the compressed CHMED23A object to minimize data size.

This implementation guide includes content from SNOMED CT, which is copyright © 2002+ International Health Terminology Standards Development Organisation (IHTSDO) and distributed by agreement between IHTSDO and HL7. Implementers of these specification must have the appropriate SNOMED CT Affiliate license - for more information contact https://www.snomed.org/snomed-ct/getsnomed or info@snomed.org.

This implementation guide contains content from LOINC® (http://loinc.org). The LOINC table, LOINC codes, and LOINC panels and forms file are copyright © 1995-2014, Regenstrief Institute, Inc. and the Logical Observation Identifiers Names and Codes (LOINC) Committee and available at no cost under the license at http://loinc.org/terms-of-use .