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"
}
]
}
}
