Zielstellung

Vorbereitung

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

UmgebungBasis-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:

Sequenzdiagramm

@startuml
autonumber "<b>[00]"

participant Labormanagementsystem as L
participant "ARS Service" as A

L -> A++: POST /v1/fhir/$process-notification ARS-Sendung
note left: [[https://demis.rki.de/fhir/ars/StructureDefinition/Bundle ARS-FHIR-Bundle]]
A -> A: Validierung / Anreicherung /\nVerarbeitung / Pseudonymisierung

alt Validierung erfolgreich
A -> L: OperationDefinition
note right: [[https://simplifier.net/mjs-test/operationdefinition OperationDefinition]]
else Validierung nicht erfolgreich
A -> L--: OperationOutcome
note right: [[https://hl7.org/fhir/operationoutcome.html OperationOutcome]]

end

@enduml

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

TypBeispiel
ARS-Sendunghttps://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:

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