In addition to deliver printed Patientenausdrucke to a pharmacy patients also may use the official gematik application to select a pharmacy in order to assign their prescriptions to this pharmacy for dispensation. Once a prescription has been assigned to a pharmacy a message is sent to the pharmacy. The RED telematik API communications service allows pharmacies to poll for new messages and to fetch messages from central Fachdienst servers.


A request for all unread messages is sent using a GET request. The requesting pharmacy is identified by its SMC-B card that must be accessible in a card terminal.

{{baseURL}}/{{tenant}}/Communication?action=$received

In response the Fachdienst will return an XML data set with patient data and access codes (basedOn.reference). 

Example for an answer from Fachdienst with no new messages
{
    "Bundle": {
        "id": "613d3f9f-786a-4750-9404-9e616be18353",
        "type": "searchset",
        "timestamp": "2022-08-12T11:44:10.146+00:00",
        "resourceType": "Bundle",
        "total": 2,
        "entry": [
            {
                "fullUrl": "https://erp-ref.zentral.erp.splitdns.ti-dienste.de/Communication/01eb8fe7-9e33-4a98-3331-55d4184fc224",
                "resource": {
                    "status": "unknown",
                    "payload": [
                        {
                            "contentString": "{\"address\":[\"Dudenstraße 11\",\"36251\",\"Bad Hersfeld\"],\"phone\":\"017670834812\",\"supplyOptionsType\":\"onPremise\",\"hint\":\"\",\"name\":\"Alice Hanna Schühmann\",\"version\":\"1\"}"
                        }
                    ],
                    "recipient": [
                        {
                            "identifier": {
                                "system": "https://gematik.de/fhir/NamingSystem/TelematikID",
                                "value": "3-SMC-B-Testkarte-883110000116808"
                            }
                        }
                    ],
                    "meta": {
                        "profile": [
                            "https://gematik.de/fhir/StructureDefinition/ErxCommunicationDispReq"
                        ]
                    },
                    "resourceType": "Communication",
                    "basedOn": [
                        {
                            "reference": "Task/160.000.166.584.050.55/$accept?ac=048bb2fdecbfdceb15f814f270e2da0ae23fd828f798931b978f15eed57ee19d"
                        }
                    ],
                    "sender": {
                        "identifier": {
                            "value": "X110459979",
                            "system": "http://fhir.de/NamingSystem/gkv/kvid-10"
                        }
                    },
                    "sent": "2022-08-12T11:41:59.311+00:00",
                    "id": "01eb8fe7-9e33-4a98-3331-55d4184fc224",
                    "received": "2022-08-12T11:44:10.136+00:00"
                },
                "search": {
                    "mode": "match"
                }
            },
            {
                "fullUrl": "https://erp-ref.zentral.erp.splitdns.ti-dienste.de/Communication/01eb8fe6-2ef0-6e78-98a5-77ea756eb2aa",
                "resource": {
                    "status": "unknown",
                    "payload": [
                        {
                            "contentString": "{\"address\":[\"Dudenstraße 11\",\"36251\",\"Bad Hersfeld\"],\"phone\":\"017670834812\",\"supplyOptionsType\":\"shipment\",\"hint\":\"\",\"name\":\"Alice Hanna Schühmann\",\"version\":\"1\"}"
                        }
                    ],
                    "recipient": [
                        {
                            "identifier": {
                                "system": "https://gematik.de/fhir/NamingSystem/TelematikID",
                                "value": "3-SMC-B-Testkarte-883110000116808"
                            }
                        }
                    ],
                    "meta": {
                        "profile": [
                            "https://gematik.de/fhir/StructureDefinition/ErxCommunicationDispReq"
                        ]
                    },
                    "resourceType": "Communication",
                    "basedOn": [
                        {
                            "reference": "Task/160.000.166.573.412.56/$accept?ac=5b582ce14823e981e2921827127bfa2f4658953a79d51d0e7dabe6bb3d33bf4e"
                        }
                    ],
                    "sender": {
                        "identifier": {
                            "value": "X110459979",
                            "system": "http://fhir.de/NamingSystem/gkv/kvid-10"
                        }
                    },
                    "sent": "2022-08-12T09:59:17.691+00:00",
                    "id": "01eb8fe6-2ef0-6e78-98a5-77ea756eb2aa",
                    "received": "2022-08-12T11:44:10.136+00:00"
                },
                "search": {
                    "mode": "match"
                }
            }
        ],
        "link": [
            {
                "relation": "self",
                "url": "https://erp-ref.zentral.erp.splitdns.ti-dienste.de/Communication?received=eqNULL"
            }
        ]
    }
}
  • No labels