RED medical offers a FHIR interface for third-party data providers/consumers. This interface is based on the German regulatory standards §291 (Verordnungssoftware - Schnittstelle / VOS) and §371 (Archiv- und Wechselschnittstelle / AWS) SGB V. These interfaces are based on the international FHIR-Standard with local extensions e.g. for statutory billing purposes.
RED interchange API provides a third-party system with functions
The RED interchange API uses the XML-based FHIR format for data exchange. Data to be sent to RED must be separated and packaged into FHIR bundles, and data queried from RED will be returned in FHIR bundles. RED uses the FHIR bundles defined by Kassenärztliche Bundesvereinigung in their AWS project.
In order to ensure the secrecy of person-related data (as required by German criminal law) RED uses end-to-end encryption of all person-related data stored in its data-centers. In order to access data in RED Users must authenticate during login and obtain the cryptographic keys necessary to decrypt and encrypt data. Therefore the RED interchange API cannot be a server interface, as encryption keys are in the possession of the users only, and data cannot be encrypted or decrypted server-side. By requirement the RED interchange API expects to communicate with an application installed on the local machine or a locally installed server reachable via localhost.
After a user has logged in successfully and obtained his cryptographic keys a local FHIR server is started by RED on the users machine. If the FHIR server is running RED will act as recipient and listen to POST and GET requests from the sending third-party application.
To use the RED interchange API it must be set up for each RED terminal (Arbeitsplatz). For development and testing the tool Postman (https://www.postman.com/downloads/) can be used as sending application. Please contact us to receive a Postman collection with sample requests.
RED interchange API - Search/Read Practitioners
RED interchange API - Search/Read PractitionerRoles
RED interchange API - Search/Read Organizations
RED interchange API - Search/Read Claims
RED interchange API - Search/Read Encounters
RED interchange API - Search/Read Observations
RED interchange API - Search/Read Coverages
RED interchange API - Search/Read DocumentReferences
RED Interchange API - Search/Read Medication