ARS - Upload der Sendungen (synchron)

Zielstellung

Bereitstellung der Sendungen im Rahmen der Antibiotika-Resistenz-Surveillance über DEMIS an das RKI
Kontinuierliche (automatisierte) Bereitstellung der Sendungen von teilnehmenden Laboren

Vorbereitung

Es wurden entsprechende Zugänge (Testumgebung) beantragt
Die Integration der DEMIS Schnittstelle wurde auf der Testumgebung erfolgreich getestet.
Authentifizierung über geeignetes Verfahren in der DEMIS Schnittelle (Beispielsweise Zertifikat) ist möglich → Authentisierung von Primärsystemen

Ablauf

Nach einer erfolgreichen Authentisierung wird die FHIR-Ressource über ein HTTP-Post-Request an DEMIS gesendet. Der Dienst steht einzig über die Backend-Schnittstelle zur Verfügung. Ein Senden über das Meldeportal ist nicht vorgesehen.

Bitte beachten Sie auch Nutzung der FHIR-Schnittstelle als Sender

Endpunkte

Umgebung	Basis-URL
Produktion	https://demis.rki.de/surveillance/antibiotic-resistance/
Test / Integration	Informationen: Endpunkte, Zertifikate, User und Passwort

Erstellen der Sendung

Zum Erstellen der Sendung als FHIR Bundle ist folgendes Profil zu berücksichtigen: https://simplifier.net/rki.demis.ars

Folgende Beispiele geben zum Aufbau Hilfestellung: https://simplifier.net/rki.demis.ars/~resources?category=Example&exampletype=Bundle

Anmerkungen:

Der Bundle.identifier wird im DEMIS System neu gesetzt. Zu Identifikation sollten die Probennummern herangezogen werden.
Die Pseudonyme des Datensenders werden im DEMIS System weiterverarbeitet und liegen dem RKI nicht vor.
Die Pseudonyme sind nach folgender Logik zu bilden und in die Sendung einzufügen: https://simplifier.net/guide/ars-implementierungsleitfaden/Home/Grundlagen-und-%C3%9Cberblick/Pseudonymisierung

Sequenzdiagramm

Rate-Limit

Der synchrone Upload für ARS Sendungen unterliegt aktuell einer Durchsatzbegrenzung über alle Teilnehmenden hinweg. Bitte verwenden Sie für die Übermittlung von großen Datenmengen den Bulk-Prozess. Sollten Sie bei dem Einreichen einzelner Sendungen einen HTTP-Status-Code 429 erhalten versuchen Sie bitte zu einem späteren Zeitpunkt (30-90 Sekunden) den Upload erneut.

Datenbeispiele

Typ

Beispiel

ARS-Sendung

https://simplifier.net/rki.demis.ars/BundleExample-Outpatient-NoGrowth/~json

Rückgabewerte:

OperationDefinition

"parameter": [
{
"name": "bundleIdentifier",
"valueIdentifier": {
"system": "https://demis.rki.de/fhir/NamingSystem/NotificationBundleId",
"value": "59c214c6-fc11-48f4-a1b6-9755ec92f8d4"
}
},
{
"name": "specimenIdentifier",
"valueIdentifier": {
"system": "http://www.Labor-Warendorf.de/identifiers/specimen/accessionIdentifier",
"value": "23-000022"
}
},

{
"name": "specimenIdentifier",
"valueIdentifier": {
"system": "http://www.Labor-Warendorf.de/identifiers/specimen/accessionIdentifier",
"value": "23-000023"
}
},
{
"name": "operationOutcome",
...

}

OperationOutcome

https://hl7.org/fhir/operationoutcome-example-exception.json.html

Ablauf:

Authentisierung und Erhalt des Tokens (nur wenn kein Token vorhanden oder abgelaufen)
Übermittlung des ARS Bundles und Tokens mittels POST Request auf <umgebung>surveillance/antibiotic-resistance/v1/fhir/$process-notification
Die Sendung wird gegen das FHIR Profil (https://simplifier.net/rki.demis.ars) validiert. Die Pseudonyme werden weiter anonymisiert.
Im Erfolgsfall wird der Identifikater der Sendung und die Probennummern (als Array) zurückgeliefert. Das Operation Outcome enthält Hinweise und Warnungen.
Im Fehlerfall wird nur das Operation Outcome mit Fehlern und Warnungen zurückgeliefert.

Page tree