eMediplan CHMED16AF Implementation Guide: Home


Medication plans are a central pillar of any eHealth solution. To enable interoperability between eHealth systems in Switzerland, the organization “Verein 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.

Example Mediplan


CHMED16A describes the proposed specification and reference implementation of the object model for a medication plan, the so called CHMED16A.

The reference consists of two major parts:

  • The content and layout specification for the electronic document, a string / textfile containing a header such as “CHMED16A1” and the (compressed, encoded) medication plan as a JSON object in UTF-8
  • The content and layout specification for a paper-based layout used in Print/PDF scenarios

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

A typical CHMED16A object would look like this:



In addition, the layout specification for the print-based layouts makes recognition of and work with medication plans easier for medical professionals and patients, as the documents will come in a universal layout, independent of the individual IT systems. Details


Disclaimer 11.06.2019: This is the current version (0.2.0) for FHIR Release 4. Please contact info@emediplan.ch if you start implementing. There will be also a convertor made availabe from version (0.1.0) based on STU3 to version 0.2.0.

FHIR is a standard in development from HL7. FHIR consists of a RESTFul API and a set of interoperability Ressources.

Extending the CHMED16A format to a FHIR based definition (CHMED16AF) has the following advantages:

  • Support for implementers: .NET/Java and other implementations are availabe to work directly with FHIR Ressources, no separate Parser/Serializer has to be written
  • CHMED16AF 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 CHEMD16AF format can bei either in XML or JSON format.

In the section Introduction the structure for the different formats/values are explained.